GOLF(2gg)

NAME
get-app - (application-information)

PURPOSE
Obtain data that describes the application.

SYNTAX

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

DESCRIPTION
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).

    • "trace-directory" is the directory where your application trace files are written, if enabled (see directories).

    • "root-directory" is the Golf's root directory (i.e. where Golf is installed, see directories).

    • "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.

    • "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

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

SEE ALSO
 Application information

get-app See all documentation