Cataly...Create(3pm)

💖 Cataly...Create(3pm) — the manual page, but make it cute 💖

okay bestie, pull up a chair, we're reading the Catalyst::Script::Create manpage together and honestly? it's giving scaffolding era. this is the little script that spins up brand new Catalyst Components for u. let's go 🎀

---

✨ NAME ✨

Catalyst::Script::Create — Create a new Catalyst Component 💅

---

🌸 SYNOPSIS 🌸

here's the whole vibe, verbatim, no cap:

myapp_create.pl [options] model|view|controller name [helper] [options]

Options:
  --force        don't create a .new file where a file to be created exists
  --mechanize    use Test::WWW::Mechanize::Catalyst for tests if available
  --help         display this help and exits

Examples:
  myapp_create.pl controller My::Controller
  myapp_create.pl controller My::Controller BindLex
  myapp_create.pl --mechanize controller My::Controller
  myapp_create.pl view My::View
  myapp_create.pl view MyView TT
  myapp_create.pl view TT TT
  myapp_create.pl model My::Model
  myapp_create.pl model SomeDB DBIC::Schema MyApp::Schema create=dynamic\
  dbi:SQLite:/tmp/my.db
  myapp_create.pl model AnotherDB DBIC::Schema MyApp::Schema create=static\
  dbi:Pg:dbname=foo root 4321

See also:
  perldoc Catalyst::Manual
  perldoc Catalyst::Manual::Intro

so like, u pass it one of model, view, or controller, then a name, and optionally a helper, and optionally more options. that's the whole recipe 🍓

the options, one by one 🫶

• --force — don't create a .new file where a file to be created exists. basically: "bestie i KNOW it's there, overwrite it anyway." 🔥
• --mechanize — use Test::WWW::Mechanize::Catalyst for tests, but only if it's available. conditional queen ✨
• --help — display this help and exits. classic. the "what does this even do" button 💀

examples that ate 💅

okay these are literally the ones from above but let's appreciate them:

• myapp_create.pl controller My::Controller — make a controller, iconic
• myapp_create.pl controller My::Controller BindLex — controller + the BindLex helper
• myapp_create.pl --mechanize controller My::Controller — controller with mechanize tests
• myapp_create.pl view My::View — a view, default flavor
• myapp_create.pl view MyView TT — view named MyView using the TT helper
• myapp_create.pl view TT TT — yes it's TT TT, no i will not explain, it just is
• myapp_create.pl model My::Model — model time
• myapp_create.pl model SomeDB DBIC::Schema MyApp::Schema create=dynamic\ + dbi:SQLite:/tmp/my.db — a DBIC::Schema model, create=dynamic, pointed at SQLite 🦋
• myapp_create.pl model AnotherDB DBIC::Schema MyApp::Schema create=static\ + dbi:Pg:dbname=foo root 4321 — same energy, create=static, Postgres this time, user root, password 4321

see also 👀

• perldoc Catalyst::Manual
• perldoc Catalyst::Manual::Intro

iykyk, go read those next.

---

💜 DESCRIPTION 💜

Create a new Catalyst Component. periodt. ✨

here's the part u NEED to hear though: existing component files are not overwritten. if any of the component files it's about to create already exist, the file gets written with a .new suffix instead. so nothing gets clobbered behind ur back, she's polite like that 🎀

and if u want it to stop being polite? that behavior can be suppressed with the --force option. then it's main character energy and it just goes 💅

ngl this is the safety net. .new files mean u get to diff and decide. --force means u already decided. choose wisely bestie 🫶

---

🦋 SEE ALSO 🦋

• Catalyst::ScriptRunner

---

👑 AUTHORS 👑

Catalyst Contributors, see Catalyst.pm.

---

🌈 COPYRIGHT 🌈

This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's the whole page, bestie!! 🌸 this doc came from the perl v5.40.0 era, dated 2024-11-15, and it's the Cataly...Create(3pm) page from the User Contributed Perl Documentation — go forth and scaffold something slay 💖✨🎀