KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

radio-garden-go

★ 36 Open GitHub ↗

A Go client and CLI for the Radio Garden API

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# radio-garden-go

A Go client and command line application for the [Radio Garden](https://radio.garden/) API.

The client is autogenerated by [oapi-codegen] from [radio-garden-openapi], an unofficial Radio Garden [OpenAPI] specification.

## Client library

This package includes two client variants:
- `Client` returns raw HTTP responses.
- `ClientWithResponses` is a wrapper around `Client` with response type handling.

### Example

```golang
import (
	"context"
	"fmt"

radiogarden "github.com/jonasrmichel/radio-garden-go"
)

func main() {
	// construct a client
	client, err := radiogarden.NewClientWithResponses("https://radio.garden/api")
	if err != nil {
		panic(err)
	}

// get a radio station's details
	res, err := client.GetAraContentChannelChannelIdWithResponse(
		context.Background(),
		"9bd5454",
	)
	if err != nil {
		panic(err)
	}

// print the station's details
	fmt.Printf("%+v", res.JSON200.Data)
}
```

### Updating the client

The client implementation is generated by [oapi-codegen].
Any Radio Garden API changes will require that the client be updated.

Run the following commands to update the client:

```sh
# install oapi-codegen (see below)
$ go install github.com/deepmap/oapi-codegen/cmd/oapi-codegen

# generate the client
$ go generate ./...

# install any missing dependencies
$ go mod tidy
```

#### Support for `oneOf` and `anyOf` schema types

Currently, oapi-codegen does not support the OpenAPI `oneOf` or `anyOf` keywords.
That caveat is addressed by [this pull request](https://github.com/deepmap/oapi-codegen/pull/471).

To update the client with support for `oneOf` and `anyOf` schema types, download and install that PR's [fork](https://github.com/ispringtech/oapi-codegen/tree/union) manually:

```sh
# clone ispringtech's oapi-codegen fork
$ git clone -b union git@github.com:ispringtech/oapi-codegen.git

# go there
$ cd oapi-codegen

# install oapi-codegen
$ go install ./cmd/oapi-codegen
```

The client implementation in this project does include type level support for `oneOf` and `anyOf` schema types generated by the above fork.

## Command line application

Run the following commands to install and run the `radio-garden` command line application:

```sh
# install the radio-garden cli app
$ go install github.com/jonasrmichel/radio-garden-go/radio-garden

# run the app
$ radio-garden -h
An application for using the Radio Garden API

Usage:
  radio-garden [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  geo         Get your geolocation
  help        Help about any command
  place       Get a place's details
  places      Get places with registered radio stations
  search      Search for countries, places, and radio stations
  station     Get a radio station's details
  stations    Get a place's registered radio stations

Flags:
  -f, --format          format the output
  -h, --help            help for radio-garden
  -s, --server string   the Radio Garden server (default "https://radio.garden/api")

Use "radio-garden [command] --help" for more information about a command.
```

## License

The client and CLI tool in this project are released under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0).
Radio Garden and its API are copyrighted by Radio Garden BV.

[oapi-codegen]: https://github.com/deepmap/oapi-codegen
[radio-garden-openapi]: https://github.com/jonasrmichel/radio-garden-openapi
[OpenAPI]: https://www.openapis.org/

radio-garden-go

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README