/ 
Punk-0.49

Changes for version 0.49 - 2026-09-11

  • ADDS: i18n catalogues are held in a Frozen block instead of an arena built here. The block holds a tree, so a level and a leaf are different nodes.
  • FIXES: a literal key containing a dot and the nested form it looks like were the same key, and which one answered was decided by the hash order of the process that loaded it. Two workers in one pool could serve different translations for the same key. A dotted key is now a boot error.
  • FIXES: a catalogue value that is not text no longer renders as the key. null, an array and a boolean are boot errors naming the path; numbers are stored as their digits and read back unchanged.
  • FIXES: UTF-8 is preserved through interpolation. A substituted value was appended as raw bytes into a string that was then flagged UTF-8, so a non-ASCII entry plus a downgraded substitution produced malformed output. Reachable from a form field.
  • FIXES: a catalogue from any producer keeps its encoding. Only the JSON path was correct before, and only because that decoder happens to decode to UTF-8.
  • FIXES: the documentation described a language-switcher cookie that was never implemented. Punk reads punk.lang and has never written it; the POD now says so and shows the handler that does.
  • ADDS: the locale hash can be iterated. keys, each and scalar used to die. The order is the same in every process.
  • BREAKING: _build takes catalogues that have been through Frozen's builder; a catalogue key may not contain a dot; a catalogue value must be text.
  • Requires Frozen 0.06.

Documentation

punk
the Punk command line

Modules

Punk
a MVC web framework
Punk::App
the per-application registry and boot compiler
Punk::AsyncAwait
async and await in Punk apps, controllers and models
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, Last-Modified 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::Stream
a streamed response for an ordinary route
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