docs: version Go SDK installs

Closes ory-corp/cloud#4065
ory · Aug 29, 2024 · 9b4a388 · 9b4a388
1 parent fe26019
commit 9b4a388
Show file tree

Hide file tree

Showing 5 changed files with 45 additions and 8 deletions.
diff --git a/docs/getting-started/integrate-auth/01_go.mdx b/docs/getting-started/integrate-auth/01_go.mdx
@@ -8,6 +8,8 @@ sidebar_label: Go
 import Teaser from '../_common/teaser.mdx'
 import mp4 from '../_static/go/screencast.mp4'
 import webm from '../_static/go/screencast.webm'
+import CodeBlock from "@theme/CodeBlock"
+import { useLatestTag } from '@site/src/hooks'
 
 <Teaser
   framework={<a href="https://go.dev/">Go</a>}
@@ -32,8 +34,8 @@ go mod init github.com/<your-name>/your-project
 
 Run this command to install the Ory SDK which allows you to interact with Ory APIs:
 
-```shell-session
-go get -u github.com/ory/client-go
+```mdx-code-block
+<CodeBlock className="language-shell">{`go get github.com/ory/client-go@${useLatestTag('client-go', 'master')}`}</CodeBlock>
 ```
 
 ## Install Ory CLI

diff --git a/docs/hydra/sdk/05_go.mdx b/docs/hydra/sdk/05_go.mdx
@@ -30,8 +30,11 @@ Don't consume the `/oauth2/auth` and `/oauth2/token` endpoints using this SDK. U
 
 To install the Go SDK, run:
 
-```go
-go get github.com/ory/client-go
+```mdx-code-block
+import CodeBlock from "@theme/CodeBlock"
+import { useLatestTag } from '@site/src/hooks'
+
+<CodeBlock className="language-shell">{`go get github.com/ory/client-go@${useLatestTag('client-go', 'master')}`}</CodeBlock>
 ```
 
 ## Making requests

diff --git a/docs/keto/sdk/05_go.mdx b/docs/keto/sdk/05_go.mdx
@@ -27,8 +27,11 @@ Ory Permissions exposes two APIs for integration
 
 ### Installation REST API
 
-```go
-go get github.com/ory/client-go
+```mdx-code-block
+import CodeBlock from "@theme/CodeBlock"
+import { useLatestTag } from '@site/src/hooks'
+
+<CodeBlock className="language-shell">{`go get github.com/ory/client-go@${useLatestTag('client-go', 'master')}`}</CodeBlock>
 ```
 
 ### Installation gRPC API

diff --git a/docs/kratos/sdk/05_go.mdx b/docs/kratos/sdk/05_go.mdx
@@ -7,6 +7,7 @@ title: Go
 import Tabs from "@theme/Tabs"
 import TabItem from "@theme/TabItem"
 import CodeBlock from "@theme/CodeBlock"
+import { useLatestTag } from '@site/src/hooks'
 ```
 
 In this document you can find code examples for the Ory Identities Go SDK.
@@ -34,8 +35,8 @@ go mod init myproject
 
 Install the Ory Go SDK
 
-```go
-go get github.com/ory/client-go
+```mdx-code-block
+<CodeBlock className="language-shell">{`go get github.com/ory/client-go@${useLatestTag('client-go', 'master')}`}</CodeBlock>
 ```
 
 ## Frontend API

diff --git a/src/hooks/index.ts b/src/hooks/index.ts
@@ -74,6 +74,7 @@ export function useLatestRelease(
         per_page: 100,
       })
       .then(({ data }) => {
+        console.log(data)
         const published = data.filter(
           ({ draft, tag_name }) => !draft && !tag_name.match(/pre.[0-9]+$/),
         )
@@ -85,6 +86,33 @@ export function useLatestRelease(
 
   return release
 }
+/**
+ * Returns the latest tag for a repo.
+ *
+ * @param repo
+ * @param fallback
+ */
+export function useLatestTag(repo: string, fallback = "<version-you-want>") {
+  const [release, setRelease] = useState<string>(fallback)
+
+  useEffect(() => {
+    octokit.repos
+      .listTags({
+        owner: "ory",
+        repo,
+        per_page: 100,
+      })
+      .then(({ data }) => {
+        console.log(data)
+        const published = data.filter((a) => !a.name.match(/pre.[0-9]+$/))
+        if (published.length > 0) {
+          setRelease(published[0].name)
+        }
+      })
+  }, [repo])
+
+  return release
+}
 
 /**
  * Returns the latest release filename tag