Skip to main content

A CLI to manage a hosts file

Project description

hostman
========
[![Build Status](https://api.travis-ci.org/jonhadfield/hostman.svg?branch=devel)](https://travis-ci.org/jonhadfield/hostman) [![Coverage Status](https://coveralls.io/repos/jonhadfield/hostman/badge.svg?branch=devel&service=github)](https://coveralls.io/github/jonhadfield/hostman?branch=devel)

A simple command line tool for managing your hosts file.
Add, remove or import entries from file or URLs.

Installation
------------
pip install hostman


Usage
------------
hostman add [-fqbcvq] [--force] [--path=PATH]
( [ENTRY ...] | [--input-file=FILE] | [--input-url=URL] )
hostman remove [-qbcvq] ([--address=<address>] [--names=<names>]) [--path=PATH]
[--input-file=FILE] [--input-url=URL]
hostman --version

Options
------------
-h --help show this help message and exit
--version show version and exit
-f --force first remove all existing entries that match
--address=ADDRESS ipv6 or ipv4 address
--names=NAMES host names
-q --quiet report only failures
-p --path=PATH location of hosts file (attempts to detect default)
-i --input-file=FILE file containing hosts to import
-u --input-url=URL url of file containing hosts to import
-b --backup create a backup before each change
--exclude=VALUE comma separated list of names or addresses
to exclude from operation [default: 127.0.0.1]
-c --count count entries added, replaced and removed
-v --verbose print verbose output

Examples
------------
Adding a single entry

hostman add 1.2.3.4 example.com

Importing a list of host entries by URL

hostman add --input-url https://dl.dropboxusercontent.com/u/167103/hosts

Requirements
------------
Tested on python 2.6, 2.7 and 3.4


License
-------

MIT




History
-------

0.1.0 (2015-01-11)
---------------------

* First release on PyPI.


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

pyhostman-0.1.1.tar.gz (15.3 kB view hashes)

Uploaded Source

Built Distribution

pyhostman-0.1.1-py2.py3-none-any.whl (6.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page