nanodock 0.1.1

Minimal synchronous Docker/Podman client for container detection, port mapping, and lifecycle control
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

# nanodock - Release Workflow
# Creates a draft GitHub release with a version tag. Manually triggered.
#
# For library crates, GitHub releases serve as changelog anchors and version
# markers. Users install the crate via crates.io (`cargo add nanodock`), so
# no binary artifacts are attached.
#
# Usage:
#   gh workflow run release.yml -f version=0.2.0
#   gh workflow run release.yml -f version=0.2.0 -f commit=abc123

name: Release

on:
  workflow_dispatch:
    inputs:
      version:
        description: "Release version (e.g. 0.2.0, without leading 'v')"
        required: true
        type: string
      commit:
        description: "Commit SHA to tag (leave empty for latest on default branch)"
        required: false
        type: string
        default: ""

permissions:
  contents: write

jobs:
  release:
    name: Create Draft Release
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - name: Validate version format
        run: |

          version="${{ inputs.version }}"
          if ! echo "$version" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$'; then
            echo "::error::Invalid version format: '$version'. Expected semver (e.g. 0.2.0 or 1.0.0-rc.1)."
            exit 1
          fi
          echo "VERSION=$version" >> "$GITHUB_ENV"
          echo "TAG=v$version" >> "$GITHUB_ENV"

      - name: Resolve target commit
        run: |

          commit="${{ inputs.commit }}"
          if [ -z "$commit" ]; then
            echo "TARGET=${{ github.sha }}" >> "$GITHUB_ENV"
            echo "Targeting latest commit on default branch: ${{ github.sha }}"
          else
            echo "TARGET=$commit" >> "$GITHUB_ENV"
            echo "Targeting user-specified commit: $commit"
          fi

      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          ref: ${{ env.TARGET }}

      - name: Verify Cargo.toml version matches
        run: |

          cargo_version=$(sed -n 's/^version = "\(.*\)"/\1/p' Cargo.toml | head -1)
          if [ "$cargo_version" != "$VERSION" ]; then
            echo "::warning::Cargo.toml version ($cargo_version) does not match release version ($VERSION). Update Cargo.toml before publishing to crates.io."
          fi

      - name: Check tag does not already exist
        run: |

          if git rev-parse "refs/tags/$TAG" >/dev/null 2>&1; then
            echo "::error::Tag $TAG already exists."
            exit 1
          fi

      - name: Create and push tag
        run: |

          git tag "$TAG" "$TARGET"
          git push origin "$TAG"

      - name: Create draft GitHub release
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |

          gh release create "$TAG" \
            --title "nanodock $TAG" \
            --generate-notes \
            --draft \
            --target "$TARGET"