Skip to main content

Generate a README and other files for GitHub.

Project description

README Template

A template project / CLI tool for creating a README and other files for Python projects on GitHub.

License: MIT PyPI

  • This project contains templates you can use to write your own README, CONTRIBUTING and PULL_REQUEST_TEMPLATE files.
  • It also includes a CLI tool for using these files in your own projects.
  • Supports pip or poetry for dependency management.

Demo of the Read Me template command line app. It shows the user inputting their GitHub username and a repository name to generate a set of customised files useful for sharing GitHub projects.

Install

pip install readme-template-cli

Usage

readme [-h] [--test] [--force]
Flag Description
-h, --help Show this help message and exit.
--test Run in test mode - files created have .test extension. This does not update filename references inside the templates.
--force Force overwrite existing files.

Run locally

Install dependencies

If using pip:

pip install -r requirements.txt

If using poetry:

poetry install --without dev

Usage

Run the program from the command line (from the project root) like this:

If using pip:

python3 readme_generator/src/generator.py

If using poetry:

poetry run readme

Contributing

For information on how to set up your dev environment and contribute, see here.

License

MIT

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

readme_template_cli-0.1.3.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

readme_template_cli-0.1.3-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file readme_template_cli-0.1.3.tar.gz.

File metadata

  • Download URL: readme_template_cli-0.1.3.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.2 CPython/3.9.2 Linux/5.15.133.1-microsoft-standard-WSL2

File hashes

Hashes for readme_template_cli-0.1.3.tar.gz
Algorithm Hash digest
SHA256 2cacd5e4bb4a3625a7667f186f67002f214385b47ed1d2e574334b13c0a64369
MD5 6984335b2b631e8651ee53e0cdae55e3
BLAKE2b-256 2aaddc17a8049c536d2ff788dce119ba80e416af45e0f6e5d70538dbf823bc37

See more details on using hashes here.

File details

Details for the file readme_template_cli-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: readme_template_cli-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.2 CPython/3.9.2 Linux/5.15.133.1-microsoft-standard-WSL2

File hashes

Hashes for readme_template_cli-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c2196882e58de9cb9df2465cb54e34ac21ccdbfb70f4429fdbff339997b22c8b
MD5 881f4e19197379eb9b0f2eb329f30c3c
BLAKE2b-256 9562284f377d564b15d866211586b09286245ee7a6bb001aa1b70c49ada3017e

See more details on using hashes here.

Supported by

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