devopstemplate 0.6.0

This package provides a command-line interface for setting up a Python project based on a DevOps template

Python Devops Template Tool

Command-line interface for setting up a Python project based on a dev-ops template.

• Sample project for this template (including detailed documentation).
• Cookiecutter for this template.
• Also check out audreyr/cookiecutter-pypackage for additional Python package templates.

Features

This command-line interface supports the creation and the management of a Python dev-ops template that provides:

• testing and deployment in a multi-stage Docker environment,
• packaging with setuptools,
• code analysis with pylint, bandit, pytest and coverage,
• code quality monitoring with SonarQube.

The dev-ops pipeline is mostly implemented in a Makefile and a Dockerfile which are independent of your Python code. A SonarQube server is started with docker-compose.

Creation and management of the template:

• create a new instance of the template (very similar to Cookiecutter),
• manage an existing instance/project by adding template components as the project evolves,
• generate a Cookiecutter template (see lrothack/cookiecutter-pydevops),
• packages the template code in a Python distributions, e.g., binary wheel package,
• configure the template with boolean command-line flags or in interactive mode,
• resolves author information automatically with git config.

Installation

Install the latest version from pypi.org:

pip install -U devopstemplate

From source:

# Obtain sources
git clone --recurse-submodules https://github.com/lrothack/dev-ops-admin.git

# Install and activate virtual environment
cd dev-ops-admin
python3 -m venv venv
source venv/bin/activate

# Build package
make dist

The binary wheel package is located in the dist directory and can be installed with pip.

Create and manage projects

After installation, the executable devopstemplate is available. It provides the sub-commands:

• create
• manage
• cookiecutter

An overview of the functionalities is shown on the help screens:

devopstemplate --help
devopstemplate <sub-command> --help

The working directory is always the root directory of your project, for example:

mkdir sampleproject
cd sampleproject
devopstemplate create sampleproject

Using the dev-ops template

After creating a new project or after switching to the project directory:

• Set up a virtual environment for your project and activate it (requires Python >= 3.6).
• Run make help in order to get an overview of the targets provided by Makefile.
• Run make install-dev in order to install the package (and all dependencies) in development mode.
• Run make lint in order to run code analysis with pylint and bandit.
• Run make test in order to run unit tests with pytest and coverage.
• Run make dist in order to build a Python package (binary and source).
• Run docker-compose -p sonarqube -f sonarqube/docker-compose.yml up -d in order to start a SonarQube server.
• Run make sonar in order to locally run sonar-scanner and report results to your local SonarQube server. Requires a local installation of sonar-scanner.
• Run make docker-build in order to analyze, test, package, report to SonarQube and deploy in a multi-stage Docker build. Test your docker image with docker run. Make sure you have Docker installed and the Docker daemon is running.

Advanced configurations can be made in the configuration sections of Makefile. See lrothack/dev-ops for more information.