Uses the latest version of shade for cleaner code. Also, always return the key dict whether we create the key, or it already exists. The example using public_key_file is corrected to use a full path since ~ is not converted for us.
lookup() is currently broken (current Ansible devel branch), so better to avoid it in our examples.
Also deprecate old nova_keypair module.