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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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