Initial commit of code, tests and docs.

Author: domdfcoding

.bumpversion.cfg

@@ -0,0 +1,20 @@
+[bumpversion]
+current_version = 0.0.0
+commit = True
+tag = True
+
+[bumpversion:file:README.rst]
+
+[bumpversion:file:doc-source/index.rst]
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
+
+[bumpversion:file:repo_helper.yml]
+
+[bumpversion:file:doc-source/usage.rst]
+
+[bumpversion:file:snippet_fmt/__init__.py]
+search = : str = "{current_version}"
+replace = : str = "{new_version}"

.dependabot/config.yml

@@ -0,0 +1,9 @@
+# This file is managed by 'repo_helper'. Don't edit it directly.
+---
+version: 1
+update_configs:
+- package_manager: python
+  directory: /
+  update_schedule: weekly
+  default_reviewers:
+  - domdfcoding

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,51 @@
+---
+name: Bug report
+about: Create a report to help us improve
+labels: bug
+assignees: domdfcoding
+
+---
+
+<!-- Have you searched for similar issues? Before submitting this issue, please check the open issues and add a note before logging a new issue.
+
+PLEASE USE THE TEMPLATE BELOW TO PROVIDE INFORMATION ABOUT THE ISSUE.
+THE ISSUE WILL BE CLOSED IF INSUFFICIENT INFORMATION IS PROVIDED.
+-->
+
+## Description
+<!--Provide a brief description of the issue-->
+
+
+## Steps to Reproduce
+<!--Please add a series of steps to reproduce the issue.
+
+If possible, please include a small, self-contained reproduction.
+-->
+
+   1.
+   2.
+   3.
+
+## Actual result:
+<!--Please add screenshots if needed and include the Python traceback if present-->
+
+
+## Expected result:
+
+
+## Reproduces how often:
+<!--[Easily reproduced/Intermittent issue/No steps to reproduce]-->
+
+
+## Version
+
+  * Operating System:
+  * Python:
+  * snippet-fmt:
+
+## Installation source
+<!-- e.g. GitHub repository, GitHub Releases, PyPI/pip, Anaconda/conda -->
+
+
+## Other Additional Information:
+<!--Any additional information, related issues, extra QA steps, configuration or data that might be necessary to reproduce the issue-->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+labels: "enhancement"
+assignees: domdfcoding
+
+---
+
+<!-- Have you searched for similar issues? Someone may already be working on the feature you are suggesting. Before submitting this issue, please check the open issues and add a note before logging a new issue.
+-->
+
+
+## Description
+<!--Provide a clear and concise description of what the problem is and the improvement you are suggesting-->
+
+<!--Please add screenshots if needed-->
+
+
+## Version
+
+  * Operating System:
+  * Python:
+  * snippet-fmt:
+
+
+## Other Additional Information:
+<!--Any additional information, related issues, etc.-->

.github/auto_assign.yml

@@ -0,0 +1,9 @@
+# This file is managed by 'repo_helper'. Don't edit it directly.
+---
+addReviewers: true
+addAssignees: true
+reviewers:
+- domdfcoding
+numberOfReviewers: 0
+
+# more settings at https://github.com/marketplace/actions/auto-assign-action

.github/dependabot.yml

@@ -0,0 +1,10 @@
+# This file is managed by 'repo_helper'. Don't edit it directly.
+---
+version: 2
+updates:
+- package-ecosystem: pip
+  directory: /
+  schedule:
+    interval: weekly
+  reviewers:
+  - domdfcoding

.github/stale.yml

