894adb1e43
This will make it convenient to include these bots in Zulip API releases on pypi. Fix #5009.
45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
# 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](http://zulip.readthedocs.io/en/latest/bots-guide.html#how-to-deploy-a-bot).
|
|
|
|
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.
|