auto-unsub 1.0.0__tar.gz

auto_unsub-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nithish1201
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

auto_unsub-1.0.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: auto-unsub
+Version: 1.0.0
+Summary: Scan Gmail for unsubscribe options and bulk unsubscribe from senders.
+Author: Nithish1201
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Nithish1201-code/AutoUnsub
+Project-URL: Repository, https://github.com/Nithish1201-code/AutoUnsub
+Project-URL: Issues, https://github.com/Nithish1201-code/AutoUnsub/issues
+Keywords: gmail,unsubscribe,email,cli,productivity
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: keyring>=25.0
+Dynamic: license-file
+
+# AutoUnsub
+
+A python tool that scans your Gmail inbox for senders with unsubscribe options and lets you unsubscribe from them without opening a bunch of emails yourself.
+
+## Overview
+
+I made AutoUnsub because my inbox was getting kinda stupid with newsletters, random notifications, and stuff I signed up for once and completely forgot about.
+
+Unsubscribing isn't really hard, but doing it over and over again is annoying, so I wanted to automate that part.
+
+It uses Gmail IMAP to scan message headers and a small parser to figure out what unsubscribe option an email has. SQLite keeps track of the senders and messages so the same stuff doesn't keep getting counted.
+
+I also didn't want to put everything into one massive Python file, so `main.py` is the only thing you actually run and everything else is split into smaller files.
+
+<img width="1253" height="925" alt="image" src="https://github.com/user-attachments/assets/aa750961-83e9-48cc-bd40-a28c8f3c5c42" />
+
+## Features
+
+| Feature                                               |   |
+| ----------------------------------------------------- | - |
+| Scan Gmail from however many days back you want       |   |
+| Set a max number of messages to scan                  |   |
+| Detect one-click unsubscribe options                  |   |
+| Detect normal HTTP and HTTPS unsubscribe links        |   |
+| Detect `mailto:` unsubscribe links                    |   |
+| Store senders and message data in SQLite              |   |
+| Don't count the same message twice                    |   |
+| Show message counts for each sender                   |   |
+| Show unsubscribe methods                              |   |
+| Unsubscribe from one sender                           |   |
+| Unsubscribe from multiple senders                     |   |
+| Track successful and failed attempts                  |   |
+| Store the Gmail app password using the system keyring |   |
+| Colored terminal interface                            |   |
+
+<img width="1441" height="851" alt="image" src="https://github.com/user-attachments/assets/40babdb4-8bb8-497a-b073-03e4296dbc99" />
+
+## How It Works
+
+`Gmail -> IMAP -> parser -> SQLite -> terminal -> unsubscribe`
+
+The scanner only gets the headers it actually needs instead of downloading the whole email.
+
+Then it pulls out the sender, date, and unsubscribe info and sends that into the parser.
+
+The results get stored in SQLite so AutoUnsub remembers what it has already seen.
+
+When you unsubscribe, it uses whatever method was found in the email.
+
+One-click options use a POST request, normal links use an HTTP request, and `mailto:` options get turned into an email and sent through Gmail SMTP.
+
+## Project Structure
+
+| Path                     | Contents                                  |
+| ------------------------ | ----------------------------------------- |
+| `main.py`                | the thing you actually run                |
+| `sweeper/config.py`      | handles Gmail credentials                 |
+| `sweeper/db.py`          | DB                                        |
+| `sweeper/imap_scan.py`   | scans Gmail                               |
+| `sweeper/sweep.py`       | connects the scanner, parser and database |
+| `sweeper/unsub_parse.py` | figures out unsubscribe methods           |
+| `sweeper/unsubscribe.py` | actually sends the unsubscribe request    |
+| `tests/`                 | tests for everything                      |
+| `requirements.txt`       | Python dependencies                       |
+| `README.md`              | this file                                 |
+
+## Install
+
+### From PyPI
+
+Once released, the normal user install will be:
+
+```bash
+python -m pip install auto-unsub
+auto-unsub
+```
+
+This installs AutoUnsub as a real command-line application, so users do not need to clone the repository.
+
+### From source
+
+For development:
+
+```bash
+python -m pip install -e .
+auto-unsub
+```
+
+### Development setup
+
+It is recommended to use a virtual environment so the dependencies don't pollute your global Python installation:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+```
+
+On Windows:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\activate
+```
+
+Then install the project:
+
+```bash
+python -m pip install -e .
+```
+
+## Using AutoUnsub
+
+On the first run it asks for your Gmail address and app password.
+
+The app password gets stored using the system keyring so you don't have to enter it every time.
+
+You do have to create the app password yourself from your Google account first.
+
+<img width="636" height="349" alt="image" src="https://github.com/user-attachments/assets/ead0f025-be57-4020-8a56-6d1465b6fa4b" />
+
+After that you choose how many days back you want to scan and how many messages you want to check.
+
+Then it shows you what it found.
+
+<img width="569" height="298" alt="image" src="https://github.com/user-attachments/assets/51aeb6e0-1397-44e1-b909-264d8b6d9218" />
+
+## What I Learned
+
+Honestly this taught me way more than I expected.
+
+I learned how Gmail IMAP works, how email headers are structured, and how unsubscribe headers can have a bunch of different formats.
+
+I also got way more comfortable with SQLite and keeping state between runs.
+
+The networking part was kinda interesting too because fetching messages one by one was ridiculously slow, so I changed it to fetch them in batches (default 25, but I can change this).
+
+Real email data was also way messier than the fake tests I started with because some emails have no unsubscribe options at all and some have huge weird unsubscribe URLs.
+
+## Why I Built It
+
+Mostly because I wanted it for myself.
+
+<img width="1631" height="722" alt="image" src="https://github.com/user-attachments/assets/7caeb23b-b4fb-4604-ad5d-55b24db723ad" />
+
+My inbox has a bunch of random stuff that I don't really care about anymore, and manually cleaning it up is just boring and repetitive.
+
+## Current Status
+
+The main thing works now.
+
+AutoUnsub can connect to Gmail, scan real messages, figure out which ones have unsubscribe options, save everything to SQLite, and actually send unsubscribe requests.
+
+The interface is still pretty basic and there's still a lot I want to improve, mainly making the scanning less slow, handling weird unsubscribe services better, and making the whole thing feel like an actual finished app.

auto_unsub-1.0.0/README.md

@@ -0,0 +1,153 @@
+# AutoUnsub
+
+A python tool that scans your Gmail inbox for senders with unsubscribe options and lets you unsubscribe from them without opening a bunch of emails yourself.
+
+## Overview
+
+I made AutoUnsub because my inbox was getting kinda stupid with newsletters, random notifications, and stuff I signed up for once and completely forgot about.
+
+Unsubscribing isn't really hard, but doing it over and over again is annoying, so I wanted to automate that part.
+
+It uses Gmail IMAP to scan message headers and a small parser to figure out what unsubscribe option an email has. SQLite keeps track of the senders and messages so the same stuff doesn't keep getting counted.
+
+I also didn't want to put everything into one massive Python file, so `main.py` is the only thing you actually run and everything else is split into smaller files.
+
+<img width="1253" height="925" alt="image" src="https://github.com/user-attachments/assets/aa750961-83e9-48cc-bd40-a28c8f3c5c42" />
+
+## Features
+
+| Feature                                               |   |
+| ----------------------------------------------------- | - |
+| Scan Gmail from however many days back you want       |   |
+| Set a max number of messages to scan                  |   |
+| Detect one-click unsubscribe options                  |   |
+| Detect normal HTTP and HTTPS unsubscribe links        |   |
+| Detect `mailto:` unsubscribe links                    |   |
+| Store senders and message data in SQLite              |   |
+| Don't count the same message twice                    |   |
+| Show message counts for each sender                   |   |
+| Show unsubscribe methods                              |   |
+| Unsubscribe from one sender                           |   |
+| Unsubscribe from multiple senders                     |   |
+| Track successful and failed attempts                  |   |
+| Store the Gmail app password using the system keyring |   |
+| Colored terminal interface                            |   |
+
+<img width="1441" height="851" alt="image" src="https://github.com/user-attachments/assets/40babdb4-8bb8-497a-b073-03e4296dbc99" />
+
+## How It Works
+
+`Gmail -> IMAP -> parser -> SQLite -> terminal -> unsubscribe`
+
+The scanner only gets the headers it actually needs instead of downloading the whole email.
+
+Then it pulls out the sender, date, and unsubscribe info and sends that into the parser.
+
+The results get stored in SQLite so AutoUnsub remembers what it has already seen.
+
+When you unsubscribe, it uses whatever method was found in the email.
+
+One-click options use a POST request, normal links use an HTTP request, and `mailto:` options get turned into an email and sent through Gmail SMTP.
+
+## Project Structure
+
+| Path                     | Contents                                  |
+| ------------------------ | ----------------------------------------- |
+| `main.py`                | the thing you actually run                |
+| `sweeper/config.py`      | handles Gmail credentials                 |
+| `sweeper/db.py`          | DB                                        |
+| `sweeper/imap_scan.py`   | scans Gmail                               |
+| `sweeper/sweep.py`       | connects the scanner, parser and database |
+| `sweeper/unsub_parse.py` | figures out unsubscribe methods           |
+| `sweeper/unsubscribe.py` | actually sends the unsubscribe request    |
+| `tests/`                 | tests for everything                      |
+| `requirements.txt`       | Python dependencies                       |
+| `README.md`              | this file                                 |
+
+## Install
+
+### From PyPI
+
+Once released, the normal user install will be:
+
+```bash
+python -m pip install auto-unsub
+auto-unsub
+```
+
+This installs AutoUnsub as a real command-line application, so users do not need to clone the repository.
+
+### From source
+
+For development:
+
+```bash
+python -m pip install -e .
+auto-unsub
+```
+
+### Development setup
+
+It is recommended to use a virtual environment so the dependencies don't pollute your global Python installation:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+```
+
+On Windows:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\activate
+```
+
+Then install the project:
+
+```bash
+python -m pip install -e .
+```
+
+## Using AutoUnsub
+
+On the first run it asks for your Gmail address and app password.
+
+The app password gets stored using the system keyring so you don't have to enter it every time.
+
+You do have to create the app password yourself from your Google account first.
+
+<img width="636" height="349" alt="image" src="https://github.com/user-attachments/assets/ead0f025-be57-4020-8a56-6d1465b6fa4b" />
+
+After that you choose how many days back you want to scan and how many messages you want to check.
+
+Then it shows you what it found.
+
+<img width="569" height="298" alt="image" src="https://github.com/user-attachments/assets/51aeb6e0-1397-44e1-b909-264d8b6d9218" />
+
+## What I Learned
+
+Honestly this taught me way more than I expected.
+
+I learned how Gmail IMAP works, how email headers are structured, and how unsubscribe headers can have a bunch of different formats.
+
+I also got way more comfortable with SQLite and keeping state between runs.
+
+The networking part was kinda interesting too because fetching messages one by one was ridiculously slow, so I changed it to fetch them in batches (default 25, but I can change this).
+
+Real email data was also way messier than the fake tests I started with because some emails have no unsubscribe options at all and some have huge weird unsubscribe URLs.
+
+## Why I Built It
+
+Mostly because I wanted it for myself.
+
+<img width="1631" height="722" alt="image" src="https://github.com/user-attachments/assets/7caeb23b-b4fb-4604-ad5d-55b24db723ad" />
+
+My inbox has a bunch of random stuff that I don't really care about anymore, and manually cleaning it up is just boring and repetitive.
+
+## Current Status
+
+The main thing works now.
+
+AutoUnsub can connect to Gmail, scan real messages, figure out which ones have unsubscribe options, save everything to SQLite, and actually send unsubscribe requests.
+
+The interface is still pretty basic and there's still a lot I want to improve, mainly making the scanning less slow, handling weird unsubscribe services better, and making the whole thing feel like an actual finished app.

auto_unsub-1.0.0/auto_unsub.egg-info/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: auto-unsub
+Version: 1.0.0
+Summary: Scan Gmail for unsubscribe options and bulk unsubscribe from senders.
+Author: Nithish1201
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Nithish1201-code/AutoUnsub
+Project-URL: Repository, https://github.com/Nithish1201-code/AutoUnsub
+Project-URL: Issues, https://github.com/Nithish1201-code/AutoUnsub/issues
+Keywords: gmail,unsubscribe,email,cli,productivity
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: keyring>=25.0
+Dynamic: license-file
+
+# AutoUnsub
+
+A python tool that scans your Gmail inbox for senders with unsubscribe options and lets you unsubscribe from them without opening a bunch of emails yourself.
+
+## Overview
+
+I made AutoUnsub because my inbox was getting kinda stupid with newsletters, random notifications, and stuff I signed up for once and completely forgot about.
+
+Unsubscribing isn't really hard, but doing it over and over again is annoying, so I wanted to automate that part.
+
+It uses Gmail IMAP to scan message headers and a small parser to figure out what unsubscribe option an email has. SQLite keeps track of the senders and messages so the same stuff doesn't keep getting counted.
+
+I also didn't want to put everything into one massive Python file, so `main.py` is the only thing you actually run and everything else is split into smaller files.
+
+<img width="1253" height="925" alt="image" src="https://github.com/user-attachments/assets/aa750961-83e9-48cc-bd40-a28c8f3c5c42" />
+
+## Features
+
+| Feature                                               |   |
+| ----------------------------------------------------- | - |
+| Scan Gmail from however many days back you want       |   |
+| Set a max number of messages to scan                  |   |
+| Detect one-click unsubscribe options                  |   |
+| Detect normal HTTP and HTTPS unsubscribe links        |   |
+| Detect `mailto:` unsubscribe links                    |   |
+| Store senders and message data in SQLite              |   |
+| Don't count the same message twice                    |   |
+| Show message counts for each sender                   |   |
+| Show unsubscribe methods                              |   |
+| Unsubscribe from one sender                           |   |
+| Unsubscribe from multiple senders                     |   |
+| Track successful and failed attempts                  |   |
+| Store the Gmail app password using the system keyring |   |
+| Colored terminal interface                            |   |
+
+<img width="1441" height="851" alt="image" src="https://github.com/user-attachments/assets/40babdb4-8bb8-497a-b073-03e4296dbc99" />
+
+## How It Works
+
+`Gmail -> IMAP -> parser -> SQLite -> terminal -> unsubscribe`
+
+The scanner only gets the headers it actually needs instead of downloading the whole email.
+
+Then it pulls out the sender, date, and unsubscribe info and sends that into the parser.
+
+The results get stored in SQLite so AutoUnsub remembers what it has already seen.
+
+When you unsubscribe, it uses whatever method was found in the email.
+
+One-click options use a POST request, normal links use an HTTP request, and `mailto:` options get turned into an email and sent through Gmail SMTP.
+
+## Project Structure
+
+| Path                     | Contents                                  |
+| ------------------------ | ----------------------------------------- |
+| `main.py`                | the thing you actually run                |
+| `sweeper/config.py`      | handles Gmail credentials                 |
+| `sweeper/db.py`          | DB                                        |
+| `sweeper/imap_scan.py`   | scans Gmail                               |
+| `sweeper/sweep.py`       | connects the scanner, parser and database |
+| `sweeper/unsub_parse.py` | figures out unsubscribe methods           |
+| `sweeper/unsubscribe.py` | actually sends the unsubscribe request    |
+| `tests/`                 | tests for everything                      |
+| `requirements.txt`       | Python dependencies                       |
+| `README.md`              | this file                                 |
+
+## Install
+
+### From PyPI
+
+Once released, the normal user install will be:
+
+```bash
+python -m pip install auto-unsub
+auto-unsub
+```
+
+This installs AutoUnsub as a real command-line application, so users do not need to clone the repository.
+
+### From source
+
+For development:
+
+```bash
+python -m pip install -e .
+auto-unsub
+```
+
+### Development setup
+
+It is recommended to use a virtual environment so the dependencies don't pollute your global Python installation:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+```
+
+On Windows:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\activate
+```
+
+Then install the project:
+
+```bash
+python -m pip install -e .
+```
+
+## Using AutoUnsub
+
+On the first run it asks for your Gmail address and app password.
+
+The app password gets stored using the system keyring so you don't have to enter it every time.
+
+You do have to create the app password yourself from your Google account first.
+
+<img width="636" height="349" alt="image" src="https://github.com/user-attachments/assets/ead0f025-be57-4020-8a56-6d1465b6fa4b" />
+
+After that you choose how many days back you want to scan and how many messages you want to check.
+
+Then it shows you what it found.
+
+<img width="569" height="298" alt="image" src="https://github.com/user-attachments/assets/51aeb6e0-1397-44e1-b909-264d8b6d9218" />
+
+## What I Learned
+
+Honestly this taught me way more than I expected.
+
+I learned how Gmail IMAP works, how email headers are structured, and how unsubscribe headers can have a bunch of different formats.
+
+I also got way more comfortable with SQLite and keeping state between runs.
+
+The networking part was kinda interesting too because fetching messages one by one was ridiculously slow, so I changed it to fetch them in batches (default 25, but I can change this).
+
+Real email data was also way messier than the fake tests I started with because some emails have no unsubscribe options at all and some have huge weird unsubscribe URLs.
+
+## Why I Built It
+
+Mostly because I wanted it for myself.
+
+<img width="1631" height="722" alt="image" src="https://github.com/user-attachments/assets/7caeb23b-b4fb-4604-ad5d-55b24db723ad" />
+
+My inbox has a bunch of random stuff that I don't really care about anymore, and manually cleaning it up is just boring and repetitive.
+
+## Current Status
+
+The main thing works now.
+
+AutoUnsub can connect to Gmail, scan real messages, figure out which ones have unsubscribe options, save everything to SQLite, and actually send unsubscribe requests.
+
+The interface is still pretty basic and there's still a lot I want to improve, mainly making the scanning less slow, handling weird unsubscribe services better, and making the whole thing feel like an actual finished app.

auto_unsub-1.0.0/auto_unsub.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+LICENSE
+README.md
+main.py
+pyproject.toml
+auto_unsub.egg-info/PKG-INFO
+auto_unsub.egg-info/SOURCES.txt
+auto_unsub.egg-info/dependency_links.txt
+auto_unsub.egg-info/entry_points.txt
+auto_unsub.egg-info/requires.txt
+auto_unsub.egg-info/top_level.txt
+sweeper/__init__.py
+sweeper/config.py
+sweeper/db.py
+sweeper/imap_scan.py
+sweeper/sweep.py
+sweeper/unsub_parse.py
+sweeper/unsubscribe.py
+tests/test_db.py
+tests/test_imap_scan.py
+tests/test_queries.py
+tests/test_unsub_parse.py
+tests/test_unsubscribe.py

auto_unsub-1.0.0/auto_unsub.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

auto_unsub-1.0.0/auto_unsub.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+auto-unsub = main:main

auto_unsub-1.0.0/auto_unsub.egg-info/requires.txt

@@ -0,0 +1,2 @@
+colorama>=0.4.6
+keyring>=25.0

auto_unsub-1.0.0/auto_unsub.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+main
+sweeper