use github action and pages

- switch from gitlab-ci to github actions
- use gh-pages for docs
- publish to pypi

Author: thomas-maschler

.github/workflows/docs.yml

@@ -0,0 +1,21 @@
+name: Docs
+
+env:
+  PIXI_LOCKED: true
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Pixi
+        uses: prefix-dev/[email protected]
+        with:
+          pixi-version: v0.59.0
+          run-install: false
+      - run: pixi run -e docs deploy

.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPi
+
+env:
+  PIXI_LOCKED: true
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+
+  publish:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    env:
+      TWINE_USERNAME: "__token__"
+      TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      TWINE_REPOSITORY_URL: "https://upload.pypi.org/legacy/"
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Pixi
+        uses: prefix-dev/[email protected]
+        with:
+          pixi-version: v0.59.0
+          run-install: false
+      - run: pixi run -e build deploy

.github/workflows/publish_test.yml

@@ -0,0 +1,26 @@
+name: Publish to Test PyPi
+
+env:
+  PIXI_LOCKED: true
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    if: github.ref != 'refs/heads/main'
+    env:
+      TWINE_USERNAME: "__token__"
+      TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      TWINE_REPOSITORY_URL: "https://test.pypi.org/legacy/"
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Pixi
+        uses: prefix-dev/[email protected]
+        with:
+          pixi-version: v0.59.0
+          run-install: false
+      - run: pixi run -e build deploy

.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: Test
+
+
+env:
+  PIXI_LOCKED: true
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Pixi
+        uses: prefix-dev/[email protected]
+        with:
+          pixi-version: v0.59.0
+          run-install: false
+      - run: pixi run -e lint lint
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        gdal: [gdal38, gdal39, gdal310, gdal311]
+        stac_version: ["1.0.0", "1.1.0"]
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Pixi
+        uses: prefix-dev/[email protected]
+        with:
+          pixi-version: v0.59.0
+          run-install: false
+      - run: sudo apt-get update && sudo apt-get install -y build-essential
+      - run: pixi run -e dev-${{ matrix.gdal }} test
+        env:
+          PYSTAC_STAC_VERSION_OVERRIDE: ${{ matrix.stac_version }}

.gitlab-ci.yml

@@ -6,7 +6,7 @@ rio-stac-io is a [rasterio](https://github.com/rasterio/rasterio) extension to o
 
 ## Documentation
 
-https://planetary-variables.pages.earth.planet.com/forests/rio-stac-io/
+https://planetlabs.github.io/rio-stac-io
 
 
 ## Installation

README.md

@@ -9,15 +9,14 @@ site_dir: 'build'
 # site info
 repo_name: 'forests/rio-stac-io'
 repo_url: 'https://github.com/planetlabs/rio-stac-io'
-site_url: 'https://planetary-variables.pages.earth.planet.com/forests/rio-stac-io/'
-
+site_url: 'https://planetlabs.github.io/rio-stac-io'
 # social
 extra:
     social:
       - icon: 'material/earth'
-        link: 'https://hello.planet.com/code/planetary-variables/forests'
-      - icon: 'fontawesome/brands/gitlab'
-        link: 'https://hello.planet.com/code/planetary-variables/forests'
+        link: 'https://github.com/planetlabs/'
+      - icon: 'fontawesome/brands/github'
+        link: 'https://github.com/planetlabs/rio-stac-io'
 
 # site navigation
 nav:

mkdocs.yml

@@ -114,7 +114,7 @@ livereload = ">=2.6.3"
 
 [tool.pixi.feature.docs.tasks]
 localdocs = "mkdocs serve"
-deploy = "mkdocs build --strict --verbose --site-dir public"
+deploy = "mkdocs gh-deploy"
 
 ######## Pixi/ Hatch Build