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
Contributors
- Maxim R. - initial work - mrmaxguns
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.
- Documentation: https://github.com/mrmaxguns/please-readme/wiki
- Github Page: https://github.com/mrmaxguns/please-readme/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 936b7df50940cff806db3f89187047a382075deab563229cc7e0af6b0757e660 |
|
MD5 | a38c4b38e5ca1313e123ab326284a712 |
|
BLAKE2b-256 | 6fe0d0d1dced047ee842a5cad110ee5159979559c7d40023639213a4b7ae2ad0 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d4690645813cb349384b60855c6cbd73b5740b3898bc45b205caa6a3e218499 |
|
MD5 | a766c5dd8ed496386bf3ca22e91904b8 |
|
BLAKE2b-256 | c3178e9f5654ef1e18fe5d3d2c9215b879cd036200eac801bdd2635bfe7f782e |