python-zulip-api/zulip_bots/zulip_bots/bots/virtual_fs/doc.md
Eeshan Garg d63269ee6a zulip_bots: Rename bots/{bot}/readme.md -> bots/{bot}/doc.md.
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.
2017-08-15 19:30:13 -07:00

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.