host_range 0.0.0 → 0.0.1

data/README.rdoc

@@ -7,18 +7,77 @@ Make lists of hosts using ranges like:
 
 == Library Usage
 
-require 'host_range'
-hosts = HostRange.parse('foo-[01-09].domain.com')
+Get an array of hostname from a range:
+
+    require 'host_range'
+    HostRange.parse 'foo-[01-03].domain.com'
+     => ["foo-01.domain.com", "foo-02.domain.com", "foo-03.domain.com"]
+
+== Patterns
+
+Ranges are parsed using the ruby '..' operator:
+
+    HostRange.parse 'foo-[a-c]'
+     => ["foo-a", "foo-b", "foo-c"] 
+
+Multiple atoms and ranges may be separated by commas:
+
+    HostRange.parse 'foo-[1,3-5,9]'
+     => ["foo-1", "foo-3", "foo-4", "foo-5", "foo-9"] 
+
+With no commas or range operators ('-'), atoms are parsed as single
+characters:
+
+    HostRange.parse 'foo-[123]'
+     => ["foo-1", "foo-2", "foo-3"] 
+
+Combined:
+
+    HostRange.parse 'foo-[ab][01-02]'
+     => ["foo-a01", "foo-a02", "foo-b01", "foo-b02"] 
 
 == Command-line Usage
 
 Commandline tool lists hosts, or execs commands on them in a loop:
 
-* hr -h
-* hr foo-[01-09].domain.com
-* hr foo-[01-09].domain.com -e ssh root@{} hostname
+Get help:
+
+    $ hr -h
+
+List some hosts:
+
+    $ hr foo-[01-03].domain.com
+    foo-01.domain.com
+    foo-02.domain.com
+    foo-03.domain.com
+
+Get some IP addresses:
+
+    $ hr foo-[01-03].domain.com -e host
+    foo-01.domain.com has address 172.16.0.1
+    foo-02.domain.com has address 172.16.0.2
+    foo-03.domain.com has address 172.16.0.3
+
+Run a command, '{}' is replaced with each hostname:
+
+    $ hr foo-[01-03].domain.com -e ssh root@{} uptime
+
+You can provide a config file (~/.hr.yaml) with predefined patterns with
+project names:
+
+    web:
+      - webfe-[ab][01-05].newco.com
+      - webfe-c[20-23,27-29].newco.com
+    dev:
+      - dev-[web,db]-[01-02].newco.com
+
+and then call project by name:
 
-Can provide a config file (~/.hr.yaml) with predefined patterns called by name.
+    $ hosts dev
+    dev-web-01.newco.com
+    dev-web-02.newco.com
+    dev-db-01.newco.com
+    dev-db-02.newco.com
 
 == Copyright
 

data/VERSION

@@ -1 +1 @@
-0.0.0
+0.0.1

data/examples/hr.yaml

@@ -1,3 +1,9 @@
+## example config file for the host_range 'hr' command-line tool
+## install as ~/.hr.yaml
+##
+## list pre-defined host patterns for your various projects, then invoke them
+## by the given name, e.g.:
+##   hr web -e ssh root@{} service httpd restart
 web:
   - webfe-[ab][01-05].newco.com
   - webfe-c[20-23,27-29].newco.com

data/host_range.gemspec

@@ -0,0 +1,61 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{host_range}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = [%q{Richard Lister}]
+  s.date = %q{2011-09-15}
+  s.description = %q{Allows specification of hostname ranges such as foo-[01-09].}
+  s.email = %q{rlister+gh@gmail.com}
+  s.executables = [%q{hr}]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "bin/hr",
+    "examples/hr.yaml",
+    "host_range.gemspec",
+    "lib/host_range.rb",
+    "test/helper.rb",
+    "test/test_host_range.rb"
+  ]
+  s.homepage = %q{http://github.com/rlister/host_range}
+  s.licenses = [%q{MIT}]
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.5}
+  s.summary = %q{Convert hostname range pattern into array of hostnames.}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<shoulda>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<shoulda>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/test/helper.rb

@@ -7,12 +7,12 @@ rescue Bundler::BundlerError => e
   $stderr.puts "Run `bundle install` to install missing gems"
   exit e.status_code
 end
-require 'test/unit'
-require 'shoulda'
+# require 'test/unit'
+# require 'shoulda'
 
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 require 'host_range'
 
-class Test::Unit::TestCase
-end
+# class Test::Unit::TestCase
+# end

data/test/test_host_range.rb

@@ -1,7 +1,7 @@
-require 'helper'
+# require 'helper'
 
-class TestHostRange < Test::Unit::TestCase
-  should "probably rename this file and start testing for real" do
-    flunk "hey buddy, you should probably rename this file and start testing for real"
-  end
-end
+# class TestHostRange < Test::Unit::TestCase
+#   should "probably rename this file and start testing for real" do
+#     flunk "hey buddy, you should probably rename this file and start testing for real"
+#   end
+# end

metadata

@@ -2,7 +2,7 @@
 name: host_range
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.0
+  version: 0.0.1
 platform: ruby
 authors: 
 - Richard Lister
@@ -74,6 +74,7 @@ files:
 - VERSION
 - bin/hr
 - examples/hr.yaml
+- host_range.gemspec
 - lib/host_range.rb
 - test/helper.rb
 - test/test_host_range.rb
@@ -90,7 +91,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 1458013719312908271
+      hash: 1347353560576965439
       segments: 
       - 0
       version: "0"