chore: init project setup

Author: Heiru Wu

.appveyor.yml

@@ -0,0 +1,30 @@
+image: Visual Studio 2019
+
+environment:
+  global:
+    RANDOM_SEED: 0
+  matrix:
+    - PYTHON_MAJOR: 3
+      PYTHON_MINOR: 8
+
+cache:
+  - .venv -> poetry.lock
+
+install:
+  # Add Make and Python to the PATH
+  - copy C:\MinGW\bin\mingw32-make.exe C:\MinGW\bin\make.exe
+  - set PATH=%PATH%;C:\MinGW\bin
+  - set PATH=C:\Python%PYTHON_MAJOR%%PYTHON_MINOR%;%PATH%
+  - set PATH=C:\Python%PYTHON_MAJOR%%PYTHON_MINOR%\Scripts;%PATH%
+  # Install system dependencies
+  - curl -sSL https://install.python-poetry.org | python -
+  - set PATH=%USERPROFILE%\AppData\Roaming\Python\Scripts;%PATH%
+  - make doctor
+  # Install project dependencies
+  - make install
+
+build: off
+
+test_script:
+  - make check
+  - make test

.coveragerc

@@ -0,0 +1,18 @@
+[run]
+
+branch = true
+
+data_file = .cache/coverage
+
+omit =
+    .venv/*
+    */tests/*
+    */__main__.py
+
+[report]
+
+exclude_lines =
+    pragma: no cover
+    raise NotImplementedError
+    except DistributionNotFound
+    TYPE_CHECKING

.gitattributes

@@ -0,0 +1,3 @@
+* text=auto
+CHANGELOG.md merge=union
+poetry.lock merge=binary

.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: main
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.7', '3.8', '3.9', '3.10']
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - uses: Gr1N/setup-poetry@v8
+
+    - name: Check dependencies
+      run: make doctor
+
+    - uses: actions/cache@v2
+      with:
+        path: .venv
+        key: ${{ runner.os }}-poetry-${{ hashFiles('poetry.lock') }}
+
+    - name: Install dependencies
+      run: make install
+
+    - name: Check code
+      run: make check
+
+    - name: Test code
+      run: make test
+
+    - name: Upload coverage
+      uses: codecov/codecov-action@v1
+      with:
+        fail_ci_if_error: true

.gitignore

@@ -0,0 +1,53 @@
+# Temporary Python files
+*.pyc
+*.egg-info/
+__pycache__/
+.ipynb_checkpoints/
+setup.py
+pip-wheel-metadata/
+
+# Temporary OS files
+Icon*
+
+# Temporary virtual environment files
+/.cache/
+/.venv/
+tmp/
+
+# Temporary server files
+.env
+*.pid
+
+# Generated documentation
+/docs/gen/
+/docs/apidocs/
+/site/
+/*.html
+/docs/*.png
+
+# Google Drive
+*.gdoc
+*.gsheet
+*.gslides
+*.gdraw
+
+# Testing and coverage results
+/.coverage
+/.coverage.*
+/htmlcov/
+/prof/
+coverage.xml
+
+# Build and release directories
+/build/
+/dist/
+*.spec
+
+# Sublime Text
+*.sublime-workspace
+
+# Eclipse
+.settings
+
+# VSCode
+.vscode

.pydocstyle.ini

@@ -0,0 +1,14 @@
+[pydocstyle]
+
+# D211: No blank lines allowed before class docstring
+add_select = D211
+
+# D100: Missing docstring in public module
+# D101: Missing docstring in public class
+# D102: Missing docstring in public method
+# D103: Missing docstring in public function
+# D104: Missing docstring in public package
+# D105: Missing docstring in magic method
+# D107: Missing docstring in __init__
+# D202: No blank lines allowed after function docstring
+add_ignore = D100,D101,D102,D103,D104,D105,D107,D202