From 5af7dc8d208ed7f6fc61fef13b81d636e6e0dfcd Mon Sep 17 00:00:00 2001 From: Bryan Newbold Date: Wed, 9 May 2018 11:12:04 -0700 Subject: README updates --- fatcat-go/README.md | 3 +++ notes/golang.txt | 14 +++++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/fatcat-go/README.md b/fatcat-go/README.md index ea1166ce..408ee1a5 100644 --- a/fatcat-go/README.md +++ b/fatcat-go/README.md @@ -21,3 +21,6 @@ In early development, we'll make at least the following simplifications: - "extra" metadata is stored in-entity as JSONB. In the future this might be broken out to a separate table - libraries won't be vendored; in the future they will be via a git submodule + + +## Tools diff --git a/notes/golang.txt b/notes/golang.txt index 090a5942..0730f409 100644 --- a/notes/golang.txt +++ b/notes/golang.txt @@ -1,8 +1,9 @@ +## Database Schema / ORM / Generation + - pq: basic postgres driver and ORM (similar to sqlalchemy?) - sqlx: small extensions to builtin sql; row to struct mapping - code generation from SQL schema: - https://github.com/xo/xo - https://github.com/volatiletech/sqlboiler @@ -20,6 +21,17 @@ for auth, start with oauth2... orcid? debug postgres with gocmdpev +## OpenAPI/Swagger + +go-swagger (OpenAPI 2.0): +- generate initial API server skeleton from a yaml definition +- export updated yaml from code after changes +- web UI for documentation +- templating/references +- auto-generate client (in golang) + +also look at ReDoc as a UI; all in-brower generated from JSON (react) + ## Non-API stuff - logrus structured logging (or zap?) -- cgit v1.2.3