CLI to calculates the time some text takes the average human to read, based on Medium's read time forumula.
Project description
📖 Readtime-CLI
CLI to calculates the time some text takes the average human to read, based on Medium's read time forumula.
🧮 Algorithm
Medium's Help Center says,
Read time is based on the average reading speed of an adult (roughly 265 WPM). We take the total word count of a post and translate it into minutes, with an adjustment made for images. For posts in Chinese, Japanese and Korean, it's a function of number of characters (500 characters/min) with an adjustment made for images.
Double checking with real articles, the English algorithm is:
seconds = num_words / 265 * 60 + img_weight * num_images
With img_weight
starting at 12
and decreasing one second with each image encountered, with a minium img_weight
of 3
seconds.
Requirements
MacOS or Linux
Python 3.9+
Readtime-CLI stands on the shouders of giants:
🛠 Installation
Poetry
poetry add readtime-cli
Pip
virtualenv venv
. venv/bin/activate
pip install readtime-cli
💻 Usage
Version
readtime version
Calculate Read time Markdown files
readtime md FILE_PATH [OPTIONS]
Calculate Read time HTML files
readtime html FILE_PATH [OPTIONS]
Calculate Read time Text files
readtime text FILE_PATH [OPTIONS]
Options for all commands
--wpm INTEGER Word Per Minute [default: 265]
--language [en|pt-br] [default: Languages.en]
--help Show this message and exit.
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
Hashes for readtime_cli-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8a2297a90a36a09d3ab2b872f8953972ead3c982fb127ee48bc2f74fad23eeba |
|
MD5 | 197b4f550bbdb08b214a283ebb15dcd1 |
|
BLAKE2b-256 | 18830076429c52dce203db6fef97cba635e494d16c575d0df6674e21a259b77b |