keepass 1.0.0

This package provides the command `keepass-picker' to quickly
retrieve selected KeePass passwords from within Emacs using
`keepassxc-cli'.

------------------------------------------------------------------
                             Setup
------------------------------------------------------------------

This package uses the command keepassxc-cli, which must located on
the path.  Install KeePassXC in order to get this program.

Set the absolute path to your KeePass database file:

 (setq keepass-db "/absolute/path/to/my-passwords.kdbx")

If you use a key file to unlock the database, set it as
`keepass-key-file'.

A password can be retrieved by using the command `keepass-picker'.
In order to create a global keybinding for `keepass-picker', use
the utility function `keepass-global' in your config.

 (keepass-global "C-c p")

OR

 (keepass-global (kbd "C-c p"))


------------------------------------------------------------------
                     Registering passwords
------------------------------------------------------------------

In order to register a password for the password manager, use the
function `keepass-register':

 (keepass-register "m" "My Pass" :name "Email/Yahoo Email")

This will register a password entry named "My Pass" which can be
retrieved by calling `keepass-picker' and entering the letter "m".

`keepass-register' can also be used to register a category of
passwords by omitting the KeePass name:

 (keepass-register "e" "Email category")

After a category has been registered, passwords can be registered
under the category by prepending the key of the category to the key
of the password:

 (keepass-register "el" "Laura's email" :name "Laura Gmail")

Categories can be nested arbitrarily deep:

 (keepass-register "s" "Social")
 (keepass-register "sr"  "Reddit")
 (keepass-register "srp"   "Personal" :name "Reddit/Personal")
 (keepass-register "sra"   "Anon"     :name "Reddit/Anon")

------------------------------------------------------------------
                           Security
------------------------------------------------------------------

The master password for the KeePass database will be cached for
`password-cache-expiry' seconds.

By default, keepass.el will copy the password to the kill ring for
`keepass-timeout' seconds, then remove it.  During this time, the
clipboard feature of Emacs will be disabled.  Set
`keepass-clipboard' to `t' to allow other applications to access
the password through the clipboard.

------------------------------------------------------------------
                       Multiple databases
------------------------------------------------------------------

When registering a password entry or category, you can specify the
database file and/or key file:

 (keepass-register "w" "Work Database"
   :db "/absolute/path/to/work-passwords.kdbx"
   :key-file "/absolute/path/to/key-file")

These settings will be applied to all children of the category "w"
(unless overriden by the child).

To unset the key file for a particular password entry or category,
use -1 (setting `nil' will use inheritance).

 (keepass-register "w" "Work Database"
   :db "/absolute/path/to/work-passwords.kdbx"
   :key-file -1)