fognode 0.1.0__tar.gz

fognode-0.1.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @IMDelewer

fognode-0.1.0/.github/PULL_REQUEST_TEMPLATE/bug_fix.md

@@ -0,0 +1,12 @@
+## Bug fix
+
+- [ ] `ruff check src/ tests/` — no errors
+- [ ] `black --check src/ tests/` — no changes needed
+- [ ] `pyright src/` — no errors
+- [ ] `pytest tests/` — all pass
+
+### What bug is fixed?
+
+### Root cause
+
+### How was it fixed?

fognode-0.1.0/.github/PULL_REQUEST_TEMPLATE/optimization.md

@@ -0,0 +1,12 @@
+## Optimization
+
+- [ ] `ruff check src/ tests/` — no errors
+- [ ] `black --check src/ tests/` — no changes needed
+- [ ] `pyright src/` — no errors
+- [ ] `pytest tests/` — all pass
+
+### What was optimized?
+
+### Measured improvement
+
+### Risks / trade-offs

fognode-0.1.0/.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    target-branch: dev
+    labels:
+      - dependencies
+    reviewers:
+      - IMDelewer

fognode-0.1.0/.github/workflows/build.yml

@@ -0,0 +1,129 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Release version"
+        required: true
+        default: "v0.1.0"
+
+      publish_pypi:
+        description: "Publish package to PyPI"
+        type: boolean
+        required: true
+        default: true
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+
+    environment:
+      name: pypi
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Validate version format
+        run: |
+          VERSION="${{ github.event.inputs.version }}"
+          if [[ ! "$VERSION" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Invalid version format: $VERSION"
+            echo "Expected: vX.Y.Z"
+            exit 1
+          fi
+          echo "Version format valid: $VERSION"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine hatchling
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify package
+        run: twine check dist/*
+
+      - name: Generate release notes
+        id: notes
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+          if [ -z "$PREV_TAG" ]; then
+            LOG=$(git log --max-count=50 --pretty=format:"- %s")
+          else
+            LOG=$(git log ${PREV_TAG}..HEAD --max-count=100 --pretty=format:"- %s")
+          fi
+
+          {
+            echo 'notes<<EOF'
+            echo "# fognode ${{ github.event.inputs.version }}"
+            echo
+            echo "## Changes"
+            echo
+            echo "$LOG"
+            echo
+            echo "## Installation"
+            echo
+            echo '```bash'
+            echo 'pip install fognode'
+            echo '```'
+            echo
+            echo "## PyPI"
+            echo
+            echo "https://pypi.org/project/fognode/"
+            echo
+            echo 'EOF'
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag exists
+        id: check_tag
+        run: |
+          TAG="${{ github.event.inputs.version }}"
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists"
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create tag
+        if: steps.check_tag.outputs.exists == 'false'
+        run: |
+          TAG="${{ github.event.inputs.version }}"
+          git tag "$TAG"
+          git push origin "$TAG"
+
+      - name: Create GitHub release
+        if: steps.check_tag.outputs.exists == 'false'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.inputs.version }}
+          name: fognode ${{ github.event.inputs.version }}
+          body: ${{ steps.notes.outputs.notes }}
+          generate_release_notes: false
+          files: |
+            dist/*
+
+      - name: Publish to PyPI
+        if: github.event.inputs.publish_pypi == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: false
+          skip-existing: true
+          verbose: true

fognode-0.1.0/.github/workflows/pr.yml

@@ -0,0 +1,155 @@
+name: PR Checks
+
+on:
+  pull_request:
+    branches: [main, dev]
+
+jobs:
+  lint:
+    name: Lint & Types
+    runs-on: ubuntu-latest
+    outputs:
+      ruff: ${{ steps.ruff.outcome }}
+      black: ${{ steps.black.outcome }}
+      pyright: ${{ steps.pyright.outcome }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Ruff
+        id: ruff
+        continue-on-error: true
+        run: ruff check src/ tests/
+
+      - name: Black
+        id: black
+        continue-on-error: true
+        run: black --check src/ tests/
+
+      - name: Pyright
+        id: pyright
+        continue-on-error: true
+        run: pyright src/
+
+  test:
+    name: Python ${{ matrix.python }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.10", "3.12", "3.14"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          allow-prereleases: true
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Pytest
+        id: pytest
+        continue-on-error: true
+        run: pytest tests/ -v --tb=short
+
+      - name: Save result
+        if: always()
+        run: echo "${{ steps.pytest.outcome }}" > pytest-result.txt
+
+      - name: Upload result
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: result-py${{ matrix.python }}
+          path: pytest-result.txt
+
+  comment:
+    name: PR Comment
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: always()
+    permissions:
+      pull-requests: write
+
+    steps:
+      - name: Download results
+        uses: actions/download-artifact@v4
+        with:
+          path: results
+
+      - name: Build comment
+        id: build
+        run: |
+          ruff="${{ needs.lint.outputs.ruff }}"
+          black="${{ needs.lint.outputs.black }}"
+          pyright="${{ needs.lint.outputs.pyright }}"
+
+          icon()  { [ "$1" = "success" ] && echo "✅" || echo "❌"; }
+          label() { [ "$1" = "success" ] && echo "Passed" || echo "Failed"; }
+
+          py310=$(cat results/result-py3.10/pytest-result.txt 2>/dev/null || echo "unknown")
+          py312=$(cat results/result-py3.12/pytest-result.txt 2>/dev/null || echo "unknown")
+          py314=$(cat results/result-py3.14/pytest-result.txt 2>/dev/null || echo "unknown")
+
+          all_passed="true"
+          for v in "$ruff" "$black" "$pyright" "$py310" "$py312" "$py314"; do
+            [ "$v" != "success" ] && all_passed="false" && break
+          done
+
+          [ "$all_passed" = "true" ] \
+            && header="✅ PR Check Results" \
+            || header="❌ PR Check Results"
+
+          [ "$all_passed" = "true" ] \
+            && footer="All checks passed." \
+            || footer="One or more checks failed. Fix the issues and push again."
+
+          cat > comment.md << EOF
+          ## $header
+
+          ### Lint & Type Checks
+
+          | Check | Status |
+          |-------|--------|
+          | Ruff    | $(icon "$ruff") $(label "$ruff") |
+          | Black   | $(icon "$black") $(label "$black") |
+          | Pyright | $(icon "$pyright") $(label "$pyright") |
+
+          ### Tests
+
+          | Python | Status |
+          |--------|--------|
+          | 3.10 | $(icon "$py310") $(label "$py310") |
+          | 3.12 | $(icon "$py312") $(label "$py312") |
+          | 3.14 | $(icon "$py314") $(label "$py314") |
+
+          > $footer
+          EOF
+
+          {
+            echo 'body<<COMMENT_EOF'
+            cat comment.md
+            echo 'COMMENT_EOF'
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Comment Pull Request
+        uses: thollander/actions-comment-pull-request@v3.0.1
+        with:
+          message: ${{ steps.build.outputs.body }}
+          comment-tag: pr-checks

fognode-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+.venv/
+venv/
+
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+*.pem
+*.key
+*.bin

fognode-0.1.0/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.0
+
+- Initial release.
+- TLS 1.2+ with strong cipher suite.
+- X25519 ephemeral key exchange over TLS.
+- AESGCM-256 + HMAC-SHA256 frame encryption.
+- PBKDF2-HMAC-SHA256 password derivation.
+- Monotonic counter + timestamp replay protection.
+- IP-to-word encoding for human-readable addresses.
+- Rate-limited authentication.

fognode-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# Contributing to fognode
+
+Personal library. PRs accepted only in narrow scope.
+
+## Accepted
+
+| Type | Accepted |
+|---|---|
+| Bug fixes | yes |
+| Code optimization | yes |
+| Cross-platform improvements | yes |
+| Security hardening | yes |
+| Features | no |
+| Documentation | no |
+| Questions | no |
+
+## Requirements
+
+- Python 3.10+
+- `ruff check src/ tests/`
+- `black --check src/ tests/`
+- `pyright src/`
+- `pytest tests/`
+- No comments explaining what code does
+- `from __future__ import annotations` where needed
+
+## PR checklist
+
+- [ ] All checks pass
+- [ ] No breaking API changes in `src/fognode/__init__.py`

fognode-0.1.0/LICENSE

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

fognode-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: fognode
+Version: 0.1.0
+Summary: fognode - headless secure encrypted data transmission. TLS + X25519 + AESGCM + PBKDF2.
+Project-URL: Repository, https://github.com/reekeer/fognode
+Author: reekeer
+License: MIT License
+        
+        Copyright (c) 2026 reekeer
+        
+        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
+Requires-Python: >=3.10
+Requires-Dist: cryptography>=44.0.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0.0; extra == 'dev'
+Requires-Dist: pyright>=1.1.409; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<h1 align="center">fognode</h1>
+
+<h4 align="center">headless secure encrypted data transmission.</h4>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge&logo=opensourceinitiative&logoColor=FFFFFF" alt="License"></a>
+  <img src="https://img.shields.io/badge/Python-3.10%2B-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+  <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey?style=for-the-badge&logo=linux&logoColor=FCC624" alt="Platform">
+  <img src="https://img.shields.io/badge/code%20style-black-000000?style=for-the-badge" alt="black">
+  <img src="https://img.shields.io/badge/linting-ruff-orange?style=for-the-badge" alt="ruff">
+  <img src="https://img.shields.io/badge/type%20checked-pyright-4B8BBE?style=for-the-badge" alt="pyright">
+</p>
+
+---
+
+Encrypted channel library for headless projects. Built for speed and zero-trust networking.
+
+Stack: TLS 1.2+ · X25519 · AESGCM-256 · HMAC-SHA256 · PBKDF2 · HKDF
+
+---
+
+## Install
+
+```bash
+pip install fognode
+```
+
+## Quick start (aiogram-style)
+
+### Server
+
+```python
+from fognode import App, Cipher
+
+app = App(
+    host="0.0.0.0",
+    port=9443,
+    user="alice",
+    password="secret",
+    cipher=Cipher.AESGCM,
+)
+
+@app.on_message()
+async def echo(ctx):
+    await ctx.answer(f"echo: {ctx.message.text}")
+
+@app.on_command("ping")
+async def ping(ctx):
+    await ctx.answer("pong")
+
+@app.on_connect()
+async def on_connect(ctx):
+    print(f"+ {ctx.user}")
+
+if __name__ == "__main__":
+    app.run()
+```
+
+### Client
+
+```python
+from fognode import App, Cipher
+
+app = App.client(
+    connect_string="alice@oak-pine-stone-field:9443",
+    password="secret",
+    cipher=Cipher.AESGCM,
+)
+
+@app.on_message()
+async def on_message(ctx):
+    print(f"{ctx.message.user}: {ctx.message.text}")
+
+if __name__ == "__main__":
+    app.run()
+```
+
+## Classic API
+
+```python
+from fognode import start_server, client_connect
+
+ip, code, fp = start_server("0.0.0.0", 9443, "alice", "secret")
+print(f"Connect: alice@{code}:9443")
+```
+
+## Structure
+
+```
+src/fognode/
+├── app.py          # App class (aiogram-style)
+├── cipher.py       # Cipher enum
+├── context.py      # Context for handlers
+├── message.py      # Message dataclass
+├── router.py       # Router for handlers
+├── filters/        # Command, Text filters
+├── handlers/       # HandlerObject
+├── types/          # exceptions, constants, protocol
+├── crypto/         # primitives, kdf, cert, channel
+├── ciphers/        # aesgcm, chacha20, x25519, hkdf, pbkdf2, hmac
+├── wire/           # framing
+├── auth/           # handshake
+├── core/           # server, client, session, state
+├── decorators.py   # retry, rate_limited, timed
+├── exceptions.py   # errors
+├── utils/          # ipwords, ratelimit, net
+└── cli/            # entrypoint
+```
+
+---
+
+<p align="center"><sub><a href="LICENSE">MIT</a> © reekeer</sub></p>

fognode-0.1.0/README.md

@@ -0,0 +1,112 @@
+<h1 align="center">fognode</h1>
+
+<h4 align="center">headless secure encrypted data transmission.</h4>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge&logo=opensourceinitiative&logoColor=FFFFFF" alt="License"></a>
+  <img src="https://img.shields.io/badge/Python-3.10%2B-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+  <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey?style=for-the-badge&logo=linux&logoColor=FCC624" alt="Platform">
+  <img src="https://img.shields.io/badge/code%20style-black-000000?style=for-the-badge" alt="black">
+  <img src="https://img.shields.io/badge/linting-ruff-orange?style=for-the-badge" alt="ruff">
+  <img src="https://img.shields.io/badge/type%20checked-pyright-4B8BBE?style=for-the-badge" alt="pyright">
+</p>
+
+---
+
+Encrypted channel library for headless projects. Built for speed and zero-trust networking.
+
+Stack: TLS 1.2+ · X25519 · AESGCM-256 · HMAC-SHA256 · PBKDF2 · HKDF
+
+---
+
+## Install
+
+```bash
+pip install fognode
+```
+
+## Quick start (aiogram-style)
+
+### Server
+
+```python
+from fognode import App, Cipher
+
+app = App(
+    host="0.0.0.0",
+    port=9443,
+    user="alice",
+    password="secret",
+    cipher=Cipher.AESGCM,
+)
+
+@app.on_message()
+async def echo(ctx):
+    await ctx.answer(f"echo: {ctx.message.text}")
+
+@app.on_command("ping")
+async def ping(ctx):
+    await ctx.answer("pong")
+
+@app.on_connect()
+async def on_connect(ctx):
+    print(f"+ {ctx.user}")
+
+if __name__ == "__main__":
+    app.run()
+```
+
+### Client
+
+```python
+from fognode import App, Cipher
+
+app = App.client(
+    connect_string="alice@oak-pine-stone-field:9443",
+    password="secret",
+    cipher=Cipher.AESGCM,
+)
+
+@app.on_message()
+async def on_message(ctx):
+    print(f"{ctx.message.user}: {ctx.message.text}")
+
+if __name__ == "__main__":
+    app.run()
+```
+
+## Classic API
+
+```python
+from fognode import start_server, client_connect
+
+ip, code, fp = start_server("0.0.0.0", 9443, "alice", "secret")
+print(f"Connect: alice@{code}:9443")
+```
+
+## Structure
+
+```
+src/fognode/
+├── app.py          # App class (aiogram-style)
+├── cipher.py       # Cipher enum
+├── context.py      # Context for handlers
+├── message.py      # Message dataclass
+├── router.py       # Router for handlers
+├── filters/        # Command, Text filters
+├── handlers/       # HandlerObject
+├── types/          # exceptions, constants, protocol
+├── crypto/         # primitives, kdf, cert, channel
+├── ciphers/        # aesgcm, chacha20, x25519, hkdf, pbkdf2, hmac
+├── wire/           # framing
+├── auth/           # handshake
+├── core/           # server, client, session, state
+├── decorators.py   # retry, rate_limited, timed
+├── exceptions.py   # errors
+├── utils/          # ipwords, ratelimit, net
+└── cli/            # entrypoint
+```
+
+---
+
+<p align="center"><sub><a href="LICENSE">MIT</a> © reekeer</sub></p>