Trying to merge upstream changes into my fork.

.dockerignore

@@ -0,0 +1,8 @@
+.travis.yml
+ISSUE_TEMPLATE.md
+docs/
+test/
+tools/
+COPYRIGHT
+env-setup
+.vscode

.gitignore

@@ -41,3 +41,18 @@ nosetests.xml
 docs/build
 docs/*.rst
 docs/_build/
+docs/sphinx.log
+
+tests/.vagrant/*
+
+# Window File Explorer
+desktop.ini
+
+# Mac OS X Finder
+.DS_Store
+
+# PyCharm
+.idea
+
+# VC Code
+.vscode

COPYRIGHT

@@ -1,5 +1,5 @@
 
- Copyright (c) 1999-2014, Juniper Networks Inc.
+ Copyright (c) 1999-2020, Juniper Networks Inc.
                2014, Jeremy Schulman
 
  All rights reserved.

DOCKER-EXAMPLES.md

@@ -0,0 +1,78 @@
+# Examples of using the Docker image
+
+To run this as a Docker container, which includes JSNAPy and PyEZ, simply pull it from the Docker hub and run it. The following will pull the latest image and run it in an interactive ash shell.
+
+  docker run -it --rm juniper/pyez-ansible
+
+Although, you'll probably want to bind mount a host directory (perhaps the directory containing your playbooks and associated files). The following will bind mount the current working directory and start the ash shell.
+
+  docker run -it --rm -v $PWD:/project juniper/pyez-ansible
+
+You can also use the container as an executable to run your playbooks. Let's assume we have a typical playbook structure as below:
+
+    example
+    |playbook.yml
+    |hosts
+    |-vars
+    |-templates
+    |-scripts
+
+We can move to the example directory and run the playbook with the following command:
+
+  cd example/
+  docker run -it --rm -v $PWD:/playbooks juniper/pyez-ansible ansible-playbook -i hosts playbook.yml
+
+You can pass any valid command string after the container name and it will be passed to Bash for execution.
+
+You may have noticed that the base command is almost always the same. We can also use an alias to save some keystrokes.
+
+  alias pb-ansible="docker run -it --rm -v $PWD:/project juniper/pyez-ansible ansible-playbook"
+  pb-ansible -i hosts playbook.yml
+
+### Extending the container with additional packages
+
+It's possible to install additional OS (Alpine) packages, Python packages (via pip), and Ansible collections at container instantiation. This can be done by passing in environment variables or binding mount files.
+
+#### OS Packages
+
+Environment Variable: `$APK`
+Bind Mount: `/extras/apk.txt`
+File Format: list of valid Alpine packages, one per line
+Examples:
+
+As an environment variable, where the file containing a list of packages is in the current directory.
+
+ docker run -it --rm -v $PWD:/project -e APK="apk.txt" juniper/pyez-ansible
+
+As a bind mount.
+
+  docker run -it --rm -v $PWD/apk.txt:/extras/apk.txt juniper/pyez-ansible
+
+#### Python Packages
+
+Environment Variable: `$REQ`
+Bind Mount: `/extras/requirements.txt`
+File Format: pip [requirements](https://pip.pypa.io/en/stable/reference/requirements-file-format/) file
+
+Examples:
+
+  docker run -it --rm -v $PWD:/project -e REQ="requirements.txt" juniper/pyez-ansible
+
+As a bind mount.
+
+  docker run -it --rm -v $PWD/requirements.txt:/extras/requirements.txt juniper/pyez-ansible
+
+#### Ansible Packages
+
+Environment Variable: `$COLLECTIONS`
+Bind Mount: `/extras/requirements.yml`
+File Format: Ansible [requirements](https://docs.ansible.com/ansible/devel/user_guide/collections_using.html#install-multiple-collections-with-a-requirements-file) file
+
+
+Examples:
+
+  docker run -it --rm -v $PWD:/project -e REQ="requirements.yml" juniper/pyez-ansible
+
+As a bind mount.
+
+  docker run -it --rm -v $PWD/requirements.txt:/extras/requirements.yml juniper/pyez-ansible

Dockerfile

@@ -0,0 +1,35 @@
+FROM python:3.12-alpine
+
+LABEL net.juniper.image.maintainer="Juniper Networks <[email protected]>" \
+      net.juniper.image.description="Lightweight image with Ansible and the Junos roles"
+
+WORKDIR /tmp
+
+## Copy project inside the containers
+ADD requirements.txt .
+ADD entrypoint.sh /usr/local/bin/.
+
+## Install dependencies and PyEZ
+RUN apk add --no-cache build-base python3-dev py3-pip \
+    libxslt-dev libxml2-dev libffi-dev openssl-dev curl \
+    ca-certificates py3-pip bash openssh-client
+
+RUN pip install --upgrade pip \
+    && python3 -m pip install -r requirements.txt
+
+# Also install the collections juniper.device
+# Install Ansible modules in one layer
+RUN ansible-galaxy collection install juniper.device
+
+## Clean up and start init
+RUN apk del -r --purge gcc make g++ \
+    && rm -rf /var/cache/apk/* \
+    && rm -rf /tmp/* \
+    && rm -rf /root/.cache \
+    && chmod +x /usr/local/bin/entrypoint.sh
+
+WORKDIR /project
+
+VOLUME /project
+
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

ISSUE_TEMPLATE.md

@@ -0,0 +1,55 @@
+<!---
+Verify first that your issue/request is not already reported on GitHub. -->
+
+Issue Type
+------
+<!--- Pick one below and delete the rest -->
+ - Bug Report
+ - Feature Idea
+ - Documentation Report
+
+Module Name
+------
+<!--- Insert, BELOW THIS COMMENT, the name of the module, plugin, task or feature
+-->
+
+juniper.device collection and Python libraries version
+<!--- Paste, BELOW THIS COMMENT, verbatim output from "ansible --version" and  "pip freeze" between quotes below
+Also provide the version of juniper.device collection-->
+```
+
+```
+
+OS / Environment
+------
+<!--- Mention, the JUNOS version and firmware model you are trying to control-->
+
+Summary
+------
+<!--- Explain the problem briefly -->
+
+Steps to reproduce
+------
+<!--- For bugs, show exactly how to reproduce the problem, using a minimal test-case.
+For new features, show how the feature would be used. -->
+
+<!--- Paste example playbooks or commands between quotes below -->
+```yaml
+
+```
+
+<!--- You can also paste gist.github.com links for larger files -->
+
+Expected results
+<!--- What did you expect to happen when running the steps above? -->
+```
+
+```
+Actual results
+------
+<!--- What actually happened? If possible run with extra verbosity (-vvvv) -->
+
+<!--- Paste verbatim command output between quotes below -->
+```
+
+```

LICENSE

@@ -199,4 +199,3 @@ Apache License
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-