Poet::...iguring(3pm)

✨ NAME ✨

Poet::Manual::Configuring — it's the built-in Poet configuration options, bestie 💅 and yes she's a 3pm Perl manual page, we love that for her

---

🎀 DESCRIPTION 🎀

Okay so listen. This is literally the list of configuration keys that Poet itself uses. You can drop these into any Poet conf file, like local.cfg or conf/global/*.cfg. Any of them. She's flexible like that 💖

Entries like foo.bar can be written either in dot notation:

foo.bar: 5

or as part of a hash:

foo:
   bar: 5

See Dot notation for details. (iykyk 🦋)

---

🌸 The Keys, The Icons, The Moment 🌸

• cache — the entire hash under this entry gets passed straight to Poet::Cache->config(). See Poet::Cache for examples, because bestie there are so many examples. e.g.

cache:
   defaults:
      expires_variance: 0.2
   storage:
      file:
         driver: File
         root_dir: ${root}/data/cache
      memcached:
         driver: Memcached
         servers: ["10.0.0.15:11211", "10.0.0.15:11212"]
         compress_threshold: 4096
   namespace:
      /some/component:       { storage: file, expires_in: 5min }
      /some/other/component: { storage: memcached, expires_in: 1h }
      Some::Library:         { storage: memcached, expires_in: 10min }

• env.bin_dir, env.comps_dir, etc. — these entries change what comes back from $poet->bin_dir, $poet->bin_path, $poet->comps_dir, etc., which lowkey means they control where all your various Poet resources live. See Poet::Environment. For example, if you wanna move data and logs into external directories outside the environment:

env:
  data_dir: /some/external/data/dir
  logs_dir: /some/external/logs/dir

• log.defaults, log.category — these set the log level, the output location, and the layout string for logging — in the default case and for particular categories respectively. See Poet::Log for examples. e.g.

log:
  defaults:
    level: info
    output: poet.log
    layout: "%d{dd/MMM/yyyy:HH:mm:ss.SS} [%p] %c - %m - %F:%L - %P%n"
  class:
    CHI:
      level: debug
      output: chi.log
      layout: "%d{dd/MMM/yyyy:HH:mm:ss.SS} %m - %P%n"
    MyApp::Foo:
      output: stdout

• log.log4perl_conf — this one lets you bypass Poet's simplified logging configuration entirely and point at a log4perl conf file directly. e.g.

log:
  log4perl_conf: /path/to/log4perl.conf

• mason — the hash under this entry gets treated as options passed to Mason->new for the main Mason instance, overriding any default options. See Poet::Mason. e.g.

mason:
  static_source: 1
  static_source_touch_file: ${root}/data/purge.dat

• server.default_content_type — the content type for requests that don't explicitly set one. Defaults to text/html. Simple, iconic, does her job 👑
• server.host — the IP address to listen on.
• server.load_modules — a list of modules to load on server startup, e.g.

server.load_modules:
   - DBI
   - List::Util
   - MyApp::Foo
   - MyApp::Bar

• server.port — the port to listen on. That's it, that's the whole vibe ✨

---

🦋 SEE ALSO 🦋

• Poet — go read her, she's the moment 💜

---

👑 AUTHOR 👑

Jonathan Swartz <swartz@pobox.com> — king behavior, fr fr 🫶

---

💖 COPYRIGHT AND LICENSE 💖

This software is copyright (c) 2012 by Jonathan Swartz.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. Slay, legally speaking 🌈

---

and that's the whole page bestie, no cap 💅 this was perl v5.34.0 energy, dated 2022-06-18, and yeah the man page title is literally Poet::...iguring(3pm) because apparently nobody had the range to spell it out. iconic. mwah 🎀✨