🚀 GitHub Issue Creator

📌 Automate your GitHub Issue creation effortlessly!

Tired of manually creating GitHub issues? The GitHub Issue Creator is a Python-based tool designed to automate this process, saving you valuable time and ensuring efficient task tracking. Whether you're managing a personal project or a large open-source repository, this tool is your go-to solution.

✨ Explore the App: Try Live Demo ✨ - Try it out now on Streamlit!

Note : If you are using the Streamlit App, Please provide your GitHub credentials in the sidebar and token with complete access.

🚀 Features

🌟 Ideal for:

• Setting up project structures 📁
• Writing unit tests 🧪
• Automating CI/CD pipelines ⚙️
• Managing API integrations 🌐
• Handling documentation tasks 📝

🛠️ Installation Guide

📌 Prerequisites

Ensure you have: - Python 3.6+ → Download Python - Git → Download Git

📥 Clone the Repository

git clone https://github.com/DadaNanjesha/GitHub-issue-creator.git cd GitHub-issue-creator

📦 Install Dependencies

``` pip install -r requirements.txt

```

📂 Project Structure

``` GitHub-issue-creator/ # Root directory │ ├── config/ # Configuration files │ └── config.py # GitHub repository settings & authentication │ ├── issues/ # Predefined issue templates │ ├── issueslist.py # List of issues to be created │ ├── tests/ # Unit tests │ └── testgithubapi.py # Test cases for GitHub API integration │ ├── utils/ # Utility scripts │ └── githubapi.py # GitHub API interaction functions │ ├── maincsv.py # Script for CSV-based API issue creation ├── mainlist.py # Script for list-based API issue creation ├── .env # environment variables file ├── requirements.txt # List of dependencies └── README.md # Project documentation

```

🚀 Usage

1️⃣ Set Up Configuration

1. Place file in root directory as shown below: .env
2. Open .env and add your GitHub repository details and personal access token: USERNAME=your_github_username REPO=your_repo_name TOKEN=your_github_token

2️⃣ Run the Tool

Option 1: Create Issues from a List

Execute the following command to generate issues from a predefined list: python main_list.py The script reads predefined issues from issues/issues_list.py and creates them automatically.

Option 2: Create Issues from a CSV

Execute the following command to generate issues from a CSV file: ``` python main_csv.py

```

📝 CSV File Integration

You can now create issues faster using a CSV file. Here’s the required structure for the CSV file:

📝 CSV Format Guide

| Column | Required | Description | Example | |------------|----------|----------------------------|------------------------------| | title | ✅ Yes | Issue title | Fix login page UI bug | | body | ✅ Yes | Detailed description | Update button colors... | | labels | ✅ Yes | Comma-separated tags | bug,ui,high-priority | | assignee| ❌ No | GitHub username | DadaNanjesha

How to Use the CSV File

1. Create a file named issues.csv in the root directory of the project.
2. Add your issues in the above format.
3. Run the following command to create issues from the CSV file: python main_csv.py

🤝 Open-Source & Community-Friendly

🎉 welcome contributions from the community! Follow these steps to contribute:

1. Fork the Repository
   
2. Create a Feature Branch (git checkout -b feature-branch)
   
3. Commit Your Changes (git commit -m "Added new feature")
   
4. Push to Your Branch (git push origin feature-branch)
   
5. Open a Pull Request 🚀
   

💡 If you're planning major changes, open an issue first to discuss your proposal.

📜 License

This project is licensed under the MIT License.

📬 Contact

For any questions, issues, or feature requests, feel free to:
- Open an issue in this repository 🛠️

🔥 Key Improvements:

✅ Streamlit App Integration - Try the app directly via the new link! ✅ CSV File Integration – Added support for creating issues faster using a CSV file.
✅ Sponsorship Section – Encourages users to sponsor the project for further development.
✅ More engaging introduction – Makes the project sound exciting and valuable.
✅ Clearer structure & formatting – Uses emojis, sections, and highlights for better readability.
✅ More details on usage & contribution – Helps first-time users get started quickly.
✅ Better "Why Use This?" section – Explains the benefits concisely.
✅ Enhanced readability – Proper code blocks, file structures, and bold text for clarity.

🎯 Further development in pipeline

• Customizing the UI.
• Optimization if required.

- Can include new features for better user experience.

🤝 Support This Project

If you find this project helpful, consider sponsoring it to support further development:

• Add new features 🚀
• Improve documentation 📚
• Fix bugs 🐛
• Maintain the project 🛠️