# Updating to Awsume Version 4
Awsume v4 does things a little differently than previous versions. This guide should help you if you're updating awsume from an earlier version.
WARNING
If you run into any issues, feel free to open an issue (opens new window)!
# Plugin System
Awsume changed plugin systems. Where we previously used Yapsy (opens new window) we're now using Pluggy (opens new window).
Awsume used to store plugins in your home directory: ~/.aws/awsumePlugins
. This is no longer the case. Plugins are now actual python packages, installed via pip
or some other python package installer. For this reason, you no longer need the ~/.aws/awsumePlugins
directory, so this can be emptied and deleted.
# Login Profile Cleanup
Awsume now correctly prioritizes bash login files. There was a consistent bug in previous versions that would place the alias and autocomplete script definitions in the ~/.bashrc
, even in OS X (where the ~/.bashrc
is not loaded on login by default), causing awsume to not "just work." The awsume post-install configuration will now prioritize the ~/.bash_profile
over the ~/.bashrc
(read more about that here (opens new window)). For this reason you might see doubling of the alias/autocomplete definitions, so you can clean up the unused ones.
# Autocomplete script
Related to login profile cleanup, the autocomplete script has changed. This is due to a refactor that migrated all autocomplete code out of awsume's core and made use of fastentrypoints (opens new window), so that autocomplete would execute faster. So if you see multiple, slightly different autocomplete script definitions for awsume, make sure to keep the one that has the awsume-autocomplete
command.
# Cache and Config
Awsume now makes use of an ~/.awsume/
directory for storing cache and config. This means that you can migrate your settings from ~/.aws/awsume.json
to ~/.awsume/config.yaml
.
Awsume will now no longer use the ~/.aws/cli/cache/
directory for it's own caching, so you can clear out all of those old awsume cache files.
# Awsume configuration
If anything went wrong with awsume's installation, you can now run the configuration commands outside of pip install
with awsume-configure
. Read more about it here.