Merge pull request #85 from opera-adt/pixi

Utilize Pixi for dependecy and virtual env management

Author: cmarshak

.gitattributes

@@ -0,0 +1,2 @@
+# SCM syntax highlighting & preventing 3-way merges
+pixi.lock merge=binary linguist-language=YAML linguist-generated=true -diff

.github/workflows/nb_tests.yml

@@ -14,10 +14,6 @@ on:
 jobs:
   pytest:
     runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ['3.12']
 
     steps:
       - uses: actions/checkout@v6
@@ -28,19 +24,13 @@ jobs:
           username: ${{ secrets.EARTHDATA_USERNAME }}
           password: ${{ secrets.EARTHDATA_PASSWORD }}
 
-      - uses: mamba-org/setup-micromamba@v3
+      - uses: prefix-dev/setup-pixi@v0.8.1
         with:
-          environment-name: dist-s1-enumerator
-          environment-file: environment.yml
-          extra-specs: |
-            python=${{ matrix.python-version }}
-          create-args: |
-            papermill
+          pixi-version: latest
 
-      - name: Pytest Notebook tests in conda environment
-        shell: bash -l {0}
+      - name: Pytest Notebook tests
         run: |
-          mamba install papermill --yes
-          python -m pip install --no-deps .
-          python -m ipykernel install --user --name dist-s1-enumerator
-          pytest . -m 'notebooks'
+          pixi run pip install --no-deps .
+          pixi run pip install papermill
+          pixi run python -m ipykernel install --user --name dist-s1-enumerator
+          pixi run pytest . -m 'notebooks'

.github/workflows/tests.yml

@@ -1,4 +1,4 @@
-name: Unit and Small Integration Tests 
+name: Unit and Small Integration Tests
 
 on:
   workflow_dispatch:
@@ -14,10 +14,6 @@ on:
 jobs:
   pytest:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.12", "3.13"]
-      fail-fast: false
 
     steps:
       - uses: actions/checkout@v6
@@ -28,16 +24,11 @@ jobs:
           username: ${{ secrets.EARTHDATA_USERNAME }}
           password: ${{ secrets.EARTHDATA_PASSWORD }}
 
-      - uses: mamba-org/setup-micromamba@v3
+      - uses: prefix-dev/setup-pixi@v0.8.1
         with:
-            environment-name: dist-s1-enumerator
-            environment-file: environment.yml
-            create-args: >-
-              python=${{ matrix.python-version }}
+          pixi-version: latest
 
-
-      - name: Pytest in conda environment
-        shell: bash -l {0}
+      - name: Pytest
         run: |
-          python -m pip install --no-deps .
-          pytest . -m 'not notebooks'
+          pixi run python -m pip install --no-deps .
+          pixi run pytest . -m 'not notebooks'

.gitignore

@@ -99,3 +99,6 @@ notebooks/*.parquet
 # out tests
 tests/tmp/
 tests/out/
+# pixi environments
+.pixi/*
+!.pixi/config.toml

CHANGELOG.md

@@ -6,6 +6,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [PEP 440](https://www.python.org/dev/peps/pep-0440/)
 and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.14] - 2026-01-27
+
+### Changed
+* Use pixi for dependency and virtual environment management.
+
 ## [1.0.13] - 2026-01-27
 
 ### Fixed

README.md

@@ -15,7 +15,9 @@ We use "enumeration" to describe the "curation of required DIST-S1 inputs."
 
 ## Installation/Setup
 
-We recommend managing dependencies and virutal environments using [mamba/conda](https://mamba.readthedocs.io/en/latest/user_guide/installation.html).
+### Mamba
+
+We used mamba to manage virutal environments and dependencies: [mamba/conda](https://mamba.readthedocs.io/en/latest/user_guide/installation.html). However, `pixi` is the more modern approach and will be integrated (see below).
 
 ```bash
 mamba update -f environment.yml  # creates a new environment dist-s1-enumerator
@@ -24,6 +26,23 @@ pip install dist-s1-enumerator
 python -m ipykernel install --user --name dist-s1-enumerator
 ```
 
+### Pixi
+
+Install [pixi](https://pixi.sh/latest/#installation), then:
+
+```bash
+git clone https://github.com/opera-adt/dist-s1-enumerator.git
+cd dist-s1-enumerator
+pixi install
+pixi run python -c "import dist_s1_enumerator"
+```
+
+For JupyterLab:
+
+```bash
+pixi run jupyter lab
+```
+
 ### Downloading data
 
 For searching through the metadata of OPERA RTC-S1, you will not need any earthdata credentials.

pixi.lock

@@ -0,0 +1,37 @@
+[workspace]
+authors = ["Charlie Marshak <charlie.z.marshak@jpl.nasa.gov>"]
+channels = ["conda-forge"]
+name = "dist-s1-enumerator"
+platforms = ["osx-arm64", "linux-64", "osx-64"]
+version = "0.1.0"
+
+[tasks]
+
+[dependencies]
+python = ">=3.14.6,<4"
+pip = ">=26.1.2,<27"
+asf_search = ">=12.2.2,<13"
+tenacity = ">=8.2.2,<9"
+contextily = ">=1.7.0,<2"
+flake8 = ">=7.3.0,<8"
+flake8-blind-except = ">=0.2.1,<0.3"
+flake8-builtins = ">=3.1.0,<4"
+flake8-import-order = ">=0.19.2,<0.20"
+geopandas = ">=1.1.3,<2"
+ipykernel = ">=7.3.0,<8"
+isort = ">=8.0.1,<9"
+jupyterlab = ">=4.5.8,<5"
+matplotlib = ">=3.10.9,<4"
+numpy = ">=2.4.6,<3"
+pandas = ">=3.0.3,<4"
+pandera = ">=0.31.1,<0.32"
+pyarrow = ">=24.0.0,<25"
+pytest = ">=9.0.3,<10"
+pytest-cov = ">=7.1.0,<8"
+pytest-mock = ">=3.15.1,<4"
+rasterio = ">=1.5.0,<2"
+requests = ">=2.34.2,<3"
+ruff = ">=0.15.17,<0.16"
+shapely = ">=2.1.2,<3"
+tqdm = ">=4.68.2,<5"
+jupyter = ">=1.1.1,<2"