Project

roast

0.0
No commit activity in last 3 years
No release in over 3 years
Roast is a simple /etc/hosts entry manager
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
~> 3.0.0
~> 0.13.3
>= 0
 Project Readme

Roast Build Status

Roast helps you manage entries in your /etc/hosts file. Roast allows you to group entries together in a named group and disable/enable them all at once. It's pretty useful if you work with a lot of entries in your hosts file and find it annoying to constantly be enabled/editing your hosts file manually.

Installation

$ gem install roast

Commands

Roast has a decent set of commands available:

list                list the entries in the hosts file          alias: l
add                 adds a new entry to the hosts file          alias: a
enable              enables a disabled (commented out) entry    alias: e
enable-group        enables an entire group                     alias: eg
disable             disables an entry (comments it out)         alias: d
disable-group       disables an entire group                    alias: dg
delete              deletes an entry entirely
delete-group        deletes an enitre group

a few of the commands have aliases, they are listed to the right

Usage

A few examples of using roast to manage your /etc/hosts file:

# list all entires
$ roast list

# add an entry to the base group
$ sudo roast add 10.0.1.1 something.dev

# add an entry to the "testing" group
$ sudo roast add testing 127.0.0.1 exampleapp.dev

# add an entry to the "testing" group via another hostname (resolve the ip)
$ sudo roast add testing example.org exampleapp.dev

# disable all entries with the ip "10.0.1.1"
$ sudo roast disable 10.0.1.1

# delete an entry entirely
$ sudo roast delete exampleapp.dev

notice that you can list entries without sudo, but editing the hosts file does require sudo

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request