2 unstable releases
0.2.0 | Oct 21, 2024 |
---|---|
0.1.0 | Oct 16, 2024 |
#470 in Development tools
18KB
231 lines
🦀 Github PR URL Generator
Welcome to the GitHub PR URL Generator! This command-line tool simplifies the creation of pull request for your GitHub repositories.
To create a PR quickly, run the command and click the generated link.
🚀 Examples of Usage
Here are some examples of how to use the ghpr
command:
- Generate a pull request URL with a specified repository, source branch, and destination branch:
ghpr --repo owner/repo --src my-feature-branch --dest main
- Generate a pull request URL with additional parameters like title and body:
ghpr --repo owner/repo --src main --dest feature-branch --title "Fix bug" --body "This PR fixes the bug."
- Generate a pull request URL using values from a
.ghprrc
file (destination is picked up from the file):
ghpr --src feature-branch --title "Add new feature"
.ghprrc file:
[defaults]
dest="master"
repo="ArunVenkata/ghpr"
Generated URL: https://github.com/ArunVenkata/ghpr/compare/feature-branch...master?quick_pull=1&title=Add%20new%20feature
📦 Installation Instructions
-
Ensure you have Rust installed on your machine.
-
Run the following command
cargo install ghpr
🖥️ Install from Source
- Clone the repository:
git clone https://github.com/ArunVenkata/ghpr.git
cd ghpr
-
Ensure you have Rust installed on your machine.
-
Build the project:
cargo build --release
- Run the tool:
./target/release/ghpr --help
⚙️ About the .ghprrc File
The .ghprrc file allows you to set default values for various parameters used in the ghpr command. This file should be located in your project directory and formatted as follows:
[defaults]
repo = "owner/repo"
src = "feature-branch"
dest = "main"
title = "Your PR Title"
body = "Description of the pull request."
labels = "bug,enhancement"
milestone = "1.0"
assignees = "username1,username2"
projects = "project1,project2"
template = "template_name"
Note: If
src
is not specified, it automatically refers to your current git branch (provided your current directory is a git repository)
Run ghpr --help
for more information on the supported parameters.
🤝 Contributing Guidelines
If you would like to contribute to the project, please follow these guidelines:
- Fork the repository and create your feature branch:
git checkout -b feature/new-feature
- Commit your changes:
git commit -m "Add some feature"
- Push to the branch:
git push origin feature/new-feature
- Open a pull request and describe your changes.
🎉 License
This project is licensed under the MIT License. See the LICENSE file for details.
Dependencies
~12–22MB
~377K SLoC