android-watcher 1.0.0__py3-none-any.whl

android_watcher-1.0.0.dist-info/METADATA

@@ -0,0 +1,310 @@
+Metadata-Version: 2.4
+Name: android-watcher
+Version: 1.0.0
+Summary: Self-hosted CLI that watches Google's official Android sites and delivers AI-triaged change digests.
+Project-URL: Homepage, https://github.com/krayong/android-watcher
+Project-URL: Repository, https://github.com/krayong/android-watcher
+Project-URL: Issues, https://github.com/krayong/android-watcher/issues
+Author-email: Karan Gourisaria <androidwatcher@krayong.com>
+License: MIT
+License-File: LICENSE
+Keywords: android,changelog,digest,monitoring,rss,sitemap
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Requires-Dist: defusedxml==0.7.1
+Requires-Dist: httpx==0.28.1
+Requires-Dist: platformdirs==4.10.0
+Requires-Dist: textual==8.2.7
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/logo.svg" alt="Android Watcher" width="160">
+</p>
+
+<h1 align="center">Android Watcher</h1>
+
+<p align="center">
+  Watch every official Google site for Android and Android developers, and get a
+  ranked, AI-triaged digest when something actually changes.
+</p>
+
+<p align="center">
+  <a href="https://github.com/krayong/android-watcher/actions/workflows/ci.yml"><img src="https://github.com/krayong/android-watcher/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/android-watcher/"><img src="https://img.shields.io/pypi/v/android-watcher.svg" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/python-3.11%2B-blue.svg" alt="Python 3.11+">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
+  <a href="https://github.com/pre-commit/pre-commit"><img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit" alt="pre-commit"></a>
+</p>
+
+<p align="center">
+  Self-hosted CLI. No cloud subscription. MIT.
+</p>
+
+---
+
+## What it does
+
+Google ships Android news across dozens of properties: platform and AOSP release
+notes, Android Studio and Gradle Plugin changelogs, the AndroidX feeds, the
+Developers Blog, Material Design, YouTube, and many sections of
+`developer.android.com`. Keeping up means babysitting a pile of RSS readers and
+bookmarks, and most of what changes is a typo fix or a template reflow.
+
+`android-watcher` checks a curated catalog of official sources on a schedule,
+detects real changes (not cosmetic churn), uses Claude to decide what is worth
+your attention and write a short description, ranks the result, and delivers a
+digest to email, Slack, or Telegram. When nothing substantive changed, it says so
+instead of padding a digest with noise.
+
+Install it once, run the interactive setup wizard, and receive a daily (or
+hourly, or weekly) digest.
+
+---
+
+## Install
+
+**Homebrew** (recommended):
+
+```sh
+brew tap krayong/android-watcher https://github.com/krayong/android-watcher
+brew install android-watcher
+```
+
+The tap points straight at this repo's `Formula/`, so `brew upgrade` tracks new
+releases. (A bare `brew install android-watcher` without the tap only works once a
+formula is accepted into homebrew-core.)
+
+**PyPI** (via uv or pipx):
+
+```sh
+uv tool install android-watcher     # via uv
+pipx install android-watcher        # via pipx
+```
+
+**From source:**
+
+```sh
+git clone https://github.com/krayong/android-watcher
+cd android-watcher
+uv tool install .
+```
+
+Requires **Python 3.11+**.
+
+**AI prerequisite:** The triage backend calls `claude -p` (the Claude CLI). No
+API key is required; the CLI handles authentication. Install and authenticate
+`claude` separately if you want AI triage. To skip it, set
+`[ai] mode = "off"` and android-watcher still delivers a digest (every detected
+change is marked substantive, with no description).
+
+---
+
+## Quickstart
+
+```sh
+android-watcher                        # open the Textual setup wizard
+android-watcher test                   # dry run: render the digest to stdout, send nothing
+android-watcher run                    # one detection-triage-notify pass
+android-watcher schedule install       # install the native launchd / systemd / cron entry
+android-watcher schedule status        # confirm the entry is loaded and active
+android-watcher schedule remove        # uninstall the scheduled job
+android-watcher doctor                 # health checks: prefixes, AI reachable, schedule active
+android-watcher catalog                # list and inspect the shipped source catalog
+android-watcher --help                 # full flag reference
+```
+
+Bare `android-watcher` opens the Textual setup wizard. It walks you through config
+and writes a native scheduled job. The first pipeline run baselines each source
+silently. It does not send a digest claiming every page is new.
+
+---
+
+## Configuration
+
+Config lives at `~/.config/android-watcher/config.toml` (honoring
+`$XDG_CONFIG_HOME`) and is written with `0600` permissions. State (snapshots,
+change history, delivery ledger) lives in a SQLite database under
+`~/.local/share/android-watcher/`. Override the config path with `--config PATH`.
+
+The setup wizard writes the file for you. To edit manually:
+
+```toml
+[schedule]
+interval = "daily"     # hourly | daily | weekly | cron
+at = "09:00"           # local time; ignored when interval = "cron"
+cron = ""              # raw cron expression; only used when interval = "cron"
+
+[ai]
+mode = "claude_cli"    # claude_cli | off
+model = "claude-sonnet-4-6"
+
+[digest]
+max_items = 10         # cap on change-groups shown in the message; the rest collapse into the full digest page
+empty = "send"         # send | skip  (what to do when nothing substantive changed)
+
+[sort]
+# Optional per-source or per-category priority overrides (higher = ranked first).
+# "android-developers-blog" = 90
+
+[channels.email]
+enabled = true
+smtp_host = "smtp.example.com"
+smtp_port = 465                                    # TLS required: implicit (465) or STARTTLS
+username = "you@example.com"
+password = "${ANDROID_WATCH_SMTP_PASSWORD}"        # env-var ref recommended; see Security
+from = "you@example.com"
+to = "you@example.com"
+
+[channels.slack]
+enabled = true
+bot_token = "${ANDROID_WATCH_SLACK_TOKEN}"        # env-var ref recommended (bot token is a secret)
+channel = "C0123456789"                           # channel ID (or #channel-name)
+
+[channels.telegram]
+enabled = false
+bot_token = "${ANDROID_WATCH_TELEGRAM_TOKEN}"     # env-var ref recommended (bot token is a secret)
+chat_id = "123456789"
+
+# Add your own URLs (same shape as catalog entries):
+# [[custom_source]]
+# id = "my-blog"
+# name = "My Blog"
+# category = "dev-blog"
+# detector = "feed"
+# url = "https://example.com"
+# feed_url = "https://example.com/feed.xml"
+# enabled = true
+```
+
+### Secrets
+
+The secrets android-watcher uses are the SMTP password, the Slack bot token, and
+the Telegram bot token. Use **environment-variable references** so those values
+are never written into the config file:
+
+```sh
+export ANDROID_WATCH_SMTP_PASSWORD="hunter2"
+export ANDROID_WATCH_SLACK_TOKEN="xoxb-..."
+export ANDROID_WATCH_TELEGRAM_TOKEN="1234567890:AAF..."
+```
+
+The config stores `${ANDROID_WATCH_SMTP_PASSWORD}` literally; the value is
+resolved at runtime. Inline plaintext works but is discouraged.
+
+---
+
+## The catalog
+
+A curated catalog of 41 official Android and Android-developer sources ships
+inside the package. `android-watcher catalog` lists it. The setup wizard lets you
+enable or disable catalog entries and add custom sources.
+
+To propose a new official source, edit `src/android_watcher/catalog/catalog.toml`
+and open a pull request (see [CONTRIBUTING.md](CONTRIBUTING.md)).
+
+---
+
+## Scheduling
+
+After the wizard completes, install the native scheduled job:
+
+```sh
+android-watcher schedule install
+```
+
+On macOS this writes a launchd plist to `~/Library/LaunchAgents/` and loads it
+via `launchctl`. On Linux with systemd it writes a user timer and enables it;
+run `loginctl enable-linger $USER` once so the timer fires after logout. On
+Linux without systemd it writes a marked crontab block.
+
+Confirm the job is active:
+
+```sh
+android-watcher schedule status
+```
+
+If the machine was asleep during a scheduled cycle, android-watcher detects the
+missed run on the next wake and catches up automatically.
+
+---
+
+## Security and privacy
+
+**Secrets.** The secrets are the SMTP password, the Slack bot token, and the
+Telegram bot token. The config file is written `0600`. Prefer environment-variable
+references (`password = "${ANDROID_WATCH_SMTP_PASSWORD}"`) so plaintext values
+are never written to disk.
+
+**Keep config out of git.** If you keep your config under version control, never
+commit a file with inline secrets. Add to `.gitignore`:
+
+```gitignore
+# android-watcher
+config.toml
+*.android-watcher.toml
+```
+
+The TUI and `--config` warn when the config path is inside a git work tree,
+because an accidental commit would expose your SMTP password, Slack bot token, or
+Telegram bot token.
+
+**AI data egress.** When `[ai] mode = "claude_cli"`, the **content of changed
+pages is sent to the `claude` CLI** for triage and description. For the shipped
+catalog this is public Google documentation. If you add **custom sources** (such
+as an internal wiki), that page content is also sent to `claude`. Set
+`[ai] mode = "off"` for the no-egress path: no triage, no descriptions, no
+page content leaves your machine.
+
+**SMTP transport.** SMTP enforces TLS (implicit on port 465 or mandatory
+STARTTLS) with certificate verification. It fails closed rather than downgrading
+to plaintext.
+
+**Slack and Telegram.** The Slack bot token and Telegram bot token are treated
+as bearer secrets and are never logged.
+
+---
+
+## Commands
+
+| Command                            | What it does                                           |
+|------------------------------------|--------------------------------------------------------|
+| `android-watcher`                  | Open the Textual setup wizard                          |
+| `android-watcher run [--force]`    | One detection-triage-notify pass                       |
+| `android-watcher test`             | Dry run: render digest to stdout, send nothing         |
+| `android-watcher doctor`           | Health checks: prefixes, AI reachable, schedule active |
+| `android-watcher catalog`          | List and inspect the shipped source catalog            |
+| `android-watcher schedule install` | Install the native scheduled job                       |
+| `android-watcher schedule status`  | Show whether the job is loaded and active              |
+| `android-watcher schedule remove`  | Uninstall the scheduled job                            |
+| `android-watcher --config PATH`    | Use a specific config file                             |
+| `android-watcher --version`        | Print version                                          |
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Short version: add a source by editing
+`catalog.toml`; add a detector, triager, or channel by implementing the
+protocol, registering the name, and adding a fixture-backed test. TDD, `ruff`,
+and `pytest` must pass.
+
+---
+
+## Contact
+
+For questions or support, open an issue on [GitHub](https://github.com/krayong/android-watcher/issues)
+or email **androidwatcher@krayong.com**. Security reports: see [SECURITY.md](SECURITY.md).
+
+---
+
+## License
+
+[MIT](LICENSE).

android_watcher-1.0.0.dist-info/RECORD

@@ -0,0 +1,44 @@
+android_watcher/__init__.py,sha256=7EbyCBwwpIxwKyVfqzPJSEbHmj4moQbEgJRy86tQTkg,343
+android_watcher/cli.py,sha256=AnpXdZ1ZaVo6HqBmHzfuRFhFH1aZujJFAc0m2GEWh_s,4851
+android_watcher/config.py,sha256=Zj95Zyt3sgsesgYf-B2v9o0qzAS14wJPFtF4Fon36Lw,7417
+android_watcher/doctor.py,sha256=MrxPlSXc7k9OT3KoUepvYF2kio2zA_a5U6wsEce7fj0,3976
+android_watcher/fetch.py,sha256=9LLAGWIKQZ-TdeLp1QnuQeGbvbAnZdMmhqtOPSYJsQ8,5076
+android_watcher/group.py,sha256=hO24nHlTxlaGrnD7OsRVYhZA3PsfxlvwFhVIj-pMEnc,2695
+android_watcher/lock.py,sha256=qgHLHhFMhHMlS6f1Vl1ZwtJEas6A1rOWgS1O72RTiXg,845
+android_watcher/models.py,sha256=CpYqXKHIkMsA1hqoApNtlUuuRnb9G7xmXZuUT1UQD9E,4881
+android_watcher/rank.py,sha256=PQiYmcDoXRg7hWcVZzdFUsUHRER1DXiB187ERC__OBg,2844
+android_watcher/registry.py,sha256=4bLpNy6Zr4BB8gtSigZulSh02aP8G8MzKlM5MkOa05c,1105
+android_watcher/run.py,sha256=Q5ZWoZBq97UNDxDvYcP3NV0nTACXUX6oe4SB8i7j7js,11149
+android_watcher/schedule.py,sha256=s0qtKYZDM7288gucNV0h1XgxVU_mUSYQEOHai-wdJNw,15782
+android_watcher/store.py,sha256=dERDSa_lRuJLveyYEfu4sZ36gNUrFXEeiyeUw382Eug,17232
+android_watcher/catalog/__init__.py,sha256=FNk48zIH-OByNJkFkX3ByOytrcCVPM7R2NkmpZtvxqw,911
+android_watcher/detect/__init__.py,sha256=2vIf9slnYHzhURSzjMRgYG9BnRm-W3T_oav4cB9b3YU,68
+android_watcher/detect/_normalize.py,sha256=C2WsXXiYCws6Qe9OSG6wI6WoKy0cDjwAF07K5CGN29Y,6034
+android_watcher/detect/android_sitemap.py,sha256=P75azyaVVFfFXFnsEBjCbykNQpcZdlM1LiuWeUu2tto,17941
+android_watcher/detect/base.py,sha256=VR045hE8XwE7HRTQMkrXswgjvNi3nrfFoetfT28u6f4,331
+android_watcher/detect/content.py,sha256=f_2MSINprpg4tPm4Po4w17aF4HNrRp-gKTVMu-YchUQ,2540
+android_watcher/detect/feed.py,sha256=BDwh11nlpjxWmFoT2zWlDQo8lfHPHQJpzfwOsxn6PHo,3816
+android_watcher/detect/sitemap.py,sha256=Ip0hrLfCf-Nmw1G0AV6Jg2xNOfmT_FFsGVZYKP_ttCg,6260
+android_watcher/notify/__init__.py,sha256=u2CarGIQ-cnO-eb3EnArGWOO938a4Z0f_aAOHd6abn4,51
+android_watcher/notify/base.py,sha256=uQkNQ2YxJBosFDkBWaaJGJvkuWbhhHtLdC5j0-pHqpE,575
+android_watcher/notify/email.py,sha256=faDVRShLrFLpUrYekRjMhR93m041tVu2c-FCZ0xrqDU,1598
+android_watcher/notify/html.py,sha256=Y9q_FcYWrOuSCvnMTFhKilzsH0v0wK7vwskFsKjOxCQ,6275
+android_watcher/notify/render.py,sha256=FmxaFPMiSdhv7lgigtS1RqLTjlCVAhuS1Cyek1YSxDE,7585
+android_watcher/notify/slack.py,sha256=KPDmyNz_8RN5vIJ-q4FQqd0buu3G1lbWbzUNd_Gt1rs,4579
+android_watcher/notify/telegram.py,sha256=wFnA5-_J3Vj-6ZYiMJW588CXB3ea_iIJgkit6Q9n2WM,1477
+android_watcher/seed/__init__.py,sha256=huw7-hRmTpaABjQ47v5y0AaiC-s5rMRnojSbzT3IolQ,1478
+android_watcher/seed/seed.sql.gz,sha256=Xb8Xfq6StzFfiyQp2JmsB6BDXaxNR1Tyw0iZdZqXbxE,1359156
+android_watcher/triage/__init__.py,sha256=2gW7caI9axsnc1HL52bojYY3ns2T-Bb0svUL2gn5bbI,45
+android_watcher/triage/base.py,sha256=JqoopBh-M3uMvJ41TGRu9fpOEGNEh5XpVk_-sgEDm7c,613
+android_watcher/triage/claude_cli.py,sha256=aRUkUrDM6O5CMJIHE6QnReqz4AzlnRnr5vB9-LixlhE,6920
+android_watcher/triage/noop.py,sha256=57RliCDLxg_TxnN3inbpOeCl-4_3apffgpfOmSNBmLs,920
+android_watcher/tui/__init__.py,sha256=Ii18IyVP_b-8_kPr3DB5HxdF2D_FCiPdJm3o6S_7AWg,60
+android_watcher/tui/app.py,sha256=pCgnm2A1CDLxIhyKycCxomNU6ZapFVBCpQqlbZ1LTAg,5253
+android_watcher/tui/configio.py,sha256=gpK1nB8SIHEQJwJnzma4zaLuR_mG6XNFNpbF93heZwU,6915
+android_watcher/tui/screens.py,sha256=bjQQz2Q0JyJQbYIWAC0Svy1HShkypCaVRW3uz1fxim8,26741
+android_watcher/catalog/catalog.toml,sha256=y3BYlTWw6Y-bAg9pSz1FP2K2EB-9sqRDCWaIUpBVKYc,13653
+android_watcher-1.0.0.dist-info/METADATA,sha256=sx-SqGVsmV7JZem6UtP6rdp8Eub3yLl8GT2PtesN7pA,11723
+android_watcher-1.0.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+android_watcher-1.0.0.dist-info/entry_points.txt,sha256=7romTFQ-SEcKyhBa1C-59p775lRL_j-N5up5p43DcbE,61
+android_watcher-1.0.0.dist-info/licenses/LICENSE,sha256=zfqiug1DwqwO-97fRFMtZi6SKtEwPs0FqyKX6zVPBXg,1113
+android_watcher-1.0.0.dist-info/RECORD,,

android_watcher-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

android_watcher-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+android-watcher = android_watcher.cli:main

android_watcher-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Karan Gourisaria (https://github.com/krayong/)
+
+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.