Skip to content

A CLI tool that creates and updates project folders from templates to spark faster project bootstrapping.

License

Notifications You must be signed in to change notification settings

mobiusbyte/sparks

Repository files navigation

Sparks

Maintainability Test Coverage

Sparks is a minimal command-line tool to manage customizable project folders from templates.

Features

  • Simple command line usage thanks to Click.
  • Customizable folder, files, and file contents thanks to Jinja2.

Installation

Run the following to install:

pip install sparks

Usage

Creating a new project

sparks create --help
Usage: sparks create [OPTIONS]

Options:
  -t, --template TEXT  Template folder to generate from
  -o, --output TEXT    Output folder to create files in. The folder will be
                       created if it does not already exist.
  --skip-prompt        Skips the prompt and uses the default settings as
                       specified in the spark_config.yaml.
  --help               Show this message and exit.

Contributing

Development setup

  1. Install pipenv
    pip install pipenv
  2. Clone this repository and activate your environment
    bash-3.2$ git clone [email protected]:binaryart/sparks.git
    bash-3.2$ cd sparks
    bash-3.2$ pipenv shell
    (sparks) bash-3.2$ pipenv install --dev
    (sparks) bash-3.2$ pre-config install
  3. Make your changes in the application and test code
  4. Run the tests
    (sparks) bash-3.2$ pytest test
  5. Commit your changes. The commit will fail if any of the pre-commit rules failed their check. Simply follow the instructions from the console to fix the check failures.

Publishing

  1. Bump the version in setup.py
  2. Merge this change to master branch
  3. Generate the distribution packages and upload it to PyPI
    (sparks) bash-3.2$ python setup.py bdist_wheel sdist
    (sparks) bash-3.2$ twine upload dist/*

License

Sparks is released under the MIT License.

About

A CLI tool that creates and updates project folders from templates to spark faster project bootstrapping.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages