Skip to main content

A python development boilerplate generator

Project description

Logo

boilrpy is a Python project automation tool that simplifies the process of creating new Python projects. It generates a standardized project structure, including essential files and configurations, allowing developers to quickly start working on their Python projects.

PyPI version License: MIT Python Coverage

Installation

You can install boilrpy directly from PyPI:

pip install boilrpy

Quick Start

Create a new Python project with boilrpy:

from boilrpy import create_project

create_project(
    name="my_awesome_project",
    version="0.1.0",
    license="MIT",
    use_poetry=True
)

Or use the command-line interface:

boilrpy

Features

  • Create a new Python project with a standardized structure
  • Generate essential files (LICENSE, .gitignore, README.md, etc.)
  • Initialize a Git repository
  • Set up dependency management (Poetry or pip)
  • Create a Dockerfile and .dockerignore
  • Support for multiple license types
  • Configurable project

Usage

To create a new Python project using the CLI, run:

boilrpy

Follow the prompts to configure your project. You'll be asked for:

  • Project name
  • Version
  • License type
  • Dependency management preference (Poetry or pip)
  • And more...

Project Structure

boilrpy generates the following project structure:

your_project/
├── .gitignore
├── LICENSE
├── README.md
├── Dockerfile (if using Docker)
├── .dockerignore (if using Docker)
├── pyproject.toml (if using Poetry)
├── requirements.txt (if using pip)
├── src/
│   └── your_project/
│       └── __init__.py
└── tests/
    └── __init__.py

Configuration

Boilrpy uses sensible defaults, but you can customize the project creation process by answering the prompts during project creation.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you encounter any problems or have any questions, please open an issue on the GitHub repository.

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

boilrpy-0.5.0.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

boilrpy-0.5.0-py3-none-any.whl (18.5 kB view details)

Uploaded Python 3

File details

Details for the file boilrpy-0.5.0.tar.gz.

File metadata

  • Download URL: boilrpy-0.5.0.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for boilrpy-0.5.0.tar.gz
Algorithm Hash digest
SHA256 7f8eca958f7173cf01224d981d10eb4d406b66bfd1d5340845ca581eb16655d9
MD5 fda3dc1c3ad1f6629a7ed43cc2e6ccde
BLAKE2b-256 ded3e442ee8713e6836c1a41b0a4178ae963d9e3c33cef72cecec6eee5c1598e

See more details on using hashes here.

File details

Details for the file boilrpy-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: boilrpy-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 18.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for boilrpy-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8e424369fb5e29547d0c1eecf750ba27d5c27cf9a9b44ac95db9f59e76ca8297
MD5 e8bbd2dc9841f4883a98ff8f5aad9d20
BLAKE2b-256 14777e9f6bec6788d5457762671912907927ea0982a47db049a41cfa4a4ed699

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page