Skip to main content

A tool to automatically generate a README.md and suggest code improvements for any python code repository

Project description

GPT4Readability

License Badge Issues Badge Pull Requests Badge Contributors Badge contributions welcome

GPT4Readability is a powerful tool designed to automatically generate a comprehensive README.md file and suggest code improvements for any Python code repository. With its advanced AI capabilities, GPT4Readability goes beyond surface-level interpretation, allowing it to establish connections between disparate parts of code and gain an in-depth understanding of the code's functionality, structure, and intent.

Other than this sentence this readme file and this suggestions file were both generated by GPT4Readability using gpt-3.5-turbo. Any other changes made will be listed below:

Features

  • Automatic generation of a detailed README.md file for your Python codebase
  • Suggestions for code improvements to enhance readability and maintainability

Installation

To use GPT4Readability, you need to have Python 3.6 or higher installed on your system. You can install GPT4Readability and its dependencies using the following command:

pip install GPT4Readability==0.0.3

Usage

GPT4Readability provides two main functionalities: README generation and code improvement suggestions. You can choose to use either one or both of these functions.

README Generation

To generate a README.md file for your codebase, use the following command:

gpt4readability <path> --function readme --output_readme README.md --model <model>

Replace <path> with the path to your codebase directory and <model> with the desired model to use (either "gpt-3.5-turbo" or "gpt-4").

Code Improvement Suggestions

To generate code improvement suggestions for your codebase, use the following command:

gpt4readability <path> --function suggestions --output_suggestions suggestions.md --model <model>

Replace <path> with the path to your codebase directory and <model> with the desired model to use (either "gpt-3.5-turbo" or "gpt-4").

Authors

GPT4Readability is developed and maintained by Dennis Johan Loevlie. For any inquiries or support, please contact Dennis Johan Loevlie at loevliedenny@gmail.com.

Contributing

Contributions to GPT4Readability are welcome! If you encounter any issues or have suggestions for improvements, please report them by opening an issue on the GitHub repository.

To contribute code changes, follow these steps:

  1. Fork the repository on GitHub.
  2. Create a new branch from the main branch.
  3. Make your desired changes and commit them.
  4. Push your branch to your forked repository.
  5. Open a pull request on the main repository.

Please ensure that your code changes adhere to the coding style and guidelines of the project.

Support

For support or assistance with using GPT4Readability, please contact Dennis Johan Loevlie at loevliedenny@gmail.com.

License

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

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

GPT4Readability-0.0.4.tar.gz (9.9 kB view hashes)

Uploaded Source

Built Distribution

GPT4Readability-0.0.4-py3-none-any.whl (12.5 kB view hashes)

Uploaded Python 3

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