final class IncOptions extends Serializable
Represents all configuration options for the incremental compiler itself and not the underlying Java/Scala compiler.
- Alphabetic
- By Inheritance
- IncOptions
- Serializable
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Instance Constructors
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: File, _classfileManagerType: ClassFileManagerType, _auxiliaryClassFiles: Array[AuxiliaryClassFiles], _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Boolean, _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String], _strictMode: Boolean, _allowMachinePath: Boolean, _pipelining: Boolean)
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: Optional[File], _classfileManagerType: Optional[ClassFileManagerType], _auxiliaryClassFiles: Array[AuxiliaryClassFiles], _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Optional[Boolean], _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String], _strictMode: Boolean, _allowMachinePath: Boolean, _pipelining: Boolean)
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: File, _classfileManagerType: ClassFileManagerType, _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Boolean, _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String], _strictMode: Boolean, _allowMachinePath: Boolean, _pipelining: Boolean)
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: Optional[File], _classfileManagerType: Optional[ClassFileManagerType], _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Optional[Boolean], _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String], _strictMode: Boolean, _allowMachinePath: Boolean, _pipelining: Boolean)
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: File, _classfileManagerType: ClassFileManagerType, _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Boolean, _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String], _strictMode: Boolean)
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: Optional[File], _classfileManagerType: Optional[ClassFileManagerType], _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Optional[Boolean], _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String], _strictMode: Boolean)
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: File, _classfileManagerType: ClassFileManagerType, _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Boolean, _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String])
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: Optional[File], _classfileManagerType: Optional[ClassFileManagerType], _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Optional[Boolean], _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks, _ignoredScalacOptions: Array[String])
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: File, _classfileManagerType: ClassFileManagerType, _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Boolean, _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks)
- Attributes
- protected[compile]
-
new
IncOptions(_transitiveStep: Int, _recompileAllFraction: Double, _relationsDebug: Boolean, _apiDebug: Boolean, _apiDiffContextSize: Int, _apiDumpDirectory: Optional[File], _classfileManagerType: Optional[ClassFileManagerType], _useCustomizedFileManager: Boolean, _recompileOnMacroDef: Optional[Boolean], _useOptimizedSealed: Boolean, _storeApis: Boolean, _enabled: Boolean, _extra: Map[String, String], _logRecompileOnMacro: Boolean, _externalHooks: ExternalHooks)
- Attributes
- protected[compile]
-
new
IncOptions()
- Attributes
- protected[compile]
Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
allowMachinePath(): Boolean
When set to true, this makes the mapped file converter strict, so no paths will include machine-specific absolute path.
-
def
apiDebug(): Boolean
Enable tools for debugging API changes.
-
def
apiDiffContextSize(): Int
Controls context size (in lines) displayed when diffs are produced for textual API representation.
Controls context size (in lines) displayed when diffs are produced for textual API representation.
This option is used only when
apiDebug == true
. -
def
apiDumpDirectory(): Optional[File]
The directory where we dump textual representation of APIs.
The directory where we dump textual representation of APIs. This method might be called only if apiDebug returns true. This is unused option at the moment as the needed functionality is not implemented yet.
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
auxiliaryClassFiles(): Array[AuxiliaryClassFiles]
Associate each class file with corresponding files (eg.
Associate each class file with corresponding files (eg. .tasty files) that must be managed by the ClassfileManager.
-
def
classfileManagerType(): Optional[ClassFileManagerType]
ClassfileManager that will handle class file deletion and addition during a single incremental compilation run.
-
def
clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
def
enabled(): Boolean
Determines whether incremental compilation is enabled.
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(obj: Any): Boolean
- Definition Classes
- IncOptions → AnyRef → Any
-
def
externalHooks(): ExternalHooks
External hooks that allows clients e.g.
External hooks that allows clients e.g. IDEs to interacts with compilation internals
-
def
extra(): Map[String, String]
Extra options
-
def
finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
hashCode(): Int
- Definition Classes
- IncOptions → AnyRef → Any
-
def
ignoredScalacOptions(): Array[String]
Array of regexes that will be used to determine if scalac options should be ignored if they change
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
def
logRecompileOnMacro(): Boolean
Determines whether to log information on file recompiled due to a transitive macro change
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
def
pipelining(): Boolean
Enabled when build pipelining is used for this subproject.
Enabled when build pipelining is used for this subproject. The consumption of early output (pickle JAR) is dependent on the Scala version, so this flag in Zinc effectively means skip Javac invocation.
Note that contribution to pipelining by exporting early output is signaled by setting an earlyOutput in CompileOptions.
-
def
recompileAllFraction(): Double
What's the fraction of invalidated source files when we switch to recompiling all files and giving up incremental compilation altogether.
What's the fraction of invalidated source files when we switch to recompiling all files and giving up incremental compilation altogether. That's useful in cases when probability that we end up recompiling most of source files but in multiple steps is high. Multi-step incremental recompilation is slower than recompiling everything in one step.
-
def
recompileOnMacroDef(): Optional[Boolean]
Determines whether incremental compiler should recompile all dependencies of a file that contains a macro definition.
-
def
relationsDebug(): Boolean
Print very detailed information about relations, such as dependencies between source files.
-
def
storeApis(): Boolean
Determines whether incremental compiler stores apis alongside analysis.
-
def
strictMode(): Boolean
Enable assertions and other runtime checks that are otherwise disabled.
Enable assertions and other runtime checks that are otherwise disabled. Can be useful for debugging incremental compilation issues.
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- IncOptions → AnyRef → Any
-
def
transitiveStep(): Int
After which step include whole transitive closure of invalidated source files.
-
def
useCustomizedFileManager(): Boolean
Option to turn on customized file manager that tracks generated class files for transactional rollbacks.
Option to turn on customized file manager that tracks generated class files for transactional rollbacks. Using customized file manager may conflict with some libraries, this option allows user to decide whether to use.
-
def
useOptimizedSealed(): Boolean
Determines whether optimized approach for invalidating sealed classes/trait is used.
Determines whether optimized approach for invalidating sealed classes/trait is used. Turning this on may cause undercompilation in case of macros that are based sealed trait/class children enumeration.
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
- def withAllowMachinePath(allowMachinePath: Boolean): IncOptions
- def withApiDebug(apiDebug: Boolean): IncOptions
- def withApiDiffContextSize(apiDiffContextSize: Int): IncOptions
- def withApiDumpDirectory(apiDumpDirectory: File): IncOptions
- def withApiDumpDirectory(apiDumpDirectory: Optional[File]): IncOptions
- def withAuxiliaryClassFiles(auxiliaryClassFiles: Array[AuxiliaryClassFiles]): IncOptions
- def withClassfileManagerType(classfileManagerType: ClassFileManagerType): IncOptions
- def withClassfileManagerType(classfileManagerType: Optional[ClassFileManagerType]): IncOptions
- def withEnabled(enabled: Boolean): IncOptions
- def withExternalHooks(externalHooks: ExternalHooks): IncOptions
- def withExtra(extra: Map[String, String]): IncOptions
- def withIgnoredScalacOptions(ignoredScalacOptions: Array[String]): IncOptions
- def withLogRecompileOnMacro(logRecompileOnMacro: Boolean): IncOptions
- def withPipelining(pipelining: Boolean): IncOptions
- def withRecompileAllFraction(recompileAllFraction: Double): IncOptions
- def withRecompileOnMacroDef(recompileOnMacroDef: Boolean): IncOptions
- def withRecompileOnMacroDef(recompileOnMacroDef: Optional[Boolean]): IncOptions
- def withRelationsDebug(relationsDebug: Boolean): IncOptions
- def withStoreApis(storeApis: Boolean): IncOptions
- def withStrictMode(strictMode: Boolean): IncOptions
- def withTransitiveStep(transitiveStep: Int): IncOptions
- def withUseCustomizedFileManager(useCustomizedFileManager: Boolean): IncOptions
- def withUseOptimizedSealed(useOptimizedSealed: Boolean): IncOptions