aboutsummaryrefslogtreecommitdiffstats
path: root/notes
diff options
context:
space:
mode:
Diffstat (limited to 'notes')
-rw-r--r--notes/golang.txt14
1 files changed, 13 insertions, 1 deletions
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?)