hunt-framework 0.2.2__tar.gz

hunt_framework-0.2.2/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Report a reproducible bug in hunt
+labels: bug
+---
+
+## Description
+
+A clear description of the bug.
+
+## hunt version
+
+<!-- Output of: python -c "import hunt; print(hunt.__version__)" -->
+
+## Python version
+
+<!-- Output of: python --version -->
+
+## Minimal reproduction
+
+```python
+# Paste the smallest possible code that demonstrates the bug
+```
+
+## Expected behaviour
+
+What you expected to happen.
+
+## Actual behaviour
+
+What actually happened. Include the full traceback if applicable.
+
+## Additional context
+
+Any other information that might help (OS, database driver, etc.).

hunt_framework-0.2.2/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://hunt-framework.com/docs/installation
+    about: Check the docs before opening an issue
+  - name: Security vulnerability
+    url: https://github.com/hunt-core/hunt/security/advisories/new
+    about: Please report security issues privately

hunt_framework-0.2.2/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Feature request
+about: Propose a new feature or improvement
+labels: enhancement
+---
+
+## Problem
+
+What problem does this feature solve? Who benefits and how often does this come up?
+
+## Proposed solution
+
+Describe the API or behaviour you have in mind. Code examples are helpful.
+
+```python
+# How would it look to use this feature?
+```
+
+## Alternatives considered
+
+Other approaches you considered and why you prefer this one.
+
+## Additional context
+
+Links, prior art, or anything else relevant.

hunt_framework-0.2.2/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+## What does this PR do?
+
+<!-- A concise description of the change. -->
+
+## Why?
+
+<!-- The motivation — link an issue if one exists. -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor / cleanup
+- [ ] Documentation
+- [ ] Tests only
+
+## Checklist
+
+- [ ] `pytest` passes with no new failures
+- [ ] New behaviour is covered by tests
+- [ ] No unrelated changes included
+- [ ] CHANGELOG.md updated (maintainers will do this on merge if you prefer)

hunt_framework-0.2.2/.github/workflows/lint.yml

@@ -0,0 +1,29 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Ruff
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Install ruff
+        run: uv tool install ruff
+
+      - name: Lint
+        run: uv tool run ruff check src/
+
+      - name: Format
+        run: uv tool run ruff format --check src/

hunt_framework-0.2.2/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

hunt_framework-0.2.2/.github/workflows/tests.yml

@@ -0,0 +1,34 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest --tb=short -q

hunt_framework-0.2.2/.gitignore

@@ -0,0 +1,63 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+
+# Build / distribution
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# uv
+.uv/
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.tox/
+
+# Type checking
+.mypy_cache/
+.pyright/
+.ruff_cache/
+
+# IDEs
+.idea/
+*.iml
+*.ipr
+*.iws
+.vscode/
+*.swp
+*.swo
+*~
+
+# Environment / secrets
+.env
+.env.*
+!.env.example
+
+# Compiled views cache
+storage/framework/views/
+
+# Logs
+storage/logs/
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+admin_plan.md
+.claude
+/templates

