/ 
Punk-0.12

Changes for version 0.12 - 2026-08-15

  • Adds Punk::Auth. The `auth` keyword freezes the config at to_app (model, a fields map so existing schemas need no renames, session_key, roles hook, rank ladder); croaks without a session, on any unknown option, and on a roles target typo - at boot.
  • Context surface: $c->login / logout / auth_id / current_user (memoized per request, model loaded through an await seam so the blocking DBI backend and the future-returning DBIx::Loop backend both work).
  • auth_guard for `under`: the bare is-anyone-signed-in form runs entirely in C. Denial negotiates - a browser is redirected to login_path with a relative-only ?to= return-to, an API client gets the house 401 - with on_denied '403', '404' or a coderef. The roles hook may return one role, a list or an arrayref; a required role on the rank ladder means "this or better", one outside it matches exactly (a staff role next to tenant roles). Guards record what they learned in $c->stash->{auth}.
  • Bare `model;` registers everything under MyApp::Model::*

Modules

Punk
a MVC web framework
Punk::App
the per-application registry and boot compiler
Punk::Auth
the authentication battery
Punk::Auth::Password
password hashing
Punk::CORS
cross-origin resource sharing
Punk::CSRF
single-use CSRF tokens
Punk::Command
the subcommands behind the punk tool
Punk::Config
YAML configuration with secrets kept out of the file
Punk::Context
the per-request object
Punk::Controller
base class for Punk controllers
Punk::DevError
the development error page
Punk::Future
an async result that runs on the loop, or blocks
Punk::Generate
scaffold a new Punk application
Punk::Headers
security response headers
Punk::Logger
a level-based logger
Punk::Model
the storage-agnostic model tier
Punk::Model::DBI
the default DBI backend for Punk models
Punk::Model::DBIx::Loop
a non-blocking backend for Punk models
Punk::Mount::Markdown
a directory of markdown as a documentation site
Punk::Mount::OpenAPI
the api mount: spec-first operations
Punk::Plugin
base class for Punk plugins
Punk::RateLimit
rate limiting and IP blocking over Hyperman's shared arena
Punk::Request
a lazy wrapper over the PSGI environment
Punk::Response
a response builder
Punk::Router
the compiled-at-boot route tables (XS)
Punk::Router::Scope
the handle an under returns
Punk::SSE
a Server-Sent Events stream
Punk::Session
signed cookie sessions
Punk::Static
serving files from a directory
Punk::Test
an in-process test client for Punk applications
Punk::Test::WS
a pure-Perl RFC 6455 codec for testing WebSocket servers
Punk::Test::WS::Conn
the client side of one WebSocket connection
Punk::UA
the outbound HTTP agent on the context
Punk::Upload
an uploaded file from a multipart form
Punk::Validate
collecting request validation
Punk::View::Stencil
the Template::Stencil view engine
Punk::Views
the pluggable view engine registry (XS)
Punk::WebSocket
a WebSocket connection
Punk::WebSocket::Room
pub/sub groups of WebSocket connections

Provides

BenchCat
in bench/apps/cat-lib/BenchCat.pm
BenchCat::Controller::Root
in bench/apps/cat-lib/BenchCat/Controller/Root.pm
Punk::Test::_Writer
in lib/Punk/Test.pm

Examples

Other files