vagrant-group 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3c1f6abcfd5c7e098ea5f14e80e156b2fd962f75
-  data.tar.gz: 3f517f0379c46c37a76eeb9f574cc64eacf10f2e
+  metadata.gz: a12d6231dc315ba52c0e2f07ad0a0eaccd63101e
+  data.tar.gz: 8dc59ae99e730295f0b4357764d68f1fd382e52f
 SHA512:
-  metadata.gz: 07fc04936abe946f94f9d716b4fa33998eae6facc04269395a497b25785367556850a16e2ec47755d3d940a2d7211163cf54fba4cbf58010bc1c0dcabf68eca8
-  data.tar.gz: 4928f9206bef104363bdcd9190a499cece92604fba14f88fd98b71fb48e83713d443a56389f406747b29cbb700eed7e76b150cc67f2fca65f5cc3a6afc759fdf
+  metadata.gz: 56d63f1fefa01536aeb55e274909ba006184dd3b76a642652f306627e6359fa3db7049688e3476d387b2ff697f5defb2d438f096d375904c8c03c7a53427ab12
+  data.tar.gz: 45df86faca90dba6a310629b6963383d9a01f243d6398db4d6802436ddcce3e80f05cf2f00cf6f5123d239fff38ec8442e06b2850bef5a36b1ab9c658f807e47

data/README.md

