tcpsweep 0.1.0__tar.gz

tcpsweep-0.1.0/.gitignore

@@ -0,0 +1,55 @@
+# ── Scan output / reconnaissance data ────────────────────────────────
+# scan.py writes NAME.json / NAME.gnmap / NAME.state.json (and -oX/-oJ/-oC
+# reports) to the working directory. These contain sensitive recon data and
+# must never be committed.
+*.gnmap
+*.state.json
+*.json
+*.xml
+*.csv
+# Keep tracked project config despite the broad rules above.
+!.claude/settings.json
+
+# ── Python ───────────────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+.installed.cfg
+
+# ── Testing / coverage ───────────────────────────────────────────────
+.pytest_cache/
+.tox/
+.nox/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+.hypothesis/
+
+# ── Virtual environments ─────────────────────────────────────────────
+.venv/
+venv/
+env/
+ENV/
+
+# ── Editors / OS ─────────────────────────────────────────────────────
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# ── Claude Code local settings (per-user, not shared) ────────────────
+.claude/settings.local.json
+
+# ── Atomic-write temp files (scan.py and others write NAME.tmp.* then rename)
+*.tmp.*
+

tcpsweep-0.1.0/LICENSE

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

tcpsweep-0.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: tcpsweep
+Version: 0.1.0
+Summary: A netcat-style TCP connect sweep in a single, dependency-free Python file.
+Project-URL: Homepage, https://github.com/BearlyStable/scanner
+Project-URL: Repository, https://github.com/BearlyStable/scanner
+Project-URL: Issues, https://github.com/BearlyStable/scanner/issues
+Author-email: Philipp Herkert <philipp.herkert@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: netcat,network,portscan,recon,scanner,security,tcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Networking :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# tcpsweep
+
+A netcat-style TCP connect sweep in a single, dependency-free Python file.
+
+`tcpsweep` sends the same probe as `nc -z` (a full TCP connect) to every
+host/port in a target spec and reports which ports are open. It uses the
+standard library only, so it can be dropped onto any box with a Python 3
+interpreter and run directly (`./tcpsweep.py ...`) or as a module
+(`python3 -m tcpsweep ...`).
+
+Discovered open ports stream to **stdout** (one `IP PORT` line each) so the
+tool composes in a pipeline; progress and the summary go to **stderr**.
+Results are also written to `NAME.json` and `NAME.gnmap` plus a resumable
+`NAME.state.json` — all written atomically and owner-readable only (`0600`),
+since a scan result is sensitive reconnaissance data.
+
+> **Authorized use only.** Only scan hosts and networks you own or have
+> explicit permission to test.
+
+## Install
+
+```sh
+pipx install tcpsweep      # isolated, recommended for a CLI tool
+pip install tcpsweep       # or a plain pip install
+```
+
+Both provide a `tcpsweep` command on your `PATH`. The tool has no third-party
+dependencies, so you can also just copy `tcpsweep.py` onto a host and run it.
+
+## Requirements
+
+- Python 3.8+ (standard library only — no third-party packages)
+
+## Usage
+
+```sh
+tcpsweep 192.168.1.1 22 80 443
+tcpsweep 192.168.1.0/24 -p 22,80,443 -t 16
+tcpsweep 10.0.0.{1-10,254} -p 1-1024 -r -o office
+tcpsweep 192.168.1.1 -p 1-65535 -w 2 -P 0.2        # rate-limited, 0.2s gap
+tcpsweep 10.0.0.0/24 -p 22 -b                        # grab banners
+```
+
+Run `tcpsweep --help` for the full option list, including target selection
+(CIDR / dash ranges / brace notation / `-iL` target files / `--exclude`),
+threading, rate limiting, link-health auto-pause, and the various output
+formats (`-oJ` / `-oX` / `-oT` / `-oC` / `-oA`).
+
+## Output files
+
+By default the scanner writes working files named after the target (or the
+`-o NAME` base):
+
+| File               | Contents                                  |
+| ------------------ | ----------------------------------------- |
+| `NAME.json`        | Full structured results                   |
+| `NAME.gnmap`       | Greppable, nmap-style summary             |
+| `NAME.state.json`  | Resume state for an interrupted scan      |
+
+These files hold reconnaissance data and are excluded from version control via
+`.gitignore`.
+
+## Development
+
+Run the test suite with:
+
+```sh
+python3 -m pytest test_scan.py -q     # or: python3 -m unittest test_scan
+```

