Metadata-Version: 2.1
Name: pib-cli
Version: 0.0.5
Summary: Python Development CLI
Home-page: https://github.com/niall-byrne/pib_cli
License: MPL-2.0
Author: Niall Byrne
Author-email: niall@niallbyrne.ca
Requires-Python: >=3.7.0,<3.8.0
Classifier: License :: OSI Approved
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: PyYAML (>=5.3.1,<5.4.0)
Requires-Dist: bandit (>=1.6.2,<1.6.3)
Requires-Dist: click (>=7.1.2,<7.2.0)
Requires-Dist: commitizen (>=2.8.2,<3.0.0)
Requires-Dist: isort (>=5.6.0,<5.7.0)
Requires-Dist: jinja2 (>=2.10.3,<3.0.0)
Requires-Dist: m2r2 (>=0.2.7,<0.3.0)
Requires-Dist: poetry (>=1.1.4,<1.2.0)
Requires-Dist: pylint (>=2.6.0,<2.7.0)
Requires-Dist: pytest (>=5.4.1,<5.5.0)
Requires-Dist: pytest-cov (>=2.10.1,<2.11.0)
Requires-Dist: pytest-pylint (>=0.18.0,<0.20.0)
Requires-Dist: safety (>=1.9.0)
Requires-Dist: sphinx (>=3.0.4,<3.1.0)
Requires-Dist: wheel (>=0.36.0)
Requires-Dist: yamllint (>=1.25.0)
Requires-Dist: yapf (>=0.30.0)
Project-URL: Documentation, https://github.com/niall-byrne/pib_cli/README.md
Project-URL: Repository, https://github.com/niall-byrne/pib_cli
Description-Content-Type: text/markdown

# PIB CLI

A development environment CLI, complete with tooling.

[Project Documentation](https://pib_cli.readthedocs.io/en/latest/)

## Develop Branch

[![pib_cli-automation](https://github.com/shared-vision-solutions/pib_cli/workflows/pib_cli%20Automation/badge.svg?branch=develop)](https://github.com/shared-vision-solutions/pib_cli/actions)

## Master Branch

[![pib_cli-automation](https://github.com/shared-vision-solutions/pib_cli/workflows/pib_cli%20Automation/badge.svg?branch=master)](https://github.com/shared-vision-solutions/pib_cli/actions)

## Installation

This is a development environment CLI, with a customizable yaml config.

It's built into this [Cookie Cutter](https://github.com/cookiecutter/cookiecutter) template:

- [Python In A Box](https://github.com/shared-vision-solutions/python-in-a-box)

To install, simply use: `pip install pib_cli`

## Usage

- use the `dev` command for details once inside the container

## Container

[python:3.7-slim](https://github.com/docker-library/python/tree/master/3.7/buster/slim)

## License

[MPL-2](LICENSE)

## Installed Packages:
| package    | Description                       |
| ---------- | --------------------------------- |
| bandit     | Finds common security issues      |
| commitizen | Standardizes commit messages      |
| isort      | Sorts imports                     |
| poetry     | Python Package Manager            |
| pylint     | Static Code Analysis              |
| pytest     | Test suite                        |
| pytest-cov | Coverage support for pytest       |
| sphinx     | Generating documentation          |
| safety     | Dependency vulnerability scanning |
| wheel      | Package distribution tools        |
| yamllint   | Lint yaml configuration files     |
| yapf       | Customizable Code Formatting      |

## Customizing the Command Line Interface

The CLI has some defaults built in, but is customizable by setting the `PIB_CONFIG_FILE_LOCATION` environment variable.
The default config file can be found [here](pib_cli/config/config.yml).

Each command is described by a yaml key in this format :

```yaml
- name: "command-name"
  path_method: "location_string"
  commands:
    - "one or more"
    - "shell commands"
    - "each run in a discrete environment"
  success: "Success Message"
  failure: "Failure Message"
```

where `location_string` is one of:

- `project_root` (`/app`)
- `project_docs` (`/app/documentation`)
- `project_home` (`/app/${PROJECT_HOME}`)

## Installing a virtual environment, and the CLI on your host machine

The [scripts/extras.sh](scripts/extras.sh) script does this for you.

First install [poetry](https://python-poetry.org/) on your host machine:
- `pip install poetry`

Then source this script, setup the hostmachine, and you can use the `dev` command on your host:
- `source scripts/extras.sh`
- `pib_setup_hostmachine` (to install the poetry dependencies)  
- `dev --help` (to run the cli outside the container)

It is still recommended to work inside the container, as you'll have access to the full managed python environment, 
as well as any additional services you are running in containers.

## Development Dependencies

You'll need to install:

- [Docker](https://www.docker.com/)
- [Docker Compose](https://docs.docker.com/compose/install/)

## Setup the Development Environment

Build the development environment container (this takes a few minutes):

- `docker-compose build`

Start the environment container:

- `docker-compose up -d`

Spawn a shell inside the container:

- `./container`

