Skip to content

Commit

Permalink
Revert "Regenerate OpenAPI Client (#112)"
Browse files Browse the repository at this point in the history
This reverts commit 9c485da.
  • Loading branch information
xylo04 committed Jan 20, 2025
1 parent 9c485da commit 418a576
Show file tree
Hide file tree
Showing 27 changed files with 386 additions and 1,938 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/assign_pr.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: "Auto Assign"
name: 'Auto Assign'
on:
pull_request:
types: [opened, ready_for_review]
Expand Down
3 changes: 0 additions & 3 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,3 @@ _testmain.go
# IDE files
*.iml
.idea/

.travis.yml
git_push.sh
6 changes: 5 additions & 1 deletion .openapi-generator-ignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@
# Generated by openapi-generator https://github.com/openapitools/openapi-generator

# Use this file to prevent files from being overwritten by the generator.
# The patterns follow closely to .gitignore or .dockerignore.

go.mod
git_push.sh
.gitignore
README.md
.travis.yml
client.go
15 changes: 0 additions & 15 deletions .openapi-generator/FILES

This file was deleted.

2 changes: 1 addition & 1 deletion .openapi-generator/VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
7.10.0
4.3.1
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,17 @@

# Go API client for QRZ.com Logbook

A GoLang client library for QRZ.com's Logbook data service. The service provides
real-time access to information from QRZ.com logbooks. The API is documented
[here](https://www.qrz.com/docs/logbook/QRZLogbookAPI.html).
A GoLang client library for QRZ.com's Logbook data service. The service
provides real-time access to information from QRZ.com logbooks. The API is
documented [here](https://www.qrz.com/docs/logbook/QRZLogbookAPI.html).

This client library was generated based on the OpenAPI specification in the
`api/openapi.yaml` file. However, the API itself is not well-described by
This client library was generated based on the OpenAPI specification in
the `api/openapi.yaml` file. However, the API itself is not well-described by
OpenAPI, so the generated library is supplemented with `wrapper.go`.

A simple application to demonstrate how to integrate the library is located in
`cmd/qrz-logbook/main.go`.

A QRZ.com XML subscription is required to take full advantage of the API. A
description of subscription plans and rates is available on the
description of subscription plans and rates is available on the
[QRZ.com website](http://www.qrz.com/i/subscriptions.html).
2 changes: 0 additions & 2 deletions api/openapi-config.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,2 @@
packageName: qrzlog
withGoCodegenComment: true
globalProperties:
skipFormModel: false
44 changes: 19 additions & 25 deletions api/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@ openapi: 3.0.1
info:
contact:
email: [email protected]
description: |
This API provides methods for external programs to interact with the
description: This API provides methods for external programs to interact with the
QRZ Logbook using an HTTP REST interface. The QRZ Logbook is a combination free
and paid subscription service of QRZ. Some advanced features require a valid subscription
while the majority of operations are free to all QRZ members. All users of the
Expand All @@ -15,7 +14,7 @@ externalDocs:
description: Prose API description
url: http://files.qrz.com/static/qrz/The%20QRZ%20Logbook%20API.pdf
servers:
- url: https://logbook.qrz.com/api
- url: https://logbook.qrz.com/api
paths:
/:
post:
Expand All @@ -24,14 +23,14 @@ paths:
content:
application/x-www-form-urlencoded:
schema:
$ref: "#/components/schemas/Request"
$ref: '#/components/schemas/Request'
required: true
responses:
"200":
content:
application/x-www-form-urlencoded:
schema:
$ref: "#/components/schemas/Response"
$ref: '#/components/schemas/Response'
description: OK
summary: The do-everything endpoint
components:
Expand All @@ -42,12 +41,12 @@ components:
description: A QRZ supplied logbook access key
type: string
ACTION:
description: "Type of request, i.e. INSERT, DELETE, UPLOAD, etc."
description: Type of request, i.e. INSERT, DELETE, UPLOAD, etc.
enum:
- INSERT
- DELETE
- STATUS
- FETCH
- INSERT
- DELETE
- STATUS
- FETCH
type: string
ADIF:
description: ADIF formatted input data
Expand All @@ -59,35 +58,30 @@ components:
description: A comma separated list of integer logid values
type: string
required:
- ACTION
- KEY
- ACTION
- KEY
type: object
Response:
properties:
RESULT:
description: |
OK when the operation succeeds, FAIL when the operation failed,
description: OK when the operation succeeds, FAIL when the operation failed,
AUTH when API Access lacked sufficient privileges for the operation, or
other action-specific codes
type: string
REASON:
description:
Used with RESULT=FAIL to describe the specific reason for failure
description: Used with RESULT=FAIL to describe the specific reason for failure
type: string
LOGIDS:
description:
A comma separated list of logid values that were affected by the
action
description: A comma separated list of logid values that were affected by
the action
type: string
LOGID:
description:
The logid value of the record that was inserted or replaced.
(Singular "LOGID" response only used by INSERT as it is a single
record operation.)
description: The logid value of the record that was inserted or replaced.
(Singular "LOGID" response only used by INSERT as it is a single record
operation.)
type: string
COUNT:
description:
The number of QSO records that were affected by the action
description: The number of QSO records that were affected by the action
type: string
DATA:
description: Used for action-specific data such as status reports
Expand Down
157 changes: 55 additions & 102 deletions api_default.go

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 418a576

Please sign in to comment.