xsbt
package xsbt
- Alphabetic
- Public
- All
Type Members
- final class API extends Compat with GlobalHelpers with ClassName
- final class Analyzer extends LocateClassFile
-
sealed abstract
class
CallbackGlobal extends Global with ZincPicklePath
Defines the interface of the incremental compiler hiding implementation details.
-
trait
ClassName extends Compat
Utility methods for creating (source|binary) class names for a Symbol.
- abstract class Compat extends AnyRef
- final class CompilerInterface extends AnyRef
- class ConsoleInterface extends AnyRef
-
final
class
Dependency extends LocateClassFile with GlobalHelpers
Extracts dependency information from each compilation unit.
Extracts dependency information from each compilation unit.
This phase detects all the dependencies both at the term and type level.
When dependency symbol is processed, it is mapped back to either source file where it's defined in (if it's available in current compilation run) or classpath entry where it originates from. The Symbol -> Classfile mapping is implemented by LocateClassFile that we inherit from.
-
class
ExtractAPI[GlobalType <: Global] extends Compat with ClassName with GlobalHelpers
Extracts full (including private members) API representation out of Symbols and Types.
Extracts full (including private members) API representation out of Symbols and Types.
API for each class is extracted separately. Inner classes are represented as an empty (without members) member of the outer class and as a separate class with full API representation. For example:
class A { class B { def foo: Int = 123 } }
Is represented as:
// className = A class A { class B } // className = A.B class A.B { def foo: Int }
Each compilation unit should be processed by a fresh instance of this class.
NOTE: This class extract *full* API representation. In most of other places in the incremental compiler, only non-private (accessible from other compilation units) members are relevant. Other parts of the incremental compiler filter out private definitions before processing API structures. Check SameAPI for an example.
-
class
ExtractUsedNames[GlobalType <: CallbackGlobal] extends Compat with ClassName with GlobalHelpers
Extracts simple names used in given compilation unit.
Extracts simple names used in given compilation unit.
Extracts simple (unqualified) names mentioned in given in non-definition position by collecting all symbols associated with non-definition trees and extracting names from all collected symbols. Also extract the names of the types of non-definition trees (see source-dependencies/types-in-used-names-* and source-dependencies/as-seen-from-* for examples where this is required).
If given symbol is mentioned both in definition and in non-definition position (e.g. in member selection) then that symbol is collected. It means that names of symbols defined and used in the same compilation unit are extracted. We've considered not extracting names of those symbols as an optimization strategy. It turned out that this is not correct. Check https://github.com/gkossakowski/sbt/issues/3 for an example of scenario where it matters.
All extracted names are returned in _decoded_ form. This way we stay consistent with the rest of incremental compiler which works with names in decoded form.
Names mentioned in Import nodes are handled properly but require some special logic for two reasons:
- The
termSymbol
of Import nodes point to the symbol of the prefix it imports from (not the actual members that we import, that are represented as names). 2. ImportSelector is not subtype of Tree therefore is not processed byTree.foreach
.
Another type of tree nodes that requires special handling is TypeTree. TypeTree nodes has a little bit odd representation:
- TypeTree.hasSymbol always returns false even when TypeTree.symbol returns a symbol 2. The original tree from which given TypeTree was derived is stored in TypeTree.original but Tree.forech doesn't walk into original tree so we missed it
The tree walking algorithm walks into TypeTree.original explicitly.
- The
- trait GlobalHelpers extends AnyRef
- class InteractiveConsoleFactory extends xsbti.InteractiveConsoleFactory
- class InteractiveConsoleInterface extends xsbti.InteractiveConsoleInterface
- case class InteractiveConsoleResponse(result: InteractiveConsoleResult, output: String) extends xsbti.InteractiveConsoleResponse with Product with Serializable
- class InterfaceCompileCancelled extends CompileCancelled
- class InterfaceCompileFailed extends CompileFailed
-
class
LocalToNonLocalClass[G <: CallbackGlobal] extends AnyRef
A memoized lookup of an enclosing non local class.
A memoized lookup of an enclosing non local class.
Let's consider an example of an owner chain:
pkg1 <- pkg2 <- class A <- object B <- class C <- def foo <- class Foo <- class Bar
For an object, we work with its
moduleClass
so we can refer to everything as classes.Classes A, B, C are non local so they are mapped to themselves. Classes Foo and Bar are local because they are defined within method
foo
.Let's define non local class more precisely. A non local class is a class that is owned by either a package or another non local class. This gives rise to a recursive definition of a non local class that is used in the implementation of the mapping.
Thanks to memoization, the amortized cost of a lookup is O(1). We amortize over lookups of all class symbols in the current compilation run.
Additionally, you can query whether a given class is local. Check
isLocal
's documentation. -
abstract
class
LocateClassFile extends Compat with ClassName
Contains utility methods for looking up class files corresponding to Symbols.
-
final
class
PickleVirtualDirectory extends VirtualDirectory
Defines an almost exact copy of
VirtualDirectory
but allowing us to usePickleVirtualFile
for thefileNamed
directory. -
final
class
PickleVirtualFile extends VirtualFile
Simulates a
VirtualFile
but gives it a container and allows it to have content. - final class PicklerGen extends Compat with GlobalHelpers
- class ScaladocInterface extends AnyRef
-
sealed
class
ZincCompiler extends CallbackGlobal with ZincGlobalCompat with ZincOutlining
Defines the implementation of Zinc with all its corresponding phases.
- final class ZincCompilerRangePos extends ZincCompiler with Positions
-
trait
ZincGlobalCompat extends AnyRef
Defines compatibility utils for ZincCompiler.
- trait ZincOutlining extends ZincStatistics
- trait ZincPickleCompletion extends AnyRef
- final class ZincSettings extends Settings
- trait ZincStatistics extends AnyRef
- abstract class ZincSymbolLoaders extends GlobalSymbolLoaders with ZincPickleCompletion
Value Members
- object API
- object Analyzer
- object Command
- object Compat
- object Dependency
- object ExtractAPI
- object InteractiveConsoleHelper
- object InteractiveMakeSettings
- object Log
- object MakeSettings
- object Message
- object PicklerGen