release: 0.1.0-beta.3

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
     timeout-minutes: 10
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/deeptable-cli' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
       - uses: actions/checkout@v6
@@ -49,7 +49,7 @@ jobs:
       contents: read
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/deeptable-cli' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
       - uses: actions/checkout@v6
 

.github/workflows/publish-release.yml

@@ -10,6 +10,7 @@ on:
   push:
     tags:
       - "v*"
+  workflow_dispatch: {}
 jobs:
   goreleaser:
     runs-on: ubuntu-latest

.gitignore

@@ -1,4 +1,5 @@
 .prism.log
+.stdy.log
 dist/
 /deeptable
 *.exe

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-beta.2"
+  ".": "0.1.0-beta.3"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/deeptable%2Fdeeptable-acfb7545d19701827292fc4663c6852d423dd84e65639e5b7ed766dc2d01aff2.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/deeptable/deeptable-acfb7545d19701827292fc4663c6852d423dd84e65639e5b7ed766dc2d01aff2.yml
 openapi_spec_hash: 9f090892f01aa7afe4f22910c41b911b
 config_hash: 56ee7b575c6a6e90046a0f807e5f3234

CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 0.1.0-beta.3 (2026-04-30)
+
+Full Changelog: [v0.1.0-beta.2...v0.1.0-beta.3](https://github.com/deeptable-com/deeptable-cli/compare/v0.1.0-beta.2...v0.1.0-beta.3)
+
+### Features
+
+* allow `-` as value representing stdin to binary-only file parameters in CLIs ([e30bb3a](https://github.com/deeptable-com/deeptable-cli/commit/e30bb3a93f299cc74a5fd022fd6d7bc4ad16bebf))
+* better error message if scheme forgotten in CLI `*_BASE_URL`/`--base-url` ([3ee457a](https://github.com/deeptable-com/deeptable-cli/commit/3ee457aa17ed94997cc134b99c77e28a85900a82))
+* binary-only parameters become CLI flags that take filenames only ([482d722](https://github.com/deeptable-com/deeptable-cli/commit/482d722a794806e5c60ab124dee0459170397bc9))
+* **cli:** add `--raw-output`/`-r` option to print raw (non-JSON) strings ([177c28f](https://github.com/deeptable-com/deeptable-cli/commit/177c28f629b61bb326788545144976e2e54e46a3))
+* **cli:** alias parameters in data with `x-stainless-cli-data-alias` ([9a763d3](https://github.com/deeptable-com/deeptable-cli/commit/9a763d3b2a19e9e1fb60cab9da8a9562a0760177))
+* **cli:** send filename and content type when reading input from files ([4116cf0](https://github.com/deeptable-com/deeptable-cli/commit/4116cf01842502beea08e26368f9d99a5049bb06))
+* set CLI flag constant values automatically where `x-stainless-const` is set ([d5a50f3](https://github.com/deeptable-com/deeptable-cli/commit/d5a50f395b1a844f07824fb1f2e4bdfcd22e354c))
+* support passing path and query params over stdin ([8e27218](https://github.com/deeptable-com/deeptable-cli/commit/8e27218906f07ebd77ee8ba790eec504bbcfbe7f))
+
+
+### Bug Fixes
+
+* cli no longer hangs when stdin is attached to a pipe with empty input ([0063fc1](https://github.com/deeptable-com/deeptable-cli/commit/0063fc108a77d22495846cc6106592c22761792c))
+* **cli:** correctly load zsh autocompletion ([9e91ddf](https://github.com/deeptable-com/deeptable-cli/commit/9e91ddf6fb36e634f56a23a9a01102e548073eb4))
+* fall back to main branch if linking fails in CI ([ec4eb09](https://github.com/deeptable-com/deeptable-cli/commit/ec4eb09e2f76d4a75fdfec1f2b407d9ad8afb67a))
+* fix for failing to drop invalid module replace in link script ([b3ea45a](https://github.com/deeptable-com/deeptable-cli/commit/b3ea45a6f1c7bc4111bf68507f061b642d6bb789))
+* fix for off-by-one error in pagination logic ([d7142f9](https://github.com/deeptable-com/deeptable-cli/commit/d7142f9c3552886983d8590e9b47df4b774ffb49))
+* fix quoting typo ([006840d](https://github.com/deeptable-com/deeptable-cli/commit/006840d8fc41deeb53de45b2ab1c18fd877480aa))
+* flags for nullable body scalar fields are strictly typed ([a98eb25](https://github.com/deeptable-com/deeptable-cli/commit/a98eb255536c876836413ba333773b7b54929fb9))
+* handle empty data set using `--format explore` ([76e8aa7](https://github.com/deeptable-com/deeptable-cli/commit/76e8aa73ea6dbaceb088b835888f26688dc6f360))
+* use `RawJSON` when iterating items with `--format explore` in the CLI ([0806fe8](https://github.com/deeptable-com/deeptable-cli/commit/0806fe8ed9e8355d4f06f028de673e541d091105))
+
+
+### Chores
+
+* add documentation for ./scripts/link ([a8008f2](https://github.com/deeptable-com/deeptable-cli/commit/a8008f2a7b3a064ad21d86ab8800d6696c8d455e))
+* **ci:** skip lint on metadata-only changes ([0be1028](https://github.com/deeptable-com/deeptable-cli/commit/0be1028ca0f24e44cd5fe74b046ad514b47d08a4))
+* **ci:** support manually triggering release workflow ([92efacd](https://github.com/deeptable-com/deeptable-cli/commit/92efacd686131b1245b8f25467daaba4c650d602))
+* **cli:** additional test cases for `ShowJSONIterator` ([f882462](https://github.com/deeptable-com/deeptable-cli/commit/f8824621a6ffc592f70e7cefe0c0ded4ce892888))
+* **cli:** fall back to JSON when using default "explore" with non-TTY ([22db507](https://github.com/deeptable-com/deeptable-cli/commit/22db507c72c8578edaea3d1295d08b22229430bd))
+* **cli:** let `--format raw` be used in conjunction with `--transform` ([eca1743](https://github.com/deeptable-com/deeptable-cli/commit/eca1743bead6e107e3c839d96245005d1401a0c7))
+* **cli:** switch long lists of positional args over to param structs ([5d7b97a](https://github.com/deeptable-com/deeptable-cli/commit/5d7b97aad32a194a00a4f43c95197bbd018413b2))
+* **cli:** use `ShowJSONOpts` as argument to `formatJSON` instead of many positionals ([8eb757d](https://github.com/deeptable-com/deeptable-cli/commit/8eb757d4dc41a21f87cdeda972597ada022a3580))
+* **internal:** codegen related update ([ab0b024](https://github.com/deeptable-com/deeptable-cli/commit/ab0b024de44d535fb1402bdfd82f048d943ff65d))
+* **internal:** codegen related update ([636523c](https://github.com/deeptable-com/deeptable-cli/commit/636523c180805486a19a0687901d9b4c27212e19))
+* **internal:** codegen related update ([6241318](https://github.com/deeptable-com/deeptable-cli/commit/6241318a939febb87359001b98fe890de2797099))
+* **internal:** codegen related update ([aad810e](https://github.com/deeptable-com/deeptable-cli/commit/aad810e7b632dd112c095cf2d428c23ee4a96a99))
+* **internal:** more robust bootstrap script ([3e2edb5](https://github.com/deeptable-com/deeptable-cli/commit/3e2edb59bd63cdb77f3128feaf7c1a68e1b0c77c))
+* **internal:** update gitignore ([428cb27](https://github.com/deeptable-com/deeptable-cli/commit/428cb27be73809d9bb17a02134a302a08a0f9520))
+* mark all CLI-related tests in Go with `t.Parallel()` ([f895692](https://github.com/deeptable-com/deeptable-cli/commit/f8956929608c4ee645de258a11fc982cdf1f35e6))
+* modify CLI tests to inject stdout so mutating `os.Stdout` isn't necessary ([1fae171](https://github.com/deeptable-com/deeptable-cli/commit/1fae171f023fc2529341f3b2ee4704dceefeeff1))
+* omit full usage information when missing required CLI parameters ([33fb84c](https://github.com/deeptable-com/deeptable-cli/commit/33fb84c343af94a2a673652f9da1655f9ea20d2e))
+* switch some CLI Go tests from `os.Chdir` to `t.Chdir` ([1c11dc7](https://github.com/deeptable-com/deeptable-cli/commit/1c11dc73b06973991ce1c129a2010e54bf4f599e))
+
 ## 0.1.0-beta.2 (2026-03-19)
 
 Full Changelog: [v0.1.0-beta.1...v0.1.0-beta.2](https://github.com/deeptable-com/deeptable-cli/compare/v0.1.0-beta.1...v0.1.0-beta.2)

README.md

@@ -112,3 +112,23 @@ base64-encoding). Note that absolute paths will begin with `@file://` or
 ```bash
 deeptable <command> --arg @data://file.txt
 ```
+
+## Linking different Go SDK versions
+
+You can link the CLI against a different version of the DeepTable Go SDK
+for development purposes using the `./scripts/link` script.
+
+To link to a specific version from a repository (version can be a branch,
+git tag, or commit hash):
+
+```bash
+./scripts/link github.com/org/repo@version
+```
+
+To link to a local copy of the SDK:
+
+```bash
+./scripts/link ../path/to/deeptable-go
+```
+
+If you run the link script without any arguments, it will default to `../deeptable-go`.

cmd/deeptable/main.go

@@ -23,6 +23,13 @@ func main() {
 		prepareForAutocomplete(app)
 	}
 
+	if baseURL, ok := os.LookupEnv("DEEPTABLE_BASE_URL"); ok {
+		if err := cmd.ValidateBaseURL(baseURL, "DEEPTABLE_BASE_URL"); err != nil {
+			fmt.Fprintf(os.Stderr, "%s\n", err.Error())
+			os.Exit(1)
+		}
+	}
+
 	if err := app.Run(context.Background(), os.Args); err != nil {
 		exitCode := 1
 
@@ -36,7 +43,12 @@ func main() {
 			fmt.Fprintf(os.Stderr, "%s %q: %d %s\n", apierr.Request.Method, apierr.Request.URL, apierr.Response.StatusCode, http.StatusText(apierr.Response.StatusCode))
 			format := app.String("format-error")
 			json := gjson.Parse(apierr.RawJSON())
-			show_err := cmd.ShowJSON(os.Stdout, "Error", json, format, app.String("transform-error"))
+			show_err := cmd.ShowJSON(json, cmd.ShowJSONOpts{
+				ExplicitFormat: app.IsSet("format-error"),
+				Format:         format,
+				Title:          "Error",
+				Transform:      app.String("transform-error"),
+			})
 			if show_err != nil {
 				// Just print the original error:
 				fmt.Fprintf(os.Stderr, "%s\n", err.Error())

go.mod

@@ -7,7 +7,7 @@ require (
 	github.com/charmbracelet/bubbletea v1.3.6
 	github.com/charmbracelet/lipgloss v1.1.0
 	github.com/charmbracelet/x/term v0.2.1
-	github.com/deeptable-com/deeptable-go v0.0.2-beta
+	github.com/deeptable-com/deeptable-go v0.1.0-beta.4
 	github.com/goccy/go-yaml v1.18.0
 	github.com/itchyny/json2yaml v0.1.4
 	github.com/muesli/reflow v0.3.0

go.sum

@@ -22,8 +22,8 @@ github.com/cpuguy83/go-md2man/v2 v2.0.2 h1:p1EgwI/C7NhT0JmVkwCD2ZBK8j4aeHQX2pMHH
 github.com/cpuguy83/go-md2man/v2 v2.0.2/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/deeptable-com/deeptable-go v0.0.2-beta h1:6DLb/If0Ylrro/OMaZhuC5Em10HxoPDE73RE8npZDFo=
-github.com/deeptable-com/deeptable-go v0.0.2-beta/go.mod h1:fIo2owpf3vsy9vMv3XyFe4ahUcPAjKtutJEobZ8R/jI=
+github.com/deeptable-com/deeptable-go v0.1.0-beta.4 h1:iZ2W2ROHRAfsGEbJmcQ1EJdtu35d2jsrMjxDKIvmos8=
+github.com/deeptable-com/deeptable-go v0.1.0-beta.4/go.mod h1:fIo2owpf3vsy9vMv3XyFe4ahUcPAjKtutJEobZ8R/jI=
 github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
 github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
 github.com/goccy/go-yaml v1.18.0 h1:8W7wMFS12Pcas7KU+VVkaiCng+kG8QiFeFwzFb+rwuw=

internal/apiform/form_test.go

@@ -85,8 +85,12 @@ var tests = map[string]struct {
 }
 
 func TestEncode(t *testing.T) {
+	t.Parallel()
+
 	for name, test := range tests {
 		t.Run(name, func(t *testing.T) {
+			t.Parallel()
+
 			buf := bytes.NewBuffer(nil)
 			writer := multipart.NewWriter(buf)
 			writer.SetBoundary("xxx")

internal/apiquery/query_test.go

@@ -6,6 +6,8 @@ import (
 )
 
 func TestEncode(t *testing.T) {
+	t.Parallel()
+
 	tests := map[string]struct {
 		val      any
 		settings QuerySettings
@@ -114,6 +116,8 @@ func TestEncode(t *testing.T) {
 
 	for name, test := range tests {
 		t.Run(name, func(t *testing.T) {
+			t.Parallel()
+
 			query := map[string]any{"query": test.val}
 			values, err := MarshalWithSettings(query, test.settings)
 			if err != nil {

internal/autocomplete/autocomplete_test.go

@@ -8,6 +8,8 @@ import (
 )
 
 func TestGetCompletions_EmptyArgs(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Usage: "Generate SDK"},
@@ -26,6 +28,8 @@ func TestGetCompletions_EmptyArgs(t *testing.T) {
 }
 
 func TestGetCompletions_SubcommandPrefix(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Usage: "Generate SDK"},
@@ -43,6 +47,8 @@ func TestGetCompletions_SubcommandPrefix(t *testing.T) {
 }
 
 func TestGetCompletions_HiddenCommand(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "visible", Usage: "Visible command"},
@@ -57,6 +63,8 @@ func TestGetCompletions_HiddenCommand(t *testing.T) {
 }
 
 func TestGetCompletions_NestedSubcommand(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -79,6 +87,8 @@ func TestGetCompletions_NestedSubcommand(t *testing.T) {
 }
 
 func TestGetCompletions_FlagCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -102,6 +112,8 @@ func TestGetCompletions_FlagCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_ShortFlagCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -123,6 +135,8 @@ func TestGetCompletions_ShortFlagCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_FileFlagBehavior(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -142,6 +156,8 @@ func TestGetCompletions_FileFlagBehavior(t *testing.T) {
 }
 
 func TestGetCompletions_NonBoolFlagValue(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -161,6 +177,8 @@ func TestGetCompletions_NonBoolFlagValue(t *testing.T) {
 }
 
 func TestGetCompletions_BoolFlagDoesNotBlockCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -185,6 +203,8 @@ func TestGetCompletions_BoolFlagDoesNotBlockCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_ColonCommands_NoColonTyped(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -202,6 +222,8 @@ func TestGetCompletions_ColonCommands_NoColonTyped(t *testing.T) {
 }
 
 func TestGetCompletions_ColonCommands_ColonTyped_Bash(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -221,6 +243,8 @@ func TestGetCompletions_ColonCommands_ColonTyped_Bash(t *testing.T) {
 }
 
 func TestGetCompletions_ColonCommands_ColonTyped_Zsh(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -240,6 +264,8 @@ func TestGetCompletions_ColonCommands_ColonTyped_Zsh(t *testing.T) {
 }
 
 func TestGetCompletions_BashStyleColonCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -257,6 +283,8 @@ func TestGetCompletions_BashStyleColonCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_BashStyleColonCompletion_NoMatch(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -271,6 +299,8 @@ func TestGetCompletions_BashStyleColonCompletion_NoMatch(t *testing.T) {
 }
 
 func TestGetCompletions_ZshStyleColonCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -287,6 +317,8 @@ func TestGetCompletions_ZshStyleColonCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_MixedColonAndRegularCommands(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Usage: "Generate SDK"},
@@ -305,6 +337,8 @@ func TestGetCompletions_MixedColonAndRegularCommands(t *testing.T) {
 }
 
 func TestGetCompletions_FlagWithBoolFlagSkipsValue(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -329,6 +363,8 @@ func TestGetCompletions_FlagWithBoolFlagSkipsValue(t *testing.T) {
 }
 
 func TestGetCompletions_MultipleFlagsBeforeSubcommand(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -353,6 +389,8 @@ func TestGetCompletions_MultipleFlagsBeforeSubcommand(t *testing.T) {
 }
 
 func TestGetCompletions_CommandAliases(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Aliases: []string{"gen", "g"}, Usage: "Generate SDK"},
@@ -372,6 +410,8 @@ func TestGetCompletions_CommandAliases(t *testing.T) {
 }
 
 func TestGetCompletions_AllFlagsWhenNoPrefix(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{