Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Tools for managing Nengo projects

Project description

Latest PyPI version Travis-CI build status Test coverage

Nengo Bones

The aim of this project is to automate the configuration of repositories throughout the Nengo ecosystem. The idea is that we can centralize the design and maintenance of “meta” project code (such as CI testing infrastructure) in this project, rather than each repository maintaining that code independently.

The basic methodology for this project is a templating system in which there are common templates for meta files that are populated with data in each downstream project. Projects control this templating through the .nengobones.yml configuration file, which defines the information used to fill in the templates.

Wherever possible, we try to do this templating in such a way that downstream projects will be automatically updated when an update is made in nengo-bones. However, some files cannot be updated automatically and require downstream repos to manually run a script to update those files.

Note that this repository itself is configured using the nengo-bones templating system, so if you would like an example of how to use it, check out the source code.

Installation

We recommend installing nengo-bones using pip:

pip install nengo-bones

Or for the latest updates you can perform a developer installation:

git clone https://github.com/nengo/nengo-bones.git
pip install -e ./nengo-bones

Basic usage

The first step is to fill in the .nengobones.yml configuration file. You can use the one in this repository as a starting point, or see the documentation for more details. This file should be placed in the top level of your project.

All of the manually generated template files can then be rendered by running this command in the same folder as the .nengobones.yml file:

bones-generate

See bones-generate --help or the documentation for a full list of command line options.

Release History

0.2.1 (May 24, 2019)

Added

  • Added codespell_ignore_words option to static.sh.template, which is a list of words that codespell will ignore. (#35)
  • Added analytics_id option to docs_conf.py.template, which will enable Google Analytics tracking. (#35)

Changed

  • codespell will now ignore _vendor directories. (#36)

Fixed

  • Fixed an issue with static.sh.template in which Python files that were not converted from notebooks were deleted. (#16)

0.2.0 (May 15, 2019)

Added

  • Added apt_install option that can be set in the jobs section to apt install any custom apt requirements for a job. (#14)
  • Added templates for CONTRIBUTING.rst, CONTRIBUTORS.rst, LICENSE.rst, MANIFEST.in, docs/conf.py, setup.cfg, and setup.py (#17)
  • Templates will now be automatically loaded from a <repo>/.templates directory if it exists. When overriding existing templates, the built-in templates can be accessed in include and extend tags with the templates/ prefix. (#17)
  • Added flake8 to the static check script. (#17)
  • Added the bones-pr-number script to predict the next PR number for a repository. This helps when writing a changelog entry before a PR has been made. (#18)

Changed

  • The Python version is now specified by the python option (instead of python_version), for consistency with .travis.yml. (#14)
  • All nengo-bones scripts now start with bones-, to make them easier to find with autocompletion. generate-bones is now bones-generate, and check-bones is now bones-check. (#18)

Removed

  • Removed conda from the CI setup; all installations should be done through pip instead. (#14)
  • Removed the --template-dir option from the generate-bones script; use a .templates directory instead. (#17)

Fixed

  • Order of templated dicts should now be deterministic for all Python versions. (#14)

0.1.0 (April 15, 2019)

Initial release of Nengo Bones! Thanks to all of the contributors for making this possible!

Project details


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
nengo_bones-0.2.1-py3-none-any.whl (36.0 kB) Copy SHA256 hash SHA256 Wheel py3
nengo-bones-0.2.1.tar.gz (47.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

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