Metadata-Version: 2.1
Name: ociedoo
Version: 0.7.0
Summary: CLI tool to simplify the management of Odoo
Home-page: https://gitlab.com/coopiteasy/ociedoo
License: GPL-3.0-or-later
Keywords: cli,odoo,coopiteasy
Author: Coop IT Easy SCRLfs
Author-email: remy@coopiteasy.be
Maintainer: Rémy Taymans
Maintainer-email: remy@coopiteasy.be
Requires-Python: >=3.5,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Dist: click (>=7.0,<8.0)
Requires-Dist: passlib (>=1.7.4,<2.0.0)
Requires-Dist: prgconfig (>=1.0.0-beta.2,<2.0.0)
Requires-Dist: sh (>=1.12,<2.0)
Project-URL: Repository, https://gitlab.com/coopiteasy/ociedoo
Description-Content-Type: text/markdown

[![pipeline status](https://gitlab.com/coopiteasy/ociedoo/badges/master/pipeline.svg)](https://gitlab.com/coopiteasy/ociedoo)

ociedoo
=======

ociedoo is a cli collection of tools to simplify the management of odoo
on a server.

See help for more info.


Installation
------------

ociedoo needs python version >= 3.5. So ensure `pip` points to a correct
version of python. To do this run:
```shell
pip --version
```

It should return something like:
```
pip xx.y from /path/to/pip (python 3.5)
```

If `pip` doesn't run python >=3.5, try running `pip3` which is on
certain distribution the `pip` for python >=3.


### Dependencies

ociedoo uses external programs via the shell. Be sure they are installed
and accessible for the current user.

- psql
- createdb
- dropdb
- systemctl


### Install for a specific user


#### Installation with pipx (recommended python >= 3.6)

```shell
pipx install ociedoo
```


#### Installation with pipsi (recommended python < 3.5)

```shell
pipsi install ociedoo
```


#### Install with pip

```shell
pip install --user ociedoo
```


### Install system wide (for all users)


#### Install with pipx (recommended python >= 3.6)

First install pipx if not already installed:
```shell
sudo pip install pipx
```

Then install ociedoo:
```shell
sudo PIPX_HOME=/usr/local PIPX_BIN_DIR=/usr/local/bin pipx install ociedoo
```


#### Install with pipsi (recommended python < 3.6)

First install pipsi, if not already installed:
```shell
sudo curl https://raw.githubusercontent.com/mitsuhiko/pipsi/master/get-pipsi.py | sudo python3 - --bin-dir /usr/local/bin --home /usr/local/venvs --no-modify-path
```

Then install ociedoo:
```shell
sudo pipsi --bin-dir /usr/local/bin --home /usr/local/venvs install ociedoo
```


#### Install with pip
```shell
sudo pip install ociedoo
```


### Enable bash completion


#### Bash completion for a specific user

To enable bash completion add the following in your `.bashrc`:

```shell
# ociedoo
# =======
if command -v ociedoo >/dev/null; then
    eval "$(_OCIEDOO_COMPLETE=source ociedoo)"
fi
```

Or if you use zsh, add this to your `.zshrc`:
```shell
# ociedoo
# =======
if command -v ociedoo >/dev/null; then
    eval "$(_OCIEDOO_COMPLETE=source_zsh ociedoo)"
fi
```


#### Bash completion system wide (for all users)

To enable bash completion add the following in `/etc/bash.bashrc`:
```shell
# ociedoo
# =======
if command -v ociedoo >/dev/null; then
    eval "$(_OCIEDOO_COMPLETE=source ociedoo)"
fi
```

Or if you use zsh, add this to your `/etc/zsh/zshrc`:
```shell
# ociedoo
# =======
if command -v ociedoo >/dev/null; then
    eval "$(_OCIEDOO_COMPLETE=source_zsh ociedoo)"
fi
```


Upgrade
-------


### Upgrade for a specific user


#### Upgrade with pipx (recommended python >= 3.6)

```shell
pipx upgrade ociedoo
```


#### Upgrade with pipsi (recommended python < 3.5)

```shell
pipsi upgrade ociedoo
```


#### Upgrade with pip

```shell
pip install --user --upgrade ociedoo
```


### Upgrade system wide (for all users)


#### Upgrade with pipx (recommended python >= 3.6)

```shell
sudo PIPX_HOME=/usr/local PIPX_BIN_DIR=/usr/local/bin pipx upgrade ociedoo
```


#### Upgrade with pipsi (recommended python < 3.5)

```shell
sudo pipsi --bin-dir /usr/local/bin --home /usr/local/venvs upgrade ociedoo
```


#### Upgrade with pip

```shell
sudo pip install --upgrade ociedoo
```

