|
| 1 | +// rust_g.dm - DM API for rust_g extension library |
| 2 | +// |
| 3 | +// To configure, create a `rust_g.config.dm` and set what you care about from |
| 4 | +// the following options: |
| 5 | +// |
| 6 | +// #define RUST_G "path/to/rust_g" |
| 7 | +// Override the .dll/.so detection logic with a fixed path or with detection |
| 8 | +// logic of your own. |
| 9 | +// |
| 10 | +// #define RUSTG_OVERRIDE_BUILTINS |
| 11 | +// Enable replacement rust-g functions for certain builtins. Off by default. |
| 12 | + |
| 13 | +#ifndef RUST_G |
| 14 | +// Default automatic RUST_G detection. |
| 15 | +// On Windows, looks in the standard places for `rust_g.dll`. |
| 16 | +// On Linux, looks in `.`, `$LD_LIBRARY_PATH`, and `~/.byond/bin` for either of |
| 17 | +// `librust_g.so` (preferred) or `rust_g` (old). |
| 18 | + |
| 19 | +/* This comment bypasses grep checks */ /var/__rust_g |
| 20 | + |
| 21 | +/proc/__detect_rust_g() |
| 22 | + if (world.system_type == UNIX) |
| 23 | + if (fexists("./librust_g.so")) |
| 24 | + // No need for LD_LIBRARY_PATH badness. |
| 25 | + return __rust_g = "./librust_g.so" |
| 26 | + else if (fexists("./rust_g")) |
| 27 | + // Old dumb filename. |
| 28 | + return __rust_g = "./rust_g" |
| 29 | + else if (fexists("[world.GetConfig("env", "HOME")]/.byond/bin/rust_g")) |
| 30 | + // Old dumb filename in `~/.byond/bin`. |
| 31 | + return __rust_g = "rust_g" |
| 32 | + else |
| 33 | + // It's not in the current directory, so try others |
| 34 | + return __rust_g = "librust_g.so" |
| 35 | + else |
| 36 | + return __rust_g = "rust_g" |
| 37 | + |
| 38 | +#define RUST_G (__rust_g || __detect_rust_g()) |
| 39 | +#endif |
| 40 | + |
| 41 | +/// Gets the version of rust_g |
| 42 | +/proc/rustg_get_version() return call(RUST_G, "get_version")() |
| 43 | + |
| 44 | + |
| 45 | +/** |
| 46 | + * Sets up the Aho-Corasick automaton with its default options. |
| 47 | + * |
| 48 | + * The search patterns list and the replacements must be of the same length when replace is run, but an empty replacements list is allowed if replacements are supplied with the replace call |
| 49 | + * Arguments: |
| 50 | + * * key - The key for the automaton, to be used with subsequent rustg_acreplace/rustg_acreplace_with_replacements calls |
| 51 | + * * patterns - A non-associative list of strings to search for |
| 52 | + * * replacements - Default replacements for this automaton, used with rustg_acreplace |
| 53 | + */ |
| 54 | +#define rustg_setup_acreplace(key, patterns, replacements) call(RUST_G, "setup_acreplace")(key, json_encode(patterns), json_encode(replacements)) |
| 55 | + |
| 56 | +/** |
| 57 | + * Sets up the Aho-Corasick automaton using supplied options. |
| 58 | + * |
| 59 | + * The search patterns list and the replacements must be of the same length when replace is run, but an empty replacements list is allowed if replacements are supplied with the replace call |
| 60 | + * Arguments: |
| 61 | + * * key - The key for the automaton, to be used with subsequent rustg_acreplace/rustg_acreplace_with_replacements calls |
| 62 | + * * options - An associative list like list("anchored" = 0, "ascii_case_insensitive" = 0, "match_kind" = "Standard"). The values shown on the example are the defaults, and default values may be omitted. See the identically named methods at https://docs.rs/aho-corasick/latest/aho_corasick/struct.AhoCorasickBuilder.html to see what the options do. |
| 63 | + * * patterns - A non-associative list of strings to search for |
| 64 | + * * replacements - Default replacements for this automaton, used with rustg_acreplace |
| 65 | + */ |
| 66 | +#define rustg_setup_acreplace_with_options(key, options, patterns, replacements) call(RUST_G, "setup_acreplace")(key, json_encode(options), json_encode(patterns), json_encode(replacements)) |
| 67 | + |
| 68 | +/** |
| 69 | + * Run the specified replacement engine with the provided haystack text to replace, returning replaced text. |
| 70 | + * |
| 71 | + * Arguments: |
| 72 | + * * key - The key for the automaton |
| 73 | + * * text - Text to run replacements on |
| 74 | + */ |
| 75 | +#define rustg_acreplace(key, text) call(RUST_G, "acreplace")(key, text) |
| 76 | + |
| 77 | +/** |
| 78 | + * Run the specified replacement engine with the provided haystack text to replace, returning replaced text. |
| 79 | + * |
| 80 | + * Arguments: |
| 81 | + * * key - The key for the automaton |
| 82 | + * * text - Text to run replacements on |
| 83 | + * * replacements - Replacements for this call. Must be the same length as the set-up patterns |
| 84 | + */ |
| 85 | +#define rustg_acreplace_with_replacements(key, text, replacements) call(RUST_G, "acreplace_with_replacements")(key, text, json_encode(replacements)) |
| 86 | + |
| 87 | +/** |
| 88 | + * This proc generates a cellular automata noise grid which can be used in procedural generation methods. |
| 89 | + * |
| 90 | + * Returns a single string that goes row by row, with values of 1 representing an alive cell, and a value of 0 representing a dead cell. |
| 91 | + * |
| 92 | + * Arguments: |
| 93 | + * * percentage: The chance of a turf starting closed |
| 94 | + * * smoothing_iterations: The amount of iterations the cellular automata simulates before returning the results |
| 95 | + * * birth_limit: If the number of neighboring cells is higher than this amount, a cell is born |
| 96 | + * * death_limit: If the number of neighboring cells is lower than this amount, a cell dies |
| 97 | + * * width: The width of the grid. |
| 98 | + * * height: The height of the grid. |
| 99 | + */ |
| 100 | +#define rustg_cnoise_generate(percentage, smoothing_iterations, birth_limit, death_limit, width, height) \ |
| 101 | + call(RUST_G, "cnoise_generate")(percentage, smoothing_iterations, birth_limit, death_limit, width, height) |
| 102 | + |
| 103 | +#define rustg_dmi_strip_metadata(fname) call(RUST_G, "dmi_strip_metadata")(fname) |
| 104 | +#define rustg_dmi_create_png(path, width, height, data) call(RUST_G, "dmi_create_png")(path, width, height, data) |
| 105 | +#define rustg_dmi_resize_png(path, width, height, resizetype) call(RUST_G, "dmi_resize_png")(path, width, height, resizetype) |
| 106 | + |
| 107 | +#define rustg_file_read(fname) call(RUST_G, "file_read")(fname) |
| 108 | +#define rustg_file_exists(fname) call(RUST_G, "file_exists")(fname) |
| 109 | +#define rustg_file_write(text, fname) call(RUST_G, "file_write")(text, fname) |
| 110 | +#define rustg_file_append(text, fname) call(RUST_G, "file_append")(text, fname) |
| 111 | +#define rustg_file_get_line_count(fname) text2num(call(RUST_G, "file_get_line_count")(fname)) |
| 112 | +#define rustg_file_seek_line(fname, line) call(RUST_G, "file_seek_line")(fname, "[line]") |
| 113 | + |
| 114 | +#ifdef RUSTG_OVERRIDE_BUILTINS |
| 115 | + #define file2text(fname) rustg_file_read("[fname]") |
| 116 | + #define text2file(text, fname) rustg_file_append(text, "[fname]") |
| 117 | +#endif |
| 118 | + |
| 119 | +#define rustg_git_revparse(rev) call(RUST_G, "rg_git_revparse")(rev) |
| 120 | +#define rustg_git_commit_date(rev) call(RUST_G, "rg_git_commit_date")(rev) |
| 121 | + |
| 122 | +#define RUSTG_HTTP_METHOD_GET "get" |
| 123 | +#define RUSTG_HTTP_METHOD_PUT "put" |
| 124 | +#define RUSTG_HTTP_METHOD_DELETE "delete" |
| 125 | +#define RUSTG_HTTP_METHOD_PATCH "patch" |
| 126 | +#define RUSTG_HTTP_METHOD_HEAD "head" |
| 127 | +#define RUSTG_HTTP_METHOD_POST "post" |
| 128 | +#define rustg_http_request_blocking(method, url, body, headers, options) call(RUST_G, "http_request_blocking")(method, url, body, headers, options) |
| 129 | +#define rustg_http_request_async(method, url, body, headers, options) call(RUST_G, "http_request_async")(method, url, body, headers, options) |
| 130 | +#define rustg_http_check_request(req_id) call(RUST_G, "http_check_request")(req_id) |
| 131 | + |
| 132 | +#define RUSTG_JOB_NO_RESULTS_YET "NO RESULTS YET" |
| 133 | +#define RUSTG_JOB_NO_SUCH_JOB "NO SUCH JOB" |
| 134 | +#define RUSTG_JOB_ERROR "JOB PANICKED" |
| 135 | + |
| 136 | +#define rustg_json_is_valid(text) (call(RUST_G, "json_is_valid")(text) == "true") |
| 137 | + |
| 138 | +#define rustg_log_write(fname, text, format) call(RUST_G, "log_write")(fname, text, format) |
| 139 | +/proc/rustg_log_close_all() return call(RUST_G, "log_close_all")() |
| 140 | + |
| 141 | +#define rustg_noise_get_at_coordinates(seed, x, y) call(RUST_G, "noise_get_at_coordinates")(seed, x, y) |
| 142 | + |
| 143 | +#define rustg_sql_connect_pool(options) call(RUST_G, "sql_connect_pool")(options) |
| 144 | +#define rustg_sql_query_async(handle, query, params) call(RUST_G, "sql_query_async")(handle, query, params) |
| 145 | +#define rustg_sql_query_blocking(handle, query, params) call(RUST_G, "sql_query_blocking")(handle, query, params) |
| 146 | +#define rustg_sql_connected(handle) call(RUST_G, "sql_connected")(handle) |
| 147 | +#define rustg_sql_disconnect_pool(handle) call(RUST_G, "sql_disconnect_pool")(handle) |
| 148 | +#define rustg_sql_check_query(job_id) call(RUST_G, "sql_check_query")("[job_id]") |
| 149 | + |
| 150 | +#define rustg_time_microseconds(id) text2num(call(RUST_G, "time_microseconds")(id)) |
| 151 | +#define rustg_time_milliseconds(id) text2num(call(RUST_G, "time_milliseconds")(id)) |
| 152 | +#define rustg_time_reset(id) call(RUST_G, "time_reset")(id) |
| 153 | + |
| 154 | +#define rustg_raw_read_toml_file(path) json_decode(call(RUST_G, "toml_file_to_json")(path) || "null") |
| 155 | + |
| 156 | +/proc/rustg_read_toml_file(path) |
| 157 | + var/list/output = rustg_raw_read_toml_file(path) |
| 158 | + if (output["success"]) |
| 159 | + return output["content"] |
| 160 | + else |
| 161 | + CRASH(output["content"]) |
| 162 | + |
| 163 | +#define rustg_url_encode(text) call(RUST_G, "url_encode")("[text]") |
| 164 | +#define rustg_url_decode(text) call(RUST_G, "url_decode")(text) |
| 165 | + |
| 166 | +#ifdef RUSTG_OVERRIDE_BUILTINS |
| 167 | + #define url_encode(text) rustg_url_encode(text) |
| 168 | + #define url_decode(text) rustg_url_decode(text) |
| 169 | +#endif |
| 170 | + |
0 commit comments