#1 Community artifacts from template-python

.dockerignore

@@ -0,0 +1,15 @@
+.github/
+docs/
+.DS_Store
+.gitignore
+.project
+.pydevproject
+CHANGELOG.md
+CODE_OF_CONDUCT.md
+CONTRIBUTING.md
+docker-compose.test.yml
+LICENSE
+Makefile
+PULL_REQUEST_TEMPLATE.md
+README.md
+requirements.txt

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+
+- OS: [e.g. iOS]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+
+- Device: [e.g. iPhone6]
+- OS: [e.g. iOS8.1]
+- Browser [e.g. stock browser, safari]
+- Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/documentation_request.md

@@ -0,0 +1,26 @@
+---
+name: Documentation request
+about: Identify an area for improvement in documentation
+
+---
+
+**What is the URL of the documentation?**
+
+- **Example:** https://github.com/Senzing/template-docker#external-database
+    - *Note:*  This URL includes the web page and the section of the documentation.
+
+**What can be improved?**
+
+A clear and concise description of what can be improved.
+Examples:
+
+- "I don't understand where the ${XYZ} variable is set."
+- "There seems to be a step missing between 'X' and 'Z'.   I don't know how to get to 'Z'."
+- "When I run `command sub-command ...`  I get the following error:"
+- "I don't know what is meant by 'gerble barb gazoink` in the instructions".
+
+**Additional context**
+
+Add any other context or screenshots to help describe the documentation improvement.
+If you think the documentation improvement is operating system specific,
+please indicate which operating system is being used.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.project

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>docker-xterm</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.python.pydev.PyDevBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.python.pydev.pythonNature</nature>
+	</natures>
+</projectDescription>

.pydevproject

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<?eclipse-pydev version="1.0"?><pydev_project>
+<pydev_property name="org.python.pydev.PYTHON_PROJECT_INTERPRETER">Default</pydev_property>
+<pydev_property name="org.python.pydev.PYTHON_PROJECT_VERSION">python interpreter</pydev_property>
+</pydev_project>

CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+[markdownlint](https://dlaa.me/markdownlint/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+- Thing 5
+- Thing 4
+
+## [1.0.1] - yyyy-mm-dd
+
+### Added to 1.0.1
+
+- Thing 3
+
+### Fixed in 1.0.1
+
+- Thing 2
+
+## [1.0.0] - yyyy-mm-dd
+
+### Added to 1.0.0
+
+- Thing 2
+- Thing 1

CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at support@senzing.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

CONTRIBUTING.md

@@ -0,0 +1,124 @@
+# Contributing
+
+Welcome to the project!
+
+We encourage contribution in a manner consistent with the [Code of Conduct](CODE_OF_CONDUCT.md).
+The following will guide you through the process.
+
+There are a number of ways you can contribute:
+
+1. [Asking questions](#questions)
+1. [Requesting features](#feature-requests)
+1. [Reporting bugs](#bug-reporting)
+1. [Contributing code or documentation](#contributing-code-or-documentation)
+
+## License Agreements
+
+If your contribution modifies the git repository, the following agreements must be established.
+
+*Note:*  License agreements are only needed for adding, modifying, and deleting artifacts kept within the repository.
+In simple terms, license agreements are needed before pull requests can be accepted.
+A license agreement is not needed for submitting feature request, bug reporting, or other project management.
+
+### Individual Contributor License Agreement
+
+In order to contribute to this repository, an
+[Individual Contributor License Agreement (ICLA)](.github/senzing-individual-contributor-license-agreement.pdf)
+must be completed, submitted and accepted.
+
+### Corporate Contributor License Agreement
+
+If the contribution to this repository is on behalf of a company, a
+[Corporate Contributor License Agreement (CCLA)](.github/senzing-corporate-contributor-license-agreement.pdf)
+must also be completed, submitted and accepted.
+
+### Project License Agreement
+
+The license agreement for this repository is stated in the
+[LICENSE](LICENSE) file.
+
+## Questions
+
+Please do not use the GitHub issue tracker to submit questions.
+
+TODO: Instead, use ???
+
+1. ??? Slack ???
+1. ??? stackoverflow.com ???
+
+## Feature Requests
+
+All feature requests are "GitHub issues".
+To request a feature, create a
+[GitHub issue](https://help.github.com/articles/creating-an-issue/)
+in this repository.
+
+When creating an issue, there will be a choice to create a "Bug report" or a "Feature request".
+Choose "Feature request".
+
+## Bug Reporting
+
+All bug reports are "GitHub issues".
+Before reporting on a bug, check to see if it has
+[already been reported](https://github.com/search?q=+is%3Aissue+user%3Asenzing).
+To report a bug, create a
+[GitHub issue](https://help.github.com/articles/creating-an-issue/)
+in this repository.
+
+When creating an issue, there will be a choice to create a "Bug report" or a "Feature request".
+Choose "Bug report".
+
+## Contributing code or documentation
+
+To contribute code or documentation to the repository, you must have
+[License Agreements](#license-agreements) in place.
+This needs to be complete before a [Pull Request](#pull-requests) can be accepted.
+
+### Setting up a development environment
+
+#### Set Environment variables
+
+These variables may be modified, but do not need to be modified.
+The variables are used throughout the installation procedure.
+
+```console
+export GIT_ACCOUNT=senzing
+export GIT_REPOSITORY=docker-xterm
+```
+
+Synthesize environment variables.
+
+```console
+export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
+export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"
+export GIT_REPOSITORY_URL="git@github.com:${GIT_ACCOUNT}/${GIT_REPOSITORY}.git"
+```
+
+#### Clone repository
+
+Get repository.
+
+```console
+mkdir --parents ${GIT_ACCOUNT_DIR}
+cd  ${GIT_ACCOUNT_DIR}
+git clone ${GIT_REPOSITORY_URL}
+cd ${GIT_REPOSITORY_DIR}
+```
+
+### Coding conventions
+
+TODO:
+
+### Testing
+
+TODO:
+
+### Pull Requests
+
+Code in the master branch is modified via GitHub pull request.
+Follow GitHub's
+[Creating a pull request from a branch](https://help.github.com/articles/creating-a-pull-request/)
+or
+[Creating a pull request from a fork](https://help.github.com/articles/creating-a-pull-request-from-a-fork/) instructions.
+
+Accepting pull requests will be at the discretion of Senzing, Inc. and the repository owner(s).

Dockerfile

@@ -0,0 +1,29 @@
+ARG BASE_IMAGE=senzing/senzing-base:1.4.0
+FROM ${BASE_IMAGE}
+
+ENV REFRESHED_AT=2020-03-01
+
+LABEL Name="senzing/template" \
+      Maintainer="support@senzing.com" \
+      Version="1.0.0"
+
+HEALTHCHECK CMD ["/app/healthcheck.sh"]
+
+# Run as "root" for system installation.
+
+USER root
+
+# Install packages via apt.
+
+# Copy files from repository.
+
+COPY ./rootfs /
+
+# Make non-root container.
+
+USER 1001
+
+# Runtime execution.
+
+WORKDIR /app
+CMD ["/app/sleep-infinity.sh"]