aboutsummaryrefslogtreecommitdiffstats
path: root/notes
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2018-05-09 11:12:04 -0700
committerBryan Newbold <bnewbold@robocracy.org>2018-05-09 11:12:16 -0700
commit5af7dc8d208ed7f6fc61fef13b81d636e6e0dfcd (patch)
tree0493a7b0212fe4fe43936efebc8d5ba91de2c82a /notes
parent351773cca98ccc61f7844ba9892ee797f1dd3d29 (diff)
downloadfatcat-5af7dc8d208ed7f6fc61fef13b81d636e6e0dfcd.tar.gz
fatcat-5af7dc8d208ed7f6fc61fef13b81d636e6e0dfcd.zip
README updatesx-attic-golang
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?)