add github action for release and doc building

.github/workflows/build_docs.yml

@@ -0,0 +1,68 @@
+# Building and hosting documentation for PACKAGE_NAME
+#
+# Notes:
+#   - After the first run of this workflow:
+#       - Within the project repo, navigate to Setting/Github Pages
+#       - set `the source pbranch to `gh-pages/(root))`.
+#   - Uncomment evertything below the following line to enable the workflow.
+#---------------------------------------------------------------------------
+
+ name: Build Docs
+
+ on:
+   push:
+     # Sequence of patterns matched against refs/tags
+     tags:
+       - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10
+   workflow_dispatch:
+     inputs:
+       version:
+         description: Manual Doc Build
+         default: test
+         required: false
+ jobs:
+   docs:
+     name: build & push docs
+     runs-on: ${{ matrix.os }}
+     timeout-minutes: 90
+     strategy:
+       matrix:
+         os: ['ubuntu-latest']
+         environment-file: [ci/311-BASE.yaml]
+         experimental: [false]
+     defaults:
+       run:
+         shell: bash -l {0}
+
+     steps:
+       - name: checkout repo
+         uses: actions/checkout@v3
+
+       - name: setup micromamba
+         uses: mamba-org/provision-with-micromamba@main
+         with:
+           environment-file: ${{ matrix.environment-file }}
+           micromamba-version: 'latest'
+
+       - name: make docs
+         run: cd docs; make html
+
+       - name: commit docs
+         run: |
+           git clone https://github.com/ammaraskar/sphinx-action-test.git --branch gh-pages --single-branch gh-pages
+           cp -r docs/_build/html/* gh-pages/
+           cd gh-pages
+           git config --local user.email "action@github.com"
+           git config --local user.name "GitHub Action"
+           git add .
+           git commit -m "Update documentation" -a || true
+           # The above command will fail if no changes were present,
+           # so we ignore the return code.
+
+       - name: push to gh-pages
+         uses: ad-m/github-push-action@master
+         with:
+            branch: gh-pages
+            directory: gh-pages
+            github_token: ${{ secrets.GITHUB_TOKEN }}
+            force: true

.github/workflows/release_and_publish.yml

@@ -0,0 +1,44 @@
+# Release package on GitHub and publish to PyPI
+# IMPORTANT -- 1 MANUAL STEP
+#   * FOLLOWING TAGGED RELEASE
+#       - update CHANGELOG.md
+#--------------------------------------------------
+
+name: Build, Release, and publish
+
+on:
+  push:
+    # Sequence of patterns matched against refs/tags
+    tags:
+      - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Manual Release
+        default: test
+        required: false
+
+jobs:
+  build:
+    name: Create release & publish to PyPI
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+
+      - name: Set up python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install setuptools wheel twine jupyter urllib3 pandas pyyaml
+          python setup.py sdist bdist_wheel
+
+      - name: Publish distribution 📦 to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_PASSWORD }}

README.md

@@ -1,6 +1,6 @@
 # pointpats: Point Pattern Analysis in PySAL
 
-[![Continuous Integration](https://github.com/pysal/pointpats/actions/workflows/tests.yml/badge.svg)](https://github.com/pysal/pointpats/actions/workflows/tests.yml)
+[![Continuous Integration](https://github.com/pysal/pointpats/actions/workflows/tests.yaml/badge.svg)](https://github.com/pysal/pointpats/actions/workflows/tests.yaml)
 [![codecov](https://codecov.io/gh/pysal/pointpats/branch/master/graph/badge.svg)](https://codecov.io/gh/pysal/pointpats)
 [![Documentation Status](https://readthedocs.org/projects/pointpats/badge/?version=latest)](https://pointpats.readthedocs.io/en/latest/?badge=latest)
 [![PyPI version](https://badge.fury.io/py/pointpats.svg)](https://badge.fury.io/py/pointpats)
@@ -26,14 +26,14 @@ Online documentation is available
 
 ## Examples
 
--   [Basic point pattern
+- [Basic point pattern
     structure](https://github.com/pysal/pointpats/tree/master/notebooks/pointpattern.ipynb)
--   [Centrography and
+- [Centrography and
     visualization](https://github.com/pysal/pointpats/tree/master/notebooks/centrography.ipynb)
--   [Marks](https://github.com/pysal/pointpats/tree/master/notebooks/marks.ipynb)
--   [Simulation of point
+- [Marks](https://github.com/pysal/pointpats/tree/master/notebooks/marks.ipynb)
+- [Simulation of point
     processes](https://github.com/pysal/pointpats/tree/master/notebooks/process.ipynb)
--   [Distance based
+- [Distance based
     statistics](https://github.com/pysal/pointpats/tree/master/notebooks/distance_statistics-numpy-oriented.ipynb)
 
 ##  Installation

setup.py

@@ -47,7 +47,7 @@ def setup_package():
         maintainer="Hu Shao",
         maintainer_email="shaohutiger@gmail.com",
         py_modules=["pointpats"],
-        python_requires=">3.5",
+        python_requires=">3.7",
         tests_require=["pytest"],
         keywords="spatial statistics",
         classifiers=[
@@ -59,8 +59,10 @@ def setup_package():
             "Topic :: Scientific/Engineering :: GIS",
             "License :: OSI Approved :: BSD License",
             "Programming Language :: Python",
-            "Programming Language :: Python :: 3.6",
-            "Programming Language :: Python :: 3.7",
+            "Programming Language :: Python :: 3.8",
+            "Programming Language :: Python :: 3.9",
+            "Programming Language :: Python :: 3.10",
+            "Programming Language :: Python :: 3.11"
         ],
         license="3-Clause BSD",
         packages=find_packages(),