Skip to main content

Reado: Your Automated README Generator

Introduction

Reado is a compatible command-line interface (CLI) tool designed to streamline the creation of professional-grade README files. Tired of manually writing READMEs? Reado automates the process by analyzing your project's structure and content, generating a comprehensive and well-formatted README in seconds. Simply point Reado at your project, and it will handle the rest, ensuring your project is well-documented and easily understood by others. Reado leverages the power of the Google Gemini 1.5 Flash model to produce high-quality, informative README files.

Installation

Installing Reado is simple and straightforward. Ensure you have Python 3 installed on your system. Then, use pip to install the package:

sudo  pip  install  reado

This will install Reado and its dependencies. You'll then need to set your Google Gemini API key (see Usage for details).

Usage

Reado offers a streamlined workflow to generate your README. Follow these steps:

  1. Set your API Key: Before using Reado, you must set your Google Gemini API](https://aistudio.google.com/) key. This key grants Reado access to the Gemini 1.5 Flash model. Use the following command, replacing <YOUR_Gemini_API> with your actual API key:
reado  set_api_key  <YOUR_Gemini_API>
  1. Initialize the Project: After setting your API key, initialize Reado within your project's root directory:
reado  init

This command creates the necessary configuration files. After running this command, a file named readme_config.json with the following structure is generated:

"description": "<Write a brief description of your project.>",

"usage_example": "First , Second , ...",

"installation": "ex: pip install <YOUR-PrOJECT-NAME> ",

"contributing": "",

"license": ""

Completing this information is required to create a README.

  1. Generate the README: Finally, generate the README file:
reado  generate

Reado will Extract your project's structure using Nimblex, identify key components, and generate a comprehensive README.md file in your project's root directory. Ensure that Google services are supported in your region for successful operation. Reado must be run from the root directory of your project.

Contributing

i welcome contributions to Reado!

License

Reado is licensed under the MIT License. See the LICENSE file for more details.


This README was made using READO

Metadata

Release files for Reado 0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Reado 0.1
File Size Uploaded
reado-0.1.tar.gz 5.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Reado 0.1
File Interpreter ABI Platform
Reado-0.1-py3-none-any.whl Python 3 none any Details

Total release size: 12.0 kB

Release files / reado-0.1.tar.gz

Download URL reado-0.1.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5354751488a224970e2b7ea1d851f10607813b63d68b7998987716e2ab59d8ab
BLAKE2b-256 checksum
How to use checksums
8c2e24737056d92f4be3dd3077e6a0d208e063946f879cc7003849f986098534
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.10.12

Release files / Reado-0.1-py3-none-any.whl

Download URL Reado-0.1-py3-none-any.whl
Size 6.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b826ff1e24aa2f54f5434e2298d09fe80073abe5d10fcaa120361cd39912cf3d
BLAKE2b-256 checksum
How to use checksums
5891dfa7a27e55387f734f2620e11bfa167feeea30e4990de600462722682cf4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.10.12

Release history Release notifications | RSS feed

This release

0.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page