feat: ci

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: ApeWorX

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Report an error that you've encountered.
+labels: 'category: bug'
+---
+
+### Environment information
+
+- OS: macOS / linux / win
+- Python Version: x.x.x
+- `ape` and plugin versions:
+
+```sh
+$ ape --version
+# ...copy and paste result of above command here...
+
+$ ape plugins list
+# ...copy and paste result of above command here...
+```
+
+- Contents of your `ape-config.yaml` (NOTE: do not post anything private like RPC urls or secrets!):
+
+```sh
+$ cat ape-config.yaml
+# ...copy and paste result of above command here...
+```
+
+### What went wrong?
+
+Please include information like:
+
+- what command you ran
+- the code that caused the failure (see [this link](https://help.github.com/articles/basic-writing-and-formatting-syntax/) for help with formatting code)
+- full output of the error you received
+
+### How can it be fixed?
+
+Fill this in if you have ideas on how the bug could be fixed.

.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Request a new feature, or an improvement to existing functionality.
+labels: 'category: feature'
+---
+
+### Overview
+
+Provide a simple overview of what you wish to see added. Please include:
+
+- What you are trying to do
+- Why Ape's current functionality is inadequate to address your goal
+
+### Specification
+
+Describe the syntax and semantics of how you would like to see this feature implemented. The more detailed the better!
+
+Remember, your feature is much more likely to be included if it does not involve any breaking changes.
+
+### Dependencies
+
+Include links to any open issues that must be resolved before this feature can be implemented.

.github/ISSUE_TEMPLATE/work-item.md

@@ -0,0 +1,47 @@
+---
+name: Work item
+about: New work item for Ape team
+---
+
+### Elevator pitch:
+
+<!-- 1-2 line summary of the scope of this work item -->
+
+### Value:
+
+<!--
+  Who is this for?
+  Persona or group of people whom will derive value from the scenario.
+  What benefits will be achieved or business metrics improved?
+-->
+
+### Dependencies:
+
+<!-- Call out key people, teams, tech dependencies, or assumptions. -->
+
+### Design approach:
+
+<!--
+  Free text / diagram / whiteboard picture / etc. that clearly shows your approach and considerations to build the task list.
+  Existing code patterns in production code base that you will base your work off of.
+-->
+
+### Task list:
+
+<!-- Bulleted list describing the exit criteria, desired end state and any documentation, monitors, work for DRI, etc. that will need to be added to make sure someone else can support once it's live. -->
+
+- \[ \] Tasks go here
+
+### Estimated completion date:
+
+### Design review:
+
+<!-- 1-2 people needed for signoff -->
+
+Do not signoff unless:
+
+- 1. agreed the tasks and design approach will achieve acceptance, and
+- 2. the work can be completed by one person within the SLA.
+     Design reviewers should consider simpler approaches to achieve goals.
+
+(Please leave a comment to sign off)

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+### What I did
+
+<!-- Create a summary of the changes -->
+
+<!-- The `fixes:` field denotes an issue that will be marked resolved by merging this PR -->
+
+fixes: #
+
+### How I did it
+
+<!-- Discuss the thought process behind the change -->
+
+### How to verify it
+
+<!-- Discuss any methods that should be used to verify the change -->
+
+### Checklist
+
+<!-- All PRs must complete the following checklist before being merged -->
+
+- [ ] All changes are completed
+- [ ] New test cases have been added
+- [ ] Documentation has been updated

.github/release-drafter.yml

@@ -0,0 +1,39 @@
+name-template: '$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+
+categories:
+  - title: 'Features'
+    labels:
+      - 'feat'
+  - title: 'Bug Fixes'
+    labels:
+      - 'fix'
+  - title: 'Other updates'
+    labels:
+      - 'refactor'
+      - 'chore'
+      - 'docs'
+      - 'perf'
+      - 'test'
+
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+change-title-escapes: '\<*_&' # You can add # and @ to disable mentions, and add ` to disable code blocks.
+
+version-resolver:
+  major:
+    labels:
+      - 'major'
+  minor:
+    labels:
+      - 'minor'
+  patch:
+    labels:
+      - 'patch'
+  default: patch
+
+template: |
+  ## Changes
+
+  $CHANGES
+
+  Special thanks to: $CONTRIBUTORS

.github/workflows/codeql.yml

@@ -0,0 +1,34 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v2
+      with:
+        languages: python
+
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v2
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v2

.github/workflows/commitlint.yaml

@@ -0,0 +1,28 @@
+on: push
+
+name: Commit Message
+
+# NOTE: Skip check on PR so as not to confuse contributors
+# NOTE: Also install a PR title checker so we don't mess up merges
+jobs:
+    commit-msg:
+
+        runs-on: ubuntu-latest
+
+        steps:
+        - uses: actions/checkout@v3
+          with:
+              fetch-depth: 0
+
+        - name: Setup Python
+          uses: actions/setup-python@v4
+          with:
+              python-version: "3.10"
+
+        - name: Install Dependencies
+          run: |
+            python -m pip install --upgrade pip
+            pip install -r cz-requirement.txt
+
+        - name: Check commit history
+          run: cz check --rev-range $(git rev-list --all --reverse | head -1)..HEAD

.github/workflows/docs.yaml

@@ -0,0 +1,57 @@
+name: Docs
+
+on:
+    push:
+        branches: [main]
+    release:
+        types: [released]
+    pull_request:
+        types: [opened, synchronize]
+
+jobs:
+    docs:
+        runs-on: ubuntu-latest
+
+        steps:
+        - uses: actions/checkout@v3
+
+        - name: Setup Python
+          uses: actions/setup-python@v4
+          with:
+              python-version: "3.10"
+
+        - name: Install Dependencies
+          run: |
+            python -m pip install --upgrade pip
+            pip install .[doc]
+
+        - name: Build HTML artifact
+          run: python build_docs.py
+
+        - name: Upload HTML artifact
+          uses: actions/upload-artifact@v3
+          with:
+              name: DocumentationHTML
+              path: docs/_build/ape
+
+        - name: Commit and publish documentation changes to gh-pages branch
+          run: |
+              if [[ "${GITHUB_EVENT_NAME}" =~ "pull_request" ]]; then
+                echo "skipping 'git commit' step for PR"
+              else
+                git clone https://github.com/${GITHUB_REPOSITORY} --branch gh-pages --single-branch gh-pages
+                cp -r docs/_build/ape/* gh-pages/
+                cd gh-pages
+                touch .nojekyll
+                git config --local user.email "[email protected]"
+                git config --local user.name "GitHub Action"
+                git add .
+                git commit -m "Update documentation" -a || true
+              fi
+        - name: Push changes
+          uses: ad-m/github-push-action@master
+          if: ${{ github.event_name != 'pull_request' }}
+          with:
+              branch: gh-pages
+              directory: gh-pages
+              github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/draft.yaml

@@ -0,0 +1,17 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  update-draft:
+    runs-on: ubuntu-latest
+    steps:
+      # Drafts your next Release notes as Pull Requests are merged into "main"
+      - uses: release-drafter/release-drafter@v5
+        with:
+          disable-autolabeler: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/prtitle.yaml

@@ -0,0 +1,30 @@
+name: PR Title
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - synchronize
+
+jobs:
+    pr-title:
+        runs-on: ubuntu-latest
+
+        steps:
+        - uses: actions/checkout@v3
+
+        - name: Setup Python
+          uses: actions/setup-python@v4
+          with:
+              python-version: "3.10"
+
+        - name: Install Dependencies
+          run: |
+            python -m pip install --upgrade pip
+            pip install -r cz-requirement.txt
+
+        - name: Check PR Title
+          env:
+              TITLE: ${{ github.event.pull_request.title }}
+          run: cz check --message "$TITLE"

.github/workflows/publish.yaml

@@ -0,0 +1,32 @@
+name: Release
+
+on:
+  release:
+    types: [released]
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.10"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .[release]
+
+    - name: Build
+      run: python setup.py sdist bdist_wheel
+
+    - name: Publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: twine upload dist/*