awswl


Nameawswl JSON
Version 1.2.1 PyPI version JSON
download
home_pagehttps://github.com/geoffreywiseman/awswl
SummaryA project to make it simple to add/remove ip addresses (or CIDR blocks) from an AWS Security group.
upload_time2024-11-17 01:04:05
maintainerNone
docs_urlNone
authorGeoffrey Wiseman
requires_python<4.0,>=3.9
licensePublic Domain
keywords aws vpn securitygroups security networking allowlist ssh firewall utility
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # AWS Allowlist

[![ci](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml/badge.svg)](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml)
[![Downloads](https://static.pepy.tech/badge/awswl)](https://pepy.tech/project/awswl)
[![Documentation](https://readthedocs.org/projects/awswl/badge/)](https://awswl.readthedocs.io/en/latest/)
![PyPI - Downloads](https://img.shields.io/pypi/dm/awswl)


A small tool to make it pretty simple to add and remove ip addresses (or CIDR blocks) from an AWS security group. This acts like a sort of oversimplified VPN, where you can quickly give yourself SSH access to a project as you move about from network to network.

This README should have enough information to get started, but you can get more information on:
- recent changes in the [CHANGELOG](CHANGELOG.md)
- documentation on [Read The Docs](https://awswl.readthedocs.io/en/latest/)
- [Alternatives](docs/alternatives.md) to awswl

## Installing 🛠️

This is a python tool, packaged as a python module, so you should be able to just run

```bash
pip install awswl
```    

Of course, if you don't know what a python module is, or you don't have python and pip installed,
you may have additional work ahead of you.

Now that Python2 is largely a relic of the past, I'm focused on supporting Python 3 only. The current CI build is for Python 3.9+.

## Usage ⌨

If you want usage help at the command line, try:

```bash
awswl --help
```

There's more detailed usage documentation in the documentation, which you can read on [GitHub](docs/usage.md) or [readthedocs](https://awswl.readthedocs.io/en/latest/usage/).


## Environment

All of these require you to have AWS credentials set up in advance, stored in
``~/.aws/credentials``, and if you need to use a profile, you can configure it with
``AWS_PROFILE``. If you want to identify the security group using a command-line variable so that
you don't have to put it into each command invocation, you can put it in ``AWSWL_SGID``.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/geoffreywiseman/awswl",
    "name": "awswl",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.9",
    "maintainer_email": null,
    "keywords": "aws, vpn, securitygroups, security, networking, allowlist, ssh, firewall, utility",
    "author": "Geoffrey Wiseman",
    "author_email": "geoffrey.wiseman@codiform.com",
    "download_url": "https://files.pythonhosted.org/packages/f5/e4/4de0dea2de97882924d3507877372306acf67b751ea083a73d99f8de9e40/awswl-1.2.1.tar.gz",
    "platform": null,
    "description": "# AWS Allowlist\n\n[![ci](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml/badge.svg)](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml)\n[![Downloads](https://static.pepy.tech/badge/awswl)](https://pepy.tech/project/awswl)\n[![Documentation](https://readthedocs.org/projects/awswl/badge/)](https://awswl.readthedocs.io/en/latest/)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/awswl)\n\n\nA small tool to make it pretty simple to add and remove ip addresses (or CIDR blocks) from an AWS security group. This acts like a sort of oversimplified VPN, where you can quickly give yourself SSH access to a project as you move about from network to network.\n\nThis README should have enough information to get started, but you can get more information on:\n- recent changes in the [CHANGELOG](CHANGELOG.md)\n- documentation on [Read The Docs](https://awswl.readthedocs.io/en/latest/)\n- [Alternatives](docs/alternatives.md) to awswl\n\n## Installing \ud83d\udee0\ufe0f\n\nThis is a python tool, packaged as a python module, so you should be able to just run\n\n```bash\npip install awswl\n```    \n\nOf course, if you don't know what a python module is, or you don't have python and pip installed,\nyou may have additional work ahead of you.\n\nNow that Python2 is largely a relic of the past, I'm focused on supporting Python 3 only. The current CI build is for Python 3.9+.\n\n## Usage \u2328\n\nIf you want usage help at the command line, try:\n\n```bash\nawswl --help\n```\n\nThere's more detailed usage documentation in the documentation, which you can read on [GitHub](docs/usage.md) or [readthedocs](https://awswl.readthedocs.io/en/latest/usage/).\n\n\n## Environment\n\nAll of these require you to have AWS credentials set up in advance, stored in\n``~/.aws/credentials``, and if you need to use a profile, you can configure it with\n``AWS_PROFILE``. If you want to identify the security group using a command-line variable so that\nyou don't have to put it into each command invocation, you can put it in ``AWSWL_SGID``.\n",
    "bugtrack_url": null,
    "license": "Public Domain",
    "summary": "A project to make it simple to add/remove ip addresses (or CIDR blocks) from an AWS Security group.",
    "version": "1.2.1",
    "project_urls": {
        "Homepage": "https://github.com/geoffreywiseman/awswl",
        "Repository": "https://github.com/geoffreywiseman/awswl"
    },
    "split_keywords": [
        "aws",
        " vpn",
        " securitygroups",
        " security",
        " networking",
        " allowlist",
        " ssh",
        " firewall",
        " utility"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e10482648d73cc49aa76952f6ef47889ab633ecee7dfa244df1f14c485bed47c",
                "md5": "626d415916e533e56552c5951804cbde",
                "sha256": "31a524aa4457a16bfeeb9fddff487f0a0ee42fb5cb980cad996ec832b9ec5947"
            },
            "downloads": -1,
            "filename": "awswl-1.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "626d415916e533e56552c5951804cbde",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.9",
            "size": 7677,
            "upload_time": "2024-11-17T01:04:03",
            "upload_time_iso_8601": "2024-11-17T01:04:03.340999Z",
            "url": "https://files.pythonhosted.org/packages/e1/04/82648d73cc49aa76952f6ef47889ab633ecee7dfa244df1f14c485bed47c/awswl-1.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f5e44de0dea2de97882924d3507877372306acf67b751ea083a73d99f8de9e40",
                "md5": "b2c88f8964ea0b6d8f1b82147f3e7d0d",
                "sha256": "679aa480e9504320dd7b308926c6d77895ce44d6a115e3ca630ac7027c9d13a9"
            },
            "downloads": -1,
            "filename": "awswl-1.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "b2c88f8964ea0b6d8f1b82147f3e7d0d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.9",
            "size": 6242,
            "upload_time": "2024-11-17T01:04:05",
            "upload_time_iso_8601": "2024-11-17T01:04:05.610030Z",
            "url": "https://files.pythonhosted.org/packages/f5/e4/4de0dea2de97882924d3507877372306acf67b751ea083a73d99f8de9e40/awswl-1.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-17 01:04:05",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "geoffreywiseman",
    "github_project": "awswl",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "awswl"
}
        
Elapsed time: 0.48973s