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
from
method of the ConfigReader is called with null. -
trait
BasicReaders
extends PrimitiveReaders with UriAndPathReaders with JavaTimeReaders with DurationReaders with TypesafeConfigReaders
Trait containing
ConfigReader
instances 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
ConfigWriter
instances for primitive types and simple classes in Java and Scala standard libraries. -
trait
DerivedReaders
extends AnyRef
Trait containing
ConfigReader
instances for collection, product and coproduct types. -
trait
DerivedWriters
extends AnyRef
Trait containing
ConfigWriter
instances for collection, product and coproduct types. -
trait
DurationReaders
extends AnyRef
Trait containing
ConfigReader
instances for Duration and FiniteDuration. -
trait
DurationWriters
extends AnyRef
Trait containing
ConfigWriter
instances for Duration and FiniteDuration. -
trait
JavaTimeReaders
extends AnyRef
Trait containing
ConfigReader
instances forjava.time
classes. -
trait
JavaTimeWriters
extends AnyRef
Trait containing
ConfigWriter
instances forjava.time
classes. -
trait
PrimitiveReaders
extends AnyRef
Trait containing
ConfigReader
instances for primitive types. -
trait
PrimitiveWriters
extends AnyRef
Trait containing
ConfigWriter
instances for primitive types. -
trait
TypesafeConfigReaders
extends AnyRef
Trait containing
ConfigReader
instances for Typesafe config models. -
trait
TypesafeConfigWriters
extends AnyRef
Trait containing
ConfigWriter
instances for Typesafe config models. -
trait
UriAndPathReaders
extends AnyRef
Trait containing
ConfigReader
instances for classes related to file system paths and URIs. -
trait
UriAndPathWriters
extends AnyRef
Trait containing
ConfigWriter
instances for classes related to file system paths and URIs. -
trait
CapitalizedWordsNamingConvention
extends NamingConvention
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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 for objects capable of reading and writing objects of a given type from and to
ConfigValues
.- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
trait
ConfigFieldMapping
extends (String) ⇒ String
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
trait
ConvertHelpers
extends AnyRef
Useful helpers for building
ConfigConvert
instances and dealing with results.Useful helpers for building
ConfigConvert
instances and dealing with results.- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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
ConfigConvert
instance 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
fieldValue
of this class.- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
class
FirstSuccessCoproductHint
[T] extends CoproductHint[T]
Hint where all coproduct options are tried in order.
Hint where all coproduct options are tried in order.
from
will choose the first option able to deserialize the config without errors, whileto
will write the config as is, with no disambiguation information.- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
trait
NamingConvention
extends AnyRef
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
class
StringDelimitedNamingConvention
extends NamingConvention
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
Value Members
- object BasicReaders extends BasicReaders
- object BasicWriters extends BasicWriters
- object DerivedReaders extends DerivedReaders
- object DerivedWriters extends DerivedWriters
Deprecated Value Members
-
def
loadConfig[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the givenConfig
Load a configuration of type
Config
from the givenConfig
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfig[Config](conf: Config)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the givenConfig
Load a configuration of type
Config
from the givenConfig
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfig[Config](path: Path, namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the given file.Load a configuration of type
Config
from 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
Success
with the configuration if it is possible to create an instance of typeConfig
from the configuration files, else aFailure
with details on why it isn't possible
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfig[Config](path: Path)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the given file.Load a configuration of type
Config
from the given file. Note that standard configuration files are still loaded but can be overridden from the given configuration file- returns
A
Success
with the configuration if it is possible to create an instance of typeConfig
from the configuration files, else aFailure
with details on why it isn't possible
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfig[Config](namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the standard configuration filesLoad a configuration of type
Config
from the standard configuration files- namespace
the base namespace from which the configuration should be load
- returns
A
Success
with the configuration if it is possible to create an instance of typeConfig
from the configuration files, else aFailure
with details on why it isn't possible
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfig[Config](implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the standard configuration filesLoad a configuration of type
Config
from the standard configuration files- returns
A
Success
with the configuration if it is possible to create an instance of typeConfig
from the configuration files, else aFailure
with details on why it isn't possible
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigFromFiles[Config](files: Traversable[Path])(implicit arg0: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Loads
files
in order, allowing values in later files to backstop missing values from prior, and converts them into aConfig
.Loads
files
in 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
files
references 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.
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigFromFilesOrThrow[Config](files: Traversable[Path])(implicit arg0: ConfigReader[Config], ct: ClassTag[Config]): Config
- returns
the configuration
- Annotations
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
- See also
-
def
loadConfigOrThrow[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the givenConfig
Load a configuration of type
Config
from the givenConfig
- conf
Typesafe configuration to load
- namespace
the base namespace from which the configuration should be load
- returns
the configuration
- Annotations
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigOrThrow[Config](conf: Config)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the givenConfig
Load a configuration of type
Config
from the givenConfig
- conf
Typesafe configuration to load
- returns
the configuration
- Annotations
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigOrThrow[Config](path: Path, namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the given file.Load a configuration of type
Config
from 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
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigOrThrow[Config](path: Path)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the given file.Load a configuration of type
Config
from the given file. Note that standard configuration files are still loaded but can be overridden from the given configuration file- returns
the configuration
- Annotations
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigOrThrow[Config](namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the standard configuration filesLoad a configuration of type
Config
from the standard configuration files- namespace
the base namespace from which the configuration should be load
- returns
the configuration
- Annotations
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigOrThrow[Config](implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the standard configuration filesLoad a configuration of type
Config
from the standard configuration files- returns
the configuration
- Annotations
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigWithFallback[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the givenConfig
, falling back to the default configurationLoad a configuration of type
Config
from 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
Success
with the configuration if it is possible to create an instance of typeConfig
from the configuration files, else aFailure
with details on why it isn't possible
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigWithFallback[Config](conf: Config)(implicit reader: ConfigReader[Config]): Either[ConfigReaderFailures, Config]
Load a configuration of type
Config
from the givenConfig
, falling back to the default configurationLoad a configuration of type
Config
from the givenConfig
, falling back to the default configuration- conf
Typesafe configuration to load
- returns
A
Success
with the configuration if it is possible to create an instance of typeConfig
from the configuration files, else aFailure
with details on why it isn't possible
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigWithFallbackOrThrow[Config](conf: Config, namespace: String)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the givenConfig
, falling back to the default configurationLoad a configuration of type
Config
from 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
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
def
loadConfigWithFallbackOrThrow[Config](conf: Config)(implicit reader: ConfigReader[Config], ct: ClassTag[Config]): Config
Load a configuration of type
Config
from the givenConfig
, falling back to the default configurationLoad a configuration of type
Config
from the givenConfig
, falling back to the default configuration- conf
Typesafe configuration to load
- returns
the configuration
- Annotations
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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
- @deprecated @throws( ... )
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
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
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
CamelCase
extends CapitalizedWordsNamingConvention
CamelCase identifiers look like
camelCase
anduseMorePureconfig
CamelCase identifiers look like
camelCase
anduseMorePureconfig
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
- See also
https://en.wikipedia.org/wiki/Camel_case
-
object
CapitalizedWordsNamingConvention
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
ConfigConvert
extends ConvertHelpers
Provides methods to create ConfigConvert instances.
Provides methods to create ConfigConvert instances.
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
ConfigFieldMapping
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
ConfigReader
extends BasicReaders with DerivedReaders
Provides methods to create ConfigReader instances.
Provides methods to create ConfigReader instances.
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
ConfigWriter
extends BasicWriters with DerivedWriters
Provides methods to create ConfigWriter instances.
Provides methods to create ConfigWriter instances.
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
ConvertHelpers
extends ConvertHelpers
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
CoproductHint
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
KebabCase
extends StringDelimitedNamingConvention
KebabCase identifiers look like
kebab-case
anduse-more-pureconfig
KebabCase identifiers look like
kebab-case
anduse-more-pureconfig
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
- See also
http://wiki.c2.com/?KebabCase
-
object
PascalCase
extends CapitalizedWordsNamingConvention
PascalCase identifiers look like e.g.
PascalCase
andUseMorePureconfig
PascalCase identifiers look like e.g.
PascalCase
andUseMorePureconfig
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
- See also
https://en.wikipedia.org/wiki/PascalCase
-
object
ProductHint
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
-
object
SnakeCase
extends StringDelimitedNamingConvention
SnakeCase identifiers look like
snake_case
anduse_more_pureconfig
SnakeCase identifiers look like
snake_case
anduse_more_pureconfig
- Annotations
- @deprecated
- Deprecated
(Since version 0.7.0) The pureconfig artifact with organization com.github.melrief is deprecated and won't be published anymore. Please update your dependency to use the organization com.github.pureconfig
- See also
https://en.wikipedia.org/wiki/Snake_case