From b3a205c54de37b9ac44d4d4253e2e73d40a9c7b9 Mon Sep 17 00:00:00 2001 From: Justin Largo Date: Wed, 9 Oct 2024 07:55:19 -0400 Subject: [PATCH 1/2] Update README.md with MacOS/ZSH Installation specifics --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index c3514bd..9aa08de 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,11 @@ pip install awscli-local **Note:** Automatic installation of AWS CLI version 2 is currently not supported yet (at the time of writing there is no official pypi package for `v2` available), but the `awslocal` technically also works with AWS CLI v2 (see [this section](#Limitations) for more details). +**MacOS/ZSH Installation:** If you're on MacOS or use ZSH for your shell, you may have to use quotes around the installation command due to known conflict with [pip](https://apple.stackexchange.com/questions/427572/zsh-conflict-with-python-setuptools-extras-and-pip). The command should then be the following: +```console +pip install "awscli-local[ver1]" +``` + ## Usage The `awslocal` command has the same usage as the `aws` command. For detailed usage, please refer to the manual pages of `aws help`. From 2ee82093a74c7d90eba1480587823a32526a00bf Mon Sep 17 00:00:00 2001 From: Justin Largo Date: Wed, 9 Oct 2024 09:44:29 -0400 Subject: [PATCH 2/2] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 9aa08de..fa09ae2 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,11 @@ You can install the `awslocal` command via `pip`: pip install awscli-local[ver1] ``` +If you're on macOS or use ZSH, please use the following command to install `awslocal` via `pip`: +```console +pip install "awscli-local[ver1]" +``` + Note that the command above also installs the latest version of the underlying AWS CLI version 1 (`awscli`) package. Use this command if you prefer to manage your own version of `awscli` (e.g., `v1`/`v2`) and install the wrapper script only: ```console pip install awscli-local @@ -20,11 +25,6 @@ pip install awscli-local **Note:** Automatic installation of AWS CLI version 2 is currently not supported yet (at the time of writing there is no official pypi package for `v2` available), but the `awslocal` technically also works with AWS CLI v2 (see [this section](#Limitations) for more details). -**MacOS/ZSH Installation:** If you're on MacOS or use ZSH for your shell, you may have to use quotes around the installation command due to known conflict with [pip](https://apple.stackexchange.com/questions/427572/zsh-conflict-with-python-setuptools-extras-and-pip). The command should then be the following: -```console -pip install "awscli-local[ver1]" -``` - ## Usage The `awslocal` command has the same usage as the `aws` command. For detailed usage, please refer to the manual pages of `aws help`.