{"id":13477375,"url":"https://github.com/donnemartin/saws","last_synced_at":"2025-05-14T03:10:03.722Z","repository":{"id":37431895,"uuid":"41296876","full_name":"donnemartin/saws","owner":"donnemartin","description":"A supercharged AWS command line interface (CLI).","archived":false,"fork":false,"pushed_at":"2024-04-02T14:14:38.000Z","size":5633,"stargazers_count":5273,"open_issues_count":38,"forks_count":283,"subscribers_count":106,"default_branch":"master","last_synced_at":"2025-04-10T11:01:45.792Z","etag":null,"topics":["aws","aws-cli","cli","client","cloud","cloud-management","developer-tools","development","linux","macos","programming","python","shell","terminal","utilities","utility","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/donnemartin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-08-24T10:21:15.000Z","updated_at":"2025-04-10T08:02:14.000Z","dependencies_parsed_at":"2024-06-19T02:11:47.115Z","dependency_job_id":"2e4b5264-ef4d-41be-b141-3271d98f1dd5","html_url":"https://github.com/donnemartin/saws","commit_stats":{"total_commits":985,"total_committers":8,"mean_commits":123.125,"dds":"0.013197969543147225","last_synced_commit":"bddc553237e692cbe220d94144592843b25e4a92"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donnemartin%2Fsaws","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donnemartin%2Fsaws/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donnemartin%2Fsaws/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donnemartin%2Fsaws/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/donnemartin","download_url":"https://codeload.github.com/donnemartin/saws/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254059511,"owners_count":22007769,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-cli","cli","client","cloud","cloud-management","developer-tools","development","linux","macos","programming","python","shell","terminal","utilities","utility","windows"],"created_at":"2024-07-31T16:01:41.869Z","updated_at":"2025-05-14T03:09:58.709Z","avatar_url":"https://github.com/donnemartin.png","language":"Python","funding_links":[],"categories":["Command-line Tools","Development","资源列表","Python","Uncategorized","cloud","命令行工具","Command-line Tools [🔝](#readme)","windows","Command Line Tools","\u003ca name=\"devops\"\u003e\u003c/a\u003eDevOps","Cryptocurrency","Awesome Python","Applications","\\*nix/\\*nux"],"sub_categories":["Devops","命令行工具","Uncategorized","Universal Command Line Interface","Command-line Tools","Directory Navigation","Developer"],"readme":"![](http://i.imgur.com/vzC5zmA.gif)\n\nSAWS\n============\n\n[![Build Status](https://travis-ci.org/donnemartin/saws.svg?branch=master)](https://travis-ci.org/donnemartin/saws) [![Documentation Status](https://readthedocs.org/projects/saws/badge/?version=latest)](http://saws.readthedocs.org/en/latest/?badge=latest) [![Dependency Status](https://gemnasium.com/donnemartin/saws.svg)](https://gemnasium.com/donnemartin/saws)\n\n[![PyPI version](https://badge.fury.io/py/saws.svg)](http://badge.fury.io/py/saws) [![PyPI](https://img.shields.io/pypi/pyversions/saws.svg)](https://pypi.python.org/pypi/saws/) [![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)\n\n## Motivation\n\n### AWS CLI\n\nAlthough the [AWS CLI](https://github.com/aws/aws-cli) is a great resource to manage your AWS-powered services, it's **tough to remember usage** of:\n\n* 70+ top-level commands\n* 2000+ subcommands\n* Countless command-specific options\n* Resources such as instance tags and buckets\n\n### SAWS: A Supercharged AWS CLI\n\n`SAWS` aims to **supercharge** the AWS CLI with features focusing on:\n\n* **Improving ease-of-use**\n* **Increasing productivity**\n\nUnder the hood, `SAWS` is **powered by the AWS CLI** and supports the **same commands** and **command structure**.\n\n`SAWS` and `AWS CLI` Usage:\n\n    aws \u003ccommand\u003e \u003csubcommand\u003e [parameters] [options]\n\n`SAWS` features:\n\n* Auto-completion of:\n    * Commands\n    * Subcommands\n    * Options\n* Auto-completion of resources:\n    * Bucket names\n    * Instance ids\n    * Instance tags\n    * [More coming soon!](#todo-add-more-resources)\n* Customizable shortcuts\n* Fuzzy completion of resources and shortcuts\n* Fish-style auto-suggestions\n* Syntax and output highlighting\n* Execution of shell commands\n* Command history\n* Contextual help\n* Toolbar options\n\n`SAWS` is available for Mac, Linux, Unix, and [Windows](#windows-support).\n\n![](http://i.imgur.com/Eo12q9T.png)\n\n## Index\n\n### Features\n\n* [Syntax and Output Highlighting](#syntax-and-output-highlighting)\n* [Auto-Completion of Commands, Subcommands, and Options](#auto-completion-of-commands-subcommands-and-options)\n* [Auto-Completion of AWS Resources](#auto-completion-of-aws-resources)\n    * [S3 Buckets](#s3-buckets)\n    * [EC2 Instance Ids](#ec2-instance-ids)\n    * [EC2 Instance Tags](#ec2-instance-tags)\n    * [TODO: Add More Resources](#todo-add-more-resources)\n* [Customizable Shortcuts](#customizable-shortcuts)\n* [Fuzzy Resource and Shortcut Completion](#fuzzy-resource-and-shortcut-completion)\n* [Fish-Style Auto-Suggestions](#fish-style-auto-suggestions)\n* [Executing Shell Commands](#executing-shell-commands)\n* [Command History](#command-history)\n* [Contextual Help](#contextual-help)\n    * [Contextual Command Line Help](#contextual-command-line-help)\n    * [Contextual Web Docs](#contextual-web-docs)\n* [Toolbar Options](#toolbar-options)\n* [Windows Support](#windows-support)\n\n### Installation and Tests\n\n* [Installation](#installation)\n    * [Pip Installation](#pip-installation)\n    * [Virtual Environment and Docker Installation](#virtual-environment-and-docker-installation)\n    * [AWS Credentials and Named Profiles](#aws-credentials-and-named-profiles)\n    * [Supported Python Versions](#supported-python-versions)\n    * [Supported Platforms](#supported-platforms)\n* [Developer Installation](#developer-installation)\n    * [Continuous Integration](#continuous-integration)\n    * [Dependencies Management](#dependencies-management)\n    * [Unit Tests and Code Coverage](#unit-tests-and-code-coverage)\n    * [Documentation](#documentation)\n\n### Misc\n\n* [Contributing](#contributing)\n* [Credits](#credits)\n* [Contact Info](#contact-info)\n* [License](#license)\n\n## Syntax and Output Highlighting\n\n![](http://i.imgur.com/xQDpw70.png)\n\nYou can control which theme to load for syntax highlighting by updating your [~/.sawsrc](https://github.com/donnemartin/saws/blob/master/saws/sawsrc) file:\n\n```\n# Visual theme. Possible values: manni, igor, xcode, vim, autumn, vs, rrt,\n# native, perldoc, borland, tango, emacs, friendly, monokai, paraiso-dark,\n# colorful, murphy, bw, pastie, paraiso-light, trac, default, fruity\ntheme = vim\n```\n\n## Auto-Completion of Commands, Subcommands, and Options\n\n`SAWS` provides smart autocompletion as you type.  Entering the following command will interactively list and auto-complete all subcommands **specific only** to `ec2`:\n\n    aws ec2\n\n![](http://i.imgur.com/P2tL9vW.png)\n\n## Auto-Completion of AWS Resources\n\nIn addition to the default commands, subcommands, and options the AWS CLI provides, `SAWS` supports auto-completion of your AWS resources.  Currently, bucket names, instance ids, and instance tags are included, with additional support for more resources [under development](#todo-add-more-resources).\n\n### S3 Buckets\n\nOption for `s3api`:\n\n    --bucket\n\nSample Usage:\n\n    aws s3api get-bucket-acl --bucket\n\nSyntax for `s3`:\n\n    s3://\n\nSample Usage:\n\n    aws s3 ls s3://\n\nNote:  The example below demonstrates the use of [fuzzy resource completion](fuzzy-resource-and-shortcutcompletion):\n\n![](http://i.imgur.com/39CAS5T.png)\n\n### EC2 Instance Ids\n\nOption for `ec2`:\n\n    --instance-ids\n\nSample Usage:\n\n    aws ec2 describe-instances --instance-ids\n    aws ec2 ls --instance-ids\n\nNote:  The `ls` command demonstrates the use of [customizable shortcuts](#customizable-shortcuts):\n\n![](http://i.imgur.com/jFyCSXl.png)\n\n### EC2 Instance Tags\n\nOption for `ec2`:\n\n    --ec2-tag-key\n    --ec2-tag-value\n\nSample Usage:\n\n    aws ec2 ls --ec2-tag-key\n    aws ec2 ls --ec2-tag-value\n\n**Tags support wildcards** with the `*` character.\n\nNote:  `ls`, `--ec2-tag-value`, and `--ec2-tag-key` demonstrate the use of [customizable shortcuts](#customizable-shortcuts):\n\n![](http://i.imgur.com/VIKwG3Z.png)\n\n### TODO: Add More Resources\n\nFeel free to [submit an issue or a pull request](#contributions) if you'd like support for additional resources.\n\n## Customizable Shortcuts\n\nThe [~/.saws.shortcuts](https://github.com/donnemartin/saws/blob/master/saws/saws.shortcuts) file contains shortcuts that you can modify.  It comes pre-populated with several [handy shortcuts](https://github.com/donnemartin/saws/blob/master/saws/saws.shortcuts) out of the box.  You can combine shortcuts with [fuzzy completion](#fuzzy-resource-and-shortcut-completion) for even less keystrokes.  Below are a few examples.\n\nList all EC2 instances:\n\n    aws ec2 ls\n\nList all running EC2 instances:\n\n    aws ec2 ls --ec2-state running  # fuzzy shortcut: aws ecstate\n\n![](http://i.imgur.com/jYFEsoM.png)\n\nList all EC2 instances with a matching tag (supports wildcards `*`):\n\n    aws ec2 ls --ec2-tag-key    # fuzzy shortcut: aws ectagk\n    aws ec2 ls --ec2-tag-value  # fuzzy shortcut: aws ectagv\n\n![](http://i.imgur.com/PSuwUIw.png)\n\nList EC2 instance with matching id:\n\n    aws ec2 ls --instance-ids  # fuzzy shortcut: aws eclsi\n\n![](http://i.imgur.com/wGcUCsa.png)\n\nList all DynamoDB tables:\n\n    aws dynamodb ls  # fuzzy shortcut: aws dls\n\nList all EMR clusters:\n\n    aws emr ls  # fuzzy shortcut: aws emls\n\nAdd/remove/modify shortcuts in your [~/.saws.shortcuts](https://github.com/donnemartin/saws/blob/master/saws/shortcuts) file to suit your needs.\n\nFeel free to submit:\n\n* An issue to request additional shortcuts\n* A pull request if you'd like to share your shortcuts (see [contributing guidelines](#contributions))\n\n### Fuzzy Resource and Shortcut Completion\n\nTo toggle fuzzy completion of AWS resources and shortcuts, use `F3` key.\n\nSample fuzzy shortcuts to start and stop EC2 instances:\n\n    aws ecstop\n    aws ecstart\n\nNote:  Fuzzy completion currently only works with AWS [resources](#auto-completion-of-aws-resources) and [shortcuts](customizable-shortcuts).\n\n![](http://i.imgur.com/7OvFHCw.png)\n\n## Fish-Style Auto-Suggestions\n\n`SAWS` supports Fish-style auto-suggestions.  Use the `right arrow` key to complete a suggestion.\n\n![](http://i.imgur.com/t5200q1.png)\n\n## Executing Shell Commands\n\n`SAWS` allows you to execute shell commands from the `saws\u003e` prompt.\n\n![](http://i.imgur.com/FiSn6b2.png)\n\n## Command History\n\n`SAWS` keeps track of commands you enter and stores them in `~/.saws-history`.  Use the up and down arrow keys to cycle through the command history.\n\n![](http://i.imgur.com/z8RrDQB.png)\n\n## Contextual Help\n\n`SAWS` supports contextual command line `help` and contextual web `docs`.\n\n### Contextual Command Line Help\n\nThe `help` command is powered by the AWS CLI and outputs help within the command line.\n\nUsage:\n\n    aws \u003ccommand\u003e \u003csubcommand\u003e help\n\n![](http://i.imgur.com/zSkzt6y.png)\n\n### Contextual Web Docs\n\nSometimes you're not quite sure what specific command/subcommand/option combination you need to use.  In such cases, browsing through several combinations with the `help` command line is cumbersome versus browsing the online AWS CLI docs through a web browser.\n\n`SAWS` supports contextual web docs with the `docs` command or the `F9` key.  `SAWS` will display the web docs specific to the currently entered command and subcommand.\n\nUsage:\n\n    aws \u003ccommand\u003e \u003csubcommand\u003e docs\n\n![](http://i.imgur.com/zK4IJYp.png)\n\n## Toolbar Options\n\n`SAWS` supports a number of toolbar options:\n\n* `F2` toggles [output syntax highlighting](#syntax-and-output-highlighting)\n* `F3` toggles [fuzzy completion of AWS resources and shortcuts](#fuzzy-resource-and-shortcut-completion)\n* `F4` toggles [completion of shortcuts](#customizable-shortcuts)\n* `F5` refreshes [resources for auto-completion](#auto-completion-of-aws-resources)\n* `F9` displays the [contextual web docs](#contextual-web-docs)\n* `F10` or `control d` exits `SAWS`\n\n![](http://i.imgur.com/7vz8OSc.png)\n\n## Windows Support\n\n`SAWS` has been tested on Windows 7 and Windows 10.\n\nOn Windows, the [.sawsrc](https://github.com/donnemartin/saws/blob/master/saws/sawsrc) file can be found in `%userprofile%`.  For example:\n\n    C:\\Users\\dmartin\\.sawsrc\n\nAlthough you can use the standard Windows command prompt, you'll probably have a better experience with either [cmder](https://github.com/cmderdev/cmder) or [conemu](https://github.com/Maximus5/ConEmu).\n\n![](http://i.imgur.com/pUwJWck.png)\n\n## Installation\n\n### Pip Installation\n\n[![PyPI version](https://badge.fury.io/py/saws.svg)](http://badge.fury.io/py/saws) [![PyPI](https://img.shields.io/pypi/pyversions/saws.svg)](https://pypi.python.org/pypi/saws/)\n\n`SAWS` is hosted on [PyPI](https://pypi.python.org/pypi/saws).  The following command will install `SAWS` along with dependencies such as the [AWS CLI](https://github.com/aws/aws-cli):\n\n    $ pip install saws\n\nYou can also install the latest `SAWS` from GitHub source which can contain changes not yet pushed to PyPI:\n\n    $ pip install git+https://github.com/donnemartin/saws.git\n\nIf you are not installing in a [virtualenv](#virtual-environment-and-docker-installation), run with `sudo`:\n\n    $ sudo pip install saws\n\nOnce installed, start `SAWS`:\n\n    $ saws\n\n### Virtual Environment and Docker Installation\n\nIt is recommended that you install Python packages in a [virtualenv](http://docs.python-guide.org/en/latest/dev/virtualenvs/) to avoid potential [issues with dependencies or permissions](https://github.com/donnemartin/saws/issues/15).\n\nTo view `SAWS` `virtualenv` and [Docker](https://www.docker.com/) installation instructions, click [here](https://github.com/donnemartin/saws/blob/master/INSTALLATION.md).\n\n### Mac OS X 10.11 El Capitan Users\n\nThere is a known issue with Apple and its included python package dependencies (more info at https://github.com/pypa/pip/issues/3165). We are investigating ways to fix this issue but in the meantime, to install saws, you can run:\n\n    $ sudo pip install saws --upgrade --ignore-installed six\n\n### AWS Credentials and Named Profiles\n\n[Configure your credentials](https://github.com/aws/aws-cli#getting-started) with the AWS CLI:\n\n    $ aws configure\n\nIf you'd like to use a specific named profile with `SAWS`, run the following commands on OS X, Linux, or Unix:\n\n    $ export AWS_DEFAULT_PROFILE=user1\n    $ saws\n\nOr as a one-liner:\n\n    $ AWS_DEFAULT_PROFILE=user1 saws\n\nWindows users can run the following commands:\n\n    \u003e set AWS_DEFAULT_PROFILE=user1\n    \u003e saws\n\nCommand line options for starting `SAWS` with a specific profile are [under development](https://github.com/donnemartin/saws/issues/16).  For more details on how to install and configure the AWS CLI, refer to the following [documentation](http://docs.aws.amazon.com/cli/latest/userguide/installing.html).\n\n### Supported Python Versions\n\n* Python 2.6\n* Python 2.7\n* Python 3.3\n* Python 3.4\n* Pypy\n\nLight testing indicates that `SAWS` also seems to be compatible with Python 3.5.\n\nPypy3 is not supported due to [lack of support](https://github.com/boto/botocore/issues/622) from [boto](https://github.com/boto/boto).\n\n### Supported Platforms\n\n* Mac OS X\n    * Tested on OS X 10.10\n* Linux, Unix\n    * Tested on Ubuntu 14.04 LTS\n* Windows\n    * Tested on Windows 7 and 10\n\n## Developer Installation\n\nIf you're interested in contributing to `SAWS`, run the following commands:\n\n    $ git clone https://github.com/donnemartin/saws.git\n    $ pip install -e .\n    $ pip install -r requirements-dev.txt\n    $ saws\n\n### Continuous Integration\n\n[![Build Status](https://travis-ci.org/donnemartin/saws.svg?branch=master)](https://travis-ci.org/donnemartin/saws)\n\nContinuous integration details are available on [Travis CI](https://travis-ci.org/donnemartin/saws).\n\n### Dependencies Management\n\n[![Dependency Status](https://gemnasium.com/donnemartin/saws.svg)](https://gemnasium.com/donnemartin/saws)\n\nDependencies management details are available on [Gemnasium](https://gemnasium.com/donnemartin/saws).\n\n### Unit Tests and Code Coverage\n\nRun unit tests in your active Python environment:\n\n    $ python tests/run_tests.py\n\nRun unit tests with [tox](https://pypi.python.org/pypi/tox) on multiple Python environments:\n\n    $ tox\n\n### Documentation\n\n[![Documentation Status](https://readthedocs.org/projects/saws/badge/?version=latest)](http://saws.readthedocs.org/en/latest/?badge=latest)\n\nSource code documentation is available on [Readthedocs.org](http://saws.readthedocs.org/en/latest/?badge=latest).\n\nRun the following to build the docs:\n\n    $ scripts/update_docs.sh\n\n## Contributing\n\nContributions are welcome!\n\nReview the [Contributing Guidelines](https://github.com/donnemartin/saws/blob/master/CONTRIBUTING.md) for details on how to:\n\n* Submit issues\n* Submit pull requests\n\n## Credits\n\n* [AWS CLI](https://github.com/aws/aws-cli) by [AWS](https://github.com/aws) for powering `SAWS` under the hood\n* [Python Prompt Toolkit](https://github.com/jonathanslenders/python-prompt-toolkit) by [jonathanslenders](https://github.com/jonathanslenders) for simplifying the creation of `SAWS`\n* [Wharfee](https://github.com/j-bennet/wharfee) by [j-bennet](https://github.com/j-bennet) for inspiring the creation of `SAWS` and for some handy utility functions\n\n## Contact Info\n\nFeel free to contact me to discuss any issues, questions, or comments.\n\n* Email: [donne.martin@gmail.com](mailto:donne.martin@gmail.com)\n* Twitter: [donne_martin](https://twitter.com/donne_martin)\n* GitHub: [donnemartin](https://github.com/donnemartin)\n* LinkedIn: [donnemartin](https://www.linkedin.com/in/donnemartin)\n* Website: [donnemartin.com](http://donnemartin.com)\n\n## License\n\n*I am providing code and resources in this repository to you under an open source license.  Because this is my personal repository, the license you receive to my code and resources is from me and not my employer (Facebook).*\n\n    Copyright 2015 Donne Martin\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdonnemartin%2Fsaws","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdonnemartin%2Fsaws","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdonnemartin%2Fsaws/lists"}