Get app

Purpose: Obtain data that describes the application.

get-app \
        name | directory | file-directory |
        ( user-directory [ user <user> ] ) | \
        ( socket-file [ user <user> ] [ application <app> ] ) \
        | db-vendor <database configuration> | upload-size \
        | path | is-service | stack-depth \
    to <variable>

Copied!

Application-related variables can be obtained with get-app statement. The following application variables can be obtained (they are all strings unless indicated otherwise):

"name" returns the name of your application, as specified when created (see mgrg).
"directory" is the directory where your application resides, i.e. the application home directory (see directories).
"user-directory" is the user directory, i.e a directory that houses all applications that belong to the user (see directories). If "user" is not given, then user is the current Operating system user; otherwise user is <user>.
"socket-file" is the socket-file used to communicate with an application (see new-remote, ggcli, Client-API). If neither "user" nor "application" subclauses are given, then user is current Operating system user and application is the currently running application. If "user" subclause is given, then user is <user>. If "application" subclause is specified, then application is <application>.
"is-service" is a boolean variable that is true if your code is running as a service, or false if it is running as a command-line program.
"file-directory" is the directory where Golf file storage system is, i.e. file-storage.
"db-vendor" is the database vendor name of database given by <database configuration> (as used for example in run-query). You can use it to create database specific conditions. The database vendor name can be compared against predefined string constants GG_MARIADB (for MariaDB database), GG_POSTGRES (for Postgres database) and GG_SQLITE (for SQLite database).
"path" is the leading path of the URL request that can be used to build web forms and links leading back to your application. It returns the same value as used in print-path before <request path> is appended.
"stack-depth" is the maximum allowed stack depth for calling handlers, including recursion.
"upload-size" is the maximum allowed size of an uploaded file - this is a number (see gg for setting this value).

Examples

Get the name of Golf application:

get-app name to appname

Copied!

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

Copied!