Official Golf Blog: programming language, framework and application server
Linux fragmentation (meaning many distros out there), while positive in some ways (spurring innovation, customization and freedom of choice), makes it more difficult to properly address diverging packaging methods between them. There are services online that make it possible to manage packaging for Linux, and some are quite easy, while some are (incredibly) difficult to use.
What's in packaging? For one, the list of third party packages that your package depends on.
mkdir test-list cd test-list/Copied!
gg -k list-app
Copied!
begin-handler /list silent-header // Create a list new-fifo mylist // Add data to the list write-fifo mylist key "key1" value "value1" write-fifo mylist key "key2" value "value2" start-loop // Get data from the list read-fifo mylist key k value v status st // Check if no more data if-true st not-equal GG_OKAY break-loop end-if @Obtained key <<p-out k>> with value <<p-out v>> end-loop // Go through the list again, use rewind-fifo for that rewind-fifo mylist start-loop read-fifo mylist key k value v status st if-true st not-equal GG_OKAY break-loop end-if @Again obtained key <<p-out k>> with value <<p-out v>> end-loop // Delete FIFO list purge-fifo mylist end-handlerCopied!
gg -q --debugCopied!
gg -k split
Copied!
begin-handler /parse silent-header set-string str = "a=1&b=2&c=3" // Split string using "&" as a delimiter split-string str with "&" to pair count pair_tot start-loop repeat pair_tot use pair_count read-split pair_count from pair to item // Now split each item using "=" as a delimiter split-string item with "=" to equal read-split 1 from equal to name read-split 2 from equal to value // Output each name/value pf-out "Name [%s] value [%s]\n", name, value end-loop end-handlerCopied!
gg -q --public --debugCopied!
By default, maximum file size you can upload to Golf application server is about 25MB. You can change that by using "--maxupload" option in gg command line utility when you build your application:
gg -q --maxupload=100000000
In this case, maximum size of an uploaded file is about 100MB.
In order to know in your application (at run-time) what is this limit, use get-app:
get-app upload-size to up_size
pf-out "Upload size is %ld\n", up_size
For an example of uploading files, see file manager example.
To get Golf version, use "-v" flag to gg utility:
gg -v
It might produce something like this, showing Golf version (in this case 285) and Operating System version it's running on (in this case Ubuntu 24):
Golf 285 on ubuntu (24)
...
mkdir -p c-for-web cd c-for-webCopied!
gg -k fact
Copied!
extended-mode // extended mode in order to call C code %% /calc-fact public get-param par // get input parameter from URL string-number par to num // convert to number set-number result call-extended factorial(num, &result) // call C function // Output result @Factorial of <<p-out par>> is <<p-num result>> %%Copied!
#include "golf.h" // Compute factorial of f, and store result into res void factorial(gg_num f, gg_num *res) { *res = 1; gg_num i; for (i = 2; i <= f; i++) { *res *= i; } }Copied!
To create a Golf installation package for Fedora or RedHat (or similar based on those, like Rocky), you need to get Golf RPM spec file.
For Redhat/Rocky/etc. install EPEL:
sudo dnf install epel-release
Next, install rpm-build package:
sudo dnf install rpm-build
If you'd like to create a Golf installation package for Ubuntu or Debian (or similar based on those), first get Golf source code. To do that, install git first:
sudo apt update
sudo apt install git
Then get Golf source code:
git clone https://github.com/golf-lang/golf.git
cd golf
Before you can create a package, you must first install Debian tools:
sudo apt update
sudo apt -y install devscripts equivs build-essential lintian
Next,
mkdir -p srv-example cd srv-example mkdir -p clientCopied!
begin-handler /srv public silent-header @Hello world! end-handlerCopied!
gg -k hello
Copied!
gg -q --exclude-dir=clientCopied!
mgrg -w 1 helloCopied!
cd client
Copied!
#include "gcli.h" int golf_client (gg_cli *req, char *connection, char *method, char *app_path, char *request, char *url_params); int golf_client (gg_cli *req, char *connection, char *method, char *app_path, char *request, char *url_params) { memset ((char*)req, 0, sizeof(gg_cli)); req->server = connection; req->req_method = method; req->app_path = app_path; req->req = request; req->url_params = url_params; return gg_cli_request (req); } void main () { int i; for (i = 0; i < 1000000; i++) { gg_cli req; int res = golf_client (&req, "/var/lib/gg/hello/sock/sock", "GET", "/hello", "/srv", "/"); if (res != GG_OKAY) printf("Request failed [%d] [%s]\n", res, req.errm); else printf("%s", gg_cli_data(&req)); gg_cli_delete(&req); } }Copied!
gcc -o cli cli.c $(gg -i) -O3Copied!
./cliCopied!
mkdir -p c-api cd c-apiCopied!
begin-handler /srv public silent-header do-once new-tree ind process-scope end-do-once get-param op get-param key get-param data if-true op equal "add" write-tree ind key (key) value data status st if-true st equal GG_ERR_EXIST @Key exists [<<p-out key>>] else-if @Added [<<p-out key>>] end-if else-if op equal "delete" delete-tree ind key (key) value val status st if-true st equal GG_ERR_EXIST @Not found [<<p-out key>>] else-if @Deleted, old value was [<<p-out val>>] end-if else-if op equal "query" read-tree ind equal (key) value val status st if-true st equal GG_ERR_EXIST @Not found, queried [<<p-out key>>] else-if @Value [<<p-out val>>] end-if end-if end-handlerCopied!
Golf's AUR page is https://aur.archlinux.org/packages/golf
You can build a pacman package from it, and install Golf from that package (on this or other machines):
You can install Golf from precompiled binaries provided by Launchpad which is Ubuntu service that builds Golf directly from its github source code repo.
You would add Golf repo:
sudo add-apt-repository ppa:golf-lang/golf sudo apt update
And then install Golf with:
sudo apt install golf
You can then manage the package using standard Ubuntu apt tools.
mkdir -p mail cd mailCopied!
gg -k mail-sender
Copied!
begin-handler /mail public // Get URL parameter get-param action if-true action equal "show_form" // Display HTML form @<h2>Enter email and click Send to send it</h2> @Note: 'From' field must be the email address from the domain of your server.<br/><br/> @<form action="<<p-path "/mail">>" method="POST"> @ <input type="hidden" name="action" value="submit_form"> @ <label for="from_mail">From:</label><br> @ <input type="text" name="from_mail" value=""><br> @ <label for="to_mail">To:</label><br> @ <input type="text" name="to_mail" value=""><br><br> @ <label for="subject_mail">Subject:</label><br> @ <input type="text" name="subject_mail" value=""><br><br> @ <label for="message">Message:</label><br> @ <textarea name="message" rows="3" columns="50"></textarea> @ <br/><br/> @ <input type="submit" value="Send"> @</form> else-if action equal "submit_form" // Get data from HTML form get-param from_mail get-param to_mail get-param message get-param subject_mail // Construct email message write-string msg @From: <<p-out from_mail>> @To: <<p-out to_mail>> @Subject: <<p-out subject_mail>> @ <<p-out message>> end-write-string // Send email exec-program "/usr/sbin/sendmail" args "-i", "-t" input msg status st // Check status of email sending if-true st not-equal GG_OKAY @Could not send email! else-if @Email sent! end-if @<hr/> else-if @Unrecognized action!<hr/> end-if end-handlerCopied!
mkdir -p json cd jsonCopied!
{ "country": [
{
"name": "USA",
"state": [
{
"name": "Arizona",
"city": [
{
"name" : "Phoenix",
"population": 5000000
} ,
{
"name" : "Tuscon",
"population": 1000000
}
]
} ,
{
"name": "California",
"city": [
{
"name" : "Los Angeles",
"population": 19000000
},
{
"name" : "Irvine"
}
]
}
]
} ,
{
"name": "Mexico",
"state": [
{
"name": "Veracruz",
"city": [
{
"name" : "Xalapa-EnrÃquez",
"population": 8000000
},
{
"name" : "C\u00F3rdoba",
"population": 220000
}
]
} ,
{
"name": "Sinaloa",
"city": [
{
"name" : "Culiac\u00E1n Rosales",
"population": 3000000
}
]
}
]
}
]
}
Copied!
begin-handler /parse-json public // Read the JSON file read-file "countries.json" to countries status st if-true st lesser-equal 0 @Cannot read file or file empty exit-handler -1 end-if // Parse JSON json-doc countries no-enum status st error-text et error-position ep to json // Check for errors in JSON document if-true st not-equal GG_OKAY @Error [<<p-out et>>] at [<<p-num ep>>] exit-handler -2 end-if // This is the JSON element we're looking for set-string city_name unquoted ="country"."state"."city"."name" // Read elements one by one - note you can then store them in a tree or hash for future fast searches start-loop // Read just a key read-json json key k type t // Exit if end of document if-true t equal GG_JSON_TYPE_NONE break-loop end-if // If matches key we're looking for, get the value, and output it if-true city_name equal k read-json json value v @Value [<<p-out v>>] @-------- end-if // Move on to the next JSON element read-json json next end-loop // Optionally delete JSON object, or it will be automatically deleted json-doc delete json end-handlerCopied!
mkdir enc_example cd enc_example gg -k encCopied!
begin-handler /encrypt public set-string str = "This contains a secret code, which is Open Sesame!" // Encrypt encrypt-data str to enc_str password "my_password" p-out enc_str @ // Decrypt decrypt-data enc_str password "my_password" to dec_str p-out dec_str @ end-handlerCopied!