Goodhosts (deprecated)
This library is now deprecated. See the goodhosts organisation for the current maintained version.
Simple hosts file (/etc/hosts) management in Go (golang).
A Surrealist Parisian Dinner Party chez Madame Rothschild, 1972
Features
- List, add, remove and check hosts file entries from code or the command-line.
- Windows support.
Command-Line Usage
Installation
Linux
Download the binary and put it in your path.
$ wget -O goodhosts https://github.com/lextoumbourou/goodhosts/releases/download/v2.1.0/goodhosts-linux
$ chmod +x goodhosts
$ export PATH=$(pwd):$PATH
$ goodhosts --help
Windows
Download the binary and do Windowsy stuff with it (doc PR welcome).
List entries
$ goodhosts list
127.0.0.1 localhost
10.0.0.5 my-home-server xbmc-server
10.0.0.6 my-desktop
Add --all flag to include comments.
Check for an entry
$ goodhosts check 127.0.0.1 facebook.com
Add an entry
$ goodhosts add 127.0.0.1 facebook.com
Or entries.
$ goodhosts add 127.0.0.1 facebook.com twitter.com gmail.com
Remove an entry
$ goodhosts rm 127.0.0.1 facebook.com
Or entries.
$ goodhosts rm 127.0.0.1 facebook.com twitter.com gmail.com
More
$ goodhosts --help
API Usage
Installation
$ go get github.com/lextoumbourou/goodhosts
List entries
package main
import (
"fmt"
"github.com/lextoumbourou/goodhosts"
)
func main() {
hosts := goodhosts.NewHosts()
for _, line := range hosts.Lines {
fmt.Println(line.Raw)
}
}
Check for an entry
package main
import (
"fmt"
"github.com/lextoumbourou/goodhosts"
)
func main() {
hosts := goodhosts.NewHosts()
if hosts.Has("127.0.0.1", "facebook.com") {
fmt.Println("Entry exists!")
return
}
fmt.Println("Entry doesn't exist!")
}
Add an entry
package main
import (
"fmt"
"github.com/lextoumbourou/goodhosts"
)
func main() {
hosts := goodhosts.NewHosts()
// Note that nothing will be added to the hosts file until ``hosts.Flush`` is called.
hosts.Add("127.0.0.1", "facebook.com", "twitter.com")
if err := hosts.Flush(); err != nil {
panic(err)
}
}
Remove an entry
package main
import (
"fmt"
"github.com/lextoumbourou/goodhosts"
)
func main() {
hosts := goodhosts.NewHosts()
// Same deal, yo: call hosts.Flush() to make permanent.
hosts.Remove("127.0.0.1", "facebook.com", "twitter.com")
if err := hosts.Flush(); err != nil {
panic(err)
}
}
More
Changelog
2.1.0 (2015-06-08)
- Added Windows support.
- Added command-line docs.
2.0.0 (2015-05-04)
- Breaking API change.
- Add support for adding and removing multiple hosts.
- Added
--allflag. - Handle malformed IP addresses.
1.0.0 (2015-05-03)
- Initial release.
3 Jul 29, 2021
1.4k Jan 9, 2023
139 Dec 15, 2022
0 Jan 14, 2022
3 Jul 21, 2022
8 Oct 8, 2022
120 Oct 1, 2022
17 Mar 3, 2022
8 Aug 9, 2022
7 Sep 24, 2022
0 Dec 3, 2021
7 May 17, 2022
1 Dec 20, 2021
0 Jan 18, 2022
4 Dec 7, 2022
227 Dec 15, 2022
24.3k Jan 5, 2023
2 Dec 20, 2021
3 Dec 17, 2021