Cookiecutter for mBuild recipes

A cookiecutter template for developing a Python package for mBuild recipes. Based on the MolSSI Cookiecutter.

Features

• Pre-configured setup.py for installation and packaging which automatically registers with the entry_point group defined in mBuild
• Pre-configured Linux and OSX continuous integration on Travis-CI
• Basic testing with PyTest
• Sample example directory

Requirements

• Python 3.6 or later
• Cookiecutter

Usage

With cookicutter installed, execute the following command inside the folder you want to create your skeletal mBuild recipe directory.

cookiecutter /path/to/mbuild-cookiecutter/

From here, the user will be prompted for information on how to build the directory such as package name, module name, and authors.

Testing

Unit testing with pytest has been integrated within this cookiecutter. This testing framework is used in mBuild. The default tests added in mbuild_{{cookiecutter.directory_name}}/tests/ are to check that the cookiecutter package has been successfully integrated with mBuild recipes via entrypoints.

Additional tests can be added to the project/tests/ folder. Any function starting with test_* will be automatically included into the testing framework.

To run the suite of unit tests, type pytest -v on the command line.

Continuous Integration

Continuous integration is done with Travis-CI for both Linux and MacOS testing. Travis-CI is free for open source projects and allows you to test and verify that your mBuild recipe works with various OS and Python versions.

Currently, continuous integration is setup to test Linux and MacOS builds for Python versions 3.6 and 3.7. The build instructions are contained in .travis.yml and is designed to work out of the box. However, you may have to edit the instructions to include any new dependencies.

Using entry points with mBuild

To connect your mBuild recipe to mBuild, the first step is to install your recipe locally by running pip install -e . in the project root directory. You can test that your recipe classes are recognized by mBuild by running the following list of commands:

python
import mbuild
mbuild.recipes.name_of_your_plugin()