nulltap 0.1.0__tar.gz

nulltap-0.1.0/LICENSE

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

nulltap-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: nulltap
+Version: 0.1.0
+Summary: Read the nulltap.sh cybersecurity feed from a terminal.
+Author: Justin Howe
+License-Expression: MIT
+Project-URL: Homepage, https://nulltap.sh
+Project-URL: Repository, https://github.com/JustinHowe/nulltap
+Keywords: cybersecurity,news,cli,nulltap
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+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 :: Security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# nulltap
+
+Nulltap in your terminal. This client reads the public [nulltap.sh](https://nulltap.sh) JSON feed and prints cybersecurity and AI coverage without requiring an account.
+
+## Install
+
+Python 3.10 or newer is required. After the first PyPI release, install it with [pipx](https://pipx.pypa.io/):
+
+```sh
+pipx install nulltap
+```
+
+Until then, install the current version from GitHub with `pipx install git+https://github.com/JustinHowe/nulltap.git`.
+
+Run `nulltap --help` after installation.
+
+## Commands
+
+```sh
+nulltap                         # paginated recent articles; type a number to read
+nulltap browse                  # explicit form of the default command
+nulltap latest -n 20            # browse the newest 20 articles
+nulltap latest --topic identity
+nulltap topics                  # choose a topic, then choose an article
+nulltap topic ai                # paginated articles tagged AI
+nulltap topic                   # choose a topic interactively
+nulltap search                  # enter search words interactively
+nulltap search "token theft"
+nulltap search gateway --topic appsec
+nulltap read 1                  # directly read the newest article
+nulltap read                    # browse first when no number is supplied
+nulltap --plain                 # print once; no prompts or pager
+```
+
+Interactive lists show five articles per page so a page fits a normal terminal window. Enter the displayed number to read an article, `n` for the next page, `p` for the previous page, or `q` to leave. Use `--page-size N` to change the page size.
+
+Articles open in the terminal pager. Headings, lists, quotations, code blocks, images, inline links, and primary sources are formatted for terminal reading. Press `q` to leave the pager and return to the article list. No browser is required.
+
+When output is redirected, nulltap automatically disables menus and the pager. `--plain` does the same thing explicitly. Article IDs, slugs, and URLs remain accepted as direct targets for scripts, but ordinary readers should not need them.
+
+## Search
+
+Search belongs in the CLI because it is useful when the browser is not. It runs locally over article titles, summaries, and topic tags. Search terms are never sent to nulltap or another service.
+
+Every word in the query must match. Title matches rank above tag and summary matches, with publication date breaking ties.
+
+## Scripts
+
+Add `--json` to `browse`, `latest`, `topics`, `topic`, `search`, `read`, or `show`:
+
+```sh
+nulltap search ransomware --json
+nulltap topics --json
+```
+
+Use a different compatible feed during development:
+
+```sh
+nulltap --feed http://127.0.0.1:4321/feed.json
+# or
+NULLTAP_FEED_URL=http://127.0.0.1:4321/feed.json nulltap
+```
+
+Listing and search commands make one read-only feed request. Reading an article makes a second request for that article's text. The client has no analytics, login, local database, or background process. Feed and article text are stripped of terminal control sequences before display.
+
+## Development
+
+```sh
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+python -m pip install -e .
+python -m unittest discover -s tests -v
+```
+
+Licensed under the MIT License.

nulltap-0.1.0/README.md

@@ -0,0 +1,76 @@
+# nulltap
+
+Nulltap in your terminal. This client reads the public [nulltap.sh](https://nulltap.sh) JSON feed and prints cybersecurity and AI coverage without requiring an account.
+
+## Install
+
+Python 3.10 or newer is required. After the first PyPI release, install it with [pipx](https://pipx.pypa.io/):
+
+```sh
+pipx install nulltap
+```
+
+Until then, install the current version from GitHub with `pipx install git+https://github.com/JustinHowe/nulltap.git`.
+
+Run `nulltap --help` after installation.
+
+## Commands
+
+```sh
+nulltap                         # paginated recent articles; type a number to read
+nulltap browse                  # explicit form of the default command
+nulltap latest -n 20            # browse the newest 20 articles
+nulltap latest --topic identity
+nulltap topics                  # choose a topic, then choose an article
+nulltap topic ai                # paginated articles tagged AI
+nulltap topic                   # choose a topic interactively
+nulltap search                  # enter search words interactively
+nulltap search "token theft"
+nulltap search gateway --topic appsec
+nulltap read 1                  # directly read the newest article
+nulltap read                    # browse first when no number is supplied
+nulltap --plain                 # print once; no prompts or pager
+```
+
+Interactive lists show five articles per page so a page fits a normal terminal window. Enter the displayed number to read an article, `n` for the next page, `p` for the previous page, or `q` to leave. Use `--page-size N` to change the page size.
+
+Articles open in the terminal pager. Headings, lists, quotations, code blocks, images, inline links, and primary sources are formatted for terminal reading. Press `q` to leave the pager and return to the article list. No browser is required.
+
+When output is redirected, nulltap automatically disables menus and the pager. `--plain` does the same thing explicitly. Article IDs, slugs, and URLs remain accepted as direct targets for scripts, but ordinary readers should not need them.
+
+## Search
+
+Search belongs in the CLI because it is useful when the browser is not. It runs locally over article titles, summaries, and topic tags. Search terms are never sent to nulltap or another service.
+
+Every word in the query must match. Title matches rank above tag and summary matches, with publication date breaking ties.
+
+## Scripts
+
+Add `--json` to `browse`, `latest`, `topics`, `topic`, `search`, `read`, or `show`:
+
+```sh
+nulltap search ransomware --json
+nulltap topics --json
+```
+
+Use a different compatible feed during development:
+
+```sh
+nulltap --feed http://127.0.0.1:4321/feed.json
+# or
+NULLTAP_FEED_URL=http://127.0.0.1:4321/feed.json nulltap
+```
+
+Listing and search commands make one read-only feed request. Reading an article makes a second request for that article's text. The client has no analytics, login, local database, or background process. Feed and article text are stripped of terminal control sequences before display.
+
+## Development
+
+```sh
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+python -m pip install -e .
+python -m unittest discover -s tests -v
+```
+
+Licensed under the MIT License.

nulltap-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nulltap"
+version = "0.1.0"
+description = "Read the nulltap.sh cybersecurity feed from a terminal."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Justin Howe" }]
+keywords = ["cybersecurity", "news", "cli", "nulltap"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Security"
+]
+dependencies = []
+
+[project.scripts]
+nulltap = "nulltap.cli:main"
+
+[project.urls]
+Homepage = "https://nulltap.sh"
+Repository = "https://github.com/JustinHowe/nulltap"
+
+[tool.setuptools.packages.find]
+where = ["src"]

nulltap-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

nulltap-0.1.0/src/nulltap/__init__.py

@@ -0,0 +1,3 @@
+"""nulltap command-line client."""
+
+__version__ = "0.1.0"

nulltap-0.1.0/src/nulltap/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())