Skip to main content

A command-line client for URL and hostname swizzling

Project description


hostparse - A command-line client for URL and hostname swizzling


hostparse can be installed manually by cloning this repository, going to the main directory and typing:

pip install .

Or it can be installed using PyPI:

pip install hostparse


hostparse installs as a commandline utility and takes input from stdin. In essence hostparse has a few simple parseable items it can extract from a URL. This is the full list of items:

  • scheme
  • username
  • password
  • subdomain
  • domain
  • hostname
  • tld
  • port
  • path
  • params
  • query
  • fragment

These items can be used as 'swizzling' operators seperated by a comma (,). For example, lets say the input contains a url from which you want to extract just the registered domain with its tld you can do:

hostparse domain,tld

Now what is neat with these items is that the tool will match the shortest match without duplicates. This means that instead of typing tld you can also type tl or even t as there are no other items that would conflict. The same query as before can also be written as:

hostparse d,t

The only thing to be careful of is the match, for example you can't use p for port as it will also match other items (the tool will warn you about this and simply return without processing data). You have to get the right match, po will work for ports however pa won't work woth path as it will also match params which means you have to use pat for path.

Additionally the data the tool outputs uses a delimiter based on the items you choose, so if you choose domain and tld it will be outputed as: <domain>.<tld>. You can change this delimiter value with the -d operator after you specify the items to filter out. If you don't want a delimiter you can specify it as -d''.

One extra thing to point out: the order of the items you specify is also how they are represented in the output.

Bugs & Features

Feel free to open issues for features or bugs you've found or do a pull request and you will be rewarded somewhere later in life for it.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hostparse-0.0.6.tar.gz (3.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page