GOSH(1)

📦
version 0.9.15-p2+20241205 · 4 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

gosh(1) from the Gauche Commands part of the manual — bestie, come get your Scheme 💅

🎀 NAME 🎀

gosh — a Scheme script interpreter ✨

🦋 SYNOPSIS 🦋

gosh [-bhiqV] [-I path ] [-A path ] [-u module ] [-l file ] [-L file ]
[-e expr ] [-E expr ] [-m module ] [-f flag ] [-F feature ] [-p type ]
[-r standard ] [--] [ script argument ...  ]

💖 DESCRIPTION 💖

So. Gosh is a stand-alone Scheme interpreter built on top of the Gauche Scheme script engine. That's the whole vibe. 💫

When you hand it a script, gosh loads that script and evaluates the Scheme code chilling inside it. Then — plot twist — if the script defines a procedure named main, gosh calls it with a single argument: a list made of the script name plus whatever arguments came after it. When main returns an integer value, gosh exits with that as its exit code. But if main returns something non-integer, or an error gets signaled during evaluation, gosh bails out with exit code 70 (EX_SOFTWARE). 😭 See SRFI-22 (http://srfi.schemers.org/srfi-22/srfi-22.html) for the deets. And if there's no main procedure defined in the script at all? gosh just exits with code 0 after loading the script file. Periodt. 💅

If no script file is given, gosh goes into interactive mode 🧚. By default it prompts you to enter a Scheme expression, reads and evaluates it, then prints the result — and keeps doing that until EOF is read. However, if standard input is not a terminal, gosh doesn't print a prompt at all, which lets you use gosh as a filter program 🍓. You can control this behavior with the -i or -b option — see below 👇

✨ OPTIONS ✨

Command line options are processed before loading the script file or entering the interactive mode. Order matters, bestie.

The options -I, -A, -u, -l, -L, -e and -E are processed in the order of appearance. For example, adding a load path with the -I option affects the -l options after it, but not the ones before it. It's giving chronological. ⏳

  • -V — Prints the gosh version and dips. 👋
  • -b — Batch mode. Doesn't print a prompt even when standard input is a terminal. Supersedes -i. 💪
  • -h — Print the help message to stdout and exit with 0. 🫶
  • -i — Interactive mode. Forces it to print a prompt, even when standard input is not a terminal.
  • -q — Prevents reading the default initialization file. No starter pack for you. 🙈
  • -Ipath — Adds path in front of the load path list. 👑
  • -Apath — Appends path to the tail of the load path list. 🦋
  • -umodule — Loads and imports module, exactly as if (use module ) were specified in the code.
  • -lfile — Loads a Scheme file file. 📂
  • -Lfile — Like -l, but doesn't complain if file doesn't exist. So chill of her.
  • -eexpr — Evaluates a Scheme expression expr.
  • -Eexpr — Same as -e, except that expr is read as if it's surrounded by parenthesis. 🎀
  • -mmodule — When the script file is given, this option specifies the name of the module in which the main procedure is defined. The default is user. (Main character energy, obviously.)
  • -ptype — Turns on the profiler. type can be either 'time' or 'load'. 🔥
  • -rstandard — Starts gosh with the default environment defined in RnRS, where n is determined by standard. Currently, only 7 is a valid value of standard. (Only 7. That's it. That's the list.)
  • -vversion — If version is not the running Gauche's version, but the specified version is installed in the system, execute that version's gosh instead. Super useful when you want to invoke a specific version of Gauche. The version must be 0.9.6 or later. ⭐
  • -fflag — Sets various flags. 🌈
    • case-fold — use case-insensitive reader (as in R5RS)
    • load-verbose — report while loading files
    • include-verbose — report while including files
    • no-inline — don't inline primitive procedures and constants (combined no-inline-globals, no-inline-locals, no-inline-constants and no-inline-setters.)
    • no-inline-globals — don't inline global procedures.
    • no-inline-locals — don't inline local procedures.
    • no-inline-constants — don't inline constants.
    • no-inline-setters — don't inline setters.
    • no-post-inline-pass — don't run post-inline optimization pass.
    • no-lambda-lifting-pass — don't run lambda lifting optimization pass.
    • no-post-inline-pass — don't run post-inline optimization pass. (yes, she's on the list twice, that's literally what the page says, no I will not elaborate 💀)
    • no-source-info — don't retain source information.
    • read-edit — enable input editing mode, if terminal supports it.
    • no-read-edit — disable input editing mode.
    • safe-string-cursors — performs extra validation for use of string cursors.
    • warn-legacy-syntax — print warning when legacy Gauche syntax is encountered.
    • test — assume being run in the build tree; tries to load files from the current build instead of installation directories. Useful to test the build without installation. 🧪
  • -Ffeature — Makes feature available in cond-expand forms.
  • -- — Specifies that there are no more options. If there are more arguments after this, they're taken as the script file name and its arguments. 🫡

🌸 ENVIRONMENT 🌸

  • GAUCHE_LOAD_PATH — A colon separated list of the load paths. The paths are appended before the system default load paths.
  • GAUCHE_DYNLOAD_PATH — A colon separated list of the load paths for dynamically loaded objects. The paths are appended before the system default load paths.

💜 AUTHORS 💜

Shiro Kawai (shiro @ acm . org) — icon, legend, the moment. 👑

🦄 SEE ALSO 🦄

ok that's the whole page bestie, go forth and Scheme responsibly 🫶

kisses, this was page GOSH(1) from Gauche 0.9.15-p2 — mwah 💋✨

📦 where this page comes from