Useful Tools
This page lists a number of tools (simple programs) that are particularly useful to run as external commands from Anvil. Some are specifically written to use the Anvil API.
C Development
This section lists tools useful for C development.
Format
The Format shell script uses clang-format to format a selection of C code in Anvil. It can be downloaded here, and is also found in the Anvil source code under tools/format.
Rt
When run from Anvil the Rt command reads a ctags tag file, finds the function specified as an argument, and acquires it in a window.
aad
Anvil Auto-Dump (aad) periodically runs the Anvil Dump command to create a dumpfile. It is meant to be run from within Anvil. When started it will continue running until Anvil exits or aad is killed.
By default it will Dump to a file named 'anvil-auto.dump' every 30 seconds. These values can be overridden by command line options:
| Option | Semantics |
|---|---|
| -i I, --interval I | The interval in seconds between Dumps |
| -d F, --dumpfile F | The name of the dumpfile to generate |
| -v, --verbose | Print extra info |
aad can be downloaded from the download page, and can be found in the Anvil source code at tools/aad.
mdtoc
The mdtoc command prints a table-of-contents for a Markdown file. When run from Anvil, the mdtoc command reads the contents of the current window body and outputs each line in the body that begins with '#'. It appends the filename and line number to each line for easy access from Anvil.
aedit
The aedit command is meant to be used as the value of the Unix EDITOR environment variable. The EDITOR variable specifies the command to run when programs need to invoke an interactive editor, such as when git starts an editor to fill in a commit message.
If aedit is run outside of Anvil then it launches a new Anvil instance to edit the file. When Anvil is closed, aedit exits, allowing the invoking program to continue.
If aedit is executed from within Anvil, it will open a new window in Anvil for editing the file. When the window is closed using Del aedit exits.
To use aedit only when commands are run from Anvil, set the EDITOR environment variable to aedit in the [env] section in the Anvil settings.toml configuration file.
awatch
When run from Anvil, awatch waits for files in the directory in which it is run to be Put in Anvil, and then executes it's arguments as an OS command. When started it opens a Window in which it displays the command's output. It is similar to the Watch command written for Acme.
awatch is useful to automatically compile the files in the current directory as the source files are being edited. For example, if you were creating a Go project in Linux you could run awatch go build && echo success to start awatch and have it compile the source code files when they are modified. It would display all the compile errors, or 'success' if the compilation was successful.
anvsshd
anvsshd is a simple SSH server for Linux which can be run and configured as a normal user. It's useful for a couple of specific use-cases:
- If you want to access files on a remote host and do not have permissions to modify the OpenSSH configuration to allow clients to set environment variables, you can instead run anvsshd on a different port and connect to it instead. Anvil requires SSH servers to set certain environment variables if remote commands will use the API, or if you want to use environment variables to refer to the file open in the current window in Anvil.
- If you want to use a remote host for development with Anvil, but preparing the environment for development and compiling takes significant time. This might be the case, for example, if you are doing C/C++ cross-compiling and you need to source scripts that setup the shell environment to use the right tools and settings. You can SSH to the machine, prepare the environment, then run anvsshd which will inherit the environment variables. Subsequently, commands run from Anvil through anvsshd will execute in the prepared environment.
anvssh authenticates users by public key authentication. It reads the authorized keys from the OpenSSH configuration file ~/.ssh/authorized_keys by default, or the value of the -z or --authkeys flags if set. It requires a host key which it reads from ~/.ssh/host_key by default, or the -k or --hostkey flag if set.
anvssh listens on the address 0.0.0.0 TCP port 5001 by default, but this can be overridden using the -a or --addr flag.
adiff
adiff can be used to diff the contents of the bodies two windows. Mark the two windows by typing &&1 and &&2 in the windows to diff, then run adiff. It will open a new +Diff window with the diff. You can run adiff clr to remove the marks.