Skip to main content
Help us improve Python packaging – donate today!

No project description provided

Project Description

# Boilerplate code for BrewBlox Service plugins

There is some boilerplate code involved when creating a Brewblox service plugin. This repository can be forked to avoid having to do the boring configuration.

Everything listed under Required Changes must be done before the package works as intended.

## How to use

  • Fork this repository to your own Github account or project
  • Follow all steps outlined under the various Required Changes
  • Start coding your plugin =)

## Files

### [](./ Used to create a distributable and installable Python package. See for more information.

Required Changes: * Change the project_name variable to your project name. This is generally the same as the repository name. This name is used when installing the package through Pip. * Change the package_name variable to the module name. This can be the same name as your project name, but can’t include dashes -. This name is used when importing your package in Python. * Check whether all other fields are correct. Refer to the documentation for more info. * Change the url parameter to the url of your repository. * Change the author parameter to your name. * Change the author_email parameter to your email.

### [tox.ini](./tox.ini) This file kicks off automated testing and linting of your package. See for more information.

Required Changes: * Change --cov=YOUR_PACKAGE to refer to your module name. * The --cov-fail-under=100 makes the build fail if code coverage is less than 100%. It is optional, but recommended. Remove the # comment character to enable it.

### [requirements.txt](./requirements.txt) Include all runtime requirements for your package here. See for more information.

Note: There is overlap between your requirements file, and the install_requires=[] line in For most cases, the rule of thumb is that if you need an external package to run, you should add it as dependency to both files.

### [requirements-dev.txt](./requirements-dev.txt) The file works just like [requirements.txt](./requirements.txt), but should only list the packages needed to test the code. End users do not need these dependencies.

### [](./ This file lists all non-code files that should be part of the package. See for more info.

For a basic plugin, you do not need to change anything in this file.

### [.travis.yml](./.travis.yml) Travis CI configuration. If you haven’t enabled travis for your repository: don’t worry, it won’t do anything.

### [.coveragerc](./.coveragerc) This file contains some configuration for pytest-cov.

For a basic plugin, you do not need to change anything in this file.

### [](./ Your module readme (this file). It will be the package description on, and automatically be displayed in Github. Required Changes: * Add all important info about your package here. What does your package do? How do you use it? What is your favorite color?

### [YOUR_PACKAGE/](./YOUR_PACKAGE/) Your module. This directory name should match the package_name variable in Required Changes: * Rename to the desired module name. (Python import name. Can’t include dashes “-“).

### [test/](./test/ Project-level pytest fixtures. Some useful fixtures for testing any brewblox_service implementation are defined here. See tests in for examples on how to use.

For a basic implementation, you do not need to change anything in this file.

### [test/](./test/ An example on how to test aiohttp endpoints you added. Feel free to remove this once you no longer need it.

Release history Release notifications

History Node


History Node


This version
History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
brewblox-history-0.5.0.tar.gz (8.1 kB) Copy SHA256 hash SHA256 Source None Mar 12, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page