2024 Accomplishments

The "share" module has been moved to new repository with new name at "https://sr.ht/~shulhan/pakakeh.go". For more information see the change logs at "pakakeh.go" module.

Most of the code changes related to refactoring if-else witch switch statement.

Using string instead of [bytes.Equal] give code much more readable.

This is to make the struct is clear that it represent the document attribute.

This is to make the struct is clear that it represent the document attribute.

Using struct limit the value to only string, while some attributes can be an integer value, for example "leveloffset".

The ":leveloffset:" on document attribute allow increment or decrement the heading level on included files. Reference

Previously, an empty line before Document Title cause the parser stop parsing the document header, now an empty lines are skipped. Also document attribute can be place anywhere, either before or after title, and in between attributes; now it can be only placed after revision or author or title.

Each lines to be parsed has been trimmed on the first load, so there is no need to do it again, on some cases.

The log use the wrong variable when printing path for failed include file.

Previously, if the parent document is opened using absolute path and it contains include directive, the included file will fail to read because the parent path is joined with current working directory.

This changes the order of arguments of env-get command to pass the directory first before the key. The reason is to simplify auto-completion later from the command line. —

The "env-keys" command print list of environment variables under a directory. This command is internal, not documented, used by bash completion.

Using awwan from CLI now can automatically complete the arguments based on the command and current parameter number.

Using ".reuse/dep5" has been deprecated since REUSE v3.2.0.

The wui submodule has been renamed to "pakakeh.ts".

Previously, we use pointer to indicated that the Target can be attacked or not. Since HTTPTarget now have AllowAttack, this options can be changes to non-pointer.

Instead of function that use the signature of HTTPRequestDumper/ HTTPResponseDumper; change it to function that return HTTPRequestDumper/ HTTPResponseDumper. In this way, the documentation can show the clear relation between function and its type.

The Headers field on Target define the global headers that will be send along with all HTTPTarget or WebSocketTarget. The same header can also be defined on HTTPTarget that override the value of Target.

Previously, the default HTTPRunHandler is hidden, called dynamically based on Run is nil or not. This changes make it exported as function that return HTTPRunHandler to show how define and create a custom HTTPRunHandler.

If the navLinks fields is empty, the HTTP API will return "null" and cause the rendering error. This changes fix this issue by allocating the slice navLinks with one capabilities to make JSON always return "[]" if its empty.

This changes replace handling type for storing multipart form-data from "map[string][]byte" to [*multipart.Form] based on changes on module "pakakeh.go".

Previously, if WithRawBody is true, the Params will not be rendered and parsed during Run. This changes makes the Params works along with WithRawBody. If Params are set it will be rendered along with text area for raw body.

In the Target form, user can select to send body as "text/html".

The APIs is created using https://man.sr.ht/git.sr.ht/api.md as reference. We also needs the API to create webhook since no other way to create it in current sourcehut web.

If the user does not define the Headers, clicking Run on any HTTP Target will result in error when "save" function executed before it.

If the file in FormInput is binary, the conversion to "FormInput.value" will fail with an error like "invalid characters in String".

Using [route.String] does not works if the parameter can be empty, while [route.Path] replace all keys and return the path as is.

The task "init" include initializing git submodule, installing third party tools for linters, and installing node packages.

Instead of prompting user, make the private key static, located at "$XDG_CONFIG_DIR/gotp/gotp.key".

Even though rename does not read the encrypted secret, as long as the private key is in use, it should ask for passphrase. The remove operation allow only the one that know the private key can modify the issuer.

In the POSIX system, the correct installation for bash completion script should be /usr/share/bash-completion not under /etc directory.

If the base32 hash is in lower-case, the generate command failed to print the TOTP.

The "share" module has been moved to moved from GitHub, to sourcehut, under different name.

In JobHttp, we have "_http" suffix for its HTTP APIs. To make it consistent we changes the HTTP API path to have "_exec" suffix.

By exporting the HTTP server field, user of Karajo can register additional HTTP endpoints without creating new HTTP server instance.

This is to make the [JobBase.NextRun] always set to next interval or schedule. Fixes: https://todo.sr.ht/~shulhan/karajo/2

This is to fix karajo failed to start because the DNS has not working yet when initializing email notification.

