hostsman 1.1.3

A tool to manage hosts file

|Build Status|

# hostsman #
============

We replaced the project name to ``hostsman`` from ``hoste``

Add, remove or list mappings in hosts file

INSTALLATION
------------

Package Link: `hostsman <https://pypi.python.org/pypi/hostsman>`__

You can use pip to install this tool.

Run ``pip install hostsman``.

USAGE
-----

*$ Help*
~~~~~~~~

Run ``hostsman`` or ``hostsman -h`` to check the help doc:

::

(pypi) ➜ hosts git:(master) ✗ hostsman
usage: hostsman [-h] [-l | -c HOSTNAME [HOSTNAME ...] | -i HOSTNAME[:IP]
[HOSTNAME[:IP] ...] | -r HOSTNAME [HOSTNAME ...]]

Add, remove or list mappings in hosts file

optional arguments:
-h, --help show this help message and exit
-l, --list Show the content of hosts file
-c HOSTNAME [HOSTNAME ...], --check HOSTNAME [HOSTNAME ...]
Check if the host name existed in the host file
-i HOSTNAME[:IP] [HOSTNAME[:IP] ...], --insert HOSTNAME[:IP] [HOSTNAME[:IP] ...]
Insert HOSTNAME[:IP] mappings
-r HOSTNAME [HOSTNAME ...], --remove HOSTNAME [HOSTNAME ...]
Remove mapping for HOSTNAME from hosts file.

hosts file location: /etc/hosts

The last line of help gives the hosts file location on your pc.

*$ List mappings in hosts file*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Run **``hostsman -l``** to list out the content of hosts file.

::

127.0.0.1 localhost
255.255.255.255 broadcasthost
::1 localhost
fe80::1%lo0 localhost
127.0.0.1 my.local

*$ Check HOSTNAME*
~~~~~~~~~~~~~~~~~~

Check if a hostname is configured in hosts file.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Run ``hostsman -c hostname``,

It will return the result if ``hostname`` is in hosts file:

::

# Search result:
127.0.0.1 localhost
::1 localhost
fe80::1%lo0 localhost

Check multiple hostnames
^^^^^^^^^^^^^^^^^^^^^^^^

Run ``hostsman -c my.local my.local2``,

It will print out the mappings for given hostnames

::

# Search result:
127.0.0.1 my.local
127.0.0.1 my.local2

*$ Insert mappings*
~~~~~~~~~~~~~~~~~~~

Add single mapping
^^^^^^^^^^^^^^^^^^

Run ``hostsman -i my.local3:192.1.1.3``, it will insert new mapping:

``192.1.1.3 my.local3``

If not given ip, the default value ``127.0.0.1`` will be used:

Run ``hostsman -i my.local4``, it will insert mapping:

``127.0.0.1 my.local4``

Add multiple mappings.
^^^^^^^^^^^^^^^^^^^^^^

Run ``hostsman -r my.local my.local2:192.1.1.3``

*$ Remove mapping*
~~~~~~~~~~~~~~~~~~

Run ``hostsman -r my.local`` to remove ``my.local``

*A backup file will be created for every removal operation(when the
hostname is existed) *

.. |Build Status| image:: https://travis-ci.org/qszhuan/hostsman.svg?branch=master
:target: https://travis-ci.org/qszhuan/hostsman