nulltap 0.1.1__tar.gz → 0.2.0__tar.gz

{nulltap-0.1.1/src/nulltap.egg-info → nulltap-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nulltap
-Version: 0.1.1
+Version: 0.2.0
 Summary: Read Nulltap cybersecurity and AI articles from a terminal.
 Author: Justin Howe
 License-Expression: MIT
@@ -24,7 +24,7 @@ Dynamic: license-file
 
 # nulltap
 
-Read [Nulltap](https://nulltap.sh) from a terminal. Browse recent cybersecurity and AI articles, search the feed, filter by topic, and read the full article without opening a browser.
+Read [Nulltap](https://nulltap.sh) from a terminal. Browse recent cybersecurity and AI articles, search the feed, filter by topic, and choose the full or 1-minute version without opening a browser.
 
 ## Install
 
@@ -51,12 +51,24 @@ nulltap topics                  # list every topic and its article count
 nulltap topic identity          # browse one topic
 nulltap search "token theft"    # search titles, summaries, and topic tags
 nulltap read 2                  # read the second result in the terminal
+nulltap read 2 --short          # read its 1-minute version
 ```
 
 Interactive lists show five articles at a time. Enter a result number to read it, `n` or `p` to change pages, and `q` to leave. Use `--page-size N` if you want a different page size.
 
 Articles open in the terminal pager with headings, lists, quotations, code blocks, image descriptions, links, and primary sources formatted for the console. Press `q` to return to the article list.
 
+## Reading modes
+
+Full articles are the default. Add `--short` to use the 1-minute version when you read from a list, search result, topic, or direct `read` command:
+
+```sh
+nulltap search "token theft" --short
+nulltap read 2 --short
+```
+
+Set the `NULLTAP_READING_MODE` environment variable to `short` if you want that behavior by default. The `--full` flag overrides the environment for one command. Nulltap stops with a clear message instead of silently showing the full article when a requested 1-minute version is unavailable.
+
 ## Topics
 
 Nulltap currently publishes under these topics:

{nulltap-0.1.1 → nulltap-0.2.0}/README.md

@@ -1,6 +1,6 @@
 # nulltap
 
-Read [Nulltap](https://nulltap.sh) from a terminal. Browse recent cybersecurity and AI articles, search the feed, filter by topic, and read the full article without opening a browser.
+Read [Nulltap](https://nulltap.sh) from a terminal. Browse recent cybersecurity and AI articles, search the feed, filter by topic, and choose the full or 1-minute version without opening a browser.
 
 ## Install
 
@@ -27,12 +27,24 @@ nulltap topics                  # list every topic and its article count
 nulltap topic identity          # browse one topic
 nulltap search "token theft"    # search titles, summaries, and topic tags
 nulltap read 2                  # read the second result in the terminal
+nulltap read 2 --short          # read its 1-minute version
 ```
 
 Interactive lists show five articles at a time. Enter a result number to read it, `n` or `p` to change pages, and `q` to leave. Use `--page-size N` if you want a different page size.
 
 Articles open in the terminal pager with headings, lists, quotations, code blocks, image descriptions, links, and primary sources formatted for the console. Press `q` to return to the article list.
 
+## Reading modes
+
+Full articles are the default. Add `--short` to use the 1-minute version when you read from a list, search result, topic, or direct `read` command:
+
+```sh
+nulltap search "token theft" --short
+nulltap read 2 --short
+```
+
+Set the `NULLTAP_READING_MODE` environment variable to `short` if you want that behavior by default. The `--full` flag overrides the environment for one command. Nulltap stops with a clear message instead of silently showing the full article when a requested 1-minute version is unavailable.
+
 ## Topics
 
 Nulltap currently publishes under these topics:

{nulltap-0.1.1 → nulltap-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nulltap"
-version = "0.1.1"
+version = "0.2.0"
 description = "Read Nulltap cybersecurity and AI articles from a terminal."
 readme = "README.md"
 requires-python = ">=3.10"

{nulltap-0.1.1 → nulltap-0.2.0}/src/nulltap/__init__.py

@@ -1,3 +1,3 @@
 """nulltap command-line client."""
 
-__version__ = "0.1.1"
+__version__ = "0.2.0"

{nulltap-0.1.1 → nulltap-0.2.0}/src/nulltap/cli.py

@@ -91,6 +91,10 @@ def normalize_item(raw: Any) -> dict[str, Any] | None:
         read_time = max(0, int(raw.get("read_time_minutes", 0)))
     except (TypeError, ValueError):
         read_time = 0
+    try:
+        short_read_time = max(0, int(raw.get("short_read_time_minutes", 0)))
+    except (TypeError, ValueError):
+        short_read_time = 0
 
     content_url = safe_http_url(raw.get("content_url"))
     if content_url and not same_origin(url, content_url):
@@ -105,6 +109,8 @@ def normalize_item(raw: Any) -> dict[str, Any] | None:
         "date_published": safe_text(raw.get("date_published")),
         "tags": tags,
         "read_time_minutes": read_time,
+        "short_read_available": bool(raw.get("short_read_available", False)),
+        "short_read_time_minutes": short_read_time,
         "author": safe_text(raw.get("author")),
         "image": safe_http_url(raw.get("image")),
     }
@@ -224,6 +230,13 @@ def fetch_article(
     )
     if not isinstance(payload, dict) or not isinstance(payload.get("content_text"), str):
         raise FeedError("article does not contain terminal-readable text")
+    short_content = payload.get("short_content_text", "")
+    if short_content and not isinstance(short_content, str):
+        raise FeedError("article contains invalid 1-minute text")
+    try:
+        short_read_time = max(0, int(payload.get("short_read_time_minutes", 0) or 0))
+    except (TypeError, ValueError):
+        short_read_time = 0
 
     raw_sources = payload.get("sources", [])
     if not isinstance(raw_sources, list):
@@ -240,6 +253,8 @@ def fetch_article(
     return {
         **item,
         "content_text": safe_article_text(payload["content_text"]),
+        "short_content_text": safe_article_text(short_content),
+        "short_read_time_minutes": short_read_time,
         "sources": sources,
     }
 
@@ -277,6 +292,13 @@ def build_parser() -> argparse.ArgumentParser:
     common.add_argument("--page-size", type=positive_int, metavar="N", help="articles per page (default: 5)")
     common.add_argument("--days", type=positive_days, metavar="N", help="limit the feed to the last N days")
     common.add_argument("--no-color", action="store_true", help="disable terminal color")
+    reading_mode = common.add_mutually_exclusive_group()
+    reading_mode.add_argument(
+        "--short",
+        action="store_true",
+        help="read 1-minute versions (or set NULLTAP_READING_MODE=short)",
+    )
+    reading_mode.add_argument("--full", action="store_true", help="force full articles")
 
     parser = argparse.ArgumentParser(
         prog="nulltap",
@@ -292,6 +314,7 @@ def build_parser() -> argparse.ArgumentParser:
               nulltap topic identity          browse one topic
               nulltap search "token theft"    search titles, summaries, and tags
               nulltap read 2                  read the second result in the terminal
+              nulltap read 2 --short          read its 1-minute version
 
             Run 'nulltap COMMAND --help' for command-specific options.
             """
@@ -551,6 +574,20 @@ def render_markdown(markdown: str, width: int, use_color: bool) -> tuple[str, li
     return "\n".join(output), links
 
 
+def select_reading_mode(article: dict[str, Any], short_mode: bool) -> dict[str, Any]:
+    if not short_mode:
+        return {**article, "reading_mode": "full"}
+    short_content = article.get("short_content_text", "")
+    if not short_content:
+        raise FeedError("this article does not include a 1-minute read")
+    return {
+        **article,
+        "content_text": short_content,
+        "read_time_minutes": article.get("short_read_time_minutes", 1) or 1,
+        "reading_mode": "short",
+    }
+
+
 def render_article(item: dict[str, Any], use_color: bool, width: int | None = None) -> str:
     width = width or terminal_width()
     lines: list[str] = []
@@ -558,6 +595,8 @@ def render_article(item: dict[str, Any], use_color: bool, width: int | None = No
     lines.extend(paint(line, "1", use_color) for line in title_lines)
 
     metadata = [display_date(item["date_published"]), *item["tags"]]
+    if item.get("reading_mode") == "short":
+        metadata.append("1-minute read")
     if item["read_time_minutes"]:
         metadata.append(f"{item['read_time_minutes']} min")
     if item["author"]:
@@ -641,8 +680,9 @@ def show_article(
     use_color: bool,
     use_pager: bool,
     pager: Callable[[str], None],
+    short_mode: bool,
 ) -> None:
-    article = article_loader(item, timeout)
+    article = select_reading_mode(article_loader(item, timeout), short_mode)
     rendered = render_article(article, use_color)
     if use_pager:
         pager(rendered)
@@ -661,6 +701,7 @@ def browse_items(
     article_loader: Callable[[dict[str, Any], float], dict[str, Any]],
     timeout: float,
     pager: Callable[[str], None],
+    short_mode: bool,
 ) -> int:
     if not items:
         print("No published articles matched.", file=stdout)
@@ -711,6 +752,7 @@ def browse_items(
                     use_color=use_color,
                     use_pager=True,
                     pager=pager,
+                    short_mode=short_mode,
                 )
                 continue
         print(f"Choose an article from {start + 1} to {end}, or use n, p, or q.", file=stdout)
@@ -784,6 +826,10 @@ def run(
     json_output = getattr(args, "json", False)
     plain = getattr(args, "plain", False)
     no_color = getattr(args, "no_color", False)
+    configured_mode = safe_text(os.environ.get("NULLTAP_READING_MODE", "full")).lower()
+    short_mode = getattr(args, "short", False) or (
+        configured_mode == "short" and not getattr(args, "full", False)
+    )
     page_size = min(getattr(args, "page_size", 5), 50)
 
     if timeout <= 0 or timeout > 120:
@@ -821,6 +867,7 @@ def run(
                     article_loader=article_loader,
                     timeout=timeout,
                     pager=pager,
+                    short_mode=short_mode,
                 )
             return 0
         if topics:
@@ -877,7 +924,7 @@ def run(
                 print(f"nulltap: article not found: {safe_text(target)}", file=stderr)
                 return 1
             if command in {"read", "show"}:
-                article = article_loader(item, timeout)
+                article = select_reading_mode(article_loader(item, timeout), short_mode)
                 if json_output:
                     json_dump(article, stdout)
                 else:
@@ -910,6 +957,7 @@ def run(
             article_loader=article_loader,
             timeout=timeout,
             pager=pager,
+            short_mode=short_mode,
         )
     else:
         print_items(selected, stdout, use_color)

{nulltap-0.1.1 → nulltap-0.2.0/src/nulltap.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nulltap
-Version: 0.1.1
+Version: 0.2.0
 Summary: Read Nulltap cybersecurity and AI articles from a terminal.
 Author: Justin Howe
 License-Expression: MIT
@@ -24,7 +24,7 @@ Dynamic: license-file
 
 # nulltap
 
-Read [Nulltap](https://nulltap.sh) from a terminal. Browse recent cybersecurity and AI articles, search the feed, filter by topic, and read the full article without opening a browser.
+Read [Nulltap](https://nulltap.sh) from a terminal. Browse recent cybersecurity and AI articles, search the feed, filter by topic, and choose the full or 1-minute version without opening a browser.
 
 ## Install
 
@@ -51,12 +51,24 @@ nulltap topics                  # list every topic and its article count
 nulltap topic identity          # browse one topic
 nulltap search "token theft"    # search titles, summaries, and topic tags
 nulltap read 2                  # read the second result in the terminal
+nulltap read 2 --short          # read its 1-minute version
 ```
 
 Interactive lists show five articles at a time. Enter a result number to read it, `n` or `p` to change pages, and `q` to leave. Use `--page-size N` if you want a different page size.
 
 Articles open in the terminal pager with headings, lists, quotations, code blocks, image descriptions, links, and primary sources formatted for the console. Press `q` to return to the article list.
 
+## Reading modes
+
+Full articles are the default. Add `--short` to use the 1-minute version when you read from a list, search result, topic, or direct `read` command:
+
+```sh
+nulltap search "token theft" --short
+nulltap read 2 --short
+```
+
+Set the `NULLTAP_READING_MODE` environment variable to `short` if you want that behavior by default. The `--full` flag overrides the environment for one command. Nulltap stops with a clear message instead of silently showing the full article when a requested 1-minute version is unavailable.
+
 ## Topics
 
 Nulltap currently publishes under these topics:

{nulltap-0.1.1 → nulltap-0.2.0}/tests/test_cli.py

@@ -2,6 +2,7 @@ import io
 import json
 import re
 import unittest
+from unittest.mock import patch
 from datetime import datetime, timezone
 from pathlib import Path
 
@@ -15,6 +16,8 @@ from nulltap.cli import (
     render_article,
     run,
     search_items,
+    select_reading_mode,
+    FeedError,
 )
 
 
@@ -28,6 +31,8 @@ ITEMS = [
         "date_published": "2026-07-26T12:00:00Z",
         "tags": ["cloud", "identity"],
         "read_time_minutes": 6,
+        "short_read_available": True,
+        "short_read_time_minutes": 1,
         "author": "nulltap",
         "image": "",
     },
@@ -40,6 +45,8 @@ ITEMS = [
         "date_published": "2026-07-25T12:00:00Z",
         "tags": ["ai", "appsec"],
         "read_time_minutes": 4,
+        "short_read_available": True,
+        "short_read_time_minutes": 1,
         "author": "nulltap",
         "image": "",
     },
@@ -97,6 +104,8 @@ class NulltapCliTests(unittest.TestCase):
             article_loader=lambda item, _timeout: {
                 **item,
                 "content_text": "## Access path\n\nThe token crossed a trust boundary.\n\n[Image: Token path]",
+                "short_content_text": "The token crossed a trust boundary. Revoke it and inspect the audit log.",
+                "short_read_time_minutes": 1,
                 "sources": [{"label": "Primary advisory", "url": "https://example.com/advisory"}],
             },
             browser_opener=opener or (lambda _url, **_kwargs: True),
@@ -120,6 +129,8 @@ class NulltapCliTests(unittest.TestCase):
             article_loader=lambda item, _timeout: {
                 **item,
                 "content_text": "## Access path\n\nThe token crossed a trust boundary.",
+                "short_content_text": "The short read keeps the affected boundary and the immediate check.",
+                "short_read_time_minutes": 1,
                 "sources": [],
             },
             pager=pages.append,
@@ -153,6 +164,7 @@ class NulltapCliTests(unittest.TestCase):
         self.assertIn("nulltap latest --days 7", help_text)
         self.assertIn("nulltap topics", help_text)
         self.assertIn("limit the feed to the last N days", help_text)
+        self.assertIn("nulltap read 2 --short", help_text)
 
     def test_search_uses_title_summary_and_tags(self):
         results = search_items(ITEMS, "production credentials")
@@ -177,6 +189,25 @@ class NulltapCliTests(unittest.TestCase):
         self.assertIn("Access path", stdout)
         self.assertNotIn("## Access path", stdout)
 
+    def test_short_mode_reads_the_one_minute_version(self):
+        code, stdout, stderr = self.invoke(["read", "1", "--short"])
+        self.assertEqual(code, 0)
+        self.assertEqual(stderr, "")
+        self.assertIn("1-minute read", stdout)
+        self.assertIn("Revoke it and inspect the audit log.", stdout)
+        self.assertNotIn("Access path", stdout)
+
+    def test_full_flag_overrides_short_environment_default(self):
+        with patch.dict("os.environ", {"NULLTAP_READING_MODE": "short"}):
+            code, stdout, _ = self.invoke(["read", "1", "--full"])
+        self.assertEqual(code, 0)
+        self.assertIn("Access path", stdout)
+        self.assertNotIn("1-minute read", stdout)
+
+    def test_short_mode_fails_clearly_when_article_has_no_short_read(self):
+        with self.assertRaisesRegex(FeedError, "does not include a 1-minute read"):
+            select_reading_mode({**ITEMS[0], "content_text": "Full article"}, True)
+
     def test_list_does_not_require_browser_urls(self):
         code, stdout, _ = self.invoke(["latest"])
         self.assertEqual(code, 0)