routedel 1.0.3__tar.gz

routedel-1.0.3/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Test
+        run: pytest -q
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build and check distribution
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+          twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

routedel-1.0.3/.github/workflows/publish.yml

@@ -0,0 +1,74 @@
+name: Publish to PyPI
+
+# Trigger: publish a GitHub Release (tag must match the version in pyproject.toml, e.g. v1.0.0),
+# or run manually (workflow_dispatch) to publish to TestPyPI.
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install deps
+        run: |
+          python -m pip install --upgrade pip build twine
+          pip install -e ".[dev]"
+      - name: Test
+        run: pytest -q
+      - name: Verify tag matches package version
+        if: github.event_name == 'release'
+        run: |
+          VERSION=$(python -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          TAG="${GITHUB_REF_NAME#v}"
+          [ "$VERSION" = "$TAG" ] || { echo "Tag $GITHUB_REF_NAME != version $VERSION"; exit 1; }
+      - name: Build
+        run: |
+          python -m build
+          twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    if: github.event_name == 'release'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/routedel/
+    permissions:
+      id-token: write   # PyPI Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        # Fallback to an API token instead of Trusted Publishing:
+        # with:
+        #   password: ${{ secrets.PYPI_API_TOKEN }}
+
+  publish-testpypi:
+    if: github.event_name == 'workflow_dispatch'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/routedel/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

routedel-1.0.3/.github/workflows/release.yml

@@ -0,0 +1,25 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true

routedel-1.0.3/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+.pytest_cache/
+config.json
+
+# Ignore Sublime Text project files
+*.sublime-project
+*.sublime-workspace
+
+# Added entries (1 items)
+*.json

routedel-1.0.3/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 1.0.0
+- Packaged for PyPI (src layout, `routedel` console script).
+- ntfy and Growl (GNTP 1.0) notifications, multiple servers, parallel send.
+- `--add` / `--default` implemented; non-default routes deleted with correct dest/netmask.
+- `ip route` preferred, `route -n` fallback; no shell (`subprocess` list args).
+- Monitor notifies on route add/remove, start and stop.

routedel-1.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hadi Cahyadi
+
+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.

routedel-1.0.3/MANIFEST.in

@@ -0,0 +1 @@
+include README.md LICENSE CHANGELOG.md config.example.json

routedel-1.0.3/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: routedel
+Version: 1.0.3
+Summary: Delete, add, list and monitor IPv4 routes, with ntfy and Growl (GNTP) notifications to multiple servers.
+Project-URL: Homepage, https://github.com/cumulus13/routedel
+Project-URL: Issues, https://github.com/cumulus13/routedel/issues
+Author-email: Hadi Cahyadi <cumulus13@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,gntp,growl,monitor,network,ntfy,route,routing
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.9
+Requires-Dist: rchf
+Requires-Dist: rich>=13.0
+Requires-Dist: richcolorlog
+Provides-Extra: clipboard
+Requires-Dist: clipboard; extra == 'clipboard'
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# routedel
+
+Delete, add, list and monitor IPv4 routes on Linux, with notifications to **multiple ntfy and Growl (GNTP) servers**.
+
+## Install
+
+```bash
+pip install routedel
+pip install "routedel[clipboard]"   # optional: read route rows from the clipboard
+```
+
+## Usage
+
+```bash
+routedel -l                                    # list routes
+routedel -m 100                                # delete route(s) by metric
+routedel 0.0.0.0 192.168.1.1 0.0.0.0 UG 100 0 0 eth0   # delete a full `route -n` row
+routedel 0.0.0.0 192.168.1.1 100 eth0          # legacy: X GW METRIC DEV (default route)
+routedel c                                     # delete using a route row from the clipboard
+sudo routedel -a 10.0.0.0/8 -g 192.168.1.1 -i eth0 --met 50   # add route
+sudo routedel -a -d -g 192.168.1.1 -i eth0 --met 100          # add default route
+routedel --monitor --refresh 2                 # live monitor, notifies on changes
+```
+
+Route changes need root.
+
+## Notifications
+
+Any number of servers of each type. Via CLI (repeatable):
+
+```bash
+routedel -m 100 --ntfy https://ntfy.sh/my-routes --ntfy https://ntfy.example.com/alerts \
+                --growl 192.168.1.10 --growl 192.168.1.20:23053
+```
+
+Or via a JSON config (first found wins): `--config FILE`, `$ROUTEDEL_CONFIG`,
+`~/.config/routedel/config.json`, `~/.routedel.json`. CLI targets are added to the config targets.
+
+```json
+{
+  "ntfy":  [{"url": "https://ntfy.sh", "topic": "my-routes", "token": "tk_xxx"},
+            {"url": "https://ntfy.example.com", "topic": "alerts", "user": "u", "password": "p"}],
+  "growl": [{"host": "192.168.1.10", "port": 23053, "password": "secret"},
+            {"host": "192.168.1.20"}]
+}
+```
+
+Test with `routedel --test-notify`. Disable with `--no-notify`.
+Servers are contacted in parallel; one failing server does not affect the others.
+Dependencies for notifications: none (stdlib `urllib` + raw GNTP 1.0 over sockets).
+
+## License
+
+MIT
+
+## Development & release
+
+```bash
+pip install -e ".[dev]" && pytest
+python -m build && twine check dist/*
+```
+
+Release to PyPI (GitHub Actions, Trusted Publishing — no token needed):
+
+1. On pypi.org → *Publishing* → add a pending publisher: owner `cumulus13`, repo `routedel`,
+   workflow `publish.yml`, environment `pypi`. (Repeat on test.pypi.org with environment `testpypi` if wanted.)
+2. In the GitHub repo create environments `pypi` (and `testpypi`).
+3. Bump `version` in `pyproject.toml` and `src/routedel/__init__.py`, commit, then publish a
+   GitHub Release tagged `vX.Y.Z`. The workflow tests, checks tag == version, builds and uploads.
+
+Manual alternative: `twine upload dist/*` (API token).
+
+## 👤 Author
+        
+[Hadi Cahyadi](mailto:cumulus13@gmail.com)
+    
+
+[![Buy Me a Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/cumulus13)
+
+[![Donate via Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/cumulus13)
+ 
+[Support me on Patreon](https://www.patreon.com/cumulus13)