Skip to content

Commit

Permalink
Merge pull request #22 from hookdeck/dsheridan/update-openapi-spec
Browse files Browse the repository at this point in the history
Improvement: Update OpenAPI spec
  • Loading branch information
dannysheridan authored Jan 25, 2024
2 parents 7444b06 + 6585032 commit 2d83c06
Show file tree
Hide file tree
Showing 8 changed files with 8,239 additions and 12,198 deletions.
20 changes: 20 additions & 0 deletions .github/workflows/check.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
name: fern-check

on:
pull_request:
push:
branches:
- main

jobs:
run:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Install Fern
run: npm install -g fern-api

- name: Check API is valid
run: fern check
38 changes: 0 additions & 38 deletions .github/workflows/ci.yml

This file was deleted.

22 changes: 22 additions & 0 deletions .github/workflows/generate-sdks.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
name: generate-sdks

on:
push:
tags:
- "*"

jobs:
run:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Install Fern
run: npm install -g fern-api

- name: Generate Go SDK
env:
FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
run: |
fern generate --group publish --log-level debug --version ${{ github.ref_name }}
3 changes: 0 additions & 3 deletions .vscode/settings.json

This file was deleted.

12 changes: 4 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,15 @@

Tagging a release on this repository will:

- Update the [Go SDK GitHub Repo](https://github.com/hookdeck/hookdeck-go-sdk)
- Update the [Go SDK](https://github.com/hookdeck/hookdeck-go-sdk)
- _More SDKs to come..._

## What is in this repository?

This repository contains

- Hookdeck's Fern API Definition which lives in the [definition](./fern/api/definition/) folder
- Generators (see [generators.yml](./fern/api/generators.yml))

## What is in the API Definition?

The API Definition contains information about what endpoints, types, and errors are used in the API. The definition is broken into smaller files such as [connection.yml](fern/api/definition/connection.yml) and [event.yml](fern/api/definition/event.yml).
- Hookdeck's Fern API Definition which lives in the [OpenApi](./fern/openapi/) folder
- Generators (see [generators.yml](./fern/generators.yml))

In order to make sure that the definition is valid, you can use the Fern CLI.

Expand All @@ -25,7 +21,7 @@ fern check # Checks if the definition is valid

## What are Generators?

Generators read in your API Definition and output files or code (i.e. the TypeScript SDK Generator) and are tracked in [generators.yml](./fern/api/generators.yml).
Generators read in your API Definition and output files or code (i.e. the TypeScript SDK Generator) and are tracked in [generators.yml](./fern/generators.yml).

### Local preview

Expand Down
2 changes: 1 addition & 1 deletion fern/fern.config.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"organization": "hookdeck",
"version": "0.15.0-rc17"
"version": "0.16.36"
}
4 changes: 2 additions & 2 deletions fern/generators.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ groups:
local:
generators:
- name: fernapi/fern-go-sdk
version: 0.6.1
version: 0.9.4
config:
enableExplicitNull: true
module:
Expand All @@ -13,7 +13,7 @@ groups:
publish:
generators:
- name: fernapi/fern-go-sdk
version: 0.6.1
version: 0.9.4
config:
enableExplicitNull: true
github:
Expand Down
Loading

0 comments on commit 2d83c06

Please sign in to comment.