tcpsweep-0.1.0/README.md

@@ -0,0 +1,69 @@
+# tcpsweep
+
+A netcat-style TCP connect sweep in a single, dependency-free Python file.
+
+`tcpsweep` sends the same probe as `nc -z` (a full TCP connect) to every
+host/port in a target spec and reports which ports are open. It uses the
+standard library only, so it can be dropped onto any box with a Python 3
+interpreter and run directly (`./tcpsweep.py ...`) or as a module
+(`python3 -m tcpsweep ...`).
+
+Discovered open ports stream to **stdout** (one `IP PORT` line each) so the
+tool composes in a pipeline; progress and the summary go to **stderr**.
+Results are also written to `NAME.json` and `NAME.gnmap` plus a resumable
+`NAME.state.json` — all written atomically and owner-readable only (`0600`),
+since a scan result is sensitive reconnaissance data.
+
+> **Authorized use only.** Only scan hosts and networks you own or have
+> explicit permission to test.
+
+## Install
+
+```sh
+pipx install tcpsweep      # isolated, recommended for a CLI tool
+pip install tcpsweep       # or a plain pip install
+```
+
+Both provide a `tcpsweep` command on your `PATH`. The tool has no third-party
+dependencies, so you can also just copy `tcpsweep.py` onto a host and run it.
+
+## Requirements
+
+- Python 3.8+ (standard library only — no third-party packages)
+
+## Usage
+
+```sh
+tcpsweep 192.168.1.1 22 80 443
+tcpsweep 192.168.1.0/24 -p 22,80,443 -t 16
+tcpsweep 10.0.0.{1-10,254} -p 1-1024 -r -o office
+tcpsweep 192.168.1.1 -p 1-65535 -w 2 -P 0.2        # rate-limited, 0.2s gap
+tcpsweep 10.0.0.0/24 -p 22 -b                        # grab banners
+```
+
+Run `tcpsweep --help` for the full option list, including target selection
+(CIDR / dash ranges / brace notation / `-iL` target files / `--exclude`),
+threading, rate limiting, link-health auto-pause, and the various output
+formats (`-oJ` / `-oX` / `-oT` / `-oC` / `-oA`).
+
+## Output files
+
+By default the scanner writes working files named after the target (or the
+`-o NAME` base):
+
+| File               | Contents                                  |
+| ------------------ | ----------------------------------------- |
+| `NAME.json`        | Full structured results                   |
+| `NAME.gnmap`       | Greppable, nmap-style summary             |
+| `NAME.state.json`  | Resume state for an interrupted scan      |
+
+These files hold reconnaissance data and are excluded from version control via
+`.gitignore`.
+
+## Development
+
+Run the test suite with:
+
+```sh
+python3 -m pytest test_scan.py -q     # or: python3 -m unittest test_scan
+```

tcpsweep-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tcpsweep"
+description = "A netcat-style TCP connect sweep in a single, dependency-free Python file."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Philipp Herkert", email = "philipp.herkert@gmail.com" }]
+keywords = ["portscan", "network", "tcp", "scanner", "netcat", "security", "recon"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: System Administrators",
+    "Intended Audience :: Information Technology",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Networking :: Monitoring",
+    "Topic :: Security",
+]
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://github.com/BearlyStable/scanner"
+Repository = "https://github.com/BearlyStable/scanner"
+Issues = "https://github.com/BearlyStable/scanner/issues"
+
+[project.scripts]
+tcpsweep = "tcpsweep:main"
+
+[tool.hatch.version]
+path = "tcpsweep.py"
+
+[tool.hatch.build.targets.wheel]
+only-include = ["tcpsweep.py"]
+
+[tool.hatch.build.targets.sdist]
+include = ["tcpsweep.py", "test_scan.py", "README.md", "LICENSE"]