safe rename

Changing your mind is a basic human right! In lieu of this, safe provides a rename use case that can be used to rename

As yet safe has no command for renaming books. You can achieve this by first cloning the book then deleting the original.

safe rename | chapter

To rename a chapter you must not have an open location. If you do you must first close it before renaming.

$ safe close
$ safe view
$ safe rename <old-name> <new-name>

When safe sees that the book is not open, it knows that you want to rename the chapter.

The rename command returns a view allowing you to check that the chapter name has indeed been updated.

safe rename | verse

To rename the verse you must have its chapter (and only its chapter) open.

$ safe close
$ safe open <chapter>
$ safe view
$ safe rename <old-name> <new-name>

The rename command returns a view of all the verses in the open chapter allowing you to check that the verse name has indeed been updated.

safe rename | key

Most of the time you will want to rename keys in the mini-dictionary at a chapter and verse location. To do this you must open the chapter and verse first.

$ safe open <chapter> <verse>
$ safe show
$ safe rename <old-name> <new-name>

The rename command shows you the mini-dictionary (hashing out sensitive credentials) allowing you to check that the key name has indeed been updated.

safe rename | be aware

Be aware of the following when renaming.