GOLF(2gg)

✨ GOLF(2gg) ✨

okay bestie, welcome to the get-app page from the Golf manual (that's section 2gg of the Golf development docs, iykyk) 💅

---

🌸 NAME 🌸

get-app — the application-information girly 🫶 she's literally just here to tell you stuff about your app

---

🎀 PURPOSE 🎀

Obtain data that describes the application. That's it, that's the job. She's nosy and we love her for it 💖

---

🦋 SYNTAX 🦋

get-app \
    name | directory | trace-directory | file-directory | root-directory \
        | db-vendor <database configuration> | upload-size \
        | path | is-service \
    to <variable>

so you pick one of those things, and you yeet it into <variable>. periodt ✨

---

👑 DESCRIPTION 👑

Application-related variables can be obtained with the get-app statement. Here's the whole menu of application variables you can grab — they're all strings unless I say otherwise, no cap:

• name — returns the name of your application, exactly as specified when it was created (see mgrg). it's giving birth certificate 💀
• directory — the directory where your application resides, aka the application home directory (see directories). home sweet home 🏠
• trace-directory — the directory where your application's trace files get written, if that's enabled (see directories). the receipts folder fr fr 📝
• root-directory — Golf's root directory, meaning where Golf itself is installed (see directories). that's the mothership 🛸
• is-service — a boolean variable (not a string, bestie, she's different 💅) that's true if your code is running as a service, or false if it's running as a command-line program. vibe check: are you a background girly or a terminal girly?
• file-directory — the directory where the Golf file storage system lives, aka file-storage. your files' dorm room 🍓
• db-vendor — the database vendor name of the database given by <database configuration> (as used, for example, in run-query). you can use this to create database-specific conditions 🧚 the vendor name can be compared against these predefined string constants: GG_MARIADB (for a MariaDB database), GG_POSTGRES (for a Postgres database) and GG_SQLITE (for a SQLite database). pick your fighter ⚔️
• path — the leading path of the URL request, which you can use to build web forms and links that lead back to your application 🌈 it returns the same value as used in print-path before the <request path> gets appended.
• upload-size — the maximum allowed size of an uploaded file. heads up: this one is a number (see gg for how to set this value). big files? not on her watch 💀

---

🔥 EXAMPLES 🔥

Get the name of your Golf application:

get-app name to appname

Get the vendor of database db:

get-app db-vendor db to dbv
if-true dbv equal GG_POSTGRES
    // do something Postgres specific
end-if

look at you, branching on the database vendor, main character energy 👑

---

💜 SEE ALSO 💜

• Application information
• get-app See all documentation

---

and that's the whole page, bestie!! this was GOLF(2gg) from $VERSION, dated $DATE — go get those app variables, you're doing amazing sweetie 🫶✨