Restructuring.

lib/ansible/modules/inventory/add_host

@@ -0,0 +1,36 @@
+# -*- mode: python -*-
+
+DOCUMENTATION = '''
+---
+module: add_host
+short_description: add a host (and alternatively a group) to the ansible-playbook in-memory inventory
+description:
+  - Use variables to create new hosts and groups in inventory for use in later plays of the same playbook. 
+    Takes variables so you can define the new hosts more fully.
+version_added: "0.9"
+options:
+  name:
+    aliases: [ 'hostname', 'host' ]
+    description:
+    - The hostname/ip of the host to add to the inventory, can include a colon and a port number.
+    required: true     
+  groups:
+    aliases: [ 'groupname', 'group' ]
+    description:
+    - The groups to add the hostname to, comma separated.
+    required: false
+author: Seth Vidal
+'''
+
+EXAMPLES = '''
+# add host to group 'just_created' with variable foo=42
+- add_host: name={{ ip_from_ec2 }} groups=just_created foo=42
+
+# add a host with a non-standard port local to your machines
+- add_host: name={{ new_ip }}:{{ new_port }}
+
+# add a host alias that we reach through a tunnel
+- add_host: hostname={{ new_ip }}
+            ansible_ssh_host={{ inventory_hostname }}
+            ansible_ssh_port={{ new_port }}
+'''

lib/ansible/modules/inventory/group_by

@@ -0,0 +1,25 @@
+# -*- mode: python -*-
+
+DOCUMENTATION = '''
+---
+module: group_by
+short_description: Create Ansible groups based on facts
+description:
+  - Use facts to create ad-hoc groups that can be used later in a playbook.
+version_added: "0.9"
+options:
+  key:
+    description:
+    - The variables whose values will be used as groups
+    required: true
+author: Jeroen Hoekx
+notes:
+  - Spaces in group names are converted to dashes '-'.
+'''
+
+EXAMPLES = '''
+# Create groups based on the machine architecture
+-  group_by: key=machine_{{ ansible_machine }}
+# Create groups like 'kvm-host'
+-  group_by: key=virt_{{ ansible_virtualization_type }}_{{ ansible_virtualization_role }}
+'''