semvec/pypi-packages huggingface dataset:
soda-pylib 1.3.5
Utilities to help projets at SODA Virtual.
License: MIT
Keywords: deploy fabric

# soda-pylib

This is a bucket of Pythonic utilities to help developing and maintaining
projets at SODA Virtual.


## soda.deploy

A collection of Fabric tasks that will aid deploying projects to *Virtual
Private Servers*. They will require an `env.roledefs` to work properly:

```python
from fabric.api import env

env.roledefs = {
    'dev': {
        'app_path': '/path/to/project/repository',  # Full path!
        'hosts': ['my_app.sodateste.com.br'],  #  Can be more than one
        'service_name': 'my_app',  # Supervisor service name
        'settings_module': 'my_app.settings_dev',  # Django settings module
        'user': 'soda',  # System user to perform operations
        'venv_path': '/path/to/project/venv',  # Virtualenv path
    },
    'prod': {
        # ...
    },
}
```

The following tasks are available for use:

### `git.display_version`

Display the active revision at the remote host.

```python
from fabric.api import execute
from soda.deploy import git
execute(git.display_version)
```


### `git.update_sources`

Fetch sources from the default remote (acquired by `git remote`) and checkout
to specified revision.

```python
from fabric.api import execute
from soda.deploy import git
execute(git.update_sources, 'master')
```


### `supervisor.stop`

Stop the app's Supervisor main service.

```python
from fabric.api import execute
from soda.deploy import supervisor
execute(supervisor.stop)
```


### `supervisor.start`

Start the app's Supervisor main service.

```python
from fabric.api import execute
from soda.deploy import supervisor
execute(supervisor.start)
```


### `deps.install_python_libs`

Install Python dependencies as defined in the project's `requirements.txt`.

```python
from fabric.api import execute
from soda.deploy import deps
execute(deps.install_python_libs)
```


### `deps.install_bower_libs`

Install front-end dependencies from Bower, as defined in the project's
`bower.json`.

```python
from fabric.api import execute
from soda.deploy import deps
execute(deps.install_python_libs)
```


### `django.collectstatic`

Run Django's `collectstatic` management command.

```python
from fabric.api import execute
from soda.deploy import django
execute(django.collectstatic)
```


### `django.migrate`

Run Django's `migrate` management command.

```python
from fabric.api import execute
from soda.deploy import django
execute(django.migrate)
```


### `opbeat.register_deploy`

Register a deployment to the Opbeat integration.

```python
from fabric.api import execute
from soda.deploy import opbeat
execute(opbeat.register_deploy)
```