Merge pull request #7 from planetlabs/release

Release workflow

Author: tschaub

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - run: git fetch --force --tags
+      - uses: actions/[email protected]
+        with:
+          go-version: '1.20'
+      - uses: goreleaser/goreleaser-action@v4
+        with:
+          distribution: goreleaser
+          version: latest
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          HOMEBREW_TAP_GITHUB_TOKEN: ${{ secrets.HOMEBREW_TAP_GITHUB_TOKEN }}

.goreleaser.yml

@@ -0,0 +1,38 @@
+before:
+  hooks:
+    - go mod tidy
+builds:
+  - main: ./cmd/xyz2ogc/
+    binary: xyz2ogc
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+archives:
+  - name_template: >-
+      {{ .ProjectName }}_
+      {{- title .Os }}_
+      {{- if eq .Arch "amd64" }}x86_64
+      {{- else if eq .Arch "386" }}i386
+      {{- else }}{{ .Arch }}{{ end }}
+checksum:
+  name_template: 'checksums.txt'
+snapshot:
+  name_template: "{{ incpatch .Version }}-next"
+changelog:
+  sort: asc
+  use: github-native
+brews:
+  - tap:
+      owner: planetlabs
+      name: homebrew-tap
+      token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
+    url_template: "https://github.com/planetlabs/{{ .ProjectName }}/releases/download/{{ .Tag }}/{{ .ArtifactName }}"
+    commit_msg_template: "Brew formula update for {{ .ProjectName }} version {{ .Tag }}"
+    homepage: "https://github.com/planetlabs/go-ogc"
+    description: "Generate OGC API - Tiles metadata from exiting XYZ tilesets."
+    license: "Apache-2.0"
+    test: |
+      system "#{bin}/xyz2ogc version"

readme.md

@@ -27,6 +27,16 @@ The `filter` package provides structs for encoding and decoding CQL2 filters as
 
 The `xyz2ogc` command line utility can be used to generate [OGC API – Tiles](https://ogcapi.ogc.org/tiles/) metadata from exiting XYZ tilesets.
 
+### Installation
+
+The `xyz2ogc` program can be installed by downloading one of the archives from [the latest release](https://github.com/planetlabs/go-ogc/releases).
+
+Extract the archive and place the `xyz2ogc` executable somewhere on your path.  See a list of available commands by running `xyz2ogc` in your terminal.
+
+Homebrew users can install the `xyz2ogc` program with [`brew`](https://brew.sh/):
+
+    brew install planetlabs/tap/go-ogc
+
 ### Use
 
 The `xyz2ogc` program reads a configuration file (`config.toml` by default) for information about a list of XYZ tilesets.  The program will then generate OGC API – Tiles compliant metadata for the configured tilesets.