autopr-cli 0.2.5

A CLI tool to automate PR creation and listing.

AutoPR

A CLI tool designed to streamline your GitHub workflow by automating Pull Request (PR) creation and issue management. Future versions will incorporate AI to assist in generating PR descriptions.

Features (Current)

• List open GitHub issues for the current repository.
• List all (open and closed) GitHub issues using the -a flag.
• Create a new PR with a specified title.
• Automatically detects the GitHub repository from your local .git configuration.

Installation & Setup

For Users (if published on PyPI):

You can install AutoPR using pip (once published):

pip install autopr_cli

For Developers (Local Setup):

1. Clone the repository:

   git clone <your-repository-url> # Replace <your-repository-url> with the actual URL
   cd autopr-cli # Or your repository's directory name
   

2. Create and activate a virtual environment (recommended):

   python3 -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
   

3. Install dependencies (including development tools):

   pip install -r requirements.txt
   

Usage

Make sure you are in the root directory of your Git repository.

• List open issues:

  python run_cli.py ls
  

• List all issues (open and closed):

  python run_cli.py ls -a
  

• Create a new PR:

  python run_cli.py create --title "Your Amazing PR Title"
  

Development

Running Tests

To run the automated tests, use Make:

make test

Formatting Code

To format the code using Black:

make format

Publishing a New Version (for Maintainers)

This project uses Makefile targets to streamline the release process. Ensure you have twine configured with your PyPI credentials (API tokens are recommended) and have installed development dependencies via pip install -r requirements.txt.

1. Update Version: Increment the __version__ string in autopr/__init__.py.

2. Build the Package:

   make build
   

   This cleans old builds and creates new source distribution and wheel files in the dist/ directory.

3. Test Publishing (Highly Recommended): Publish to TestPyPI to ensure everything works correctly before a real release.

   make publish-test
   

   You will be prompted for confirmation. Check the package on test.pypi.org.

4. Publish to PyPI (Real):

   make publish
   

   This will upload the package to the official PyPI. You will be prompted for confirmation.

5. Full Release (Publish to PyPI & Tag): For a complete release including Git tagging:

   make release
   

   This performs make publish and then creates a Git tag for the new version (e.g., v0.2.5). After running this, you must push the tag to the remote repository:

   git push origin vX.Y.Z  # Replace X.Y.Z with the version number
   # OR push all tags if you have multiple new tags
   git push --tags