summaryrefslogtreecommitdiffstats
path: root/fatcat-go/README.md
diff options
context:
space:
mode:
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