pjx 0.0.1__tar.gz

pjx-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,86 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master, dev]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --group dev --group test
+
+      - name: Format check
+        run: uv run ruff format --check --output-format github .
+
+      - name: Lint
+        run: uv run ruff check --output-format github .
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --group dev --group test
+
+      - name: Type check
+        run: uv run ty check --output-format github src/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --group test
+
+      - name: Run tests
+        run: uv run pytest -v --ignore=tests/benchmark --tb=short
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

pjx-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --group test
+
+      - name: Run tests
+        run: uv run pytest -v --ignore=tests/benchmark --tb=short
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pjx-0.0.1/.gitignore

@@ -0,0 +1,18 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.pytest_cache/
+.env
+.ruff_cache/
+.rumdl_cache/
+.benchmarks
+
+node_modules/
+**/static/vendor/

pjx-0.0.1/.python-version

@@ -0,0 +1 @@
+3.14

pjx-0.0.1/.rumdl.toml

@@ -0,0 +1,76 @@
+# rumdl configuration file
+
+# Inherit settings from another config file (relative to this file's directory)
+# extends = "../base.rumdl.toml"
+
+# Global configuration options
+[global]
+# List of rules to disable (uncomment and modify as needed)
+# disable = ["MD013", "MD033"]
+
+# List of rules to enable exclusively (replaces defaults; only these rules will run)
+# enable = ["MD001", "MD003", "MD004"]
+
+# Additional rules to enable on top of defaults (additive, does not replace)
+# Use this to activate opt-in rules like MD060, MD063, MD072, MD073, MD074
+# extend-enable = ["MD060", "MD063"]
+
+# Additional rules to disable on top of the disable list (additive)
+# extend-disable = ["MD041"]
+
+# List of file/directory patterns to include for linting (if provided, only these will be linted)
+# include = [
+#    "docs/*.md",
+#    "src/**/*.md",
+#    "README.md"
+# ]
+
+# List of file/directory patterns to exclude from linting
+exclude = [
+    # Common directories to exclude
+    ".git",
+    ".github",
+    "node_modules",
+    "vendor",
+    "dist",
+    "build",
+
+    # Specific files or patterns
+    "CHANGELOG.md",
+    "LICENSE.md",
+]
+
+# Respect .gitignore files when scanning directories (default: true)
+respect-gitignore = true
+
+# Markdown flavor/dialect (uncomment to enable)
+# Options: standard (default), gfm, commonmark, mkdocs, mdx, quarto
+# flavor = "mkdocs"
+
+# Rule-specific configurations (uncomment and modify as needed)
+
+# [MD003]
+# style = "atx"  # Heading style (atx, atx_closed, setext)
+
+# [MD004]
+# style = "asterisk"  # Unordered list style (asterisk, plus, dash, consistent)
+
+# [MD007]
+# indent = 4  # Unordered list indentation
+
+# [MD013]
+# line-length = 100  # Line length
+# code-blocks = false  # Exclude code blocks from line length check
+# tables = false  # Exclude tables from line length check
+# headings = true  # Include headings in line length check
+
+# [MD044]
+# names = ["rumdl", "Markdown", "GitHub"]  # Proper names that should be capitalized correctly
+# code-blocks = false  # Check code blocks for proper names (default: false, skips code blocks)
+
+[MD013]
+line-length = 0
+
+[MD060]
+enabled = true
+style = "aligned"

pjx-0.0.1/CLAUDE.md

@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+PJX is a Python DSL for reactive `.jinja` components, inspired by JSX, Svelte
+and SolidJS. It compiles a declarative component syntax (props, state, slots,
+imports, control flow) down to Jinja2 + HTMX + Alpine.js. The full DSL
+specification lives in `docs/dev/IDEA.md`, technical spec in `docs/dev/SPEC.md`.
+
+## Stack
+
+- **Language**: Python 3.14+
+- **Package manager**: uv
+- **Linter/Formatter**: ruff
+- **Type checker**: ty
+- **Test runner**: pytest
+- **Markdown lint**: rumdl
+- **Runtime deps**: FastAPI, Jinja2, minijinja, Pydantic, Rich, Typer, Uvicorn
+
+## Quick Commands
+
+```bash
+rtk uv sync                          # Install deps from lockfile
+rtk uv run task format               # Format (ruff)
+rtk uv run task lint                 # Lint + autofix (ruff)
+rtk uv run task check                # Format + lint + markdown lint
+rtk uv run task typecheck            # Type check (ty)
+rtk uv run task test                 # Run all tests
+rtk uv run task cov                  # Tests with coverage report
+rtk uv run task ci                   # Full CI: check + typecheck + test
+rtk uv run pytest tests/test_foo.py::test_bar -v  # Single test
+```
+
+## Validation (run in order, fail fast)
+
+```bash
+rtk uv run task ci
+```
+
+Or manually:
+
+```bash
+rtk uv run task check
+rtk uv run task typecheck
+rtk uv run task test
+```
+
+## Skills
+
+On-demand knowledge modules in `.agents/skills/`. Load the relevant skill
+when working in its domain.
+
+| Skill               | When to use                                       |
+| ------------------- | ------------------------------------------------- |
+| `python/SKILL.md`   | Python code, conventions, async, uv toolchain     |
+| `fastapi/SKILL.md`  | FastAPI routes, dependencies, middleware          |
+| `jx/SKILL.md`       | Jinja server-rendered components (JX patterns)    |
+| `frontend/SKILL.md` | JS/CSS tooling, Tailwind, Alpine.js, HTMX         |
+| `commit/SKILL.md`   | Small logical commits with conventional messages  |
+| `refactor/SKILL.md` | Code audit, clean code, SOLID, security review    |
+
+Each skill has a `references/` folder with detailed submodules. Load on demand.
+
+## Conventions
+
+- Use `pathlib` over `os.path`
+- f-strings only
+- `snake_case` functions/variables, `PascalCase` classes, `UPPER_SNAKE` constants
+- Type all public functions
+- Use `Annotated` style for FastAPI parameters and dependencies
+- `logging` for app logs, `rich` for CLI output — never `print`
+- Pydantic `BaseModel` for validation, `dataclass` for plain data
+- IO at edges only — services and domain must be pure
+- Prefer `uv` over direct `pip` workflows
+- Never commit code that fails `ruff check`
+
+## Code Quality
+
+- **Clean Code**: small single-responsibility functions, descriptive names
+  that make comments unnecessary, no dead or duplicated code
+- **Pythonic**: use language idioms (comprehensions, context managers,
+  itertools, `enumerate`, unpacking) — avoid C-style loops
+- **SOLID**: each module/class has a single reason to change (SRP), depend
+  on abstractions not concrete implementations (DIP), prefer composition
+  over inheritance
+- **Type safety**: type hints on all public functions and models; use
+  `Protocol` / `ABC` for contracts between layers
+
+## Tests
+
+- All new or changed code must include tests
+- Keep coverage high — cover happy path, edge cases, and expected errors
+- Unit tests for pure logic, integration tests for IO and endpoints
+- Descriptive test names: `test_<unit>_<scenario>_<expected>`
+- Use fixtures and parametrize to avoid repetition
+
+## Documentation
+
+- Update docstrings (Google style) on all public functions/classes created
+  or modified
+- Keep `README.md` up to date when installation, usage, or architecture changes
+- Add usage examples in `examples/` for each public feature — short
+  self-contained scripts that demonstrate real API usage
+- Update `docs/dev/IDEA.md` if the implementation diverges from the spec

pjx-0.0.1/LICENSE

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