doc.md better describes the style of documentation that will live inside these files, since we want these to be similar to our webhooks' doc.md files in terms of how these are rendered and composed of Markdown macros.
1.3 KiB
Virtual fs bot
This bot allows users to store information in a virtual file system, for a given stream or private chat.
Usage
Run this bot as described in here.
Use this bot with any of the following commands:
@fs mkdir
: create a directory
@fs ls
: list a directory
@fs cd
: change directory
@fs pwd
: show current path
@fs write
: write text
@fs read
: read text
@fs rm
: remove a file
@fs rmdir
: remove a directory
where fs
may be the name of the bot you registered in the zulip system.
Usage examples
@fs ls
- Initially shows nothing (with a warning)
@fs pwd
- Show which directory we are in: we start in /
@fs mkdir foo
- Make directory foo
@fs ls
- Show that foo is now created
@fs cd foo
- Change into foo (and do a pwd, automatically)
@fs write test hello world
- Write "hello world" to the file 'test'
@fs read test
- Check the text was written
@fs ls
- Show that the new file exists
@fs rm test
- Remove that file
@fs cd /
- Change back to root directory
@fs rmdir foo
- Remove foo
Notes
-
In a stream, the bot must be mentioned; in a private chat, the bot will assume every message is a command and so does not require this, though doing so will still work.
-
Use commands like
@fs help write
for more details on a command.