grokfeed 0.2.0__tar.gz

grokfeed-0.2.0/.github/release.yml

@@ -0,0 +1,14 @@
+changelog:
+  categories:
+    - title: "What's New"
+      labels:
+        - enhancement
+    - title: Bug Fixes
+      labels:
+        - bug
+    - title: Performance
+      labels:
+        - performance
+    - title: Maintenance
+      labels:
+        - chore

grokfeed-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+      - run: uv sync
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run mypy grokfeed
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync
+      - run: uv run pytest --cov=grokfeed --cov-report=xml
+      - name: Upload coverage
+        if: matrix.os == 'ubuntu-latest' && matrix.python == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  build-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv build
+      - run: uv run --with twine twine check dist/*

grokfeed-0.2.0/.github/workflows/codeql.yml

@@ -0,0 +1,32 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  schedule:
+    - cron: "17 11 * * 2"  # weekly on Tuesday
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      actions: read
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [python]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
+
+      - uses: github/codeql-action/autobuild@v3
+
+      - uses: github/codeql-action/analyze@v3
+        with:
+          category: "/language:${{ matrix.language }}"

grokfeed-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+  id-token: write  # required for PyPI trusted publishing
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history for release notes
+
+      - uses: astral-sh/setup-uv@v5
+
+      - run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*
+
+      - name: Update Homebrew formula
+        uses: mislav/bump-homebrew-formula-action@v3
+        with:
+          formula-name: grokfeed
+          homebrew-tap: emarkou/homebrew-grokfeed
+          base-branch: main
+          download-url: https://github.com/emarkou/grokfeed/archive/refs/tags/${{ github.ref_name }}.tar.gz
+          commit-message: "grokfeed {{version}}"
+        env:
+          COMMITTER_TOKEN: ${{ secrets.TAP_GITHUB_TOKEN }}

grokfeed-0.2.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+*.egg-info/
+dist/
+build/
+.claude/

grokfeed-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        args: [--ignore-missing-imports]
+        additional_dependencies: [types-tomli]

grokfeed-0.2.0/LICENSE

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

grokfeed-0.2.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: grokfeed
+Version: 0.2.0
+Summary: Hacker News + Reddit + lobste.rs terminal feed viewer
+Project-URL: Homepage, https://github.com/emarkou/grokfeed
+Project-URL: Repository, https://github.com/emarkou/grokfeed
+Project-URL: Issues, https://github.com/emarkou/grokfeed/issues
+Author-email: Eleni Markou <eamarkou@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Eleni Markou
+        
+        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.
+License-File: LICENSE
+Keywords: feed,hacker-news,lobsters,reddit,terminal,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0.0
+Requires-Dist: httpx[http2]>=0.27.0
+Requires-Dist: textual>=0.47.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Description-Content-Type: text/markdown
+
+# grokfeed
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Terminal feed reader for Hacker News, Reddit, and lobste.rs.
+
+
+## Features
+
+- Unified scrollable feed from HN, Reddit subreddits, and lobste.rs
+- Color-coded by source: HN orange, lobste.rs red, subreddits in a cycling palette
+- Read text posts and Ask HN inline — no browser needed
+- Comments viewer with nested replies (up to 2 levels)
+- Filter feed by source, refresh on demand
+- Config file at `~/.grokfeed/config.toml` — created automatically on first run
+
+## Install
+
+### Homebrew (recommended)
+
+```bash
+brew tap emarkou/grokfeed
+brew install grokfeed
+```
+
+On first run, a config file is created at `~/.grokfeed/config.toml`. Edit it to change subreddits:
+
+```bash
+nano ~/.grokfeed/config.toml
+```
+
+```toml
+subreddits = ["programming", "ClaudeAI", "machinelearning"]
+hn_story_count = 30
+reddit_post_count = 15
+lobsters_post_count = 25
+```
+
+Changes take effect on next launch or press `r` to refresh.
+
+### From source
+
+Requires Python 3.11+. Recommended: use [uv](https://github.com/astral-sh/uv).
+
+```bash
+# with uv
+uv venv --python 3.13 .venv
+source .venv/bin/activate
+uv pip install -e .
+
+# or plain pip (Python 3.11+)
+pip install -e .
+```
+
+## Run
+
+```bash
+grokfeed
+```
+
+## Screenshots
+
+![Feed](docs/screenshots/feed.png)
+
+![Post body](docs/screenshots/post.png)
+
+![Comments](docs/screenshots/comments.png)
+
+## Key bindings
+
+### Main feed
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Move down |
+| `k` / `↑` | Move up |
+| `Enter` | Open post body (text posts) or URL in browser (link posts) |
+| `c` | Open comments |
+| `f` | Cycle source filter (All → HN → r/sub → lobste.rs → …) |
+| `r` | Refresh all sources |
+| `q` | Quit |
+
+### Post body modal
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Scroll down |
+| `k` / `↑` | Scroll up |
+| `c` | Open comments for this post |
+| `o` | Open URL in browser |
+| `q` / `Esc` | Close |
+
+### Comments modal
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Scroll down |
+| `k` / `↑` | Scroll up |
+| `q` / `Esc` | Close |
+
+## Config
+
+`~/.grokfeed/config.toml` — created on first run with defaults.
+
+```toml
+subreddits = ["programming", "python", "machinelearning"]
+hn_story_count = 30
+reddit_post_count = 15
+lobsters_post_count = 25
+```
+
+Edit to add or remove subreddits. Changes take effect on next launch or `r` refresh.
+
+## Tech stack
+
+| Library | Role |
+|---------|------|
+| [Textual](https://github.com/Textualize/textual) | TUI framework |
+| [httpx](https://www.python-httpx.org/) | Async HTTP client |
+| [Typer](https://typer.tiangolo.com/) | CLI entry point |
+| [Rich](https://github.com/Textualize/rich) | Text rendering |

grokfeed-0.2.0/README.md

@@ -0,0 +1,121 @@
+# grokfeed
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Terminal feed reader for Hacker News, Reddit, and lobste.rs.
+
+
+## Features
+
+- Unified scrollable feed from HN, Reddit subreddits, and lobste.rs
+- Color-coded by source: HN orange, lobste.rs red, subreddits in a cycling palette
+- Read text posts and Ask HN inline — no browser needed
+- Comments viewer with nested replies (up to 2 levels)
+- Filter feed by source, refresh on demand
+- Config file at `~/.grokfeed/config.toml` — created automatically on first run
+
+## Install
+
+### Homebrew (recommended)
+
+```bash
+brew tap emarkou/grokfeed
+brew install grokfeed
+```
+
+On first run, a config file is created at `~/.grokfeed/config.toml`. Edit it to change subreddits:
+
+```bash
+nano ~/.grokfeed/config.toml
+```
+
+```toml
+subreddits = ["programming", "ClaudeAI", "machinelearning"]
+hn_story_count = 30
+reddit_post_count = 15
+lobsters_post_count = 25
+```
+
+Changes take effect on next launch or press `r` to refresh.
+
+### From source
+
+Requires Python 3.11+. Recommended: use [uv](https://github.com/astral-sh/uv).
+
+```bash
+# with uv
+uv venv --python 3.13 .venv
+source .venv/bin/activate
+uv pip install -e .
+
+# or plain pip (Python 3.11+)
+pip install -e .
+```
+
+## Run
+
+```bash
+grokfeed
+```
+
+## Screenshots
+
+![Feed](docs/screenshots/feed.png)
+
+![Post body](docs/screenshots/post.png)
+
+![Comments](docs/screenshots/comments.png)
+
+## Key bindings
+
+### Main feed
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Move down |
+| `k` / `↑` | Move up |
+| `Enter` | Open post body (text posts) or URL in browser (link posts) |
+| `c` | Open comments |
+| `f` | Cycle source filter (All → HN → r/sub → lobste.rs → …) |
+| `r` | Refresh all sources |
+| `q` | Quit |
+
+### Post body modal
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Scroll down |
+| `k` / `↑` | Scroll up |
+| `c` | Open comments for this post |
+| `o` | Open URL in browser |
+| `q` / `Esc` | Close |
+
+### Comments modal
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Scroll down |
+| `k` / `↑` | Scroll up |
+| `q` / `Esc` | Close |
+
+## Config
+
+`~/.grokfeed/config.toml` — created on first run with defaults.
+
+```toml
+subreddits = ["programming", "python", "machinelearning"]
+hn_story_count = 30
+reddit_post_count = 15
+lobsters_post_count = 25
+```
+
+Edit to add or remove subreddits. Changes take effect on next launch or `r` refresh.
+
+## Tech stack
+
+| Library | Role |
+|---------|------|
+| [Textual](https://github.com/Textualize/textual) | TUI framework |
+| [httpx](https://www.python-httpx.org/) | Async HTTP client |
+| [Typer](https://typer.tiangolo.com/) | CLI entry point |
+| [Rich](https://github.com/Textualize/rich) | Text rendering |

grokfeed-0.2.0/config.example.toml

@@ -0,0 +1,17 @@
+# grokfeed configuration
+# Copy to ~/.grokfeed/config.toml and edit to taste.
+
+# Subreddits to include in the feed (without the r/ prefix).
+subreddits = ["programming", "python", "machinelearning", "rust", "devops"]
+
+# Number of HN top stories to load per fetch.
+hn_story_count = 30
+
+# Number of posts to fetch per subreddit per fetch.
+reddit_post_count = 15
+
+# Number of lobste.rs posts to fetch.
+lobsters_post_count = 25
+
+# How many minutes to serve cached results before hitting the network again.
+cache_ttl_minutes = 10

grokfeed-0.2.0/grokfeed/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"