DEV Community

jadorotan@myseneca.ca
jadorotan@myseneca.ca

Posted on

readMeMaker: v0.1

About This Tool

ReadMeMaker is a CLI tool that will help users write their README.MD documentation depending on the input files the user specifies.

How to Start Using ReadMeMaker?

Clone the Repository

git clone https://github.com/jadorotan/readMeMaker
Enter fullscreen mode Exit fullscreen mode

Install the Required Dependencies for the tool to work

pip install -r requirements.txt
Enter fullscreen mode Exit fullscreen mode

Create a .env file and put inside your Groq API Key (https://console.groq.com)

GROQ_API_KEY=YOUR API KEY HERE
Enter fullscreen mode Exit fullscreen mode

Basic CLI Usage

This tool is still in it's early stages and doesn't have much any complex commands. One such example of a simple command you can run is this:

python readMeMaker.py -i .\examples\simpleCalculator.py -o .\examples\generated.md
Enter fullscreen mode Exit fullscreen mode

The command above will take the input file simpleCalculator.py that's inside the examples directory and using the -o option will store the generated.md file inside the same directory as the calculator python file. A demo of several other commands can also be found in this video: Youtube Demo.

Other CLI OPTIONS

Option Shortcut Description Default
-v --version Show the version of the tool. -
-h --help Show this help message and exit -
-i --input The input files for which to generate a README.md. -
-o --output Specify the output file name and file path. Creates a README.md file in the same directory
-m --model Specify the model to use for generating the README.md. Uses llama3-8b-8192

GitHub Repository

If you are interested in using this tool or even trying to contribute and improve the tool further, you can find it at: readMeMaker.

Conclusion

ReadMeMaker is still in its early stages of development but even so, this tool with its simple options can aid its users with writing their README.MD documentation for their code and possibly streamlining the process and saving time for the users who aren't well-versed in writing their own markdown files. This tool was made by utilizing Groq's AI Chat Completions Prompts.

Top comments (2)

Collapse
 
certification_supportsys profile image
Certification Support system

Hello there
Interested in Passing all IT and none IT exams with no efforts
PMP, azure, Salesforce, comptia, CCNA, CISCO and all others with just a click
WhatsApp Link: wa.me/message/LKPTS55J4JT6H1
Send us a massage

No UPFRONT payment
100% pass guaranteed and pay after pass
Low cost for each exam cleared
10yrs+ experience

Disclaimer: Do not Text if being certified is not your Goal
No time wasters

Send us a massage now
WhatsApp: WhatsApp Link: wa.me/message/LKPTS55J4JT6H1

Collapse
 
burgil profile image
Burgil‬‏

Nice project! I just read all the code and watched the video, and I can confirm it is looking great, I do have some suggestion for improvement if you want to hear let me know and I will write them down here