@@ -2,18 +2,35 @@
 
 [![Gem Version](https://badge.fury.io/rb/vagrant-group.svg)](http://badge.fury.io/rb/vagrant-group)
 
-With this plugin you can associate VMs to groups and then perform
-basic operations like up/halt/provision/destroy/reload on specific group.
-One host may belong to multiple groups.
+This plugin makes your life easier when it comes to maintain big development environments based on Vagrant.
+You can associate each VM to multiple groups, e.g. based on role (webserver, database) or project they belong to.
+Then with one simple command you can run basic commands on entire group.  
+
+For big configuration you may be also interested in [vagrant-dotvm plugin](https://github.com/krzysztof-magosa/vagrant-dotvm).
 
 ## How to install
 
 ```sh
-vagrant plugin install vagrant-group
+$ vagrant plugin install vagrant-group
 ```
 
 ## How to configure
 
+You need to add definition of groups to your existing `Vagrantfile`:
+```ruby
+config.group.groups = {
+  "group-name-1" => [
+    "vm-1",
+    "vm-2",
+  ],
+  "group-name-2" => [
+    "vm-3",
+    "vm-4",
+  ],
+}
+```
+
+For example it may look like that:
 ```ruby
 Vagrant.configure("2") do |config|
   config.vm.define "web1" do |web|
@@ -33,31 +50,82 @@ Vagrant.configure("2") do |config|
   end
 
   config.group.groups = {
-    "webservers" => [ "web1", "web2" ],
-    "databases"  => [ "db1", "db2" ]
+    "webservers" => [
+      "web1",
+      "web2",
+    ],
+    "databases" => [
+      "db1",
+      "db2",
+    ],
   }
 end
 ```
 
 ## How to use
 
-```sh
-$ vagrant group up webservers
-$ vagrant group halt databases
+If you forgot how to use `vagrant-group` just issue below command:
+```
+$ vagrant group
 ```
 
-At the moment you use commands `up`, `halt`, `provision`, `reload`, `suspend`, `resume` and `destroy`.  
-Parameters are not supported except `--force` in `halt` and `destroy` commands.
+Start VMs:
+```
+$ vagrant group up <group-name>
+```
 
-In order to list hosts associated to group issue below command:
+Start VMs with forced provisioning:
 ```
-$ vagrant group hosts webservers
+$ vagrant group up <group-name> --provision
 ```
 
-## Contributing
+Shut down VMs:
+```
+$ vagrant group halt <group-name>
+```
+
+Forced shut down of VMs (equivalent of pulling power):
+```
+$ vagrant group halt <group-name> --force
+```
+
+Destroy VMs:
+```
+$ vagrant group destroy <group-name>
+```
+
+Destroy VMs without asking:
+```
+$ vagrant group destroy <group-name> --force
+```
+
+Provision VMs:
+```
+$ vagrant group provision <group-name>
+```
+
+Reload VMs:
+```
+$ vagrant group reload <group-name>
+```
+
+Reload VMs with forced provisioning:
+```
+$ vagrant group reload <group-name> --provision
+```
+
+Suspend VMs:
+```
+$ vagrant group suspend <group-name>
+```
+
+Resume suspended VMs:
+```
+$ vagrant group resume <group-name>
+```
+
+List hosts associated to specific group:
+```
+$ vagrant group hosts <group-name>
+```
 
-1. Fork it ( https://github.com/krzysztof-magosa/vagrant-group/fork )
-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 a new Pull Request

data/lib/vagrant-group/command.rb

@@ -7,7 +7,7 @@ module VagrantPlugins
       def self.synopsis
         "runs vagrant command on specific group of VMs"
       end # self.synopsis
-      
+
       def execute
         options = {
           :provision_ignore_sentinel => false, # otherwise reload command does provision
@@ -18,6 +18,7 @@ module VagrantPlugins
 
           o.on('-h', '--help', 'Print this help') do
             safe_puts(opts.help)
+            return nil
           end
 
           o.on('-f', '--force', 'Do action (destroy, halt) without confirmation.') do
@@ -32,37 +33,83 @@ module VagrantPlugins
 
         argv = parse_options(opts)
 
-        action, group = argv[0], argv[1]
+        action, pattern = argv[0], argv[1]
 
-        if !group || !action || !COMMANDS.include?(action)
+        if !pattern || !action || !COMMANDS.include?(action)
           safe_puts(opts.help)
           return nil
         end
 
+        groups = find_groups(pattern)
+        if groups.length == 0
+          @env.ui.error('No groups matched the regular expression given.')
+          return nil
+        end
+
         if action == 'hosts'
-          @env.ui.info(sprintf('Hosts in %s group:', group))
-
-          with_target_vms() do |machine|
-            if machine.config.group.groups.has_key?(group)
-              if machine.config.group.groups[group].to_a.include? machine.name.to_s
-                @env.ui.info(sprintf(' - %s', machine.name))
-              end
-            elsif
-              @env.ui.warn('No hosts associated.')
-              break
-            end
+          groups.each do |group|
+            print_hosts(group)
           end
         elsif
-          with_target_vms() do |machine|
-            if machine.config.group.groups.has_key?(group)
-              if machine.config.group.groups[group].include? machine.name.to_s
-                machine.action(action, **options)
-              end
-            end
+          groups.each do |group|
+            do_action(action, options, group)
           end
         end
       end # execute
-      
+
+      def print_hosts(group)
+        @env.ui.info(sprintf('Hosts in %s group:', group))
+
+        with_target_vms() do |machine|
+          if machine.config.group.groups.has_key?(group)
+            if machine.config.group.groups[group].to_a.include? machine.name.to_s
+              @env.ui.info(sprintf(' - %s', machine.name))
+            end
+          elsif
+            @env.ui.warn('No hosts associated.')
+            break
+          end
+        end
+      end # print_hosts
+
+      def do_action(action, options, group)
+        with_target_vms() do |machine|
+          if machine.config.group.groups.has_key?(group)
+            if machine.config.group.groups[group].include? machine.name.to_s
+              machine.action(action, **options)
+            end
+          end
+        end
+      end # do_action
+
+      def all_groups
+        groups = Set.new
+
+        with_target_vms() do |machine|
+          machine.config.group.groups.to_h.each do |group_name, hosts|
+            groups << group_name
+          end
+        end
+
+        return groups.to_a
+      end # all_groups
+
+      def find_groups(pattern)
+        groups = []
+
+        if pattern[0] == "/" && pattern[-1] == "/"
+          reg = Regexp.new(pattern[1..-2])
+          all_groups.each do |item|
+            groups << item if item.match(reg)
+          end
+        else
+          all_groups.each do |item|
+            groups << item if item == pattern
+          end
+        end
+
+        groups
+      end # find_groups
     end # Command
   end # Group
 end # VagrantPlugins

data/lib/vagrant-group/version.rb

@@ -1,7 +1,7 @@
 module VagrantPlugins
   module Group
 
-    VERSION = "0.7.0"
+    VERSION = "0.8.0"
     
   end # Group
 end # VagrantPlugins

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vagrant-group
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Krzysztof Magosa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-18 00:00:00.000000000 Z
+date: 2015-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler