aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorStewart Stewart <stewinsalot@gmail.com>2016-12-06 14:51:43 -0800
committerStewart Stewart <stewinsalot@gmail.com>2016-12-06 15:28:14 -0800
commite1e38c58c85b54eea8184f84a2425ac2524b9c7a (patch)
treecdc2e7b802d9dbb6d52213190f273df35da76de7 /README.md
parentda7ba3f3ef2bc66a7b20a5d18bfba5d0353fde44 (diff)
downloadslick-codegen-plugin-e1e38c58c85b54eea8184f84a2425ac2524b9c7a.tar.gz
slick-codegen-plugin-e1e38c58c85b54eea8184f84a2425ac2524b9c7a.tar.bz2
slick-codegen-plugin-e1e38c58c85b54eea8184f84a2425ac2524b9c7a.zip
include installation instructions in README
Diffstat (limited to 'README.md')
-rw-r--r--README.md37
1 files changed, 35 insertions, 2 deletions
diff --git a/README.md b/README.md
index da15c8a..e02924c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,35 @@
-# slick-codegen-plugin
-Plugin for using our customized Slick schema code generator.
+# _sbt_ plugin for slick schema code generation
+
+Extends/customizes the
+[Slick schema code generator](http://slick.lightbend.com/doc/3.1.1/code-generation.html) and wraps it in a parameterized plugin. See [original source code here](https://github.com/slick/slick/tree/master/slick-codegen/src/main/scala/slick/codegen).
+
+## TL;DR
+
+### project/plugins.sbt
+
+```sbt
+resolvers += "releases" at "https://drivergrp.jfrog.io/drivergrp/releases"
+credentials += Credentials("Artifactory Realm", "drivergrp.jfrog.io", "sbt-publisher", "***REMOVED***")
+
+addSbtPlugin("xyz.driver" % "sbt-slick-codegen" % "0.8")
+
+// Replace with the appropriate jdbc driver for your database:
+libraryDependencies += "org.postgresql" % "postgresql" % "9.4.1212"
+```
+
+### build.sbt
+
+Minimally, define `codegenUri`, `codegenPackage`, and `codegenOutputPath` like so:
+
+
+```sbt
+enablePlugins(CodegenPlugin)
+
+codegenURI := "file:src/main/resources/conf/database.conf#database"
+
+codegenPackage := "xyz.driver.schemas"
+
+codegenOutputPath := (baseDirectory.value / "src" / "main" / "scala").getPath
+```
+
+Use `settings -V codegen` to view documentation for all available codegen settings.