https://github.com/dwighthubbard/hostlists

Python module to generate lists of hosts from various sources
https://github.com/dwighthubbard/hostlists

Last synced: 27 days ago
JSON representation

Python module to generate lists of hosts from various sources

• Host: GitHub
• URL: https://github.com/dwighthubbard/hostlists
• Owner: dwighthubbard
• License: other
• Created: 2013-03-03T08:53:33.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2020-12-21T18:45:03.000Z (over 4 years ago)
• Last Synced: 2025-04-08T20:14:22.104Z (about 2 months ago)
• Language: Python
• Size: 144 KB
• Stars: 6
• Watchers: 2
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.d/1.removal.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
[![Build Status](https://cd.screwdriver.cd/pipelines/3816/badge?nocache=true)](https://cd.screwdriver.cd/pipelines/3816)

[![Package](https://img.shields.io/badge/package-pypi-blue.svg)](https://pypi.org/project/screwdrivercd/)

[![Downloads](https://img.shields.io/pypi/dm/hostlists.svg)](https://img.shields.io/pypi/dm/hostlists.svg)

[![Codecov](https://codecov.io/gh/yahoo/hostlists/branch/master/graph/badge.svg?nocache=true)](https://codecov.io/gh/yahoo/hostlists)

[![Codestyle](https://img.shields.io/badge/code%20style-pep8-blue.svg)](https://www.python.org/dev/peps/pep-0008/)

[![Documentation](https://img.shields.io/badge/Documentation-latest-blue.svg)](https://yahoo.github.io/hostlists/)

---

# hostlists

Python module to generate lists of hosts from various sources that is extensible

via plugins.

## Components

hostlists has 2 components:

- hostlists - This module handles hostlist expansion

- hostlists_plugins - This module contains plugins that allow hostlists to get lists of hosts from various backend systems.

## Dependencies

- dnspython (BSD License) - This python module is used for the dns plugins to perform host expansion based on dns.

## Usage

The hostlists module provides a python module to do host expansion within python

programs.  It also provides a command line utility to allow usage from the

command line.

## Command Line Examples

Expand a list of hosts from round robin dns using the dns plugin

```bash

$ hostlists dns:www.google.com

pb-in-f99.1e100.net, pb-in-f[103-106].1e100.net, pb-in-f147.1e100.net

```

Multiple hosts, ranges and plugins can be passed for a single hostlists

```bash

$ hostlists dns:www.google.com, poodle[10-20,23].dog.com

pb-in-f99.1e100.net, pb-in-f[103-106].1e100.net, pb-in-f147.1e100.net, poodle[10-20].dog.com, poodle23.dog.com

```