The [ascii.Random] generate random using "crypto/rand", so no need to seed it anymore.

The "share" module repository has been moved to SourceHut, with new name "pakakeh.go".

Using 0640 (where user and group owner set to root) cause karajo service—that run as karajo user—unable to read the file.

The content of directory "/srv/karajo" may contains files served to public, even internal, so it should be accesible by other user or group.

The Version information is derived from latest tag and commit hash. This allow command "karajo version" and user interface show on which version its currently run.

Meta contains the DML meta data, including driver name, list of column names, list of column holders, and list of values. The Meta type replace the Row type.

If the tip is rebased to upstream, the author timestamp is not changes, but the commit timestamp changes.

The GenerateWithTime and GenerateNWithTime accept parameter [time.Time] as the relative time for generated password.

If the node modification time is less than requested time value in request header If-Modified-Since, server will response with 304 Not Modified.

The Head method send the HEAD request to path, with optional headers, and params in query parameters.

The Keys method return sorted list of all section, subsection, and variables as string where each of them separated by ":", for example "section:sub:var".

If [Meta.Bind] is called with the same name again, it should replace the existing named value.

The GenerateFormData generate the request body with boundary for HTTP content-type "multipart/form-data" from map[string][]byte.

The RDATA in OPT records can contains zero or more options. Previously, we only handle unpacking and packing one option, now we handle multiple options.

Using [path.Join] cause "https://domain" become "https:/domain" which is not a valid URL. This bug caused by refactoring in b89afa24f.

Using octal in mode make the embedded code more readable, for example mode with permission "0o644" much more readable than 420".

The call to get "GET <Webhook.URL.Path>/<Token>" will return HTTP status 200 with JSON body '{"code":200,"message":"OK"}'. This endpoint is to check if the bot server is really running.

Although the RFC 7231 says that no special defined meaning for a payload in GET, some implementation of HTTP API sometimes use GET with content type "application/x-www-form-urlencoded".

The CreateMultipartFileHeader help creating [multipart.FileHeader] from raw bytes, that can be assigned to [*multipart.Form].

The RequestTypeHTML define the content type "text/html".

Unlike String method that may return the key’s name in returned path, the Path method return the path with all the keys has been substituted with values, even if its empty.

In [MemFS.refresh], if the requested url is "/file1" and [Options.Root] is ".", the path during refresh become "file1" and if passed to [filepath.Dir] it will return ".". This cause the loop on refresh never end because there is no PathNodes equal with ".".

The emaildecode accept file as input. If the email header contains content-transfer-encoding with value quoted-printable or base64, it will decode the message body and print it to stdout as plain text.

In previous commit we use wrong condition when handling directory "." as Root.

Although, a message from network must end with CRLF, a message from (another) client may have been sanitized and end with LF only.

After the header and body has been parsed, if the header contains Content-Transfer-Encoding, we decode the body into its local formats. Currently supported encoding is "quoted-printable" and "base64".

By exporting the fields, this allow the caller to filter or manage the field manually.

The RFC 2183 is define Content-Disposition header field in the internet message.

Due to "byte" is considered as "uint8" during reflection, we cannot tell whether the value is slice of byte of slice of number with type uint8.

To make it consistent with RequestTypeNone, the ResponseTypeNone should not write any response header or HTTP status code. It will be handled manually by [Endpoint.Call].

Package play provides callable APIs and HTTP handlers to format and run Go code, similar to Go playground, but using HTTP instead of WebSocket.

The AppendInt64 append an int64 value into slice of byte. The AppendUint64 append an uint64 value into slice of byte.

The idea is to allow testing Go code on specific Go version. For example, before Go 1.22, the for loop with variable is shared among block statements, which cause every use of that variable is run with the last value.

By exposing the Timeout, user can set their maximum time the program can run in their playground.

In the "lib/bytes" we split the hexdump related functions to separate package, "lib/hexdump".

This package has been removed, merged into "slices" package.

Running "rescached version" now will print the program version.

The latest update on "lib/dns" package support RFC 9460, SVCB record (type 64) and HTTPS record (type 65).

The module "share" has been moved to new repository at SourceHut and we rename it to make it more unique instead of common English words "share".

The new repository and project page for rescached is at https://sr.ht/~shulhan/rescached .