proper 0.1.dev4__tar.gz → 0.9.0__tar.gz

proper-0.9.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: proper
+Version: 0.9.0
+Summary: A python web framework for people who read their code
+Author-email: Juan Pablo Scaletti <juanpablo@jpscaletti.com>
+License-Expression: MIT
+Project-URL: homepage, https://ProperProject.org/
+Project-URL: repository, https://github.com/jpsca/proper
+Project-URL: documentation, https://properproject.org/docs/
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: babel>=2.17.0
+Requires-Dist: formidable>=0.19
+Requires-Dist: hecto>=2.0.3
+Requires-Dist: huey~=2.5.2
+Requires-Dist: inflection>=0.5.1
+Requires-Dist: isort~=5.0
+Requires-Dist: itsdangerous~=1.1
+Requires-Dist: jx>=0.11.0
+Requires-Dist: markupsafe>=2.0
+Requires-Dist: passlib~=1.7
+Requires-Dist: peewee~=3.15
+Requires-Dist: peewee-migrate<2,>=1.12.1
+Requires-Dist: proper-cli~=1.2
+Requires-Dist: python-dateutil~=2.9.0
+Requires-Dist: python-multipart>=0.0.22
+Requires-Dist: traceback-with-variables~=2.0.4
+Requires-Dist: types-peewee~=3.17.7.20241017
+Requires-Dist: uvicorn>=0.41.0
+Requires-Dist: tzdata>=2025.3
+
+<h1><img src="https://properproject.org/proper.svg" height="48" />
+Proper Web Framework</h1>
+
+Proper is a new Python web framework. Not another Flask clone, it's a Ruby-on-Rails clone :P.
+
+More seriously: it isn't a clone, but it is heavily influenced by Rails in the ways that matter. Very opinionated, generator-heavy, focused on REST and server-rendered HTML, built around a fixed project structure, and packed with hardcoded batteries. You *can* swap pieces if you must, but the assumption is that you won't.
+
+The one thing Proper does very differently: **sync above, async below**. The runtime is ASGI (you need it for performance and WebSockets), but the code you write is _synchronous_. No `async`/`await` confetti scattered across code that doesn't need concurrency.
+
+
+## Quick start
+
+Requires [uv](https://docs.astral.sh/uv/getting-started/installation/).
+
+```bash
+uvx proper_new myapp
+cd myapp
+proper g resource Post title:str body:text
+proper server
+```
+
+That's a working CRUD app with model, controller, views, routes, migrations, and tests.
+
+Full (human-shaped) docs at [properproject.org/docs](https://properproject.org/docs).
+
+
+## Why not X?
+
+**Why not Flask?** - Absolute freedom means absolute chaos.
+
+**Why not Django?** - Django gives you the pieces and expects you to assemble them; Proper assembles them and gives you direction.
+
+**Why not FastAPI?** - FastAPI is awesome, but has the opposite shape: It's all about APIs and async-first, while Proper is server-rendered and sync-first. Building a React SPA on top of a JSON backend? You might want to use it. Building HTML for humans? Try Proper.
+
+**Why Peewee instead of SQLAlchemy?** - Smaller surface area, more readable, and ActiveRecord-style scopes fit it cleanly. SQLAlchemy is excellent but not something I want to read every day.
+
+**Why Jx instead of Jinja?** - Server-rendered Python components with typed props and slots. See the [Jx docs](https://properproject.org/docs/jx_components/) for the case.
+
+
+## Built with AI agents in mind
+
+Proper ships with an official skill: [properproject.org/skill.zip](https://properproject.org/skill.zip). Drop it in `~/.claude/skills/` and your agent will scaffold and edit your app the _Proper_ way (pun intended).
+
+This isn't just an extra. Hard conventions are exactly what makes AI output legible to humans: fewer tokens to understand a project, fewer surprises in generated code, and less effort reviewing it.
+
+
+## What's in the box
+
+- **Peewee ORM** with migrations, query helpers, and connection handling
+- **Forms** — declarative, validated, ORM-integrated, with rendering helpers
+- **Jx components** — server-rendered Python components, typed props, slots
+- **Caching** — fragment, action, and low-level, on SQLite or Redis
+- **Background tasks** via Huey, with retries, schedules, and cron syntax
+- **Authentication** — sessions, password resets, rate limiting, pwned-password checks
+- **File storage** — disk and S3 adapters, signed URLs, image variants
+- **i18n** — locale-aware routing, translations, pluralization, date formats
+- **Email** — templated transactional mail, SMTP and console mailers
+- **WebSockets** — channels, broadcasts, presence
+
+
+## For the press release
+
+> Proper is the Python web framework I built for myself after fifteen years in the trade, once I understood that hard conventions do not lock you in — they free you to focus on what's important.
+
+(It also works for the back cover of my future biography by Walter Isaacson).
+
+
+## Status
+
+This is 0.9, I'll call it 1.0 when I've found more bugs. Bug reports and contributions are very welcome. File them at [github.com/jpsca/proper/issues](https://github.com/jpsca/proper/issues).
+
+
+## Community
+
+- [Discord](https://discord.gg/aWVP3F4abD)
+
+
+## License
+
+Code: [MIT](https://github.com/jpsca/proper/blob/main/MIT-LICENSE). Documentation: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
+
+Made by [Juan-Pablo Scaletti](https://github.com/jpsca) in Lima, Perú.

proper-0.9.0/README.md

@@ -0,0 +1,82 @@
+<h1><img src="https://properproject.org/proper.svg" height="48" />
+Proper Web Framework</h1>
+
+Proper is a new Python web framework. Not another Flask clone, it's a Ruby-on-Rails clone :P.
+
+More seriously: it isn't a clone, but it is heavily influenced by Rails in the ways that matter. Very opinionated, generator-heavy, focused on REST and server-rendered HTML, built around a fixed project structure, and packed with hardcoded batteries. You *can* swap pieces if you must, but the assumption is that you won't.
+
+The one thing Proper does very differently: **sync above, async below**. The runtime is ASGI (you need it for performance and WebSockets), but the code you write is _synchronous_. No `async`/`await` confetti scattered across code that doesn't need concurrency.
+
+
+## Quick start
+
+Requires [uv](https://docs.astral.sh/uv/getting-started/installation/).
+
+```bash
+uvx proper_new myapp
+cd myapp
+proper g resource Post title:str body:text
+proper server
+```
+
+That's a working CRUD app with model, controller, views, routes, migrations, and tests.
+
+Full (human-shaped) docs at [properproject.org/docs](https://properproject.org/docs).
+
+
+## Why not X?
+
+**Why not Flask?** - Absolute freedom means absolute chaos.
+
+**Why not Django?** - Django gives you the pieces and expects you to assemble them; Proper assembles them and gives you direction.
+
+**Why not FastAPI?** - FastAPI is awesome, but has the opposite shape: It's all about APIs and async-first, while Proper is server-rendered and sync-first. Building a React SPA on top of a JSON backend? You might want to use it. Building HTML for humans? Try Proper.
+
+**Why Peewee instead of SQLAlchemy?** - Smaller surface area, more readable, and ActiveRecord-style scopes fit it cleanly. SQLAlchemy is excellent but not something I want to read every day.
+
+**Why Jx instead of Jinja?** - Server-rendered Python components with typed props and slots. See the [Jx docs](https://properproject.org/docs/jx_components/) for the case.
+
+
+## Built with AI agents in mind
+
+Proper ships with an official skill: [properproject.org/skill.zip](https://properproject.org/skill.zip). Drop it in `~/.claude/skills/` and your agent will scaffold and edit your app the _Proper_ way (pun intended).
+
+This isn't just an extra. Hard conventions are exactly what makes AI output legible to humans: fewer tokens to understand a project, fewer surprises in generated code, and less effort reviewing it.
+
+
+## What's in the box
+
+- **Peewee ORM** with migrations, query helpers, and connection handling
+- **Forms** — declarative, validated, ORM-integrated, with rendering helpers
+- **Jx components** — server-rendered Python components, typed props, slots
+- **Caching** — fragment, action, and low-level, on SQLite or Redis
+- **Background tasks** via Huey, with retries, schedules, and cron syntax
+- **Authentication** — sessions, password resets, rate limiting, pwned-password checks
+- **File storage** — disk and S3 adapters, signed URLs, image variants
+- **i18n** — locale-aware routing, translations, pluralization, date formats
+- **Email** — templated transactional mail, SMTP and console mailers
+- **WebSockets** — channels, broadcasts, presence
+
+
+## For the press release
+
+> Proper is the Python web framework I built for myself after fifteen years in the trade, once I understood that hard conventions do not lock you in — they free you to focus on what's important.
+
+(It also works for the back cover of my future biography by Walter Isaacson).
+
+
+## Status
+
+This is 0.9, I'll call it 1.0 when I've found more bugs. Bug reports and contributions are very welcome. File them at [github.com/jpsca/proper/issues](https://github.com/jpsca/proper/issues).
+
+
+## Community
+
+- [Discord](https://discord.gg/aWVP3F4abD)
+
+
+## License
+
+Code: [MIT](https://github.com/jpsca/proper/blob/main/MIT-LICENSE). Documentation: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
+
+Made by [Juan-Pablo Scaletti](https://github.com/jpsca) in Lima, Perú.

proper-0.9.0/pyproject.toml

@@ -0,0 +1,240 @@
+[build-system]
+requires = ["setuptools"]
+
+
+[project]
+name = "proper"
+version = "0.9.0"
+description = "A python web framework for people who read their code"
+authors = [
+    {name = "Juan Pablo Scaletti", email = "juanpablo@jpscaletti.com"},
+]
+license = "MIT"
+readme = "README.md"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "babel >= 2.17.0",
+    "formidable>=0.19",
+    "hecto >= 2.0.3",
+    "huey ~= 2.5.2",
+    "inflection >= 0.5.1",
+    "isort ~= 5.0",
+    "itsdangerous ~= 1.1",
+    "jx>=0.11.0",
+    "markupsafe >= 2.0",
+    "passlib ~= 1.7",
+    "peewee ~= 3.15",
+    "peewee-migrate >=1.12.1,< 2",
+    "proper-cli ~= 1.2",
+    "python-dateutil ~= 2.9.0",
+    "python-multipart >= 0.0.22",
+    "traceback-with-variables ~= 2.0.4",
+    "types-peewee ~= 3.17.7.20241017",
+    "uvicorn >= 0.41.0",
+    "tzdata >= 2025.3",
+]
+
+[project.urls]
+homepage = "https://ProperProject.org/"
+repository = "https://github.com/jpsca/proper"
+documentation = "https://properproject.org/docs/"
+
+
+[dependency-groups]
+dev = [
+    "ipdb >= 0.13",
+    "pre-commit",
+    "pytest-asyncio>=1.3.0",
+    "ruff >= 0.2.0",
+    "tox-uv>=1.33.1",
+    "ty>=0.0.1a24",
+]
+test = [
+    "pytest >= 7.2",
+    "pytest-cov",
+    # To test installable frameworks
+    "boto3 >= 1.35.71",
+    "poyo",
+    "pytest-smtpd",
+    "pyvips >= 2.0.0",
+    "redis >= 7.0.0",
+    "smtpdfix",
+]
+docs = [
+    "writeadoc>=0.22.0",
+]
+
+# [tool.uv.sources]
+# writeadoc = { path = "../../writeadoc", editable = true }
+
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+proper = [
+    "blueprints",
+    "core/templates",
+]
+[tool.setuptools.exclude-package-data]
+"*" = [
+    "**/__pycache__",
+    "*.pyc",
+    "*.pyo",
+]
+
+[tool.coverage.run]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "TYPE_CHECKING",
+    "def __repr__",
+    "def __str__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "except ImportError:",
+]
+omit = [
+    "src/proper/blueprints/*",
+    "src/proper/app_test.py",
+    "src/proper/cli/*",
+    "src/proper/helpers/server.py",
+]
+
+[tool.coverage.html]
+directory = "covreport"
+
+
+[tool.ty.src]
+exclude = [
+    "**/__pycache__",
+    "**/tests/",
+    "blueprint",
+    "build",
+    "docs",
+    "src/proper/mail/",
+    "src/proper/blueprints/",
+]
+
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+addopts = "--doctest-modules --ignore=src/proper/blueprints"
+filterwarnings = [
+    "ignore::DeprecationWarning:itsdangerous",
+    "ignore::DeprecationWarning:botocore",
+]
+
+
+[tool.tox]
+legacy_tox_ini = """
+[tox]
+env_list =
+    3.13
+    3.14
+
+[testenv]
+runner = uv-venv-lock-runner
+dependency_groups =
+    dev
+    test
+commands =
+    pytest -x src/proper tests
+"""
+
+[tool.ruff]
+line-length = 90
+indent-width = 4
+target-version = "py313"
+exclude = [
+  ".*",
+  "_build",
+  "build",
+  "covreport",
+  "dist",
+  "blueprint",
+  "src/proper/blueprints/*",
+]
+include = ["*.py"]
+
+[tool.ruff.format]
+# Like Black, use double quotes for strings.
+quote-style = "double"
+
+# Like Black, indent with spaces, rather than tabs.
+indent-style = "space"
+
+# Like Black, respect magic trailing commas.
+skip-magic-trailing-comma = false
+
+# Like Black, automatically detect the appropriate line ending.
+line-ending = "auto"
+
+# Enable auto-formatting of code examples in docstrings. Markdown,
+# reStructuredText code/literal blocks and doctests are all supported.
+#
+# This is currently disabled by default, but it is planned for this
+# to be opt-out in the future.
+docstring-code-format = false
+
+# Set the line length limit used when formatting code snippets in
+# docstrings.
+#
+# This only has an effect when the `docstring-code-format` setting is
+# enabled.
+docstring-code-line-length = "dynamic"
+
+[tool.ruff.lint]
+fixable = ["ALL"]
+
+ignore = [
+	# x is too complex
+	"C901",
+	# whitespace before ':'
+	"E203",
+	"E501",
+	# x defined from star imports
+	"F405",
+	# line break before binary operator
+	"W505",
+	"W605",
+]
+select = [
+	# bugbear
+	"B",
+	# mccabe"", comprehensions, commas
+	"C",
+	# pycodestyle errors
+	"E",
+	# pyflakes
+	"F",
+	# logging format
+	"G",
+	# imports
+	"I",
+	# quotes
+	"Q",
+	# pycodestyle warnings
+	"W",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["proper"]
+known-local-folder = ["src/proper"]
+no-lines-before = ["local-folder"]
+relative-imports-order = "furthest-to-closest"
+# Use two line after imports.
+lines-after-imports = 2

proper-0.9.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

proper-0.9.0/src/proper/__init__.py

@@ -0,0 +1,44 @@
+from . import (
+    auth,  # noqa
+    cache,  # noqa
+    concerns,  # noqa
+    constants,  # noqa
+    errors,  # noqa
+    forms,  # noqa
+    helpers,  # noqa
+    router,  # noqa
+    status,  # noqa
+    types,  # noqa
+    units,  # noqa
+)
+from .app import App  # noqa
+from .channel import Channel  # noqa
+from .concerns.concern import Concern  # noqa
+from .controller import Controller  # noqa
+from .emails import (  # noqa
+    BaseMailer,
+    EmailAlternative,
+    EmailAttachment,
+    EmailMessage,
+    EmailMessageDict,
+    SMTPMailer,
+    ToConsoleMailer,
+    ToMemoryMailer,
+)
+from .global_context import current  # noqa
+from .helpers import (  # noqa
+    DotDict,
+    JSONField,
+    MultiDict,
+    Undefined,
+    import_string,
+    make_list,
+    secure_filename,
+    show_banner,
+    show_welcome,
+)
+from .models import ProperModel, scope  # noqa
+from .request import Request  # noqa
+from .response import Response  # noqa
+from .router import Route, Router, ScopedRouter, StaticRoute  # noqa
+from .test_client import TestClient  # noqa