Skip to content

chirag127/AdguardFilters-Issue-Automation-Python-CLI

Repository files navigation

AdguardFilters-Issue-Automation-Python-CLI

License: CC BY-NC 4.0 Python Version Code style: black Imports: isort

High-performance Python CLI that automates issue creation, triage, and reporting for AdGuard filter lists, streamlining maintenance of large‑scale content‑blocking repositories.


✨ Features

  • 📧 Email Reporting: Automatically generate and send ad-blocking reports via email.
  • 🛡️ Brave Community Reporting: Automate the process of creating new topics on the Brave Community forum.
  • 💬 Automated Commenting: Post predefined comments on multiple tabs with a single command.
  • 🖱️ Auto-Clicker: Automate a sequence of clicks and key presses for repetitive tasks.
  • 🔧 Extension Management: Quickly remove multiple browser extensions.
  • 📸 Screenshot Utility: Capture screenshots of specific regions or the entire screen.

🚀 Installation & Usage

  1. Clone the repository:

    git clone https://github.com/chirag127/AdguardFilters-Issue-Automation-Python-CLI.git
    cd AdguardFilters-Issue-Automation-Python-CLI
  2. Install dependencies:

    pip install -r requirements.txt
  3. Run a task:

    python src/main.py <task>

    Replace <task> with one of the following:

    • report-email
    • report-brave
    • post-comments
    • auto-click
    • remove-extensions
    • screenshot

🌳 Architecture

.
├── .github
│   ├── ISSUE_TEMPLATE
│   │   └── bug_report.md
│   ├── workflows
│   │   └── ci.yml
│   └── PULL_REQUEST_TEMPLATE.md
├── assets
│   ├── AdGuard_Reporter_checkbox_gh_username.png
│   ├── AdGuard_Reporter_next_button.png
│   ├── adguard_next.png
│   ├── brave_create_topic_button.png
│   └── brave_new_topic_button.png
├── scripts
│   ├── a.txt
│   ├── command.txt
│   ├── d.txt
│   ├── param.txt
│   ├── r.txt
│   └── url.txt
├── src
│   ├── __init__.py
│   ├── auto_clicker.py
│   ├── automation_utils.py
│   ├── brave_reporter.py
│   ├── browser_utils.py
│   ├── comment_placer.py
│   ├── email_reporter.py
│   ├── extension_remover.py
│   ├── file_utils.py
│   ├── main.py
│   └── screenshot.py
├── .gitignore
├── AGENTS.md
├── CONTRIBUTING.md
├── LICENSE
├── PROPOSED_README.md
├── README.md
└── SECURITY.md


🤝 Contributing

Contributions are welcome! Please see our CONTRIBUTING.md for more details.


📜 License

This project is licensed under the CC BY-NC 4.0 license.


⭐ Star this repo

If you find this project useful, please consider giving it a star!

About

Python CLI tool for automating issue creation and management on the AdGuardTeam/AdguardFilters repository, aiding in filter list maintenance and bug reporting.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages