Metadata-Version: 2.1
Name: git-orca-python
Version: 0.1.0
Summary: This a CLI tool to fetch issues and PRs from any repo
Home-page: https://github.com/lennyAiko/git-orca-python
License: MIT
Keywords: github,issues,git,tool,pr,CLI
Author: lennox charles
Author-email: lennyaiko17@gmail.com
Maintainer: lennox charles
Maintainer-email: lennyaiko17@gmail.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: Pygments (==2.16.1)
Requires-Dist: certifi (==2023.7.22)
Requires-Dist: charset-normalize (==3.2.0)
Requires-Dist: click (==8.1.7)
Requires-Dist: colorama (==0.4.6)
Requires-Dist: idna (==3.4)
Requires-Dist: markdown-it-py (==3.0.0)
Requires-Dist: mdurl (==0.1.2)
Requires-Dist: python-dotenv (==1.0.0)
Requires-Dist: requests (==2.31.0)
Requires-Dist: rich (==13.5.2)
Requires-Dist: shellingham (==1.5.3)
Requires-Dist: typer (==0.9.0)
Requires-Dist: typing_extensions (==4.7.1)
Requires-Dist: urllib3 (==2.0.4)
Project-URL: Bug Tracker, https://github.com/lennyAiko/git-orca-python/issues
Project-URL: Repository, https://github.com/lennyAiko/git-orca-python
Description-Content-Type: text/markdown

# git-orca (python)

This a CLI tool to fetch issues and PRs from any repo

## Packages

To use this tool, the below listed are required

- [Python](https://www.python.org/downloads/)
- Github access token. How to get one [here](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic)

## Installation/Setup

1. Clone this repository to your local machine

```bash
git clone https://github.com/lennyAiko/git-orca-python.git
```

2. Navigate to the repository directory

```bash
cd git-orca-python
```

3. Install the dependencies

```bash
pip install -r requirements.txt
```

<!-- change configuring .env file -->

4. Create a `.env` file

```bash
touch .env
```

5. Add your Github access token as a variable to the `.env` file.

```bash
> cat .env
GITHUB_ACCESS_TOKEN=<github_access_token>
```

> **NOTE**
replace `github_access_token` with your github personal access token

## Usage

For a quick start, after installation/setting up the repo just run the below command. This would start an interactive session for you to provide the necessary info about the repository.

1. Install the package

```bash
node index.js
```

Alternatively, you can provide the information about the repo on execution of the script with flags:

- --owner: Specifies the GitHub username of the repository owner.
- --name: Specifies the name of the repository.
- --issue: Indicates that you want to view issues.
- --pr: Indicates that you want to view PRs.
- --open: Indicates that you want to view open issues/PRs.
- --closed: Indicates that you want to view closed issues/PRs.
- --p: Specifies the page number you want to view (e.g., page 1).
- --pp: Specifies the number of items per page (e.g., 10 items per page)

### For issues

```bash
node index.js --owner <github username> --name <repository name> --issue --open --p <page number> --pp <number of items per page>
```

### For pull requests

```bash
node index.js --owner <github username> --name <repository name> --pr --closed --p <page number> --pp <number of items per page>
```

### Example

```bash
node index.js --owner lennyaiko --name git-orca --issue --closed --p 1 --pp 5
```

> **NOTE**
You don't have to specify all the flags
