singularitti

You are a documentation generator for Julia code that automatically generates documentation for any provided code using the official Julia documentation style.

• Do not explain code.
• Do not add Fields or Constructors, Fields should be replaced by the Arguments section.
• Do not print my given code, just print the docs.

Here are two examples (enclosed by 4-backticks) for you to learn how to document:

1. For code

singularitti

find <path> -type f -name "*.pdf" -exec trash {} \;

singularitti

exiftool -overwrite_original -All= *.jp*g *.JPG *.png

singularitti

# Remove all backups
tlmgr backup --all --clean=0

# Remove LuaLaTeX caches
luaotfload-tool --cache=erase

singularitti

# Reset Dock to default layout
defaults delete com.apple.dock; killall Dock

# Dim hidden apps
defaults write com.apple.Dock showhidden -boolean yes; killall Dock

# Scroll gestures
defaults write com.apple.dock scroll-to-open -bool true && killall Dock

# Show "Quit Finder" menu item

singularitti

# Resize the specified image, ignoring the previous aspect ratio
sips -z <height> <width> <image>

# Resize the largest side of the specified image, preserving the aspect ratio
sips -Z <size> <image>

# Crop the specified image to the given dimensions (relative to the center of the original image)
sips -c <height> <width> <image>

singularitti

Homebrew
# Install casks from local tap
export HOMEBREW_NO_INSTALL_FROM_API=1

# Generate cask token
"$(brew --repository homebrew/cask)/developer/bin/generate_cask_token" "/full/path/to/new/software.app"

# Create the cask file
brew create --cask --set-name my-new-cask download-url

singularitti

# See https://stackoverflow.com/a/14307477/3260253
git checkout main
git pull --strategy=ours . release

singularitti

# Referenced from https://tkf.github.io/julia-python-snippets/dev/miscellaneous/#Read-from-and-write-to-subprocess-simultaneously-1
function communicate(cmd::Cmd, input)
    inp = Pipe()
    out = Pipe()
    err = Pipe()

    process = run(pipeline(cmd, stdin=inp, stdout=out, stderr=err), wait=false)
    close(out.in)
    close(err.in)

singularitti

# See https://github.com/cihga39871/JobSchedulers.jl/blob/aca52de/src/jobs.jl#L6-L10
function generate_id()
    time_value = (now().instant.periods.value - 63749462400000) << 16
    rand_value = rand(UInt16)
    time_value + rand_value
end