pureconfig
package pureconfig
- Alphabetic
- By Inheritance
- pureconfig
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
-
trait
AllowMissingKey
extends AnyRef
The default behavior of ConfigReaders that are implicitly derived in PureConfig is to raise a KeyNotFoundException when a required key is missing.
The default behavior of ConfigReaders that are implicitly derived in PureConfig is to raise a KeyNotFoundException when a required key is missing. Mixing in this trait to a ConfigReader allows customizing this behavior. When a key is missing, but the ConfigReader of the given type extends this trait, the
frommethod of the ConfigReader is called with null. -
trait
BasicReaders
extends PrimitiveReaders with UriAndPathReaders with JavaTimeReaders with DurationReaders with TypesafeConfigReaders
Trait containing
ConfigReaderinstances for primitive types and simple classes in Java and Scala standard libraries. -
trait
BasicWriters
extends PrimitiveWriters with UriAndPathWriters with JavaTimeWriters with DurationWriters with TypesafeConfigWriters
Trait containing
ConfigWriterinstances for primitive types and simple classes in Java and Scala standard libraries. - trait CapitalizedWordsNamingConvention extends NamingConvention
-
trait
ConfigConvert
[T] extends ConfigReader[T] with ConfigWriter[T]
Trait for objects capable of reading and writing objects of a given type from and to
ConfigValues. - trait ConfigFieldMapping extends (String) ⇒ String
-
trait
ConfigReader
[T] extends AnyRef
Trait for objects capable of reading objects of a given type from
ConfigValues.Trait for objects capable of reading objects of a given type from
ConfigValues.- T
the type of objects readable by this
ConfigReader
-
trait
ConfigWriter
[T] extends AnyRef
Trait for objects capable of writing objects of a given type to
ConfigValues.Trait for objects capable of writing objects of a given type to
ConfigValues.- T
the type of objects writable by this
ConfigWriter
-
trait
ConvertHelpers
extends AnyRef
Useful helpers for building
ConfigConvertinstances and dealing with results. -
trait
CoproductHint
[T] extends AnyRef
A trait that can be implemented to disambiguate between the different options of a coproduct or sealed family.
A trait that can be implemented to disambiguate between the different options of a coproduct or sealed family.
- T
the type of the coproduct or sealed family for which this hint applies
-
trait
DerivedReaders
extends AnyRef
Trait containing
ConfigReaderinstances for collection, product and coproduct types. -
trait
DerivedWriters
extends AnyRef
Trait containing
ConfigWriterinstances for collection, product and coproduct types. -
trait
DurationReaders
extends AnyRef
Trait containing
ConfigReaderinstances for scala.concurrent.duration.Duration and scala.concurrent.duration.FiniteDuration. -
trait
DurationWriters
extends AnyRef
Trait containing
ConfigWriterinstances for scala.concurrent.duration.Duration and scala.concurrent.duration.FiniteDuration. -
class
FieldCoproductHint
[T] extends CoproductHint[T]
Hint where the options are disambiguated by a
key = "value"field inside the config.Hint where the options are disambiguated by a
key = "value"field inside the config.This hint will cause derived
ConfigConvertinstance to fail to convert configs to objects if the object has a field with the same name as the disambiguation key.By default, the field value written is the class or coproduct option name converted to lower case. This mapping can be changed by overriding the method
fieldValueof this class. -
class
FirstSuccessCoproductHint
[T] extends CoproductHint[T]
Hint where all coproduct options are tried in order.
Hint where all coproduct options are tried in order.
fromwill choose the first option able to deserialize the config without errors, whiletowill write the config as is, with no disambiguation information. -
trait
JavaTimeReaders
extends AnyRef
Trait containing
ConfigReaderinstances forjava.timeclasses. -
trait
JavaTimeWriters
extends AnyRef
Trait containing
ConfigWriterinstances forjava.timeclasses. - trait NamingConvention extends AnyRef
-
trait
PrimitiveReaders
extends AnyRef
Trait containing
ConfigReaderinstances for primitive types. -
trait
PrimitiveWriters
extends AnyRef
Trait containing
ConfigWriterinstances for primitive types. -
trait
ProductHint
[T] extends AnyRef
A trait that can be implemented to customize how case classes are read from and written to a config.
A trait that can be implemented to customize how case classes are read from and written to a config.
- T
the type of case class for which this hint applies
- class StringDelimitedNamingConvention extends NamingConvention
-
trait
TypesafeConfigReaders
extends AnyRef
Trait containing
ConfigReaderinstances for Typesafe config models. -
trait
TypesafeConfigWriters
extends AnyRef
Trait containing
ConfigWriterinstances for Typesafe config models. -
trait
UriAndPathReaders
extends AnyRef
Trait containing
ConfigReaderinstances for classes related to file system paths and URIs. -
trait
UriAndPathWriters
extends AnyRef
Trait containing
ConfigWriterinstances for classes related to file system paths and URIs.
Value Members
-
def
loadConfig[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the givenConfig -
def
loadConfig[Config](conf: Config)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the givenConfig -
def
loadConfig[Config](path: Path, namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the given file.Load a configuration of type
Configfrom the given file. Note that standard configuration files are still loaded but can be overridden from the given configuration file- namespace
the base namespace from which the configuration should be load
- returns
A
Successwith the configuration if it is possible to create an instance of typeConfigfrom the configuration files, else aFailurewith details on why it isn't possible
-
def
loadConfig[Config](path: Path)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the given file.Load a configuration of type
Configfrom the given file. Note that standard configuration files are still loaded but can be overridden from the given configuration file- returns
A
Successwith the configuration if it is possible to create an instance of typeConfigfrom the configuration files, else aFailurewith details on why it isn't possible
-
def
loadConfig[Config](namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the standard configuration filesLoad a configuration of type
Configfrom the standard configuration files- namespace
the base namespace from which the configuration should be load
- returns
A
Successwith the configuration if it is possible to create an instance of typeConfigfrom the configuration files, else aFailurewith details on why it isn't possible
-
def
loadConfig[Config](implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the standard configuration filesLoad a configuration of type
Configfrom the standard configuration files- returns
A
Successwith the configuration if it is possible to create an instance of typeConfigfrom the configuration files, else aFailurewith details on why it isn't possible
-
def
loadConfigFromFiles[Config](files: Traversable[Path])(implicit arg0: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Loads
filesin order, allowing values in later files to backstop missing values from prior, and converts them into aConfig.Loads
filesin order, allowing values in later files to backstop missing values from prior, and converts them into aConfig.This is a convenience method which enables having default configuration which backstops local configuration.
Note: If an element of
filesreferences a file which doesn't exist or can't be read, it will silently be ignored.- files
Files ordered in decreasing priority containing part or all of a
Config. Must not be empty.
-
def
loadConfigFromFilesOrThrow[Config](files: Traversable[Path])(implicit arg0: ConfigReader[Config], ct: ClassTag[Config]): Config
- returns
the configuration
- Annotations
- @throws( ... )
- See also
-
def
loadConfigOrThrow[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the givenConfigLoad a configuration of type
Configfrom the givenConfig- conf
Typesafe configuration to load
- namespace
the base namespace from which the configuration should be load
- returns
the configuration
- Annotations
- @throws( ... )
-
def
loadConfigOrThrow[Config](conf: Config)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the givenConfigLoad a configuration of type
Configfrom the givenConfig- conf
Typesafe configuration to load
- returns
the configuration
- Annotations
- @throws( ... )
-
def
loadConfigOrThrow[Config](path: Path, namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the given file.Load a configuration of type
Configfrom the given file. Note that standard configuration files are still loaded but can be overridden from the given configuration file- namespace
the base namespace from which the configuration should be load
- returns
the configuration
- Annotations
- @throws( ... )
-
def
loadConfigOrThrow[Config](path: Path)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the given file.Load a configuration of type
Configfrom the given file. Note that standard configuration files are still loaded but can be overridden from the given configuration file- returns
the configuration
- Annotations
- @throws( ... )
-
def
loadConfigOrThrow[Config](namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the standard configuration filesLoad a configuration of type
Configfrom the standard configuration files- namespace
the base namespace from which the configuration should be load
- returns
the configuration
- Annotations
- @throws( ... )
-
def
loadConfigOrThrow[Config](implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the standard configuration filesLoad a configuration of type
Configfrom the standard configuration files- returns
the configuration
- Annotations
- @throws( ... )
-
def
loadConfigWithFallback[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the givenConfig, falling back to the default configurationLoad a configuration of type
Configfrom the givenConfig, falling back to the default configuration- conf
Typesafe configuration to load
- namespace
the base namespace from which the configuration should be load
- returns
A
Successwith the configuration if it is possible to create an instance of typeConfigfrom the configuration files, else aFailurewith details on why it isn't possible
-
def
loadConfigWithFallback[Config](conf: Config)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Configfrom the givenConfig, falling back to the default configurationLoad a configuration of type
Configfrom the givenConfig, falling back to the default configuration- conf
Typesafe configuration to load
- returns
A
Successwith the configuration if it is possible to create an instance of typeConfigfrom the configuration files, else aFailurewith details on why it isn't possible
-
def
loadConfigWithFallbackOrThrow[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the givenConfig, falling back to the default configurationLoad a configuration of type
Configfrom the givenConfig, falling back to the default configuration- conf
Typesafe configuration to load
- namespace
the base namespace from which the configuration should be load
- returns
the configuration
- Annotations
- @throws( ... )
-
def
loadConfigWithFallbackOrThrow[Config](conf: Config)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Configfrom the givenConfig, falling back to the default configurationLoad a configuration of type
Configfrom the givenConfig, falling back to the default configuration- conf
Typesafe configuration to load
- returns
the configuration
- Annotations
- @throws( ... )
-
def
saveConfigAsPropertyFile[Config](conf: Config, outputPath: Path, overrideOutputPath: Boolean = false)(implicit writer: ConfigWriter[Config]): Unit
Save the given configuration into a property file
Save the given configuration into a property file
- conf
The configuration to save
- outputPath
Where to write the configuration
- overrideOutputPath
Override the path if it already exists
- Annotations
- @throws( ... )
-
def
saveConfigToStream[Config](conf: Config, outputStream: OutputStream)(implicit writer: ConfigWriter[Config]): Unit
Writes the configuration to the output stream and closes the stream
Writes the configuration to the output stream and closes the stream
- conf
The configuration to write
- outputStream
The stream in which the configuration should be written
- object BasicReaders extends BasicReaders
- object BasicWriters extends BasicWriters
-
object
CamelCase
extends CapitalizedWordsNamingConvention
CamelCase identifiers look like
camelCaseanduseMorePureconfigCamelCase identifiers look like
camelCaseanduseMorePureconfig- See also
https://en.wikipedia.org/wiki/Camel_case
- object CapitalizedWordsNamingConvention
-
object
ConfigConvert
extends ConvertHelpers
Provides methods to create ConfigConvert instances.
- object ConfigFieldMapping
-
object
ConfigReader
extends BasicReaders with DerivedReaders
Provides methods to create ConfigReader instances.
-
object
ConfigWriter
extends BasicWriters with DerivedWriters
Provides methods to create ConfigWriter instances.
- object ConvertHelpers extends ConvertHelpers
- object CoproductHint
- object DerivedReaders extends DerivedReaders
- object DerivedWriters extends DerivedWriters
-
object
KebabCase
extends StringDelimitedNamingConvention
KebabCase identifiers look like
kebab-caseanduse-more-pureconfigKebabCase identifiers look like
kebab-caseanduse-more-pureconfig- See also
http://wiki.c2.com/?KebabCase
-
object
PascalCase
extends CapitalizedWordsNamingConvention
PascalCase identifiers look like e.g.
PascalCaseandUseMorePureconfigPascalCase identifiers look like e.g.
PascalCaseandUseMorePureconfig- See also
https://en.wikipedia.org/wiki/PascalCase
- object ProductHint
-
object
SnakeCase
extends StringDelimitedNamingConvention
SnakeCase identifiers look like
snake_caseanduse_more_pureconfigSnakeCase identifiers look like
snake_caseanduse_more_pureconfig- See also
https://en.wikipedia.org/wiki/Snake_case