SBT Basic Concepts

Transcript

1. SBT Basic Concepts @pishen
2. build.sbt
3. name := "hello_world" SettingKey[String] a function Setting[String]
4. build.sbt (*.sbt) name := "hello_world" version := "0.1.0-SNAPSHOT" scalaVersion := "2.11.8" libraryDependencies += "com.typesafe.akka" %% "akka-actor" % "2.4.8" //libraryDependencies += // "com.typesafe.akka" % "akka-actor_2.11" % "2.4.8" Setting[String] Setting[Seq[ModuleID]]
5. > inspect libraryDependencies Setting: Seq[ModuleID] = List(...) > show libraryDependencies List(...)
6. build.sbt import java.util.Date def getTime() = new Date().getTime val baseVersion = "0.1.0" version := { println("Mom! I'm here!!") baseVersion + "_" + getTime() } class A() {...} object B {...}
7. Define your own Key
8. SettingKey[T] TaskKey[T] InputKey[T] name, version compile run
9. val a = settingKey[Int]("this is a") val demo = taskKey[Unit]("demo") Description, will be shown in > inspect SettingKey[Int] > show a > demo
10. Implement the Settings val demo = taskKey[Unit]("demo") name := "hello_world" demo := { println("Hello, this is project " + name.value) } dependency > demo > inspect demo build.sbt
11. Parallelization & deduplication val demo1 = taskKey[Unit]("demo1") val demo2 = taskKey[Unit]("demo2") val demo3 = taskKey[Unit]("demo3") demo1 := println("demo1") demo2 := println("demo2") demo3 := { demo1.value println("demo3") demo2.value demo1.value } demo1 demo2 demo3 demo2 demo1 demo3 build.sbt
12. SBT is recursive ``The project directory is another build inside your build, which knows how to build your build.
13. SBT is recursive ``The project directory is another build inside your build, which knows how to build your build.
14. my-project/ └ src/main/scala/.../Main.scala └ Hello.scala └ anything.sbt └ build.sbt └ target/ └ Main.class
15. my-project/ └ src/main/scala/.../Main.scala └ Hello.scala └ anything.sbt └ build.sbt └ project/ └ MyPlugin.scala └ target/ └ Main.class class A() {...} object B {...} val a = new A()
16. my-project/ └ src/main/scala/.../Main.scala └ Hello.scala └ anything.sbt └ build.sbt └ project/ └ MyPlugin.scala └ cool.sbt └ assembly.sbt └ target/ └ Main.class libraryDependencies += "joda-time" % "joda-time" % "2.9.4" addSbtPlugin("com.eed3si9n" % "sbt-assembly" % "0.14.3") val now = DateTime.now()
17. my-project/ └ src/main/scala/.../Main.scala └ Hello.scala └ anything.sbt └ build.sbt └ project/ └ MyPlugin.scala └ cool.sbt └ assembly.sbt └ project/ └ PluginOfMyPlugin.scala └ target/ └ Main.class
18. Some examples
19. pishen/annoy4s src/main/cpp/annoyjava.cpp src/main/resource/linux-x86-64/libannoy.so win32-x86 darwin freebsd-x86 ... g++ https://github.com/pishen/annoy4s
20. pishen/annoy4s libraryDependencies += "net.java.dev.jna" % "jna" % "4.2.2" https://github.com/pishen/annoy4s project/plugins.sbt
21. pishen/annoy4s val compileNative = taskKey[Unit](...) import com.sun.jna.Platform import sys.process._ compileNative := { val lib = s"src/main/resources/${Platform.RESOURCE_PREFIX}/libannoy.so" val cpp = "src/main/cpp/annoyjava.cpp" s"g++ -o $lib -shared -fPIC $cpp".! } > compileNative https://github.com/pishen/annoy4s build.sbt
22. KKBOX/spark-deployer libraryDependencies ++= Seq( "com.typesafe" % "config" % "1.3.0", "com.amazonaws" % "aws-java-sdk-s3" % "1.10.34", "com.amazonaws" % "aws-java-sdk-ec2" % "1.10.34", "org.pacesys" % "openstack4j" % "2.0.9" ) addSbtPlugin("com.eed3si9n" % "sbt-assembly" % "0.14.0") https://github.com/KKBOX/spark-deployer project/plugins.sbt
23. Scopes
24. compile Key
25. test:compile Key Configuration
26. test:compile::fullClasspath Key Configuration other Key
27. Configuration scope compile test * runtime staging production Global custom configurations : : : : : : name name name name name name "G" "A" "B" "C" "D" delegate
28. Configuration scope compile test * runtime staging production : : : : : : compile compile compile compile compile compile Configuration Key
29. Define Configurations lazy val Staging = config("staging") name := "G" name in Staging := "D" + name.value build.sbt > show name > show *:name > show staging:name > inspect staging:name Global
30. Question 1 lazy val Staging = config("staging") version := "1.0" version in Staging := "1.0.1" name in Staging := "D" + version.value build.sbt > show staging:name D1.0? D1.0.1?
31. Solution 1 name in Staging := "D" + (version in Staging).value inConfig(Staging)(Seq( name := "D" + version.value )) build.sbt
32. Question 2 > compile Configuration? Key?
33. Usage of Configuration lazy val Staging = config("staging") lazy val Production = config("production") val deploy = taskKey[Unit]("deploy") val servers = settingKey[Seq[String]]("servers") val baseSettings = Seq( deploy := {... servers.value ...} ) inConfig(Staging)(baseSettings) inConfig(Production)(baseSettings) deploy.sbt
34. Usage of Configuration servers in Staging := Seq("192.168.0.1") servers in Production := Seq("140.112.172.1", ...) build.sbt > staging:deploy > production:deploy sbt-codedeploy https://github.com/gilt/sbt-codedeploy
35. Task scope * :: name compile test assembly :: :: :: name name name name :: assembly Key Key
36. Question 3 val demo = taskKey[Unit]("demo") version := "1.0" version in demo := "1.0.1" demo := println("D" + version.value) build.sbt > demo D1.0? D1.0.1? demo::version
37. Usage of Task scope fullClasspath in assembly += baseDirectory.value / "production-resources" my-project/ └ src/main/ └ scala/... └ resources/application.conf └ build.sbt └ production-resources/ └ production.conf include "production.conf" build.sbt
38. Mixed scope test:compile::fullClasspath fullClasspath in (Test, compile) := {...}
39. Publishing
40. libraryDependencies += "com.typesafe.akka" %% "akka-actor" % "2.4.8" ~/.ivy2/cache/ Maven Central Bintray JCenter ~/.ivy2/local/
41. libraryDependencies += "com.typesafe.akka" %% "akka-actor" % "2.4.8-SNAPSHOT" ~/.ivy2/cache/ Maven Central Bintray JCenter ~/.ivy2/local/
42. organization := "net.pishen" name := "my-project" version := "0.1.0-SNAPSHOT" crossScalaVersions := Seq("2.10.6", "2.11.8") > +publishLocal ~/.ivy2/local/ Project A libraryDependencies += "net.pishen" %% "my-project" % "0.1.0-SNAPSHOT" Project B ~/.ivy2/cache/
43. Resolvers val r = "My Resolver" at "http://my-server/my-repository" val r = Resolver.sonatypeRepo("public") val r = Resolver.bintrayRepo("owner", "repo") val r = Resolver.sftp(...) val r = Resolver.... resolvers += r publishTo := Some(r) > publish
44. Publish your own library via Bintray 1. Create an account on https://bintray.com/ 2. Install bintray-sbt https://github.com/softprops/bintray-sbt 3. Share your masterpiece to the world!
45. > thanks @pishen