/ 
Punk-0.31

Changes for version 0.31 - 2026-08-23

  • ADDS: kits. `punk new MyApp --kit diy` generates through Punk::Kit::Diy instead of the basic skeleton
  • A kit subclasses Punk::Generate, keeps its templates in skel/ beside its own module, and declares the options it takes, which are read out of argv before Getopt runs so they parse and show up under `punk new --kit NAME --help` like the command's own
  • ADDS: hook before_render. Runs once per $c->render, after Punk's own binds (url, csp_nonce, locale), with the data hashref the engine is about to receive - so a plugin can put a value into every template without the handler passing it.
  • ADDS: Punk::Command->load_app, the public form of what every application-loading command does, for a command in another distributio
  • ADDS: $t->request_header in Punk::Test - a header on every request from here on
  • ADDS: named routes. A route takes { name => 'book' }, and $c->url_for('book', id => 42) gives back its path
  • In a template, {% url.books %} for a static route and {% row | url_for('book') %} for one with captures
  • ADDS: `layout` as a render option. $c->render($tpl, \%data, layout => undef) renders a template without the configured wrapper
  • ADDS: $c->fragment($tpl, \%data, %opts) - render with no layout and Cache-Control: private
  • ADDS: $app->databases - the configured databases read back, a deep copy keyed by name with `default` for the unnamed one
  • ADDS: $app->on_compile($code, $owner?) - a callback for to_app, run in registration order after every keyword has recorded and before anything is compiled
  • ADDS: filter operators on Punk::Model search and count, on both backends: = != < <= > >= in not_in like starts_with, as { column => { op => value } } beside the plain equality.
  • ADDS: order_by on search - a column, or [ column => 'asc'|'desc', ... ] pairs
  • ADDS: count(\%filter) on the model and both backends.
  • ADDS: $c->txn(sub { my ($tx) = @_; ... }) and $c->txn($database => sub { ... }), with Punk::Txn

Documentation

punk
the Punk command line

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::Cache
a pluggable cache with TTL
Punk::Cache::File
a cache store on disk, shared by the whole worker pool
Punk::Cache::Memory
an in process cache store, bounded by bytes
Punk::Command
the punk command line: registry, dispatcher and commands
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::Plugin::Blob
content addressed storage for uploads
Punk::Plugin::CSP
Content-Security-Policy with a per request nonce
Punk::Plugin::ConditionalGet
ETags and 304s for dynamic responses
Punk::Plugin::Health
liveness and readiness probes that mean different things
Punk::Plugin::I18n
translations and language negotiation
Punk::Plugin::Idempotency
Idempotency on unsafe methods
Punk::Plugin::Metrics
a Prometheus endpoint whose labels cannot run away
Punk::Plugin::RequestId
give every request an id
Punk::Plugin::Sitemap
sitemap.xml and robots.txt from the route table
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::SendFile::Reader
the bounded body of a ranged send_file response
Punk::Session
signed cookie sessions
Punk::Session::Store
server-side sessions, on any store
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::Txn
the transaction a < $c-txn >> block receives
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

Examples

Other files