Skip to main content

A readme generation package

Project description

Please Readme

Please readme is the ultimate package for those who like to develop, not stay up all night formatting their readme. Please Readme is a simple, yet flexible tool to generate readmes from the command line or readme classes with python if you so desire.

You can think of it as an easy readme generator from the command line. It is easy to use and the python API allows for lots of flexibility.

Make sure to check out the documentation at https://github.com/mrmaxguns/please-readme/wiki

Installation

Install with pip:

pip install please-readme

To upgrade the package:

pip install please-readme --upgrade

Using the Python API

Importing the readme classes:

from pleasereadme import generate_readme

Here is an example on using the CustomReadme class. You can also create your own readme classes that inherit the CustomReadme class. Make sure to check out the documentation for all classes, methods, etc. available.

from pleasereadme import generate_readme

data = [ # Lists of tuples are used to represent readme data because dictionaries are unordered
  ( # Each section is in the form of a tuple
    "Installation", # Section title
    [
      ("0", ["text", "Install using pip"]), # A subsection: (section_id, [datatype, data])
      ("1", ["code", "pip install my_package"]) # Many data types such as multi-line-code and ul exist
    ]
  ),
  ( # Another section
    "Requirements",
    [
      ("0", ["ul", ["Python 3.6 or greater", "numpy"]])
    ]
  )
]

my_template = generate_readme.CustomReadme('My Package', "A wonderful package", data) # Title, description, sections
my_template.create() # Create a file called README.md in the current directory

The following code would create a file called README.md with the following inside:

# My Package
A wonderful package

## Installation
Install using pip
```pip install my_package```

## Requirements
* Python 3.6 or greater
* numpy

Using the command line

An easy command line interface exists to generate readmes straight from the command line. See the command line documentation for more info on how to generate the README. The keyword to run the CLI is pleasereadme:

usage: pleasereadme [-h] [-v] [-p]

A little bit about the optional arguments

-h or --help: open the help menu
-v or --version: display the current version
-p or --print print the markdown instead of creating a readme file

The command pleasereadme will bring up questions about your readme that you can fill out. A readme file will then be generated depending on the path you specified.

License

Mit License

Contributors

Documentation

Please read the documentation to learn about the different features of pleasereadme. We are constantly growing so please also check our github page out if you want to contribute.

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

please-readme-1.0.0.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

please_readme-1.0.0-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

Details for the file please-readme-1.0.0.tar.gz.

File metadata

  • Download URL: please-readme-1.0.0.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.9

File hashes

Hashes for please-readme-1.0.0.tar.gz
Algorithm Hash digest
SHA256 936b7df50940cff806db3f89187047a382075deab563229cc7e0af6b0757e660
MD5 a38c4b38e5ca1313e123ab326284a712
BLAKE2b-256 6fe0d0d1dced047ee842a5cad110ee5159979559c7d40023639213a4b7ae2ad0

See more details on using hashes here.

File details

Details for the file please_readme-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: please_readme-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 9.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.9

File hashes

Hashes for please_readme-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0d4690645813cb349384b60855c6cbd73b5740b3898bc45b205caa6a3e218499
MD5 a766c5dd8ed496386bf3ca22e91904b8
BLAKE2b-256 c3178e9f5654ef1e18fe5d3d2c9215b879cd036200eac801bdd2635bfe7f782e

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