@@ -0,0 +1,63 @@
+# This file is managed by 'repo_helper'. Don't edit it directly.
+# Configuration for probot-stale - https://github.com/probot/stale
+---
+
+# Number of days of inactivity before an Issue or Pull Request becomes stale
+daysUntilStale: 180
+
+# Number of days of inactivity before an Issue or Pull Request with the stale label is closed.
+# Set to false to disable. If disabled, issues still need to be closed manually, but will remain marked as stale.
+daysUntilClose: 180
+
+# Only issues or pull requests with all of these labels are check if stale. Defaults to `[]` (disabled)
+onlyLabels: []
+
+# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable
+exemptLabels:
+  - pinned
+  - security
+  - "[Status] Maybe Later"
+
+# Set to true to ignore issues in a project (defaults to false)
+exemptProjects: false
+
+# Set to true to ignore issues in a milestone (defaults to false)
+exemptMilestones: false
+
+# Set to true to ignore issues with an assignee (defaults to false)
+exemptAssignees: false
+
+# Label to use when marking as stale
+staleLabel: stale
+
+# Comment to post when marking as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. Thank you
+  for your contributions.
+
+# Comment to post when removing the stale label.
+# unmarkComment: >
+#   Your comment here.
+
+# Comment to post when closing a stale Issue or Pull Request.
+# closeComment: >
+#   Your comment here.
+
+# Limit the number of actions per hour, from 1-30. Default is 30
+limitPerRun: 30
+
+# Limit to only `issues` or `pulls`
+# only: issues
+
+# Optionally, specify configuration settings that are specific to just 'issues' or 'pulls':
+# pulls:
+#   daysUntilStale: 30
+#   markComment: >
+#     This pull request has been automatically marked as stale because it has not had
+#     recent activity. It will be closed if no further activity occurs. Thank you
+#     for your contributions.
+
+# issues:
+#   exemptLabels:
+#     - confirmed

.github/workflows/cleanup.yml

@@ -0,0 +1,14 @@
+# This file is managed by 'repo_helper'. Don't edit it directly.
+---
+name: Artefact Cleaner
+on:
+  schedule:
+  - cron: 0 9 1 * *
+jobs:
+  Clean:
+    runs-on: ubuntu-latest
+    steps:
+    - name: cleanup
+      uses: glassechidna/artifact-cleaner@v2
+      with:
+        minimumAge: 1000000.0

.github/workflows/docs_test_action.yml

@@ -0,0 +1,36 @@
+# This file is managed by 'repo_helper'. Don't edit it directly.
+---
+name: "Docs Check"
+on:
+  push:
+    branches-ignore:
+      - 'repo-helper-update'
+      - 'pre-commit-ci-update-config'
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout 🛎️
+        uses: "actions/checkout@v1"
+
+      - name: Check for changed files
+        uses: dorny/paths-filter@v2
+        id: changes
+        with:
+          list-files: "json"
+          filters: |
+            code:
+              - '!tests/**'
+
+      - name: Install and Build 🔧
+        uses: sphinx-toolbox/sphinx-action@sphinx-3.3.1
+        if: steps.changes.outputs.code == 'true'
+        with:
+          pre-build-command: python -m pip install tox
+          docs-folder: "doc-source/"
+          build-command: "tox -e docs -- "

.github/workflows/flake8.yml

@@ -0,0 +1,49 @@
+# This file is managed by 'repo_helper'. Don't edit it directly.
+---
+name: Flake8
+
+on:
+  push:
+    branches-ignore:
+      - 'repo-helper-update'
+      - 'pre-commit-ci-update-config'
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  Run:
+    name: "Flake8"
+    runs-on: "ubuntu-18.04"
+
+    steps:
+      - name: Checkout 🛎️
+        uses: "actions/checkout@v2"
+
+      - name: Check for changed files
+        uses: dorny/paths-filter@v2
+        id: changes
+        with:
+          list-files: "json"
+          filters: |
+            code:
+              - '!(doc-source/**|CONTRIBUTING.rst|.imgbotconfig|.pre-commit-config.yaml|.pylintrc|.readthedocs.yml)'
+
+      - name: Setup Python 🐍
+        if: steps.changes.outputs.code == 'true'
+        uses: "actions/setup-python@v2"
+        with:
+          python-version: "3.6"
+
+      - name: Install dependencies 🔧
+        if: steps.changes.outputs.code == 'true'
+        run: |
+          python -VV
+          python -m site
+          python -m pip install --upgrade pip setuptools wheel
+          python -m pip install tox
+
+      - name: "Run Flake8"
+        if: steps.changes.outputs.code == 'true'
+        run: "python -m tox -e lint -s false -- --format github"