pirg 1.2.0

command-line tool that simplifies the management of project's `requirements.txt` file

PiRG - Pip Requirements Generator

---

Description

PiRG (Pip Requirements Generator) is a minimalist command-line tool designed for Python developers who prefer a simple approach to managing project dependencies. Unlike traditional requirements files that include all installed packages and their dependencies, PiRG focuses on capturing only the primary packages you install using pip install. This makes your requirements.txt file concise and easier to manage.

With PiRG, you can also pass additional pip install or pip uninstall options to customize package installation and removal.

Philosophy

Instead of looking back and searching through project files which packages are needed for project, with PiRG you record each installed package. If you don't want to put some package into requirements.txt just use pip.

Installation

Prerequisites

Before using pirg, make sure you have Python 3.8 or higher installed on your system.

Installation Steps

1. Install pirg using pip:

   pip install pirg
   

2. Verify the installation by running:

   pirg --help
   

3. You're ready to use pirg!

Usage

Adding Packages to requirements.txt

To add one or more packages to your project's requirements.txt file and install them, use the following command:

pirg install package_name1 package_name2 ...

Removing Packages from requirements.txt

To remove one or more packages from your project's requirements.txt file and uninstall them, use the following command:

pirg uninstall package_name1 package_name2 ...

Note: Make sure to replace package_name1, package_name2, etc., with the actual names of the packages you want to add or remove.

Additional Options

• You can specify a custom path for your requirements.txt file using the --requirements-path option. By default, it assumes ./requirements.txt.

Acknowledgments

This project makes use of the following third-party libraries, each with its own licensing terms:

• Typer

  • License: MIT License

• Requests

  • License: Apache License 2.0

• Packaging

  • License: Apache License 2.0

Additionally, this project contains code under the GPL-2.0 License:

• License: GPL-2.0 License

License

This project is licensed under the terms of the GNU General Public License, version 2.0. See the GPL-2.0 License file for details.

The third-party libraries Typer, Packaging and Requests are used in this project and have their own respective licenses. Please review their licenses in the licenses directory for more information.

Contributions

Contributions to pirg are welcome! If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.