trait RichConfigOps extends Dynamic with LowPriorityArgs4cImplicits
Exposes new operations on a 'config'
- Alphabetic
- By Inheritance
- RichConfigOps
- LowPriorityArgs4cImplicits
- Dynamic
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
-
implicit
class
RichArgs extends AnyRef
- Definition Classes
- LowPriorityArgs4cImplicits
-
implicit
class
RichString extends AnyRef
- Definition Classes
- LowPriorityArgs4cImplicits
Abstract Value Members
-
abstract
def
config: Config
- returns
the configuration for which we're providing additional functionality
Concrete 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
asDuration(key: String): Duration
- key
the configuration path
- returns
the value at the given key as a scala duration
- def asFiniteDuration(key: String): FiniteDuration
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
asJson: String
- returns
the configuration as a json string
-
def
asList(path: String, separator: Option[String] = Option(",")): List[String]
produces a scala list, either from a StringList or a comma-separated string value
produces a scala list, either from a StringList or a comma-separated string value
- path
the config path
- separator
if specified, the value at the given path will be parsed if it is a string and not a stringlist
-
def
clone(): AnyRef
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @native() @throws( ... )
-
def
collectAsMap(options: ConfigRenderOptions = defaultRenderOptions): Map[String, String]
- returns
the configuration as a map
-
def
collectAsStrings(options: ConfigRenderOptions = defaultRenderOptions): Seq[(String, String)]
- returns
the configuration as a set of key/value tuples
-
implicit
def
configAsRichConfig(c: Config): RichConfig
- Definition Classes
- LowPriorityArgs4cImplicits
- def defaultRenderOptions: ConfigRenderOptions
-
def
encrypt(password: Array[Byte]): Array[Byte]
- returns
the encrypted configuration
-
def
entries(arraySyntax: Boolean = true): Set[(String, ConfigValue)]
- arraySyntax
if true expand arrays with '.[x]' syntax
- returns
the configuration entries as a set of entries
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
filter(pathFilter: (String) ⇒ Boolean): Config
- pathFilter
a predicate used to determine if the configuration path should be kept
- returns
a new configuration which just keeps the paths which include the provided path predicate
-
def
filterNot(pathFilter: (String) ⇒ Boolean): Config
- pathFilter
a predicate used to determine if the configuration path should be kept
- returns
a new configuration which just keeps the paths which do NOT include the provided path predicate
-
def
finalize(): Unit
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
hasValue(path: String): Boolean
- path
the config path
- returns
true if the config path is set in this config to a non-empty value. This will error if the path specified is an object or a list
-
def
hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
intersect(other: Config): Config
- returns
the configuration representing the intersection of the two configuration entries
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
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
origins: List[String]
- returns
a sorted list of the origins from when the config values come
-
def
overrideWith(configString: String): Config
- configString
the configuration (as a string) which should override this config -- essentially the inverse of 'withFallback'
- returns
a new configuration based on 'configString' with our config as a fallback
-
def
overrideWith(overrideConfig: Config): Config
- overrideConfig
the configuration (as a string) which should override this config -- essentially the inverse of 'withFallback'
- returns
a new configuration based on 'configString' with our config as a fallback
-
def
pathRoots: Seq[String]
The available config roots.
The available config roots.
e.g. of a config has
foo.bar.x = 1 java.home = /etc/java bar.enabled = true bar.user = root
The 'pathRoots' would return a [bar, foo, java]
- returns
a sorted list of the root entries to the config.
-
def
paths(arraySyntax: Boolean = true): Seq[String]
- returns
all the unique paths for this configuration
- def selectDynamic(path: String): Selected
- def set(values: Map[String, Any], originDesc: String = "override"): Config
- def set(key: String, value: Boolean): Config
- def set(key: String, value: String): Config
-
def
set(key: String, value: Long): Config
- key
the config path
- value
the value to set
- returns
a new configuration based on 'configString' with our config as a fallback
- def setArray[T](key: String, value: Seq[T], originDesc: String = null): Config
- def setArray[T](key: String, firstValue: T, secondValue: T, theRest: T*): Config
-
def
showIfSpecified(obscure: (String, String) ⇒ String = obscurePassword(_, _)): Option[String]
If 'show=X' is specified, configuration values which contain X in their path will be displayed with the values matching 'obscure' obscured.
If 'show=X' is specified, configuration values which contain X in their path will be displayed with the values matching 'obscure' obscured.
If 'X' is 'all' or 'root', then the entire configuration is rendered.
This can be useful to debug other command-line args (to ensure they take the desired effect) or to validate the environment variable replacement
- obscure
a function which takes a dotted configuration path and string value and returns the value to display
- returns
the optional value of what's pointed to if 'show=<path>' is specified
-
def
summary(obscure: (String, String) ⇒ String = obscurePassword(_, _)): String
Return a property-like summary of the config using the pathFilter to trim property entries
Return a property-like summary of the config using the pathFilter to trim property entries
- obscure
a function which will 'safely' replace any config values with an obscured value
- returns
a summary of the configuration
-
def
summaryEntries(obscure: (String, String) ⇒ String = obscurePassword(_, _)): Seq[StringEntry]
Return a property-like summary of the config using the 'obscure' function to mask sensitive entries
Return a property-like summary of the config using the 'obscure' function to mask sensitive entries
- obscure
a function which will 'safely' replace any config values with an obscured value
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toMap: Map[String, ConfigValue]
- returns
the config as a map
-
def
toString(): String
- Definition Classes
- AnyRef → Any
-
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
- @native() @throws( ... )
-
def
withPaths(paths: Seq[String]): Config
- returns
this configuration which only contains the specified paths
-
def
withPaths(first: String, theRest: String*): Config
- first
the first path to include (keep)
- theRest
any other paths to keep
- returns
this configuration which only contains the specified paths
-
def
withUserArgs(args: Array[String], unrecognizedArg: (String) ⇒ Config = ParseArg.Throw): Config
Overlay the given arguments over this configuration, where the arguments are taken to be in the form:
Overlay the given arguments over this configuration, where the arguments are taken to be in the form:
$ the path to a configuration file, either on the classpath or file system $ a <key>=<value> pair where the key is a 'path.to.a.configuration.entry'
- args
the user arguments in the form <key>=<value>, <filePath> or <fileOnTheClasspath>
- unrecognizedArg
what to do with malformed user input
- returns
a configuration with the given user-argument overrides applied over top
-
def
without(configPaths: TraversableOnce[String]): Config
- configPaths
the paths to remove
- returns
a new configuration with the given paths removed
-
def
without(firstPath: String, theRest: String*): Config
- firstPath
the first path to remove
- theRest
the remaining paths to remove
- returns
a new configuration with the given paths removed
-
def
without(other: Config): Config
- other
the configuration to remove from this config
- returns
a new configuration with all values from 'other' removed