Skip to content

Commit 6ddfc1a

Browse files
authored
Update README.md
1 parent a660c64 commit 6ddfc1a

1 file changed

Lines changed: 58 additions & 1 deletion

File tree

README.md

Lines changed: 58 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,58 @@
1-
# get-github-issues
1+
# Get GitHub Issues
2+
3+
A Python script to get a list of all open issues in a repository with specific labels, and fetch their corresponding bodies and comments in chronological order (oldest to newest).
4+
5+
## Prerequisites
6+
7+
- Python 3.x
8+
- GitHub Personal Access Token
9+
10+
## Installation
11+
12+
Clone the repository:
13+
```bash
14+
git clone https://github.com/BaseMax/get-github-issues.git
15+
cd get-github-issues
16+
```
17+
18+
Install the dependencies:
19+
```bash
20+
pip install -r requirements.txt
21+
```
22+
23+
## Usage
24+
25+
Set the GITHUB_TOKEN (GitHub Personal Access Token) variable inside `.env` file:
26+
27+
Or
28+
```bash
29+
export GITHUB_TOKEN=YOUR_TOKEN_HERE
30+
```
31+
32+
Run the script:
33+
```bash
34+
python get-github-issues.py <owner> <repository> <labels>
35+
```
36+
37+
Replace <owner> with the name of the repository owner, <repository> with the name of the repository, and <labels> with a comma-separated list of labels you want to filter by. For example:
38+
39+
```bash
40+
python get-github-issues.py BaseMax get-github-issues "bug, enhancement"
41+
```
42+
43+
This will fetch all open issues in the BaseMax/get-github-issues repository with the labels "bug" or "enhancement".
44+
45+
## License
46+
47+
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
48+
49+
## Acknowledgments
50+
51+
- GitHub REST API v3
52+
- python-dotenv
53+
54+
## Contributing
55+
56+
Contributions are welcome! Please open an issue or submit a pull request.
57+
58+
Copyright 2023, Max Base

0 commit comments

Comments
 (0)