A tool to manage hosts file
Project description
|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
# 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for hostsman-1.1.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0363a81319eddd5089eb86e8b527f4ef2014bc6ce4f576a69dd8cb2953d772ac |
|
MD5 | 2c02cdc2bd2fc77d0bd39fc1cb350c75 |
|
BLAKE2b-256 | 9bf0df93426f2037fa919576fd8bfefad176a32e1d114b5e2edf7c6811ea15cc |