SBT plugin to collect information about project structure
OTHER License
This plugin extracts the structure of an sbt build in XML format. It is used in Intellij Scala plugin in order to import arbitrary sbt projects into IDEA.
Please report any issues related to sbt-structure in IntelliJ on the IntelliJ Scala YouTrack project.
extractor
is an sbt plugin that actually extracts information from the sbt build.core
is a shared library that is used by both extractor
and the Intellij Scala plugin.Note: extractor
is packaged as a fat jar, by compiling the sources of core
and including the output .class
files in the resulting jar. This packaging structure is implicitly expected by the Intellij Scala plugin, due to how
the jar is injected in sbt for extracting the information of a sbt build. The shared sources are contained in the
shared
directory and linked in the extractor
and core
modules, in order to create a source dependency that can be
recognized by IDEA.
Add to your build.sbt
resolvers += Resolver.url("jb-bintray", url("https://dl.bintray.com/jetbrains/sbt-plugins"))(Resolver.ivyStylePatterns)
libraryDependencies += "org.jetbrains" %% "sbt-structure-core" % "<version>"
Then run extractor or get XML of the structure any other way and deserialize it:
import org.jetbrains.sbt._
import org.jetbrains.sbt.XmlSerializer._
val structureXml: Elem = XML.load(...)
val structure: Either[Throwable, StructureData] = structureXml.deserialize[StructureData]
Extractor can be run as a regular sbt plugin, or loaded into the build during an sbt shell session.
The quickest way to try out the extractor is by adding it to your build in project/plugins.sbt
as an sbt plugin:
addSbtPlugin("org.jetbrains" % "sbt-structure-extractor" % "<version>")
Then from the sbt shell run:
*/*:dumpStructure
This will output the xml directly to the shell.
To write the xml to a file, run:
set org.jetbrains.sbt.StructureKeys.sbtStructureOptions in Global := "prettyPrint download"
*/*:dumpStructureTo structure.xml
The dumpStructure
task uses the settings described below, the dumpStructureTo
task takes sbtStructureFile
as parameter instead.
This is the way Intellij-Scala imports projects by default.
Extractor is run in several steps:
sbt-structure-output-file
andsbt-structure-options
settings in Global
scope.dumpStructure
task in Global
scopeHere is an example of how to run extractor from sbt REPL:
set SettingKey[Option[File]]("sbtStructureOutputFile") in Global := Some(file("structure.xml"))
set SettingKey[String]("sbtStructureOptions") in Global := "prettyPrint download"
apply -cp <path-to-extractor-jar> org.jetbrains.sbt.CreateTasks
*/*:dumpStructure
sbt-structure-options
contains space-separated list of options.
sbt-structure-output-file
points to a file where structure will be written; if
it is set to None
then structure will be dump into stdout.
Available options to set in sbt-structure-options
:
download
When this option is set extractor will run update
command for each project in build and build complete
repository of all transitive library dependencies
resolveClassifiers
(requires download
option to be set as well)
Same as download
+ downloading sources and javadocs for each transitive library dependency
resolveSbtClassifiers
This option tells extractor to download sources and javadocs for sbt itself and plugins.
prettyPrint
This option will force extractor to prettify XML output. Useful for debug purposes.
^ test
command^^ 0.13.7 test
testOnly
command, e.g. ^ testOnly -- -ex "project name"
To publish artifacts locally bump version in build.sbt
and run in sbt REPL:
publishAllLocal
sbt-structure is built and published for sbt 0.13.x and 1.x
sbt-structure-core is built and published for Scala 2.10, 2.11, 2.12, 2.13