genewildish/Mainline
1
0
Fork 1
Code Issues Pull Requests 4 Packages Projects Releases Wiki Activity
184 Commits 19 Branches 0 Tags
3fa9eabe36b57cdc576381047a9eb8278b50e792
Commit Graph

184 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
David Gwilliam
35e5c8d38b refactor: phase 3 - API efficiency improvements 
Add typed dataclasses for tuple returns:
- types.py: HeadlineItem, FetchResult, Block dataclasses with legacy tuple converters
- fetch.py: Add type hints and HeadlineTuple type alias

Add pyright for static type checking:
- Add pyright to dependencies
- Verify type coverage with pyright (0 errors in core modules)

This enables:
- Named types instead of raw tuples (better IDE support, self-documenting)
- Type-safe APIs across modules
- Backward compatibility via to_tuple/from_tuple methods

Note: Lazy imports skipped for render.py - startup impact is minimal.
 2026-03-15 19:13:32 -07:00
David Gwilliam
cdc8094de2 refactor: phase 2 - modularization of scroll engine 
Split monolithic scroll.py into focused modules:
- viewport.py: terminal size (tw/th), ANSI positioning helpers
- frame.py: FrameTimer class, scroll step calculation
- layers.py: message overlay, ticker zone, firehose rendering
- scroll.py: simplified orchestrator, imports from new modules

Add stream controller and event types for future event-driven architecture:
- controller.py: StreamController for source initialization and stream lifecycle
- events.py: EventType enum and event dataclasses (HeadlineEvent, FrameTickEvent, etc.)

Added tests for new modules:
- test_viewport.py: 8 tests for viewport utilities
- test_frame.py: 10 tests for frame timing
- test_layers.py: 13 tests for layer compositing
- test_events.py: 11 tests for event types
- test_controller.py: 6 tests for stream controller

This enables:
- Testable chunks with clear responsibilities
- Reusable viewport utilities across modules
- Better separation of concerns in render pipeline
- Foundation for future event-driven architecture

Also includes Phase 1 documentation updates in code comments.
 2026-03-15 19:13:32 -07:00
David Gwilliam
f170143939 refactor: phase 1 - testability improvements 
- Add Config dataclass with get_config()/set_config() for injection
- Add Config.from_args() for CLI argument parsing (testable)
- Add platform font path detection (Darwin/Linux)
- Bound translate cache with @lru_cache(maxsize=500)
- Add fixtures for external dependencies (network, feeds, config)
- Add 15 tests for Config class, from_args, and platform detection

This enables testability by:
- Allowing config injection instead of global mutable state
- Supporting custom argv in from_args() for testing
- Providing reusable fixtures for mocking network/filesystem
- Preventing unbounded memory growth in translation cache

Fixes: _arg_value/_arg_int not accepting custom argv
 2026-03-15 19:13:32 -07:00
