An API & command line interface, for common web tasks
Table of Contents
- Additional Documentation
- What does sws do?
- Features & Roadmap
- Why should I use sws?
- Who is sws for?
- Development-Contribution guide
Super Web Scripts
A command line interface, and set of scripts for common web tasks.
pip install sws or
sudo pip3 install sws.
- Clone the github repo (https://github.com/Descent098/sws)
- cd into the 'sws' root directory (where setup.py is) and run
pip install .or
sudo pip3 install .
API Documentation can be found at https://kieranwood.ca/sws/
User Documentation for the cli can be found at https://sws.readthedocs.io
What does sws do?
sws is both a cli, and an API with the goal of making common web development tasks simple.
Specifically the API is designed to:
- Be a cross-platform utility API
- Give sensible high-level functions for common tasks
- Provide useful constants such as a list of dns record types
- Provide a set of utility classes for common tasks (such as downloads)
The CLI is designed to:
- Provide a cross-platform set of tools
- Provide a toolbox for ease of use tasks so you don't need to know dozens of commands
- Make doing simple tasks simpler
Features & Roadmap
Get information about domain names including:
- Who is the registrar
- When the domain expires
Get information about the trace of http redirects
Get deails about the ssl cert of a hostname such as:
- When the cert will expire
- The issuer of the cert
- A full dict of the details of the cert
Allows for the download of videos as well as geting metadata
Prints a table of the DNS records for a given domain
A full roadmap for each project version can be found here: https://github.com/Descent098/sws/projects
Why should I use sws?
The best marketing pitch that I can give you is that it's easy to use, free, and open source. The project really is here so that people don't have to keep writing the same implementations of basic tasks, and can instead use a tested package that contains a ton of functionality. Additionally if you don't want to use all of sws's features, because it is MIT liscenced you can feel free to vendor functions within your own project.
Who is sws for?
Really it can be used by anyone, but here are the most typial use cases:
- Web developers; tools provided in sws can help with debugging and validating web servers
- Devops Specialists & testers; can use sws api to automate validation that servers are running how they should be
- People learning webdev; Sometimes getting access to tooling while learning webdev can be difficult, this can be a one-stop shop for lots of functionality
- Scripters; people who are looking to use sws functionality in their own projects
See Contribution guide for details about helping with development.
V0.2.2; September 2nd 2021
More bug fixes
- Fixed a bug where installing whois would fail out midway through
- Added additional error catching on whois binary installation
- Fixed boolean type conversion bug on
V0.2.1; September 1st 2021
Fixing bugs found after release
- Fixed error on
sws.youtube._request_path()where it would fail if no tkinter display variable is set
- Fixed bug with retrieval of domain records where an unbound variable would exist if the request hung
- Fixed issue where no usage would print when using DNS command without any args
- Fixed issue where no usage would print when using SSL command without any args
- Fixed issue with DNS lookups where on slow connections it would hang waiting for records to load
- Fixed some spelling errors and text duplication
- Improved some of the readme and Usage docs explanations
V0.2.0; September 1st 2021
Focus for this release was to revamp the package and add a ton of functionality.
- Simplified and streamlined
- Added Bash autocomplete for ease of use on *nix systems
domainsmodule and command
dnsmodule and command
- Added ```downloads`` module to make handling downlaods simpler
__main__.pyfile for direct cli invocation (
python -m sws)
- Added logging to existing functions, and all new functions
- Added additional source, docs, and roadmap links to
- Added github templates (for issues and PR's), and testing pipeline
- Added testing suite for majority of library functions
- Moved usage docs to readthedocs https://sws.readthedocs.io
- Added API docs to https://kieranwood.ca/sws
V0.1.0; February 4th 2020
Initial release went out on github and PyPi. Ported functionality from kuws package.
- Trace redirects
- Download YouTube videos directly from command line
- Check SSL status information and expiry date
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.