This command line tool generates a static Swagger UI website that incorporates the API specifications of your AWS API Gateway APIs. The generated website files are stored locally on your file system, and if desired, the tool can also launch a local server for convenient previewing.
Only APIs that have been mapped to custom domains will be included in the generated website.
Prior to using this tool, please ensure that you are logged into your AWS account using a suitable command line tool like aws, saml2aws, okta-aws, or similar.
Please note that this tool is not provided or endorsed by AWS, and if you want it to utilise your AWS credentials and configurations stored under ~/.aws, you will need to explictly grant it the permission to do so either through GUI or sudo snap connect apig-swagger-ui:dot-aws-config-credentials.
Quick start
Try something like this:
$ apig-swagger-ui -r ap-southeast-2 -s
Generating OpenAPI spec for: https://tools-prod.example.com/
Generating OpenAPI spec for: https://tools-staging.example.com/
Generating OpenAPI spec for: https://api.example.com/
Local server started. Ctrl-C to stop. Access URL: http://localhost:8001/
For more information and detailed instructions, you can visit the GitHub repository at: https://github.com/james-hu/apig-swagger-ui
You are about to open
Do you wish to proceed?
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
On Arch Linux, snap can be installed from the Arch User Repository (AUR). The manual build process is the Arch-supported install method for AUR packages, and you’ll need the prerequisites installed before you can install any AUR package. You can then install snap with the following:
git clone https://aur.archlinux.org/snapd.git
cd snapd
makepkg -si
Once installed, the systemd unit that manages the main snap communication socket needs to be enabled:
sudo systemctl enable --now snapd.socket
If AppArmor is enabled in your system, enable the service which loads AppArmor profiles for snaps:
sudo systemctl enable --now snapd.apparmor.service
To enable classic snap support, enter the following to create a symbolic link between /var/lib/snapd/snap and /snap:
sudo ln -s /var/lib/snapd/snap /snap
Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly.
To install apig-swagger-ui (for AWS), simply use the following command:
sudo snap install apig-swagger-ui
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.