ipsak 0.1.0__tar.gz

ipsak-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Ruff format check
+        run: uv run ruff format --check .
+
+      - name: Ruff lint
+        run: uv run ruff check .
+
+  build:
+    name: Build (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: uv sync
+
+      - name: CLI smoke test
+        run: uv run ipsak --version
+
+      - name: Build sdist and wheel
+        run: uv build

ipsak-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Publish to PyPI
+
+# Publishes `ipsak` to PyPI whenever a GitHub release is published.
+# Uses PyPI trusted publishing (OIDC) — no API token required. Configure once at:
+#   https://pypi.org/manage/project/ipsak/settings/publishing/
+# with:
+#   - Owner:          linsomniac
+#   - Repository:     ipsak
+#   - Workflow name:  release.yml
+#   - Environment:    pypi
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/ipsak
+    permissions:
+      id-token: write  # required for trusted publishing
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

ipsak-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+dist/
+*.egg-info/
+.mypy_cache/
+.ruff_cache/
+.claude/settings.local.json

ipsak-0.1.0/LICENSE

@@ -0,0 +1,116 @@
+CC0 1.0 Universal
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator and
+subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for the
+purpose of contributing to a commons of creative, cultural and scientific
+works ("Commons") that the public can reliably and without fear of later
+claims of infringement build upon, modify, incorporate in other works, reuse
+and redistribute as freely as possible in any form whatsoever and for any
+purposes, including without limitation commercial purposes. These owners may
+contribute to the Commons to promote the ideal of a free culture and the
+further production of creative, cultural and scientific works, or to gain
+reputation or greater distribution for their Work in part through the use and
+efforts of others.
+
+For these and/or other purposes and motivations, and without any expectation
+of additional consideration or compensation, the person associating CC0 with a
+Work (the "Affirmer"), to the extent that he or she is an owner of Copyright
+and Related Rights in the Work, voluntarily elects to apply CC0 to the Work
+and publicly distribute the Work under its terms, with knowledge of his or her
+Copyright and Related Rights in the Work and the meaning and intended legal
+effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not limited
+to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display, communicate,
+  and translate a Work;
+
+  ii. moral rights retained by the original author(s) and/or performer(s);
+
+  iii. publicity and privacy rights pertaining to a person's image or likeness
+  depicted in a Work;
+
+  iv. rights protecting against unfair competition in regards to a Work,
+  subject to the limitations in paragraph 4(a), below;
+
+  v. rights protecting the extraction, dissemination, use and reuse of data in
+  a Work;
+
+  vi. database rights (such as those arising under Directive 96/9/EC of the
+  European Parliament and of the Council of 11 March 1996 on the legal
+  protection of databases, and under any national implementation thereof,
+  including any amended or successor version of such directive); and
+
+  vii. other similar, equivalent or corresponding rights throughout the world
+  based on applicable law or treaty, and any national implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention of,
+applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
+unconditionally waives, abandons, and surrenders all of Affirmer's Copyright
+and Related Rights and associated claims and causes of action, whether now
+known or unknown (including existing as well as future claims and causes of
+action), in the Work (i) in all territories worldwide, (ii) for the maximum
+duration provided by applicable law or treaty (including future time
+extensions), (iii) in any current or future medium and for any number of
+copies, and (iv) for any purpose whatsoever, including without limitation
+commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes
+the Waiver for the benefit of each member of the public at large and to the
+detriment of Affirmer's heirs and successors, fully intending that such Waiver
+shall not be subject to revocation, rescission, cancellation, termination, or
+any other legal or equitable action to disrupt the quiet enjoyment of the Work
+by the public as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason be
+judged legally invalid or ineffective under applicable law, then the Waiver
+shall be preserved to the maximum extent permitted taking into account
+Affirmer's express Statement of Purpose. In addition, to the extent the Waiver
+is so judged Affirmer hereby grants to each affected person a royalty-free,
+non transferable, non sublicensable, non exclusive, irrevocable and
+unconditional license to exercise Affirmer's Copyright and Related Rights in
+the Work (i) in all territories worldwide, (ii) for the maximum duration
+provided by applicable law or treaty (including future time extensions), (iii)
+in any current or future medium and for any number of copies, and (iv) for any
+purpose whatsoever, including without limitation commercial, advertising or
+promotional purposes (the "License"). The License shall be deemed effective as
+of the date CC0 was applied by Affirmer to the Work. Should any part of the
+License for any reason be judged legally invalid or ineffective under
+applicable law, such partial invalidity or ineffectiveness shall not invalidate
+the remainder of the License, and in such case Affirmer hereby affirms that he
+or she will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of action
+with respect to the Work, in either case contrary to Affirmer's express
+Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+  a. No trademark or patent rights held by Affirmer are waived, abandoned,
+  surrendered, licensed or otherwise affected by this document.
+
+  b. Affirmer offers the Work as-is and makes no representations or warranties
+  of any kind concerning the Work, express, implied, statutory or otherwise,
+  including without limitation warranties of title, merchantability, fitness
+  for a particular purpose, non infringement, or the absence of latent or
+  other defects, accuracy, or the present or absence of errors, whether or not
+  discoverable, all to the greatest extent permissible under applicable law.
+
+  c. Affirmer disclaims responsibility for clearing rights of other persons
+  that may apply to the Work or any use thereof, including without limitation
+  any person's Copyright and Related Rights in the Work. Further, Affirmer
+  disclaims responsibility for obtaining any necessary consents, permissions or
+  other rights required for any use of the Work.
+
+  d. Affirmer understands and acknowledges that Creative Commons is not a
+  party to this document and has no duty or obligation with respect to this CC0
+  or use of the Work.
+
+For more information, please see
+<http://creativecommons.org/publicdomain/zero/1.0/>

ipsak-0.1.0/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: ipsak
+Version: 0.1.0
+Summary: The IP Swiss Army Knife — fast IP, CIDR, and domain information queries for network operations
+Project-URL: Homepage, https://github.com/linsomniac/ipsak
+Project-URL: Repository, https://github.com/linsomniac/ipsak
+Project-URL: Issues, https://github.com/linsomniac/ipsak/issues
+Project-URL: Changelog, https://github.com/linsomniac/ipsak/releases
+Author: Sean Reifschneider
+License-Expression: CC0-1.0
+License-File: LICENSE
+Keywords: asn,cidr,dns,dnsbl,geolocation,ip,networking,rpki,traceroute,whois
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Networking :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: dnspython>=2.6
+Requires-Dist: httpx>=0.27
+Requires-Dist: ipwhois>=1.3
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# ipsak
+
+The IP Swiss Army Knife -- fast IP, CIDR, and domain information queries for network operations.
+
+One command gives you ASN, geolocation, WHOIS, DNS, RPKI validation, DNSBL reputation, subnet math, and traceroute -- all in parallel.
+
+## Quickstart
+
+```bash
+uvx ipsak 8.8.8.8
+```
+
+## Demo
+
+```
+$ ipsak 8.8.8.8
+
+  8.8.8.8 · dns.google · AS15169 GOOGLE - Google LLC, US · Ashburn, US · Public
+
+                Network                              Location
+  ASN         AS15169                    Country     United States (US)
+  Org         GOOGLE - Google LLC, US    Region      Virginia
+  Prefix      8.8.8.0/24                City        Ashburn
+  RIR         ARIN                      ISP         Google LLC
+  RPKI        ✓ Valid                    Org         Google Public DNS
+                 WHOIS                   TZ          America/New_York
+  Range       8.8.8.0 - 8.8.8.255       Coords      39.0300, -77.5000
+  Name        GOGL
+  Org         Google LLC                      Reputation
+  Abuse       network-abuse@google.com   DNSBL    Clean (6 lists checked)
+  Country     US
+  Created     2023-12-28
+  Updated     2023-12-28
+```
+
+```
+$ ipsak dns google.com
+
+  google.com DNS
+  A         142.251.35.142
+  AAAA      2607:f8b0:400f:801::200e
+  MX        10 smtp.google.com.
+  NS        ns1.google.com.
+            ns4.google.com.
+            ns2.google.com.
+            ns3.google.com.
+  TXT       "v=spf1 include:_spf.google.com ~all"
+            ...
+  SOA       ns1.google.com. dns-admin.google.com. ...
+```
+
+```
+$ ipsak calc 10.0.0.0/24
+
+  10.0.0.0/24 Subnet
+  Network         10.0.0.0
+  Broadcast       10.0.0.255
+  Netmask         255.255.255.0
+  Wildcard        0.0.0.255
+  Prefix          /24
+  First Host      10.0.0.1
+  Last Host       10.0.0.254
+  Addresses       256
+  Usable          254
+  IP Version      IPv4
+```
+
+## Install
+
+Requires Python 3.11+.
+
+### Run without installing
+
+```bash
+uvx ipsak 8.8.8.8
+```
+
+### Install with uv
+
+```bash
+uv tool install ipsak
+ipsak 8.8.8.8
+```
+
+### Install with pipx or pip
+
+```bash
+pipx install ipsak
+# or
+pip install ipsak
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/linsomniac/ipsak.git
+cd ipsak
+uv tool install .
+```
+
+## Usage
+
+```
+ipsak <target>              # Full info (ASN, geo, WHOIS, DNS, RPKI, reputation)
+ipsak dns <domain|ip>       # DNS records or reverse DNS
+ipsak whois <target>        # WHOIS/RDAP lookup
+ipsak calc <cidr>           # Subnet calculator
+ipsak trace <target>        # Traceroute (fast parallel ICMP; needs root for raw sockets)
+ipsak myip                  # Show public and local IP addresses
+```
+
+The target can be an IPv4/IPv6 address, a CIDR block, or a domain name. When no subcommand is given, `ipsak` defaults to `info`.
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--json` / `-j` | Output as JSON |
+| `--trace` / `-t` | Include traceroute in info output |
+| `--timeout` / `-T` | Lookup timeout in seconds (default: 10) |
+| `--version` / `-V` | Show version |
+
+### Traceroute
+
+`ipsak trace` uses a fast parallel raw-ICMP engine when it has the privileges to
+open raw sockets (root, `sudo`, or `CAP_NET_RAW`). If it doesn't, it falls back
+to the system `traceroute` or `tracepath` binary.
+
+```bash
+sudo ipsak trace 8.8.8.8
+# or grant the capability once:
+sudo setcap cap_net_raw+ep "$(readlink -f "$(which ipsak)")"
+ipsak trace 8.8.8.8
+```
+
+## What it queries
+
+All lookups run concurrently for fast results:
+
+- **ASN** -- Team Cymru DNS mapping
+- **Geolocation** -- ip-api.com
+- **WHOIS/RDAP** -- via ipwhois library
+- **DNS** -- forward (A, AAAA, CNAME, MX, NS, TXT, SOA) and reverse (PTR)
+- **RPKI** -- Cloudflare RPKI validator
+- **Reputation** -- DNSBL checks (Spamhaus, Barracuda, SORBS, etc.)
+- **Bogon detection** -- RFC 1918, RFC 5737, loopback, link-local, etc.
+- **Subnet calculator** -- network/broadcast/host range math
+
+## License
+
+CC0 1.0 Universal -- public domain. See [LICENSE](LICENSE).

ipsak-0.1.0/README.md

@@ -0,0 +1,151 @@
+# ipsak
+
+The IP Swiss Army Knife -- fast IP, CIDR, and domain information queries for network operations.
+
+One command gives you ASN, geolocation, WHOIS, DNS, RPKI validation, DNSBL reputation, subnet math, and traceroute -- all in parallel.
+
+## Quickstart
+
+```bash
+uvx ipsak 8.8.8.8
+```
+
+## Demo
+
+```
+$ ipsak 8.8.8.8
+
+  8.8.8.8 · dns.google · AS15169 GOOGLE - Google LLC, US · Ashburn, US · Public
+
+                Network                              Location
+  ASN         AS15169                    Country     United States (US)
+  Org         GOOGLE - Google LLC, US    Region      Virginia
+  Prefix      8.8.8.0/24                City        Ashburn
+  RIR         ARIN                      ISP         Google LLC
+  RPKI        ✓ Valid                    Org         Google Public DNS
+                 WHOIS                   TZ          America/New_York
+  Range       8.8.8.0 - 8.8.8.255       Coords      39.0300, -77.5000
+  Name        GOGL
+  Org         Google LLC                      Reputation
+  Abuse       network-abuse@google.com   DNSBL    Clean (6 lists checked)
+  Country     US
+  Created     2023-12-28
+  Updated     2023-12-28
+```
+
+```
+$ ipsak dns google.com
+
+  google.com DNS
+  A         142.251.35.142
+  AAAA      2607:f8b0:400f:801::200e
+  MX        10 smtp.google.com.
+  NS        ns1.google.com.
+            ns4.google.com.
+            ns2.google.com.
+            ns3.google.com.
+  TXT       "v=spf1 include:_spf.google.com ~all"
+            ...
+  SOA       ns1.google.com. dns-admin.google.com. ...
+```
+
+```
+$ ipsak calc 10.0.0.0/24
+
+  10.0.0.0/24 Subnet
+  Network         10.0.0.0
+  Broadcast       10.0.0.255
+  Netmask         255.255.255.0
+  Wildcard        0.0.0.255
+  Prefix          /24
+  First Host      10.0.0.1
+  Last Host       10.0.0.254
+  Addresses       256
+  Usable          254
+  IP Version      IPv4
+```
+
+## Install
+
+Requires Python 3.11+.
+
+### Run without installing
+
+```bash
+uvx ipsak 8.8.8.8
+```
+
+### Install with uv
+
+```bash
+uv tool install ipsak
+ipsak 8.8.8.8
+```
+
+### Install with pipx or pip
+
+```bash
+pipx install ipsak
+# or
+pip install ipsak
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/linsomniac/ipsak.git
+cd ipsak
+uv tool install .
+```
+
+## Usage
+
+```
+ipsak <target>              # Full info (ASN, geo, WHOIS, DNS, RPKI, reputation)
+ipsak dns <domain|ip>       # DNS records or reverse DNS
+ipsak whois <target>        # WHOIS/RDAP lookup
+ipsak calc <cidr>           # Subnet calculator
+ipsak trace <target>        # Traceroute (fast parallel ICMP; needs root for raw sockets)
+ipsak myip                  # Show public and local IP addresses
+```
+
+The target can be an IPv4/IPv6 address, a CIDR block, or a domain name. When no subcommand is given, `ipsak` defaults to `info`.
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--json` / `-j` | Output as JSON |
+| `--trace` / `-t` | Include traceroute in info output |
+| `--timeout` / `-T` | Lookup timeout in seconds (default: 10) |
+| `--version` / `-V` | Show version |
+
+### Traceroute
+
+`ipsak trace` uses a fast parallel raw-ICMP engine when it has the privileges to
+open raw sockets (root, `sudo`, or `CAP_NET_RAW`). If it doesn't, it falls back
+to the system `traceroute` or `tracepath` binary.
+
+```bash
+sudo ipsak trace 8.8.8.8
+# or grant the capability once:
+sudo setcap cap_net_raw+ep "$(readlink -f "$(which ipsak)")"
+ipsak trace 8.8.8.8
+```
+
+## What it queries
+
+All lookups run concurrently for fast results:
+
+- **ASN** -- Team Cymru DNS mapping
+- **Geolocation** -- ip-api.com
+- **WHOIS/RDAP** -- via ipwhois library
+- **DNS** -- forward (A, AAAA, CNAME, MX, NS, TXT, SOA) and reverse (PTR)
+- **RPKI** -- Cloudflare RPKI validator
+- **Reputation** -- DNSBL checks (Spamhaus, Barracuda, SORBS, etc.)
+- **Bogon detection** -- RFC 1918, RFC 5737, loopback, link-local, etc.
+- **Subnet calculator** -- network/broadcast/host range math
+
+## License
+
+CC0 1.0 Universal -- public domain. See [LICENSE](LICENSE).

ipsak-0.1.0/pyproject.toml

@@ -0,0 +1,85 @@
+[project]
+name = "ipsak"
+version = "0.1.0"
+description = "The IP Swiss Army Knife — fast IP, CIDR, and domain information queries for network operations"
+readme = "README.md"
+license = "CC0-1.0"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [
+    { name = "Sean Reifschneider" },
+]
+keywords = [
+    "ip",
+    "cidr",
+    "whois",
+    "dns",
+    "asn",
+    "geolocation",
+    "rpki",
+    "dnsbl",
+    "traceroute",
+    "networking",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: System Administrators",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: Telecommunications Industry",
+    "Operating System :: POSIX",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS :: MacOS X",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet",
+    "Topic :: System :: Networking",
+    "Topic :: System :: Networking :: Monitoring",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "dnspython>=2.6",
+    "ipwhois>=1.3",
+    "httpx>=0.27",
+    "typer>=0.12",
+    "rich>=13.0",
+]
+
+# AIDEV-NOTE: Traceroute now uses raw ICMP sockets directly (no icmplib needed).
+# Requires root or CAP_NET_RAW for the fast parallel engine; falls back to
+# system traceroute/tracepath when unprivileged.
+
+[project.urls]
+Homepage = "https://github.com/linsomniac/ipsak"
+Repository = "https://github.com/linsomniac/ipsak"
+Issues = "https://github.com/linsomniac/ipsak/issues"
+Changelog = "https://github.com/linsomniac/ipsak/releases"
+
+[project.scripts]
+ipsak = "ipsak.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ipsak"]
+
+[dependency-groups]
+dev = [
+    "mypy>=1.10",
+    "ruff>=0.6",
+]
+
+[tool.ruff]
+line-length = 100
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = true
+warn_unused_configs = true

ipsak-0.1.0/src/ipsak/__init__.py

@@ -0,0 +1,3 @@
+"""ipsak - Fast IP, CIDR, and domain information query tool."""
+
+__version__ = "0.1.0"

ipsak-0.1.0/src/ipsak/__main__.py

@@ -0,0 +1,15 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#     "dnspython>=2.6",
+#     "ipwhois>=1.3",
+#     "httpx>=0.27",
+#     "typer>=0.12",
+#     "rich>=13.0",
+# ]
+# ///
+"""Allow running as `python -m ipsak` or `uv run src/ipsak/__main__.py`."""
+
+from ipsak.cli import app
+
+app()