added sample facts module, updated README.md

Author: Bradley A. Thornton

README.md

@@ -10,6 +10,7 @@ The resource module builder is an Ansible playbook that helps developers scaffol
 - Subsequent uses of RMB will only replace the module arspec and file containing the module doc string.
 - Complex examples can be stored along side the model in the same directory
 - Maintain the model as the source of truth for the module and use RMB to update the source files as needed.
+- Generates working sample modules for both `<network_os>_<resource>` and `<network_os>_facts`
 
 
 ### Usage
@@ -71,6 +72,7 @@ ansible-playbook -e parent=~/github/rm_example \
 │   ├── inventory
 │   ├── modules
 │   │   ├── __init__.py
+│   │   ├── myos_facts.py
 │   │   └── myos_interfaces.py
 │   └── module_utils
 │       ├── __init__.py
@@ -125,6 +127,7 @@ ansible-playbook -e parent=~/github/rm_example/roles/my_role \
     └── my_role
         ├── library
         │   ├── __init__.py
+        │   ├── myos_facts.py
         │   └── myos_interfaces.py
         └── module_utils
             ├── __init__.py
@@ -183,6 +186,13 @@ ln -s ~/github/rm_example ~/.ansible/collections/ansible_collections/cidrblock/m
    gather_facts: False
    tasks:
    - cidrblock.my_collection.myos_interfaces:
+     register: result
+   - debug:
+       var: result
+   - cidrblock.my_collection.myos_facts:
+   - debug:
+       var: net_configuration
+
 ```
 
 **Using the role layout**
@@ -198,4 +208,10 @@ ln -s ~/github/rm_example ~/.ansible/collections/ansible_collections/cidrblock/m
   gather_facts: False
   tasks:
   - myos_interfaces:
+    register: result
+  - debug:
+      var: result
+  - myos_facts:
+  - debug:
+      var: net_configuration
 ```

roles/resource_module/templates/module_directory/network_os/network_os_facts.py.j2

@@ -0,0 +1,82 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+# {{ rm['metadata']['copyright_str'] }}
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+"""
+The module file for {{ network_os }}_facts
+"""
+
+from __future__ import absolute_import, division, print_function
+from ansible.module_utils.basic import AnsibleModule
+from ansible.module_utils.connection import Connection
+from {{ import_path }}. \
+     {{ network_os }}.facts.facts import Facts
+
+ANSIBLE_METADATA = {'metadata_version': '1.1',
+                    'status': {{ rm['metadata']['status'] }},
+                    'supported_by': {{ rm['metadata']['supported_by'] }}}
+
+
+DOCUMENTATION = """
+---
+module: {{ network_os }}_facts
+version_added: {{ rm['info']['version_added'] }}
+short_description: {{ rm['info']['short_description'] }}
+description:
+  - Collects facts from network devices running the {{ network_os }} operating
+    system. This module places the facts gathered in the fact tree keyed by the
+    respective resource name.  The facts module will always collect a
+    base set of facts from the device and can enable or disable
+    collection of additional facts.
+author: {{ rm['info']['authors'] }}
+options:
+  gather_subset:
+    description:
+      - When supplied, this argument will restrict the facts collected
+        to a given subset.  Possible values for this argument include
+        all, and net_configuration_<resource_name>.  Can specify a
+        list of values to include a larger subset.  Values can also be used
+        with an initial C(M(!)) to specify that a specific subset should
+        not be collected.
+    required: false
+    default: 'all'
+    version_added: "2.2"
+"""
+
+EXAMPLES = """
+# Gather all facts
+- {{ network_os }}_facts:
+    gather_subset: all
+
+# Collect only the {{ resource }} and default facts
+- {{ network_os }}_facts:
+    gather_subset:
+      - net_configuration_{{ resource }}
+
+# Do not collect {{ resource }} facts
+- {{ network_os }}_facts:
+    gather_subset:
+      - "!net_configuration_{{ resource }}"
+"""
+
+RETURN = """
+See the respective resource module parameters for the tree.
+"""
+
+def main():
+    """
+    Main entry point for module execution
+
+    :returns: ansible_facts
+    """
+    module = AnsibleModule(argument_spec=Facts.argument_spec,
+                           supports_check_mode=True)
+    warnings = list()
+
+    connection = Connection(module._socket_path) #pylint: disable=W0212
+    gather_subset = module.params['gather_subset']
+    ansible_facts = Facts().get_facts(module, connection, gather_subset)
+    module.exit_json(ansible_facts=ansible_facts, warnings=warnings)
+
+if __name__ == '__main__':
+    main()

roles/resource_module/templates/module_directory/network_os/network_os_resource.py.j2

@@ -33,8 +33,8 @@ from {{ import_path }}. \
      {{ network_os }}.config.{{ resource }}.{{ resource }} import {{ resource|capitalize }}
 
 ANSIBLE_METADATA = {'metadata_version': '1.1',
-                    'status': ['preview'],
-                    'supported_by': 'network'}
+                    'status': {{ rm['metadata']['status'] }},
+                    'supported_by': {{ rm['metadata']['supported_by'] }}}
 
 
 DOCUMENTATION = """

roles/resource_module/templates/module_utils/network_os/facts/resource/resource.py.j2

@@ -31,7 +31,7 @@ class {{ resource|capitalize }}Facts(FactsBase):
             pass
 
         if not data:
-            data = "" # connection.get('show running-config | section ^interface')
+            data = "foo" # connection.get('show running-config | section ^interface')
 
         # operate on a collection of resource x
         config = [data] # data.split('interface ')

roles/resource_module/vars/main.yml

@@ -48,6 +48,9 @@ resource_module_templates:
 - source: module_directory/network_os/network_os_resource.py.j2
   destination: "{{ parent_directory }}/{{ module_directory }}/{{ network_os }}_{{ resource }}.py"
   overwrite: True
+- source: module_directory/network_os/network_os_facts.py.j2
+  destination: "{{ parent_directory }}/{{ module_directory }}/{{ network_os }}_facts.py"
+  overwrite: False
 - source: module_utils/network_os/argspec/facts/facts.py.j2
   destination: "{{ parent_directory}}/module_utils/{{ network_os }}/argspec/facts/facts.py"
   overwrite: False