Blankslate automates the creation of Python projects, ensuring that every detail adheres to the best practices of Python development. It leverages GitHub Actions, NumPy docstrings, and a well-organised directory structure to deliver a ready-to-deploy project scaffold.
To install Blankslate, simply run:
pip install blankslate-python
After installation, you can create a new project by executing:
blankslate-python
Follow the prompts to specify your project details. Blankslate will create the project in your designated directory. You can then push this project to GitHub and start programming in the source/PROJECT_NAME/
directory.
- Automatic Project Structure Creation: Sets up a GitHub-ready Python project with best practices.
- Semantic Versioning: Use the script
./scripts/release.sh VERSION_NUMBER
to auto-version and generate a changelog. EnsureVERSION_NUMBER
follows semantic versioning. Note that this will automatically build and publish the project to PyPi, too. - Commit Style: Commits should follow the Angular commit style.
- Documentation: Automatically generates and pushes documentation to GitHub pages. Make sure your GitHub repository is configured under
Settings -> Pages
and set the deployment branch todocs/(root)
. - TODO to GitHub Issues: Converts
# TODO
comments in your Python code into GitHub issues. Configure this inSettings -> Actions (General) -> Workflow permissions
and enable "Read and write permissions".
Enhance your Blankslate experience with the Blankslate Extension Pack for VS Code.
Contributions are welcome! Please refer to our CONTRIBUTING.md
for more information.
This project is licensed under the MIT License - see the LICENSE.md
file for details.