txt: ## dist_cpan-HANENKAMP-AWS-Session.md
  # NAME
  
  AWS::Session - Common data useful for accessing and configuring AWS APIs
  
  # SYNOPSIS
  
  ```
  use AWS::Session;
  
  my $session      = AWS::Session.new(
      profile => 'my-profile',
  );
  
  my $profile      = $session.profile;
  my $region       = $session.region;
  my $data-path    = $session.data-path;
  my $config-file  = $session.config-file;
  my $ca-bundle    = $session.ca-bundle;
  my %api-versions = $session.api-versions;
  my $cred-file    = $session.credentials-file;
  my $timeout      = $session.metadata-service-timeout;
  my $attempts     = $session.metadata-service-num-attempts;
  
  # Read the AWS configuration file
  my %config       = $session.get-configuration;
  my %profile-conf = $session.get-profile-configuration('default');
  my %current-conf = $session.get-current-configuration;
  
  # Read the AWS credentials file
  my %cred         = $session.get-credentials;
  my %profile-cred = $session.get-profile-credentials('default');
  my %current-cred = $session.get-current-credentials;
  
  ```
  
  # DESCRIPTION
  
  AWS clients share some common configuration data. This is a configurable module for loading that data.
  
  # ATTRIBUTES
  
  Any attributes provided will override any configuration values found on the system through the environment, configuration, or defaults.
  
  ## profile
  
  The configuration files are in INI format. These are broken up into sections. Each section is a profile. This way you can have multiple AWS configurations, each with its own settings and credentials.
  
  ## region
  
  This is the AWS region code to use.
  
  ## data-path
  
  The botocore system uses data models to figure out how to interact with AWS APIs. This is the path where additional models can be loaded.
  
  ## config-file
  
  This is the location of the AWS configuration file.
  
  ## ca-bundle
  
  This is the location of the CA bundle to use.
  
  ## api-versions
  
  This is a hash of API versions to prefer for each named API.
  
  ## credentials-file
  
  This is the location of the credentials file.
  
  ## metadata-service-timeout
  
  This is the timeout to use with the metadata service.
  
  ## metadata-service-num-attempts
  
  This is the number of attempts to make when using the metadata service.
  
  ## session-configuration
  
  This is a map of configuration variable names to AWS::Session::Default objects, which define how to configure them.
  
  # HELPERS
  
  ## AWS::Session::Default
  
  This is a basic structural class. All attributes are optional.
  
  ### ATTRIBUTES
  
  #### config-file
  
  This is the name of the variable to use when loading the value from the configuration file.
  
  #### env-var
  
  This is an array of names of the environment variable to use for the value.
  
  #### default-value
  
  This is the default value to fallback to.
  
  #### converter
  
  This is a function that will convert values from the configuration file or environment variable to the appropriate object.
  
  # METHODS
  
  ## get-configuration
  
  ```
  method get-configuration($config-file?, :$reload?) returns Hash
  
  ```
  
  Returns the full contents of the configuration as a hash of hashes. Normally, this method caches the configuration. Setting the `:reload` flag will force the configuration cache to be ignored.
  
  ## get-profile-configuration
  
  ```
  method get-profile-configuration(Str:D $profile, :$config-file?) returns Hash
  
  ```
  
  Returns the named profile configuration.
  
  ## get-current-configuration
  
  ```
  method get-current-configuration() returns Hash
  
  ```
  
  Returns the configuration for the current profile.
  
  ## get-credentials
  
  ```
  method get-credentials($credentials-file?) returns Hash
  
  ```
  
  Returns the full contents of the credentials file as a hash of hashes. Unlike configuration, the contents of this file is not cached.
  
  ## get-profile-credentials
  
  ```
  method get-profile-credentials(Str:D $profile, :$credentials-file?) returns Hash
  
  ```
  
  Returns the named profile credentials.
  
  ## get-current-credentials
  
  ```
  method get-current-credentials() returns Hash
  
  ```
  
  Returns the credentials for the current profile.
  
  ## get-config-variable
  
  ```
  method get-config-variable(
      Str $logical-name,
      Bool :$from-instance = True,
      Bool :$from-env = True,
      Bool :$from-config = True,
  )
  
  ```
  
  Loads the configuration named variable from the current configuration. This is loaded from the configuration file, environment, or whatever according to the default set in `session-configuration`. Returns `Nil` if no such configuration is defined for the given `$logical-name`.
  
  The boolean flags are used to select which methods will be consulted for determining the variable value.
  
  * from-instance When True, the local instance variable will be checked.
  * from-env When True, the process environment variables will be searched for the value.
  * from-config When True, the shared configuration file will be consulted for the value.
  
  The value will be pulled in the order listed above, with the first value found being the one chosen.
  