PyScaffold extension to generate custom user extension
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Fix end of file Feb 10, 2019
src/pyscaffoldext
tests
.coveragerc
.gitignore Remove pytest_cache folder and sync gitignore with PyScaffold template Sep 4, 2018
.isort.cfg added pre-commit and travis Sep 7, 2018
.pre-commit-config.yaml
.travis.yml
AUTHORS.rst Simplified namespaces Feb 13, 2019
CHANGELOG.rst
Dockerfile
LICENSE.txt Initial commit Aug 30, 2018
README.rst
requirements.txt
setup.cfg
setup.py
tox.ini Add tox.ini Oct 17, 2018

README.rst

Travis ReadTheDocs Coveralls PyPI-Server

pyscaffoldext-custom-extension

PyScaffold extension that let's you create your own custom extensions.

Description

This extension serves as a support for the users interested in developing their own extension for PyScaffold. It configures your project so that you can start writing your extension logic and tests right away, taking care of all the wiring required to conform to PyScaffold's needs.

Let's say you want to create an extension named notebooks that creates a notebooks folder with some template Jupyter notebook. After having installed this extension with:

pip install pyscaffoldext-custom-extension

you will be able to just use it with:

putup --custom-extension notebooks

This will create a typical PyScaffold project template with some modifications:

  • the topmost namespace will be pyscaffoldext to have a unified namespace for PyScaffold extensions,
  • assures that the project is named pyscaffoldext-notebooks in setup.cfg,
  • sets the correct setup_requires and install_requires as well as the options.entry_points parameters in setup.cfg,
  • automatically activates the extensions --no-skeleton, --pre-commit, --travis and --tox since we want clean-coded, high-quality extensions,
  • creates a extension.py module holding a class Notebooks which serves you as a template for your extension,
  • adds basic unit tests checking that the invocation of your extension works and that it complies with our flake8 code guidelines,
  • provides a modified README.rst indicating that this is a PyScaffold extensions and how to install it.

Note

For more information about PyScaffold and its extension mechanism, check out http://pyscaffold.org/.