genewildish
19fb4bc4fe Merge pull request 'docs/update-readme' (#23) from docs/update-readme into main 
Reviewed-on: #23
 2026-03-16 00:09:10 +00:00
Gene Johnson
ae10fd78ca refactor: Restructure README, add uv and mise commands, and detail component extension and development workflows. 2026-03-15 17:08:32 -07:00
Gene Johnson
4afab642f7 docs: add README update design spec 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-15 16:56:58 -07:00
genewildish
f6f177590b Merge pull request 'Modernize project with uv, pytest, ruff, and git hooks' (#21) from enhance_portability into main 
Reviewed-on: #21
 2026-03-15 23:21:35 +00:00
David Gwilliam
9ae4dc2b07 fix: update ntfy tests for SSE API (reconnect_delay) 2026-03-15 15:16:37 -07:00
David Gwilliam
1ac2dec3b0 fix: use native hk staging in pre-commit hook 
fix: add explicit check command to pre-push hook
 2026-03-15 15:16:37 -07:00
David Gwilliam
757c854584 fix: apply ruff auto-fixes and add hk git hooks 
- Fix pre-existing lint errors in engine/ modules using ruff --unsafe-fixes
- Add hk.pkl with pre-commit and pre-push hooks using ruff builtin
- Configure hooks to use 'uv run' prefix for tool execution
- Update mise.toml to include hk and pkl tools
- All 73 tests pass

fix: apply ruff auto-fixes and add hk git hooks

- Fix pre-existing lint errors in engine/ modules using ruff --unsafe-fixes
- Add hk.pkl with pre-commit and pre-push hooks using ruff builtin
- Configure hooks to use 'uv run' prefix for tool execution
- Update mise.toml to include hk and pkl tools
- Use 'hk install --mise' for proper mise integration
- All 73 tests pass
 2026-03-15 15:16:37 -07:00
David Gwilliam
4844a64203 style: apply ruff auto-fixes across codebase 
- Fix import sorting (isort) across all engine modules
- Fix SIM105 try-except-pass patterns (contextlib.suppress)
- Fix nested with statements in tests
- Fix unused loop variables

Run 'uv run pytest' to verify tests still pass.
 2026-03-15 15:16:37 -07:00
David Gwilliam
9201117096 feat: modernize project with uv, add pytest test suite 
- Add pyproject.toml with modern Python packaging (PEP 517/518)
- Add uv-based dependency management replacing inline venv bootstrap
- Add requirements.txt and requirements-dev.txt for compatibility
- Add mise.toml with dev tasks (test, lint, run, sync, ci)
- Add .python-version pinned to Python 3.12
- Add comprehensive pytest test suite (73 tests) for:
  - engine/config, filter, terminal, sources, mic, ntfy modules
- Configure pytest with coverage reporting (16% total, 100% on tested modules)
- Configure ruff for linting with Python 3.10+ target
- Remove redundant venv bootstrap code from mainline.py
- Update .gitignore for uv/venv artifacts

Run 'uv sync' to install dependencies, 'uv run pytest' to test.
 2026-03-15 15:16:37 -07:00
genewildish
d758541156 Merge pull request 'feat: migrate Ntfy message retrieval from polling to SSE streaming, replacing poll_interval with reconnect_delay for continuous updates.' (#20) from feat/ntfy-sse into main 
Reviewed-on: #20
 2026-03-15 20:50:08 +00:00
genewildish
b979621dd4 Merge branch 'main' into feat/ntfy-sse 2026-03-15 20:50:02 +00:00
genewildish
f91cc9844e Merge pull request 'feat: add new font files to the fonts directory' (#19) from feat/display into main 
Reviewed-on: #19
 2026-03-15 20:47:16 +00:00
genewildish
bddbd69371 Merge branch 'main' into feat/display 2026-03-15 20:45:54 +00:00
Gene Johnson
6e39a2dad2 feat: migrate Ntfy message retrieval from polling to SSE streaming, replacing poll_interval with reconnect_delay for continuous updates. 2026-03-15 13:44:26 -07:00
Gene Johnson
1ba3848bed feat: add new font files to the fonts directory 2026-03-15 13:30:08 -07:00
genewildish
a986df344a Merge pull request 'doc: Document new font selection command-line arguments, environment variables, and a dedicated font management section.' (#18) from docs/update-readme into main 
Reviewed-on: #18
 2026-03-15 11:08:25 +00:00
Gene Johnson
c84bd5c05a doc: Document new font selection command-line arguments, environment variables, and a dedicated font management section. 2026-03-15 04:07:24 -07:00
genewildish
7b0f886e53 Merge pull request 'feat: add new font assets including CSBishopDrawn, CyberformDemo, and KATA.' (#17) from feat/font-picker into main 
Reviewed-on: #17
 2026-03-15 11:01:39 +00:00
genewildish
9eeb817dca Merge branch 'main' into feat/font-picker 2026-03-15 11:01:31 +00:00
Gene Johnson
ac80ab23cc feat: add new font assets including CSBishopDrawn, CyberformDemo, and KATA. 2026-03-15 04:01:06 -07:00
genewildish
516123345e Merge pull request 'feat/font-picker' (#16) from feat/font-picker into main 
Reviewed-on: #16
 2026-03-15 10:53:16 +00:00
Gene Johnson
11226872a1 feat: Implement interactive font selection by scanning the fonts/ directory for .otf, .ttf, and .ttc files, adding new fonts and updating documentation. 2026-03-15 03:52:10 -07:00
Gene Johnson
e6826c884c feat: Implement an interactive font face picker at startup, allowing selection of specific font faces from a font file. 2026-03-15 03:38:14 -07:00
genewildish
0740e34293 Merge pull request 'style: Replace escaped parentheses with standard parentheses in the Mainline Renderer documentation.' (#15) from feat/scalability into main 
Reviewed-on: #15
 2026-03-15 10:03:42 +00:00
genewildish
1e99d70387 Merge branch 'main' into feat/scalability 2026-03-15 10:03:34 +00:00
genewildish
7098b2f5aa Merge pull request 'feat: Introduce a complementary color gradient for queue messages.' (#14) from feat/display into main 
Reviewed-on: #14
 2026-03-15 10:01:57 +00:00
Gene Johnson
e7de09be50 style: Replace escaped parentheses with standard parentheses in the Mainline Renderer documentation. 2026-03-15 02:58:38 -07:00
Gene Johnson
9140bfd32b feat: Introduce a complementary color gradient for queue messages. 2026-03-15 02:44:38 -07:00
genewildish
c49c0aab33 Merge pull request 'refactor: Change firehose from a drifting overlay to a fixed bottom strip and message display from a top-pinned section to a centered overlay.' (#13) from drift into main 
Reviewed-on: #13
 2026-03-15 09:27:16 +00:00
Gene Johnson
66c13b5829 refactor: Change firehose from a drifting overlay to a fixed bottom strip and message display from a top-pinned section to a centered overlay. 2026-03-15 02:26:44 -07:00
genewildish
089c8ed66a Merge pull request 'drift' (#12) from drift into main 
Reviewed-on: #12
 2026-03-15 08:33:48 +00:00
Gene Johnson
086214f05e style: remove firehose opaque row backdrop and background color 2026-03-15 01:31:44 -07:00
Gene Johnson
0f762475b5 feat: Apply a distinct background color to firehose lines. 2026-03-15 01:08:17 -07:00
Gene Johnson
b00b612da0 refactor: rename rendering components and variables for clarity, distinguishing between message, ticker, and scroll motion layers. 2026-03-15 00:58:36 -07:00
Gene Johnson
39dab4b22b feat: Implement a drifting firehose overlay that scrolls independently over the main ticker content. 2026-03-15 00:49:58 -07:00
genewildish
47f17e12ef Merge pull request 'docs: Add ntfy.sh integration details, new CLI options, expanded configuration, and architecture overview to README.' (#11) from docs/update-readme into main 
Reviewed-on: #11
 2026-03-15 07:19:14 +00:00
Gene Johnson
851c4a77b4 docs: Add ntfy.sh integration details, new CLI options, expanded configuration, and architecture overview to README. 2026-03-15 00:17:05 -07:00
genewildish
cdbb6dfd1c Merge pull request 'feat/scalability' (#10) from feat/scalability into main 
Reviewed-on: #10
 2026-03-15 06:50:11 +00:00
genewildish
45a202e955 Merge branch 'main' into feat/scalability 2026-03-15 06:50:02 +00:00
Gene Johnson
339510dd60 Please provide the diff for /Users/genejohnson/Dev/mainline/mainline.py to generate an accurate commit message. 2026-03-14 23:46:31 -07:00
Gene Johnson
9bd8115c55 feat: introduce the scroll engine with a main rendering loop for headlines, messages, and visual effects. 2026-03-14 23:36:56 -07:00
Gene Johnson
2c777729f5 feat: Introduce ntfy.sh message polling, content fetching with caching, and microphone input monitoring. 2026-03-14 23:34:23 -07:00
genewildish
0e500d1b71 Merge pull request 'feat/display' (#9) from feat/display into main 
Reviewed-on: #9
 2026-03-15 06:25:57 +00:00
genewildish
3571e2780b Merge branch 'main' into feat/display 2026-03-15 06:25:49 +00:00
Gene Johnson
dfd902fb90 feat: add module for fetching RSS feeds, parsing Project Gutenberg texts, and caching headlines 2026-03-14 22:51:50 -07:00
Gene Johnson
2e6b2c48bd feat: Introduce visual effects module, enhance text rendering with SSAA, and add shifting gradient support. 2026-03-14 22:15:48 -07:00
Gene Johnson
1ff2e54586 Merge remote-tracking branch 'origin/feat/display' into feat/scalability 2026-03-14 22:06:35 -07:00