Metadata-Version: 2.1
Name: oooenv
Version: 0.1.0
Summary: Configures a project environment for LibreOffice UNO.
Home-page: https://github.com/Amourspirit/python_oooenv
License: MIT
Keywords: libreoffice,macro,uno,ooouno
Author: :Barry-Thomas-Paul: Moss
Author-email: vibrationoflife@protonmail.com
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Project-URL: Documentation, https://github.com/Amourspirit/python_oooenv
Project-URL: Repository, https://github.com/Amourspirit/python_oooenv
Description-Content-Type: text/markdown

# OOOENV

This project is strictly for LibreOffice python projects that need to set UNO environment.

A project as [OOO Development Tools](https://python-ooo-dev-tools.readthedocs.io/en/latest/index.html) would use this project

See also [OOO Development Tools - Develop Docs](https://python-ooo-dev-tools.readthedocs.io/en/latest/dev_docs/dev_notes.html)

## Installation

**oooenv** [PyPI](https://pypi.org/project/oooenv)

```
pip install oooenv
```

## Usage

### Linux/Mac

In Linux and Mac all that is needed to run a project that requires LibreOffice UNO
is to link the UNO files into virtual environment.

To add UNO links to virtual environment run command:

```sh
oooenv cmd-link -a
```

To remove UNO links from virtual environment run command:

```sh
oooenv cmd-link -r
```

### Windows

Windows python projects cannot use linking to UNO Files.

In Windows the virtual environment configuration file is manipulated.

The Follow command toggles between original configuration and UNO environment configuration.

```ps
oooenv env -t
```

If virtual environment is managed by Poetry then it will be necessary to toggle into original config before running
`poetry update`.

When updates are done just run command again to toggle back to UNO environment configuration.

