aboutsummaryrefslogtreecommitdiffstats
path: root/fatcat-go/README.md
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2018-05-09 18:31:21 -0700
committerBryan Newbold <bnewbold@robocracy.org>2018-05-09 18:31:21 -0700
commitf36836a6399022338ec02849da42f6f518c7a54f (patch)
treefc9005e6723ad124acf3e5717280bf2ee77c4813 /fatcat-go/README.md
parentcc57215fc1c5e56e8c745ea76135e2d170f585c7 (diff)
downloadfatcat-f36836a6399022338ec02849da42f6f518c7a54f.tar.gz
fatcat-f36836a6399022338ec02849da42f6f518c7a54f.zip
first swagger generation
Diffstat (limited to 'fatcat-go/README.md')
-rw-r--r--fatcat-go/README.md20
1 files changed, 19 insertions, 1 deletions
diff --git a/fatcat-go/README.md b/fatcat-go/README.md
index 408ee1a5..49410352 100644
--- a/fatcat-go/README.md
+++ b/fatcat-go/README.md
@@ -10,6 +10,17 @@ fatcatd is essentially just glue between two declarative schemas:
- a postgres-flavor SQL database schema
- an OpenAPI/Swagger REST API definition
+## Dev Setup
+
+- postgres 9.6+ running locally
+- golang environment configured
+ - https://github.com/golang/dep
+
+On debian/ubuntu:
+
+ sudo -u postgres createuser -s `whoami`
+ createdb -O `whoami` fatcat
+ psql fatcat -f fatcat-schema.sql
## Simplifications
@@ -23,4 +34,11 @@ In early development, we'll make at least the following simplifications:
- libraries won't be vendored; in the future they will be via a git submodule
-## Tools
+## OpenAPI Code Generation
+
+Install the go-swagger tool:
+
+ go get -u github.com/go-swagger/go-swagger/cmd/swagger
+
+
+ swagger generate server -A Fatcat -f fatcat-openapi2.yml