add github ref as input for publish

Author: glass-ships

README.md

@@ -19,7 +19,18 @@ GitHub action to verify a conda package by installing it with `micromamba` and e
 
 #### Usage
 
-Available inputs are listed in [`pkg-verify/action.yaml`](#pkg-verify/action.yaml).
+Full list of available inputs in [`pkg-verify/action.yaml`](#pkg-verify/action.yaml).
+
+Inputs:
+
+| Input            | Description                                                                       | Required | Default |
+| ---------------- | --------------------------------------------------------------------------------- | -------- | ------- |
+| `local-channel`  | Path to the local conda channel containing the package to verify                  | No       | -       |
+| `package-name`   | Name of the conda package                                                         | Yes      | -       |
+| `module-name`    | Name of the Python module to import (if different from package name)              | No       | -       |
+| `python-version` | Python version to use for testing (e.g., `3.10`)                                  | No       | `3.10`  |
+| `extra-channels` | Additional conda channels to use for dependencies (comma-separated)               | No       | -       |
+| `extra-commands` | Additional shell commands to run after installing the package (newline-separated) | No       | -       |
 
 Example usage in a GitHub workflow:
 
@@ -67,22 +78,7 @@ keeping the N most recent versions.
 
 #### Usage
 
-Available inputs are listed in [`pkg-remove/action.yaml`](#pkg-remove/action.yaml).
-
-```yaml
-jobs:
-  cleanup:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Remove old dev packages
-        uses: neutrons/conda-actions/pkg-remove@main
-        with:
-          anaconda_token: ${{ secrets.ANACONDA_TOKEN }}
-          organization: neutrons
-          package_name: my-package
-          label: dev
-          keep: 5
-```
+Full list of available inputs in [`pkg-remove/action.yaml`](#pkg-remove/action.yaml).
 
 Inputs:
 
@@ -91,7 +87,7 @@ Inputs:
 | `anaconda_token` | Anaconda.org API token                                                | Yes      | -       |
 | `organization`   | Anaconda.org organization or user name                                | Yes      | -       |
 | `package_name`   | Name of the conda package to clean up                                 | Yes      | -       |
-| `label`          | Label to target for cleanup (e.g., `dev`, `nightly`, `rc`)            | Yes      | -       |
+| `label`          | Label to target for cleanup (e.g., `dev`, `nightly`, `rc`)            | No       | -       |
 | `keep`           | Number of most recent package versions to keep                        | No       | `5`     |
 | `dry_run`        | If `true`, only print what would be deleted without actually deleting | No       | `false` |
 
@@ -101,10 +97,65 @@ Outputs:
 | ------------- | ------------------------------------- |
 | `num_removed` | Number of files that would be deleted |
 
+Example:
+
+```yaml
+jobs:
+  cleanup:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Remove old dev packages
+        uses: neutrons/conda-actions/pkg-remove@main
+        with:
+          anaconda_token: ${{ secrets.ANACONDA_TOKEN }}
+          organization: neutrons
+          package_name: my-package
+          label: dev
+          keep: 5
+```
+
 ## publish
 
 GitHub action to publish a conda package to Anaconda Cloud.
 
+This action assumes that:
+
+- The package has already been built and is available in a local conda channel directory
+- Either `anaconda-client` or `pixi` is installed in the environment where the action is running
+
 #### Usage
 
-TBD
+Full list of available inputs in [`publish/action.yaml`](#publish/action.yaml).
+
+Inputs:
+
+| Input            | Description                                                  | Required | Default    |
+| ---------------- | ------------------------------------------------------------ | -------- | ---------- |
+| `anaconda-token` | Anaconda.org API token                                       | Yes      | -          |
+| `organization`   | Anaconda.org organization or user name                       | Yes      | -          |
+| `package-path`   | Path to the conda package to publish                         | Yes      | -          |
+| `github-ref`     | GitHub ref (e.g., `refs/tags/v1.0.0`) to determine the label | No       | github.ref |
+| `label`          | Label to apply to the package (e.g., `dev`, `nightly`, `rc`) | No       | -          |
+| `force`          | If `true`, overwrite existing package with the same version  | No       | `false`    |
+
+Example:
+
+```yaml
+jobs:
+  publish:
+    - uses: actions/checkout@main
+
+    - uses: prefix-dev/setup-pixi@main
+
+    - name: Build package
+      run: |
+        # steps to build your .conda package, for example:
+        pixi build
+
+    - name: Publish package to Anaconda Cloud
+      uses: neutrons/conda-actions/publish@main
+      with:
+        anaconda-token: ${{ secrets.ANACONDA_TOKEN }}
+        organization: neutrons
+        package-path: my-package-*.conda
+```

publish/action.yaml

@@ -15,12 +15,18 @@ inputs:
   package-path:
     description: Path to the .conda file to upload.
     required: true
+  github-ref:
+    description: |
+      GitHub ref (branch, tag, or commit) to include in the package metadata.
+      Defaults to the current ref of the workflow run.
+    required: false
+    default: ${{ github.ref }}
   label:
     description: |
       Anaconda channel label to publish to (e.g. main, dev, nightly, rc).
       Defaults to "main".
     required: false
-    default: "main"
+    default: ""
   force:
     description: |
       If true, overwrite an existing package file with the same name/version.
@@ -49,11 +55,26 @@ runs:
         ANACONDA_API_TOKEN: ${{ inputs.anaconda-token }}
         ORGANIZATION: ${{ inputs.organization }}
         PACKAGE_PATH: ${{ inputs.package-path }}
+        REF: ${{ inputs.github-ref }}
         LABEL: ${{ inputs.label }}
         FORCE: ${{ inputs.force }}
       run: |
         set -euo pipefail
 
+        if [ "${LABEL}" = "" ]; then
+          echo "No label input provided. Determining label from GitHub ref '${REF}'..."
+          case "${REF}" in
+            refs/heads/next)  LABEL="dev" ;;
+            refs/tags/v*rc*)  LABEL="rc" ;;
+            refs/tags/v*)     LABEL="main" ;;
+            *)
+              echo "Could not determine label from ref '${REF}'. Please provide a label input or use a ref format like 'refs/heads/next' or 'refs/tags/vX.Y.Z[rcN]'."
+              exit 1
+              ;;
+          esac
+        fi
+        echo "Using label '${LABEL}' for upload."
+
         force_flag=""
         if [ "${FORCE}" = "true" ]; then
           force_flag="--force"