hunt_framework-0.2.2/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+All notable changes to hunt are documented here.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+hunt uses [semantic versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+---
+
+## [0.2.0] — 2026-05-14
+
+### Added
+
+**Admin panel**
+- Full admin panel at `/hunt-admin` with resource CRUD, index filtering, sorting, and pagination
+- Field types: `Text`, `Email`, `Password`, `Textarea`, `RichText`, `Number`, `Boolean`, `Select`, `Image`, `DateTime`, `BelongsTo`, `HasMany`, `Badge`
+- Fluent field API: `.sortable()`, `.readonly()`, `.rules()`, `.hide_from_forms()`, `.show_on_index()`, `.hide_from_index()`, etc.
+- Filter system with `SelectFilter`, `BooleanFilter`, `TrashedFilter`; options accept both dict and tuple formats
+- Action system with `ActionResponse.success()`, `ActionResponse.error()`, `ActionResponse.redirect()`
+- Metric cards: `ValueMetric`, `TrendMetric`, `PartitionMetric`
+- Global search across all registered resources, results grouped by resource with "View all" links
+- Navigation API: `NavGroup`, `NavResource`, `NavLink` with backward-compatible auto-generated sidebar
+- `hunt make:admin-resource` command — scaffolds and auto-registers an `AdminResource`; accepts both `Post` and `post` as the model argument
+
+**Authentication**
+- Session-backed auth via `Auth.attempt()`, `Auth.login()`, `Auth.logout()`, `Auth.user()`, `Auth.check()`
+- Full login / registration / forgot-password / reset-password scaffold via `hunt new`
+- Auth feature flags in `config/auth.py` (`registration`, `login`, `forgot_password`) — disabled features remove routes entirely and hide corresponding links in built-in auth views
+- Session ID regenerated on login to prevent session fixation
+
+**CLI**
+- `hunt new` — scaffold a complete application with auth, admin, migrations, and config files; auto-generates `APP_KEY` in `.env`
+- `hunt upgrade` — add missing scaffold files to existing projects; shows unified diff for locally modified files; creates new config files (e.g. `config/auth.py`) without overwriting customised ones
+- `hunt schedule:list` / `hunt schedule:run` — list and run scheduled tasks
+- `hunt queue:work` / `hunt queue:failed` / `hunt queue:flush` / `hunt queue:retry` — queue worker and failed job management
+- Full `make:*` suite: `model`, `controller`, `migration`, `middleware`, `event`, `listener`, `job`, `mail`, `seeder`, `factory`, `command`, `request`, `resource`, `rule`, `policy`, `observer`, `notification`, `admin-resource`
+
+**Queue system**
+- Sync, database, and Redis queue drivers
+- CAS-based pop in the database driver prevents race conditions under concurrent workers
+- Job chaining, delayed dispatch, configurable retries and backoff
+- `queue:work --once` for single-job processing
+
+**Scheduler**
+- Cron-expression scheduler with `every_minute()`, `hourly()`, `daily()`, `weekly()`, `monthly()`, and arbitrary `.cron()` expressions
+- Constraint modifiers: `.environments()`, `.when()`, `.skip()`, `.between()`
+- Background execution, output capture, lifecycle hooks (`.on_success()`, `.on_failure()`), health-check pings
+
+**Templates & views**
+- hunt template syntax: `@extends`, `@section`, `@yield`, `@include`, `@foreach`, `@if`, `@auth`, `@guest`, `@csrf`, `@error`, `@env`
+- `ViewFactory` automatically injects `config()`, `csrf_token`, `auth_user`, `request`, `can()`, and flash data into every template
+- View composers and shared variables
+
+**Security**
+- CSRF protection middleware with per-session tokens
+- Static file server blocks dangerous extensions: `.py`, `.env`, `.sh`, `.svg`, `.php`, and more
+- `Image` field excludes SVG from allowed upload MIME types by default
+- bcrypt password hashing via `hash_password()`
+- HTML output auto-escaped; raw output requires explicit `{!! !!}` syntax
+
+**Other**
+- ORM with `where`, `or_where`, `order_by`, `limit`, `paginate`, `first_or_create`, `find_or_fail`, soft deletes, relationships (`has_one`, `has_many`, `belongs_to`)
+- Event/listener system with `Dispatcher.dispatch_sync()` and the `event()` helper
+- Validation with 15+ built-in rules including `unique`, `confirmed`, `regex`, `in`
+- Storage system with local and S3 drivers; `storage:link` command
+- Cache system with file and Redis drivers
+- Mail system with SMTP and log transports
+- Translation / localisation support
+- `hunt tinker` — interactive REPL with full application context
+
+### Fixed
+- `make:admin-resource` normalises PascalCase model names to the correct lowercase filename
+- Scaffolded `layout.html` uses `config('key', default)` function syntax (not `.get()`)
+
+---
+
+[Unreleased]: https://github.com/hunt-core/hunt/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/hunt-core/hunt/releases/tag/v0.2.0

hunt_framework-0.2.2/CODEOWNERS

@@ -0,0 +1 @@
+* @0xsyk0

hunt_framework-0.2.2/CODE_OF_CONDUCT.md

@@ -0,0 +1,32 @@
+# Code of Conduct
+
+## Our pledge
+
+We are committed to making participation in the hunt project a welcoming experience for everyone, regardless of age, body size, disability, ethnicity, gender identity, level of experience, nationality, personal appearance, race, religion, or sexual identity.
+
+## Our standards
+
+**Encouraged behaviour:**
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Accepting constructive criticism gracefully
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+**Unacceptable behaviour:**
+
+- Harassment, insults, or derogatory comments
+- Personal or political attacks
+- Publishing others' private information without consent
+- Any conduct that would reasonably be considered inappropriate in a professional setting
+
+## Enforcement
+
+Instances of unacceptable behaviour may be reported by opening a private discussion or contacting the maintainers directly. All reports will be reviewed and investigated and will result in a response deemed appropriate to the circumstances. Maintainers are obligated to maintain confidentiality.
+
+Maintainers who do not follow or enforce this Code of Conduct in good faith may face temporary or permanent repercussions.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

hunt_framework-0.2.2/CONTRIBUTING.md

@@ -0,0 +1,100 @@
+# Contributing to hunt
+
+Thank you for your interest in contributing. hunt is a small, focused framework — contributions that keep it simple and well-tested are most welcome.
+
+---
+
+## Ways to contribute
+
+- **Bug reports** — open an issue with a minimal reproduction case
+- **Bug fixes** — open a PR against `main` with a test that fails before your fix and passes after
+- **Documentation** — fixes, clarifications, and new examples in the docs site (hunt-docs)
+- **Feature proposals** — open an issue first to discuss before writing code; small focused features are preferred over large ones
+
+---
+
+## Development setup
+
+Requirements: Python 3.11+, [uv](https://docs.astral.sh/uv/)
+
+```bash
+git clone git@github.com:hunt-core/hunt.git
+cd hunt
+uv venv && uv pip install -e ".[dev]"
+```
+
+Run the test suite:
+
+```bash
+pytest
+```
+
+---
+
+## Code style
+
+hunt uses [Ruff](https://docs.astral.sh/ruff/) for linting and formatting (configured in `pyproject.toml`).
+
+```bash
+uv tool run ruff check src/        # lint
+uv tool run ruff format src/       # format
+uv tool run ruff check src/ --fix  # auto-fix lint issues
+```
+
+Rules enforced: `E`, `W`, `F`, `I` (import order), `UP` (pyupgrade), `B` (bugbear), `RUF`. Line length 120.
+
+CI will fail if either check reports errors, so run both before opening a PR.
+
+Additional conventions:
+
+- Type annotations on all public functions and methods
+- No comments unless the *why* is genuinely non-obvious
+- No docstrings on simple functions — the name and types should speak for themselves
+
+---
+
+## Tests
+
+Every bug fix must include a regression test. New features must include tests covering the happy path and at least one edge case. Tests live in `tests/` and use pytest.
+
+```bash
+pytest                  # run all tests
+pytest tests/test_orm.py  # run a specific file
+pytest -k "test_create"   # run matching tests
+```
+
+---
+
+## Pull requests
+
+1. Fork the repository and create a branch from `main`
+2. Make your changes — keep commits small and focused
+3. Ensure `ruff check src/`, `ruff format --check src/`, and `pytest` all pass
+4. Open a PR against `main` with a clear description of the change and why
+
+PR titles should follow the pattern:
+
+```
+fix: <short description>
+feat: <short description>
+docs: <short description>
+refactor: <short description>
+```
+
+---
+
+## Versioning
+
+hunt increments the patch version (third number) for every change. You do not need to bump the version in your PR — maintainers handle that on merge.
+
+---
+
+## Reporting security issues
+
+Do **not** open a public issue for security vulnerabilities. See [SECURITY.md](SECURITY.md) for the responsible disclosure process.
+
+---
+
+## License
+
+By contributing you agree that your contributions will be licensed under the [MIT License](LICENSE).

hunt_framework-0.2.2/CONTRIBUTORS.md

@@ -0,0 +1,11 @@
+# Contributors
+
+Thank you to everyone who has contributed to hunt.
+
+## Core maintainers
+
+- **0xsyk0** ([@0xsyk0](https://github.com/0xsyk0)) — creator and lead maintainer
+
+---
+
+*To add yourself here, open a PR after your first contribution is merged.*

hunt_framework-0.2.2/LICENSE

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