Returns a builder for Config structure where the default parameters are set to those of env. The root configuration directory is set to the current working directory.

Panics

Panics if the current directory cannot be retrieved.

Example

use rocket::config::{Config, Environment};

let config = Config::build(Environment::Staging)
    .address("127.0.0.1")
    .port(700)
    .workers(12)
    .unwrap();

Creates a new configuration using the default parameters for the environment env. The root configuration directory is set to the current working directory.

Errors

If the current directory cannot be retrieved, a BadCWD error is returned.

Example

use rocket::config::{Config, Environment};

let mut my_config = Config::new(Environment::Production).expect("cwd");
my_config.set_port(1001);

Returns the default configuration for the environment env given that the configuration was stored at config_path. If config_path is not an absolute path, an Err of ConfigError::BadFilePath is returned.

Sets the configuration val for the name entry. If the name is one of "address", "port", "session_key", "log", or "workers" (the "default" values), the appropriate value in the self Config structure is set. Otherwise, the value is stored as an extra.

For each of the default values, the following Value variant is expected. If a different variant is supplied, a BadType Err is returned:

• address: String
• port: Integer (16-bit unsigned)
• workers: Integer (16-bit unsigned)
• log: String
• session_key: String (192-bit base64)

Sets the root directory of this configuration to root.

Example

use rocket::config::{Config, Environment};

let mut config = Config::new(Environment::Staging)?;
config.set_root("/tmp/my_app");

assert_eq!(config.root(), Path::new("/tmp/my_app"));

Sets the address of self to address.

Errors

If address is not a valid IP address or hostname, returns a BadType error.

Example

use rocket::config::{Config, Environment};

let mut config = Config::new(Environment::Staging)?;
assert!(config.set_address("localhost").is_ok());
assert!(config.set_address("::").is_ok());
assert!(config.set_address("?").is_err());

Sets the port of self to port.

Example

use rocket::config::{Config, Environment};

let mut config = Config::new(Environment::Staging)?;
config.set_port(1024);

Sets the number of workers in self to workers.

Example

use rocket::config::{Config, Environment};

let mut config = Config::new(Environment::Staging)?;
config.set_workers(64);

Sets the session_key in self to key which must be a 192-bit base64 encoded string.

Errors

If key is not a valid 192-bit base64 encoded string, returns a BadType error.

Example

use rocket::config::{Config, Environment};

let mut config = Config::new(Environment::Staging)?;
assert!(config.set_session_key("VheMwXIBygSmOlZAhuWl2B+zgvTN3WW5").is_ok());
assert!(config.set_session_key("hello? anyone there?").is_err());

Sets the logging level for self to log_level.

Example

use rocket::LoggingLevel;
use rocket::config::{Config, Environment};

let mut config = Config::new(Environment::Staging)?;
config.set_log_level(LoggingLevel::Critical);

Sets the extras for self to be the key/value pairs in extras. encoded string.

Example

use std::collections::HashMap;
use rocket::config::{Config, Environment, IntoValue};

let mut config = Config::new(Environment::Staging)?;

// Create the `extras` map.
let mut extras = HashMap::new();
extras.insert("another_port".to_string(), 1044.into_value());
extras.insert("templates".to_string(), "my_dir".into_value());

config.set_extras(extras);

Returns an iterator over the names and values of all of the extras in self.

Example

use std::collections::HashMap;
use rocket::config::{Config, Environment, IntoValue};

let mut config = Config::new(Environment::Staging)?;
assert_eq!(config.extras().count(), 0);

// Add a couple of extras to the config.
let mut extras = HashMap::new();
extras.insert("another_port".to_string(), 1044.into_value());
extras.insert("templates".to_string(), "my_dir".into_value());
config.set_extras(extras);

assert_eq!(config.extras().count(), 2);

Moves the session key string out of the self Config, if there is one. Because the value is moved out, subsequent calls will result in a return value of None.

Example

use rocket::config::{Config, Environment};

// Create a new config with a session key.
let key = "adL5fFIPmZBrlyHk2YT4NLV3YCk2gFXz";
let config = Config::build(Environment::Staging)
    .session_key(key)
    .unwrap();

// Get the key for the first time.
let session_key = config.take_session_key();
assert_eq!(session_key, Some(key.to_string()));

// Try to get the key again.
let session_key_again = config.take_session_key();
assert_eq!(session_key_again, None);

Attempts to retrieve the extra named name as a string.

Errors

If an extra with name doesn't exist, returns an Err of NotFound. If an extra with name does exist but is not a string, returns a BadType error.

Example

use rocket::config::{Config, Environment};

let config = Config::build(Environment::Staging)
    .extra("my_extra", "extra_value")
    .unwrap();

assert_eq!(config.get_str("my_extra"), Ok("extra_value"));

Attempts to retrieve the extra named name as an integer.

Errors

If an extra with name doesn't exist, returns an Err of NotFound. If an extra with name does exist but is not an integer, returns a BadType error.

Example

use rocket::config::{Config, Environment};

let config = Config::build(Environment::Staging)
    .extra("my_extra", 1025)
    .unwrap();

assert_eq!(config.get_int("my_extra"), Ok(1025));

Attempts to retrieve the extra named name as a boolean.

Errors

If an extra with name doesn't exist, returns an Err of NotFound. If an extra with name does exist but is not a boolean, returns a BadType error.

Example

use rocket::config::{Config, Environment};

let config = Config::build(Environment::Staging)
    .extra("my_extra", true)
    .unwrap();

assert_eq!(config.get_bool("my_extra"), Ok(true));

Attempts to retrieve the extra named name as a float.

Errors

If an extra with name doesn't exist, returns an Err of NotFound. If an extra with name does exist but is not a float, returns a BadType error.

Example

use rocket::config::{Config, Environment};

let config = Config::build(Environment::Staging)
    .extra("pi", 3.14159)
    .unwrap();

assert_eq!(config.get_float("pi"), Ok(3.14159));

Attempts to retrieve the extra named name as a slice of an array.

Errors

If an extra with name doesn't exist, returns an Err of NotFound. If an extra with name does exist but is not an array, returns a BadType error.

Example

use rocket::config::{Config, Environment};

let config = Config::build(Environment::Staging)
    .extra("numbers", vec![1, 2, 3])
    .unwrap();

assert!(config.get_slice("numbers").is_ok());

Attempts to retrieve the extra named name as a table.

Errors

If an extra with name doesn't exist, returns an Err of NotFound. If an extra with name does exist but is not a table, returns a BadType error.

Example

use std::collections::BTreeMap;
use rocket::config::{Config, Environment};

let mut table = BTreeMap::new();
table.insert("my_value".to_string(), 1);

let config = Config::build(Environment::Staging)
    .extra("my_table", table)
    .unwrap();

assert!(config.get_table("my_table").is_ok());

Returns the path at which the configuration file for self is stored. For instance, if the configuration file is at /tmp/Rocket.toml, the path /tmp is returned.

Example

use std::env::current_dir;
use rocket::config::{Config, Environment};

let config = Config::new(Environment::Staging)
    .expect("can retrieve current directory");

assert_eq!(config.root(), current_dir().unwrap());

Formats the value using the given formatter.

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.