[GH-ISSUE #45] Add pre-release versions list/read commands #8

New issue

Closed

opened 2026-02-26 21:32:44 +03:00 by kerem · 3 comments

kerem commented 2026-02-26 21:32:44 +03:00

Owner

Copy link

Originally created by @rudrankriyam on GitHub (Jan 23, 2026).
Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/45

Summary

Add commands to list/read TestFlight pre-release versions.

API endpoints

• GET /v1/apps/{id}/preReleaseVersions (list by app) — https://developer.apple.com/documentation/appstoreconnectapi/list_prerelease_versions
• GET /v1/preReleaseVersions (list with filters) — https://developer.apple.com/documentation/appstoreconnectapi/list_prerelease_versions
• GET /v1/preReleaseVersions/{id} (read) — https://developer.apple.com/documentation/appstoreconnectapi/read_prerelease_version_information

Query support

• filter[app] (app ID)
• filter[platform] (IOS, MAC_OS, TV_OS, VISION_OS)
• filter[version] (version string)
• limit, links.next, --paginate

CLI

• asc pre-release-versions list --app "APP_ID" [--platform ...] [--version ...] [--limit ...] [--next ...] [--paginate]
• asc pre-release-versions get --id "PR_ID"

Output

• JSON minified default; --output table|markdown; --pretty for JSON.

Tests

• internal/asc client query tests
• cmd/commands_test.go for CLI parsing + output

Originally created by @rudrankriyam on GitHub (Jan 23, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/45 ## Summary Add commands to list/read TestFlight pre-release versions. ## API endpoints - `GET /v1/apps/{id}/preReleaseVersions` (list by app) — https://developer.apple.com/documentation/appstoreconnectapi/list_prerelease_versions - `GET /v1/preReleaseVersions` (list with filters) — https://developer.apple.com/documentation/appstoreconnectapi/list_prerelease_versions - `GET /v1/preReleaseVersions/{id}` (read) — https://developer.apple.com/documentation/appstoreconnectapi/read_prerelease_version_information ## Query support - `filter[app]` (app ID) - `filter[platform]` (IOS, MAC_OS, TV_OS, VISION_OS) - `filter[version]` (version string) - `limit`, `links.next`, `--paginate` ## CLI - `asc pre-release-versions list --app "APP_ID" [--platform ...] [--version ...] [--limit ...] [--next ...] [--paginate]` - `asc pre-release-versions get --id "PR_ID"` ## Output - JSON minified default; `--output table|markdown`; `--pretty` for JSON. ## Tests - `internal/asc` client query tests - `cmd/commands_test.go` for CLI parsing + output

kerem closed this issue 2026-02-26 21:32:45 +03:00

kerem commented 2026-02-26 21:32:45 +03:00

Author

Owner

Copy link

@rudrankriyam commented on GitHub (Jan 23, 2026):

@cursor Please implement this issue.

Implementation Guide

1. Create cmd/prerelease.go

Create a new command group for pre-release versions:

// PreReleaseVersionsCommand returns the pre-release-versions command.
func PreReleaseVersionsCommand() *ffcli.Command {
    // Subcommands: list, get
}

2. Add Client Methods in internal/asc/client.go

// Types
type PreReleaseVersionsResponse struct {
    Data  []PreReleaseVersion `json:"data"`
    Links Links               `json:"links,omitempty"`
}

type PreReleaseVersion struct {
    Type       string                      `json:"type"`
    ID         string                      `json:"id"`
    Attributes PreReleaseVersionAttributes `json:"attributes"`
}

type PreReleaseVersionAttributes struct {
    Version  string `json:"version"`
    Platform string `json:"platform"`
}

// Methods
func (c *Client) GetPreReleaseVersions(ctx, appID string, opts...) (*PreReleaseVersionsResponse, error)
func (c *Client) GetPreReleaseVersion(ctx, id string) (*PreReleaseVersionResponse, error)

Use functional options pattern like BetaGroupsOption:

• WithPreReleaseVersionsPlatform(platform string)
• WithPreReleaseVersionsVersion(version string)
• WithPreReleaseVersionsLimit(limit int)
• WithPreReleaseVersionsNextURL(next string)

3. Register Command

Add PreReleaseVersionsCommand() to RootCommand.Subcommands in cmd/commands.go.

4. Flags

For list:

• --app (required)
• --platform (IOS, MAC_OS, TV_OS, VISION_OS)
• --version (version string filter)
• --limit, --next, --paginate
• --output, --pretty

For get:

• --id (required)
• --output, --pretty

5. Testing

Unit tests in cmd/commands_test.go:

{"pre-release-versions list missing app", []string{"pre-release-versions", "list"}, ...}
{"pre-release-versions get missing id", []string{"pre-release-versions", "get"}, ...}

Client tests in internal/asc/client_http_test.go:

• Test query building with platform filter
• Test pagination

Live API test:

./asc pre-release-versions list --app 6747745091
./asc pre-release-versions list --app 6747745091 --platform IOS
./asc pre-release-versions list --app 6747745091 --output table

6. Output Formatters

Add table/markdown formatters following the pattern in client.go:

func printPreReleaseVersionsTable(resp *PreReleaseVersionsResponse) error
func printPreReleaseVersionsMarkdown(resp *PreReleaseVersionsResponse) error

Table columns: ID | Version | Platform

7. Code Standards

• Validate platform values against allowed enum (IOS, MAC_OS, TV_OS, VISION_OS)
• Use strings.TrimSpace() on all inputs
• Follow existing ffcli patterns
• Run make format && make lint && make test before committing

<!-- gh-comment-id:3792262001 --> @rudrankriyam commented on GitHub (Jan 23, 2026): @cursor Please implement this issue. ## Implementation Guide ### 1. Create `cmd/prerelease.go` Create a new command group for pre-release versions: ```go // PreReleaseVersionsCommand returns the pre-release-versions command. func PreReleaseVersionsCommand() *ffcli.Command { // Subcommands: list, get } ``` ### 2. Add Client Methods in `internal/asc/client.go` ```go // Types type PreReleaseVersionsResponse struct { Data []PreReleaseVersion `json:"data"` Links Links `json:"links,omitempty"` } type PreReleaseVersion struct { Type string `json:"type"` ID string `json:"id"` Attributes PreReleaseVersionAttributes `json:"attributes"` } type PreReleaseVersionAttributes struct { Version string `json:"version"` Platform string `json:"platform"` } // Methods func (c *Client) GetPreReleaseVersions(ctx, appID string, opts...) (*PreReleaseVersionsResponse, error) func (c *Client) GetPreReleaseVersion(ctx, id string) (*PreReleaseVersionResponse, error) ``` Use functional options pattern like `BetaGroupsOption`: - `WithPreReleaseVersionsPlatform(platform string)` - `WithPreReleaseVersionsVersion(version string)` - `WithPreReleaseVersionsLimit(limit int)` - `WithPreReleaseVersionsNextURL(next string)` ### 3. Register Command Add `PreReleaseVersionsCommand()` to `RootCommand.Subcommands` in `cmd/commands.go`. ### 4. Flags For `list`: - `--app` (required) - `--platform` (IOS, MAC_OS, TV_OS, VISION_OS) - `--version` (version string filter) - `--limit`, `--next`, `--paginate` - `--output`, `--pretty` For `get`: - `--id` (required) - `--output`, `--pretty` ### 5. Testing **Unit tests** in `cmd/commands_test.go`: ```go {"pre-release-versions list missing app", []string{"pre-release-versions", "list"}, ...} {"pre-release-versions get missing id", []string{"pre-release-versions", "get"}, ...} ``` **Client tests** in `internal/asc/client_http_test.go`: - Test query building with platform filter - Test pagination **Live API test**: ```bash ./asc pre-release-versions list --app 6747745091 ./asc pre-release-versions list --app 6747745091 --platform IOS ./asc pre-release-versions list --app 6747745091 --output table ``` ### 6. Output Formatters Add table/markdown formatters following the pattern in `client.go`: ```go func printPreReleaseVersionsTable(resp *PreReleaseVersionsResponse) error func printPreReleaseVersionsMarkdown(resp *PreReleaseVersionsResponse) error ``` Table columns: `ID | Version | Platform` ### 7. Code Standards - Validate platform values against allowed enum (IOS, MAC_OS, TV_OS, VISION_OS) - Use `strings.TrimSpace()` on all inputs - Follow existing `ffcli` patterns - Run `make format && make lint && make test` before committing

kerem commented 2026-02-26 21:32:45 +03:00

Author

Owner

Copy link

@cursor[bot] commented on GitHub (Jan 23, 2026):

Summary:

• Added pre-release versions client types/options, list/get methods, pagination support, and table/markdown formatters.
• Implemented asc pre-release-versions command group with list/get subcommands, flag validation, and output wiring.
• Added client HTTP/query tests plus CLI validation tests.

Tests:

• make format
• make lint
• make test

Notes:

• make format initially failed due to missing gofumpt; installed mvdan.cc/gofumpt@latest and reran.

 

<!-- gh-comment-id:3792262287 --> @cursor[bot] commented on GitHub (Jan 23, 2026): Summary: - Added pre-release versions client types/options, list/get methods, pagination support, and table/markdown formatters. - Implemented `asc pre-release-versions` command group with list/get subcommands, flag validation, and output wiring. - Added client HTTP/query tests plus CLI validation tests. Tests: - `make format` - `make lint` - `make test` Notes: - `make format` initially failed due to missing `gofumpt`; installed `mvdan.cc/gofumpt@latest` and reran. <a href="https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/59"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/view-pr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/view-pr-light.svg"><img alt="View PR" src="https://cursor.com/view-pr-light.svg"></picture></a> <a href="https://cursor.com/background-agent?bcId=bc-9ce3b526-4e86-4918-86e3-c5ae34999e78"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/open-in-cursor-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/open-in-cursor-light.svg"><img alt="Open in Cursor" src="https://cursor.com/open-in-cursor.svg"></picture></a>&nbsp;<a href="https://cursor.com/agents?id=bc-9ce3b526-4e86-4918-86e3-c5ae34999e78"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/open-in-web-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/open-in-web-light.svg"><img alt="Open in Web" src="https://cursor.com/open-in-web.svg"></picture></a>

kerem commented 2026-02-26 21:32:45 +03:00

Author

Owner

Copy link

@rudrankriyam commented on GitHub (Jan 23, 2026):

Implemented in PR #59 - pre-release-versions list and get commands.

<!-- gh-comment-id:3792501456 --> @rudrankriyam commented on GitHub (Jan 23, 2026): Implemented in PR #59 - pre-release-versions list and get commands.

kerem referenced this issue 2026-02-26 21:34:11 +03:00

[PR #8] [CLOSED] Apps sort field validation #219

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

main

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.1

1.1.0

1.0.1

1.0.0

0.49.1

0.49.0

0.48.1

0.48.0

0.47.1

0.47.0

0.46.2

0.46.1

0.46.0

0.45.4

0.45.3

0.45.2

0.45.1

0.45.0

0.44.2

0.44.1

0.44.0

0.43.0

0.42.0

0.41.4

0.41.3

0.41.2

0.41.1

0.41.0

0.40.1

0.40.0

0.39.1

0.39.0

0.38.3

0.38.2

0.38.1

0.38.0

0.37.3

0.37.2

0.37.1

0.37.0

0.36.3

0.36.2

0.36.1

0.36.0

0.35.3

0.35.2

0.35.1

0.35.0

0.34.1

0.34.0

0.33.2

0.33.1

0.33.0

0.32.0

0.31.3

0.31.2

0.31.1

0.31.0

0.30.0

0.29.3

0.29.2

0.29.1

0.29.0

0.28.14

0.28.13

0.28.12

0.28.11

0.28.10

0.28.9

0.28.8

0.28.7

0.28.6

0.28.5

0.28.4

0.28.3

0.28.2

0.28.1

0.28.0

0.27.0

0.26.4

0.26.3

0.26.2

0.26.1

0.26.0

0.25.4

0.25.3

0.25.1

0.25.0

0.24.3

0.24.2

0.24.1

0.24.0

0.23.5

0.23.4

0.23.3

0.23.2

0.23.1

0.23.0

0.22.1

0.22.0

0.21.0

0.20.2

0.20.1

0.20.0

0.19.3

0.19.2

0.19.1

0.19.0

0.18.2

0.18.1

0.18.0

0.17.0

0.16.0

0.15.0

0.14.0

0.13.0

0.12.4

0.12.3

0.12.2

0.12.1

0.12.0

0.11.0

0.10.2

0.10.1

0.10.0

0.9.0

0.8.1

0.8.0

0.7.0

0.6.0

0.5.0

0.3.1

0.3.0

0.2.0

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

Labels

Clear labels   

bug

  

bug

  

documentation

  

enhancement

  

pull-request

Mirrored from GitHub Pull Request

No labels

bug

bug

documentation

enhancement

pull-request

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/App-Store-Connect-CLI#8

No description provided.