add travis tests, update documentation

Author: Colin Hoglund

.travis.yml

@@ -0,0 +1,29 @@
+---
+language: python
+python: "2.7"
+
+# Use the new container infrastructure
+sudo: false
+
+# Install ansible
+addons:
+  apt:
+    packages:
+    - python-pip
+
+install:
+  # Install ansible
+  - pip install ansible
+
+  # Check ansible version
+  - ansible --version
+
+  # Create ansible.cfg with correct roles_path
+  - printf '[defaults]\nroles_path=../' >ansible.cfg
+
+script:
+  # Basic role syntax check
+  - ansible-playbook tests/test.yml -i tests/inventory --syntax-check
+
+notifications:
+  webhooks: https://galaxy.ansible.com/api/v1/notifications/

README.md

@@ -1,42 +1,83 @@
-In addition to installing Python, this role also installs `pip` and `virtualenv` globally.
+
+ansible-role-python
+=========
+
+Ansible role for installing and configuring Python, pip, and virtualenv.
+
+https://galaxy.ansible.com/singleplatform-eng/python/
+
+Role Variables
+--------------
+
+- `logrhythm_host`: host for Mediator 1 (this is required, unless you override the entire `logrhythm_config`)
+
+- `python_apt_key_url`: apt key for installing custom python package (Default: '')
+- `python_apt_repo`: apt repo for installing custom python package (Default: '')
+- `python_global_packages`: pip packages to install globally (Default: [])
+- `python_package_name`: name of python package (Default: python)
+
+- `python_pip_config`: glocal pip.conf configuration (Default: undefined)
+
+        # Example
+        global:
+            index-url: http://pypi.example.com/simple
+            find-links:
+                - http://pypi2.example.com/simple
+                - http://pypi3.example.com/simple
+        search:
+            index: http://pypi.example.com/simple
+
+- `python_build_from_source`: whether to build from source or install package (Default: false)
+- `python_configure_prefix`: directory to install to when building from source (Default: /usr/local)
+- `python_version`: version of python to build (Default: '')
+
+Example Playbook
+----------------
 
 Install default OS package:
-```
----
 
-- hosts: all
-  become: true
-  roles:
-    - python
-```
+    ---
+
+    - hosts: all
+      become: true
+      roles:
+        - python
 
 Install custom package:
-```
----
-
-- hosts: all
-  become: true
-  vars:
-    python_apt_repo: deb http://example.repo/ trusty main
-    python_apt_key_url: https://example.repo/Release.key
-    python_package_name: python-custom
-  roles:
-    - python
-```
+
+    ---
+
+    - hosts: all
+      become: true
+      vars:
+        python_apt_repo: deb http://example.repo/ trusty main
+        python_apt_key_url: https://example.repo/Release.key
+        python_package_name: python-custom
+      roles:
+        - python
 
 Build Python 2 and 3 from source with custom prefix and global packages:
-```
----
-
-- hosts: all
-  become: true
-  vars:
-    python_build_from_source: true
-    python_configure_prefix: /opt/local
-    python_global_packages:
-      - ansible==2.0.1.0
-      - uwsgi
-  roles:
-    - { role: python, python_version: 2.7.7 }
-    - { role: python, python_version: 3.4.4 }
-```
+
+    ---
+
+    - hosts: all
+      become: true
+      vars:
+        python_build_from_source: true
+        python_configure_prefix: /opt/local
+        python_global_packages:
+          - ansible==2.0.1.0
+          - uwsgi
+      roles:
+        - { role: python, python_version: 2.7.7 }
+        - { role: python, python_version: 3.4.4 }
+
+Author Information
+------------------
+
+[SinglePlatform Engineering](http://engineering.singleplatform.com/)
+
+License
+-------
+
+BSD 3-Clause

meta/main.yml

@@ -1,17 +1,19 @@
----
 dependencies: []
-
 galaxy_info:
-  author: Colin Hoglund
-  description: Python Ansible role that supports package installs as well as building from source.
-  license: "license (BSD, MIT)"
-  min_ansible_version: 1.9
+  author: SinglePlatform Engineering (http://engineering.singleplatform.com/)
+  company: SinglePlatform (http://www.singleplatform.com/)
+  license: BSD 3-Clause
+
+  min_ansible_version: 2.1
   platforms:
-  - name: Debian
-    versions:
-    - all
-  - name: Ubuntu
-    versions:
-    - all
-  categories:
-    - development
+    - name: Ubuntu
+      versions:
+        - all
+    - name: Debian
+      versions:
+        - all
+
+  galaxy_tags:
+    - security
+    - logrhythm
+    - logging

tests/inventory

@@ -0,0 +1 @@
+localhost

tests/test.yml

@@ -0,0 +1,5 @@
+---
+- hosts: localhost
+  remote_user: root
+  roles:
+    - ansible-role-python