awx 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a22d18dbf189673739f5963a622151a85e814a1e
-  data.tar.gz: 8b61eee5e62db727d1c105df70588e2fa0209434
+  metadata.gz: f9b808a6cbb91894ebd76305daa497467f62018a
+  data.tar.gz: 368253cb9c5c47013181e6e570b5ce216bf124b9
 SHA512:
-  metadata.gz: 21cc5951d290166128b6eaa29b25de3ed4206744625013c2e420996827b47a7bfdfef276a0c5e2dffdba822e2ee353e95ba1115490c895099e29af3a34ace8fa
-  data.tar.gz: c9723e5ca2518609c52228387e2886ae85a272beed50a9392acd8953b8aa0972452a861ee5f931820fabe25ca39106e4ba0f5ecd39893ba93706dd3ec1cf238c
+  metadata.gz: ff832f18916908040ef981c4f6823feeb0c33f7625d61d212036911a064ddfa453da307ab51491ce6e9ddab1f0cdfa8eda24636315bb45f3f9134cb41d43acc0
+  data.tar.gz: 90bef958997255122411c66e1801e8cf0300c85625750d8af6a921f3b3161d9cd97f1199637625cac3449de5176db8a9703dd0d31356eb61e31afb1a55bc569a

data/lib/aws/aws.rb

@@ -0,0 +1,9 @@
+module App
+
+    class AWS
+
+        VALID_REGIONS = %w(ap-south-1 eu-west-3 eu-west-2 eu-west-1 ap-northeast-2 ap-northeast-1 sa-east-1 ca-central-1 ap-southeast-1 ap-southeast-2 eu-central-1 us-east-1 us-east-2 us-west-1 us-west-2)
+
+    end
+
+end

data/lib/aws/aws_cli.rb

@@ -65,40 +65,48 @@ module App
         end
 
         # Create a CloudFormation Stack.
-        # @return Hash
-        def self.cloudformation_stack_create(region, stack_name, s3_url, params: nil, tags: nil, capabilities: [])
+        # @return string (StackID)
+        def self.cloudformation_stack_create(region, stack_name, s3_url, params: nil, tags: nil, capabilities: [], term_protect: false, term_script: false, timeout: nil)
             params       = params.nil? ? '' : " --parameters '#{params.gsub("'", "\\'")}'"
             tags         = tags.nil? ? '' : " --tags '#{tags.gsub("'", "\\'")}'"
             capabilities = !capabilities.any? ? '' : " --capabilities #{capabilities.join(' ')}"
-            command      = "cloudformation create-stack --stack-name #{stack_name} --template-url #{s3_url}#{params}#{tags}#{capabilities}"
-            stack_send   = execute_as_proc("Sending CloudFormation Stack: #{Blufin::Terminal::format_highlight(stack_name)}", command, region, json: true)
+            term_protect = term_protect ? ' --enable-termination-protection' : ' --no-enable-termination-protection'
+            timeout      = timeout.nil? ? '' : " --timeout-in-minutes #{timeout}"
+            command      = "cloudformation create-stack --stack-name #{stack_name} --template-url #{s3_url}#{params}#{tags}#{capabilities}#{term_protect}#{timeout}"
+            App::AWSOutputter::output_cli_command("aws #{command} --region #{region} --profile #{App::AWSProfile::get_profile_name}")
+            puts
+            stack_send = execute_as_proc("Sending CloudFormation Stack: #{Blufin::Terminal::format_highlight(stack_name)}", command, region, json: true)
             begin
                 if stack_send.has_key?('StackId')
-                    Blufin::Terminal::success('Template was accepted by AWS.', "\x1B[38;5;240mStackId \xe2\x80\x94 \x1B[38;5;40m#{stack_send['StackId']}")
-                    system("/usr/bin/open -a '/Applications/Google Chrome.app' https://#{region}.console.aws.amazon.com/cloudformation/home?region=#{region}#/stack/detail?stackId=#{URI::encode(stack_send['StackId'])}")
+                    Blufin::Terminal::success('Template was accepted by AWS.', ["\x1B[38;5;240mStackId \xe2\x80\x94 \x1B[38;5;40m#{stack_send['StackId']}"])
+                    stack_url = "https://#{region}.console.aws.amazon.com/cloudformation/home?region=#{region}#/stacks?filter=active&tab=events&stackId=#{URI::encode(stack_send['StackId'])}"
+                    system("/usr/bin/open -a '/Applications/Google Chrome.app' '#{stack_url}'")
                 else
                     Blufin::Terminal::error("Key not found in response: #{Blufin::Terminal::format_invalid('StackId')}", stack_send.inspect, true)
                 end
             rescue
                 Blufin::Terminal::error('Stack was not accepted by AWS.', App::AWSCli::format_cli_error(stack_send), true)
             end
-            stack_complete = execute_as_proc("Creating CloudFormation Stack: #{Blufin::Terminal::format_highlight(stack_name)}", "cloudformation wait stack-create-complete --stack-name #{stack_name}", region, json: true)
-            if stack_complete.to_s.strip == ''
-                puts
-                puts "    \x1B[38;5;40mCREATE_COMPLETE\x1B[0m"
-                puts
-                stack_details = execute_as_proc("Getting CloudFormation Stack: #{Blufin::Terminal::format_highlight(stack_name)}", "cloudformation describe-stacks --stack-name #{stack_name}", region, json: true)
-                begin
-                    stack_json = JSON.parse(stack_details.to_json)
-                    raise RuntimeError, 'Not a Hash' unless stack_json.is_a?(Hash)
+            unless term_script
+                stack_complete = execute_as_proc("Creating CloudFormation Stack: #{Blufin::Terminal::format_highlight(stack_name)}", "cloudformation wait stack-create-complete --stack-name #{stack_name}", region, json: true)
+                if stack_complete.to_s.strip == ''
+                    puts
+                    puts "    \x1B[38;5;40mCREATE_COMPLETE\x1B[0m"
                     puts
-                    Blufin::Terminal::code_highlight(stack_json.to_yaml, 'yml', 4)
-                rescue
-                    Blufin::Terminal::error('It seems you Stack was created (but then something went wrong).', stack_details.inspect, false)
+                    stack_details = execute_as_proc("Getting CloudFormation Stack: #{Blufin::Terminal::format_highlight(stack_name)}", "cloudformation describe-stacks --stack-name #{stack_name}", region, json: true)
+                    begin
+                        stack_json = JSON.parse(stack_details.to_json)
+                        raise RuntimeError, 'Not a Hash' unless stack_json.is_a?(Hash)
+                        puts
+                        Blufin::Terminal::code_highlight(stack_json.to_yaml, 'yml', 4)
+                    rescue
+                        Blufin::Terminal::error('It seems you Stack was created (but then something went wrong).', stack_details.inspect, false)
+                    end
+                else
+                    Blufin::Terminal::error("Something went wrong. Go to: #{Blufin::Terminal::format_highlight("https://#{region}.console.aws.amazon.com/cloudformation/home")} to see what happened.", format_cli_error(stack_complete.to_s), true)
                 end
-            else
-                Blufin::Terminal::error("Something went wrong. Go to: #{Blufin::Terminal::format_highlight('https://us-west-2.console.aws.amazon.com/cloudformation/home')} to see what happened.", format_cli_error(stack_complete.to_s), true)
             end
+            stack_send['StackId']
         end
 
         # Use this when a common such as "aws do-something" returns an error (such as: Stack [cognito-public-pool-go-eat-local-albert] already exists).
@@ -122,12 +130,10 @@ module App
             raise RuntimeError, 'Must provide region.' if region.nil? || region.strip == ''
             raise RuntimeError, "Invalid region: #{region}" unless get_regions.include?(region) || region == REGION_SKIP
             begin
-                region          = region == REGION_SKIP ? '' : " --region #{region}"
-                aws_credentials = App::AWSConfig.get_credentials(App::AWSConfig::AWS_PROFILE_ALBERT_CLI)
-                region          = aws_credentials.region if region.nil?
-                puts "\x1B[38;5;70m$ \x1B[38;5;240maws #{command}#{region}\x1B[0m" if verbose
+                region = region == REGION_SKIP ? '' : " --region #{region}"
+                puts "\x1B[38;5;70m$ \x1B[38;5;240maws #{command}#{region} --profile #{App::AWSProfile::get_profile_name}\x1B[0m" if verbose
                 if json
-                    result = `aws #{command}#{region} 2>/tmp/execute-output-aws`
+                    result = `aws #{command}#{region} --profile #{App::AWSProfile::get_profile_name} 2>/tmp/execute-output-aws`
                     # If no JSON, simply return the output.
                     return `cat /tmp/execute-output-aws` if result == ''
                     begin
@@ -136,12 +142,12 @@ module App
                         raise RuntimeError, "JSON Parsing Failed:\n\n#{e.message}"
                     end
                 else
-                    result = system("aws #{command}#{region} &>/dev/null")
-                    raise RuntimeError, 'This command this not return a status code of 0 (Success).' unless result
+                    result = system("aws #{command}#{region} --profile #{App::AWSProfile::get_profile_name} 1>/dev/null 2>/tmp/execute-output-aws")
+                    `cat /tmp/execute-output-aws` unless result
                     return result
                 end
             rescue => e
-                Blufin::Terminal::error("Command Failed: #{Blufin::Terminal::format_command("aws #{command}#{region}")}", e.message, true)
+                Blufin::Terminal::error("Command Failed: #{Blufin::Terminal::format_command("aws #{command}#{region} --profile #{App::AWSProfile::get_profile_name}")}", e.message, true)
             end
         end
 
@@ -149,7 +155,7 @@ module App
         # Set JSON to TRUE if you expect JSON output back, otherwise return value will be boolean (TRUE if successful).
         # Highly recommended to keep verbose set to FALSE.
         # @return void
-        def self.execute_as_proc(title, command, region, json: false, verbose: false, catch_exception: false)
+        def self.execute_as_proc(title, command, region, json: false, verbose: false)
             output  = nil
             threads = []
             threads << Thread.new {
@@ -157,7 +163,7 @@ module App
             }
             sleep(0.1)
             puts if verbose
-            Blufin::Terminal::execute_proc("AWS - #{title}", Proc.new { threads.each { |thread| thread.join } })
+            Blufin::Terminal::execute_proc("AWS \xe2\x80\x94 #{title}", Proc.new { threads.each { |thread| thread.join } })
             output
         end
 

data/lib/aws/aws_cloudformation.rb

@@ -2,15 +2,10 @@ module App
 
     class AWSCloudFormation
 
-        S3_BUCKET_CLOUDFORMATION        = 'blufin-cloudformation-templates'
-        S3_BUCKET_CLOUDFORMATION_REGION = 'us-west-2'
-        PATH_CLOUDFORMATION             = 'aws-cloudformation'
-        FILE_CLOUDFORMATION_DEFAULTS    = 'cloudformation.rb'
-
         # Gets the path to the root of the cloudformation templates in blufin-secrets repo.
         # @return string
-        def self.get_cloudformation_path(path = PATH_CLOUDFORMATION)
-            path = "#{App::Config.param(ConfigUnique::PATH_TO_REPO_SECRETS)}/#{path}"
+        def self.get_cloudformation_path
+            path = App::AWSProfile::get_profile['CloudFormation']['TemplatePath']
             Blufin::Terminal::error("CloudFormation path not found: #{Blufin::Terminal::format_directory(path)}", 'This probably means directories got renamed or code got changed.', true) unless Blufin::Files::path_exists(path)
             path
         end
@@ -19,48 +14,76 @@ module App
         # Returns the S3 URL.
         # @return string
         def self.upload_cloudformation_template(template_category, template_name, description)
-            source = "#{get_cloudformation_path}/#{template_category}/#{template_name}/template.yml"
+            source   = "#{get_cloudformation_path}/#{template_category}/#{template_name}/template.yml"
+            tmp_file = "/tmp/aws-cf-upload-#{template_category}-#{template_name}-#{Blufin::Strings::random_string}.yml"
             raise RuntimeError, "File does not exist: #{source}" unless Blufin::Files::file_exists(source)
-            yml_data                = YAML.load_file(File.expand_path(source))
-            yml_data['Description'] = description
-            description_written     = false
-            new_yaml                = {}
-            yml_data.keys.each do |key|
-                if %w(AWSTemplateFormatVersion).include?(key)
-                    new_yaml[key] = yml_data[key]
+            Blufin::Terminal::execute("cp #{source} #{tmp_file}", text: "Preparing template: \x1B[38;5;240m#{tmp_file}\x1B[0m")
+            # Add description to final YML file.
+            Blufin::Files::write_line_to_file(tmp_file, "Description: \"#{description.gsub('"', '\"')}\"", /AWSTemplateFormatVersion:\s*("|')?[0-9\-]+("|')?/i)
+            # This block of code removes the 2nd description tag.
+            new_lines          = []
+            description_found  = false
+            parsing_parameters = true
+            Blufin::Files::read_file(tmp_file).each do |line|
+                line = line.gsub("\n", '')
+                if line.strip =~ /^description:/i
+                    new_lines << line unless description_found
+                    description_found = true
                 else
-                    unless description_written
-                        description_written     = true
-                        new_yaml['Description'] = description
+                    parsing_parameters = true if line.strip =~ /^parameters:$/i
+                    if parsing_parameters
+                        # AWS Template Anatomy: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
+                        parsing_parameters = false if line.strip =~ /^(Metadata|Mappings|Conditions|Transform|Resources|Outputs)+:$/
+                        # This skips all the parameter defaults (as they may contain weird data which won't pass regex validation when initially sent to AWS).
+                        next if line.strip =~ /^default:/i && parsing_parameters
                     end
-                    new_yaml[key] = yml_data[key] unless key == 'Description'
+                    new_lines << line
                 end
             end
-            tmp_file = "/tmp/aws-cf-upload-#{template_category}-#{template_name}.yml"
-            Blufin::Files::write_file(tmp_file, convert_string_to_line_array(new_yaml.to_yaml))
-            App::AWSCli::s3_upload(tmp_file, S3_BUCKET_CLOUDFORMATION, get_template_filename(template_category, template_name))
+            Blufin::Files::write_file(tmp_file, new_lines)
+            template_filename = "#{template_category}-#{template_name}-#{DateTime.now.strftime('%Y%m%d-%H%M%S')}.yml"
+            bucket_path       = get_s3_bucket_path
+            bucket_path       = bucket_path == '' ? '' : "#{bucket_path}/"
+            App::AWSCli::s3_upload(tmp_file, App::AWSProfile::get_profile['CloudFormation']['S3Bucket'], "#{bucket_path}#{template_filename}")
+            # Return the S3 bucket URL.
+            "#{get_s3_bucket_url}/#{template_filename}"
         end
 
-        # Gets the S3 bucket URL.
+        # Returns S3 bucket URL based on config parameters.
         # @return string
-        def self.get_cloudformation_s3_bucket_url(template_category, template_name)
-            "https://#{S3_BUCKET_CLOUDFORMATION}.s3-#{S3_BUCKET_CLOUDFORMATION_REGION}.amazonaws.com/#{get_template_filename(template_category, template_name)}"
+        def self.get_s3_bucket_url
+            bucket_path = get_s3_bucket_path
+            bucket_path = bucket_path == '' ? '' : "/#{bucket_path}"
+            "https://#{App::AWSProfile::get_profile['CloudFormation']['S3Bucket']}.s3-#{App::AWSProfile::get_profile['CloudFormation']['S3BucketRegion']}.amazonaws.com#{bucket_path}"
         end
 
-        # Converts cognito/private-pool to -> cognito-private-pool.yml
+        # Returns the S3 bucket path based on config parameters.
         # @return string
-        def self.get_template_filename(template_category, template_name)
-            "#{template_category}-#{template_name}.yml"
+        def self.get_s3_bucket_path
+            bucket_path = App::AWSProfile::get_profile['CloudFormation']['S3BucketPath']
+            bucket_path.nil? || bucket_path.to_s.strip == '' ? '' : bucket_path
         end
 
-        # Converts a string to an Array of lines to a string.
-        # @return String
-        # TODO - Must move Blufin::YmlCommon from blufin -> blufin-lib. Not sure what the damage will be... 07/08/2019.
-        def self.convert_string_to_line_array(string)
-            raise RuntimeError, "Expected String, instead got: #{string.class}" unless string.is_a?(String)
-            array_of_lines = []
-            string.split("\n").each { |line| array_of_lines << line.gsub("\n", '') }
-            array_of_lines
+        # Returns an array of cloudformation stack-names.
+        # @return Array of Hashes
+        def self.get_stacks
+            results = []
+            json    = Blufin::Terminal::execute('awx l -r CloudFormationStacks -j', capture: true, text: "AWS \xe2\x80\x94 Getting CloudFormation Stacks...")
+            begin
+                data = JSON.parse(json)
+            rescue => e
+                puts
+                puts json
+                Blufin::Terminal::error('Failed to parse AWS response JSON.', e.message)
+            end
+            data.each do |stack|
+                results << {
+                    :name   => stack['StackName'],
+                    :region => stack['region']
+                }
+            end
+            results.sort_by! { |hsh| hsh[:name] }
+            results
         end
 
     end

data/lib/aws/aws_outputter.rb

@@ -91,7 +91,7 @@ module App
                     column('Max-L', :width => column_short, :color => HEADER_COLOR)
                     column('Min-V', :width => column_short, :color => HEADER_COLOR)
                     column('Max-V', :width => column_short, :color => HEADER_COLOR)
-                    column('Cached Value(s)', :width => remaining, :color => HEADER_COLOR)
+                    column('Cached/Default Value(s)', :width => remaining, :color => HEADER_COLOR)
                     column('', :width => 2, :color => HEADER_COLOR)
                 end
                 row do
@@ -109,7 +109,13 @@ module App
                     mav = data[:max_value]
                     cop = 'light-green'
                     cop = 'purple' if data[:type_internal] == :autocomplete
-                    cop = 'yellow' if data[:type_internal] == :system || [AppCommand::AWSCloudFormationCreate::OPTION_STACK_NAME, AppCommand::AWSCloudFormationCreate::OPTION_DESCRIPTION].include?(data[:parameter])
+                    cop = 'light-grey' if data[:type_internal] == :system || [
+                        AppCommand::AWSCloudFormationCreate::OPTION_STACK_NAME,
+                        AppCommand::AWSCloudFormationCreate::OPTION_PROJECT_ID,
+                        AppCommand::AWSCloudFormationCreate::OPTION_DESCRIPTION,
+                        AppCommand::AWSCloudFormationCreate::OPTION_TERM_PROTECT,
+                        AppCommand::AWSCloudFormationCreate::OPTION_TIMEOUT
+                    ].include?(data[:parameter])
                     # In case you want to change color in future, currently this is redundant.
                     cod = data[:type_internal] == :system ? 'default' : 'default'
                     cot = data[:type_internal] == :system ? 'default' : 'default'
@@ -152,10 +158,15 @@ module App
         # @return void
         def self.get_formatter(key = nil, resource: nil, color: 'default')
             formatters = {
+                'cloudformation-stack'    => Proc.new { |n|
+                    [n.gsub(/^arn:aws:cloudformation:[a-z]{2}-[a-z]{2,12}-\d+\D?:\d{10,14}:stack\//, ''), color]
+                },
                 'cloudfront-status'       => Proc.new { |n|
                     case n
                         when 'Deployed'
                             color = 'green'
+                        when 'InProgress'
+                            color = 'orange'
                         else
                             Blufin::Terminal::output("Add something to aws_outputter switch statement for: #{n}", Blufin::Terminal::MSG_TODO)
                             color = 'default'
@@ -188,6 +199,7 @@ module App
                             color = 'dark-grey'
                         when 'terminated'
                             color = 'red'
+
                         else
                             Blufin::Terminal::output("Add something to aws_outputter switch statement for: #{n}", Blufin::Terminal::MSG_TODO)
                             color = 'default'
@@ -203,11 +215,15 @@ module App
                     region            = n.ljust(10, ' ')
                     [region, region_color]
                 },
+                'route-53-domain-name'    => Proc.new { |n|
+                    [n.gsub(/\.$/, ''), color]
+                },
                 'route-53-hosted-zone-id' => Proc.new { |n|
                     zone_color = color
                     ns         = n.split('/')
                     [ns[ns.length - 1], zone_color]
                 },
+
             }
             raise RuntimeError, "Key not found: #{key}" unless key.nil? || formatters.has_key?(key)
             return formatters.keys if key.nil?
@@ -242,6 +258,21 @@ module App
             (width == '*') ? wildcard_width : width
         end
 
+        # Standardized way of outputting a command.
+        # @return void
+        def self.output_cli_command(command, path = nil)
+            puts "  \x1B[38;5;70m$ \x1B[38;5;240m#{command}\x1B[0m" if path.nil?
+            puts "  \x1B[38;5;70m$ \x1B[38;5;240m#{command} [\x1B[38;5;246m#{path}\x1B[240m]\x1B[0m" unless path.nil?
+        end
+
+        # Standardized way of rendering selection output.
+        # @return string
+        def self.render_selection(primary, secondary = nil, tertiary = nil)
+            return "#{Blufin::Terminal::format_action(primary)} \x1B[38;5;240m[#{Blufin::Terminal::format_highlight(secondary)}\x1B[38;5;240m]\x1B[38;5;240m[#{Blufin::Terminal::format_highlight(tertiary)}\x1B[38;5;240m]" if !tertiary.nil? && !secondary.nil?
+            return "#{Blufin::Terminal::format_action(primary)} \x1B[38;5;240m[#{Blufin::Terminal::format_highlight(secondary)}\x1B[38;5;240m]" unless secondary.nil?
+            return "#{Blufin::Terminal::format_action(primary)}" if secondary.nil?
+        end
+
     end
 
 end

data/lib/aws/aws_profile.rb

@@ -0,0 +1,116 @@
+module App
+
+    class AWSProfile
+
+        @@profiles    = nil
+        @@profile     = nil
+        @@credentials = nil
+
+        FILE_AWS_CONFIG      = File.expand_path('~/.aws/config')
+        FILE_AWS_CREDENTIALS = File.expand_path('~/.aws/credentials')
+        PROFILE_DEFAULT      = 'DefaultProfile'
+        PROFILE              = 'Profile'
+        PROFILES             = 'Profiles'
+        CLOUDFORMATION       = 'CloudFormation'
+
+        # Reads the config data and decides what profile to use.
+        # @return void
+        def self.init(config_data)
+
+            raise RuntimeError, 'Cannot run App::AWSProfile::init more than once.' unless @@profiles.nil? && @@profile.nil? && @@credentials.nil?
+
+            @@profiles = {}
+            @@profile  = {}
+
+            first_key = nil
+
+            # Put all the profiles in a global Hash.
+            config_data[PROFILES].each do |profile|
+                first_key                    = profile[PROFILE] if first_key.nil?
+                @@profiles[profile[PROFILE]] = profile
+            end
+
+            if @@profiles.length == 1
+                @@profile = @@profiles[first_key]
+            elsif @@profiles.length > 1
+                if config_data[PROFILE_DEFAULT].nil?
+                    Blufin::Terminal::error('No default profile found.', "When more than 1 profile is specified, you must also specify a #{Blufin::Terminal::format_highlight('DefaultProfile:')}", true)
+                elsif !@@profiles.keys.include?(config_data[PROFILE_DEFAULT])
+                    Blufin::Terminal::error("Invalid profile: #{Blufin::Terminal::format_invalid(config_data[PROFILE_DEFAULT])}. Available profiles are:", @@profiles.keys, true)
+                else
+                    @@profile = @@profiles[config_data[PROFILE_DEFAULT]]
+                end
+            else
+                raise RuntimeError, 'No profiles found.'
+            end
+
+            errors = []
+
+            # Validate CloudFormation data (if exists)
+            if @@profile.has_key?(CLOUDFORMATION)
+                cloudformation_template_path = @@profile[CLOUDFORMATION]['TemplatePath']
+                s3_region                    = @@profile[CLOUDFORMATION]['S3BucketRegion']
+                default_regions              = @@profile[CLOUDFORMATION]['Defaults']['Regions']
+                errors << "Path not found: #{Blufin::Terminal::format_invalid(cloudformation_template_path)}" unless Blufin::Files::path_exists(cloudformation_template_path)
+                errors << "Invalid region: #{Blufin::Terminal::format_invalid(s3_region)}" unless App::AWS::VALID_REGIONS.include?(s3_region)
+                errors << "Need atleast 1 default region for: #{Blufin::Terminal::format_invalid('Profiles[].CloudFormation.Defaults.Regions')}" if default_regions.nil? || !default_regions.any?
+                default_regions.each do |default_region|
+                    errors << "Invalid region: #{Blufin::Terminal::format_invalid(default_region)}" unless App::AWS::VALID_REGIONS.include?(default_region)
+                end
+            end
+
+            # Check the credentials exist.
+            if Blufin::Files::file_exists(FILE_AWS_CREDENTIALS)
+                @@aws_credentials = App::AWSCredentials.new
+                profile           = @@profile[PROFILE]
+                config            = Blufin::Files::file_exists(FILE_AWS_CONFIG) ? ParseConfig.new(FILE_AWS_CONFIG) : nil
+                credentials       = ParseConfig.new(FILE_AWS_CREDENTIALS)
+                unless credentials.params[profile].nil?
+                    # Currently not used/required (but here just in case).
+                    unless config.nil? || config.params[profile].nil?
+                        @@aws_credentials.region = config.params[profile]['region'] unless config.params[profile]['region'].nil?
+                        @@aws_credentials.output = config.params[profile]['output'] unless config.params[profile]['output'].nil?
+
+                    end
+                    @@aws_credentials.aws_key    = credentials.params[profile]['aws_access_key_id'] unless credentials.params[profile]['aws_access_key_id'].nil?
+                    @@aws_credentials.aws_secret = credentials.params[profile]['aws_secret_access_key'] unless credentials.params[profile]['aws_secret_access_key'].nil?
+                end
+                errors << "aws-cli error. Cannot find #{profile}: #{Blufin::Terminal::format_invalid('aws_access_key_id')} in: #{Blufin::Terminal::format_directory(FILE_AWS_CREDENTIALS)}" if @@aws_credentials.aws_key.nil?
+                errors << "aws-cli error. Cannot find #{profile}: #{Blufin::Terminal::format_invalid('aws_secret_access_key')} in: #{Blufin::Terminal::format_directory(FILE_AWS_CREDENTIALS)}" if @@aws_credentials.aws_secret.nil?
+            else
+                errors << "aws-cli error. Cannot find file: #{Blufin::Terminal::format_invalid(FILE_AWS_CREDENTIALS)}"
+            end
+
+            # If anything is wrong, output error(s).
+            Blufin::Config::invalid_configuration(App::GEM_NAME, errors) if errors.any?
+
+        end
+
+        # Gets the active profile.
+        # @return Hash
+        def self.get_profile
+            @@profile
+        end
+
+        # Convenience method to just get the profile name.
+        # @return string
+        def self.get_profile_name
+            @@profile[PROFILE]
+        end
+
+        # Returns an Array of all available profile names (not the entire profile).
+        # @return Array
+        def self.get_profile_names
+            @@profiles.keys
+        end
+
+        # Gets AWS credentials from ~/.aws directory for given profile.
+        # If credentials don't exist (or are missing information) -- nil is returned.
+        # @return App::AWSCredentials
+        def self.get_credentials
+            @@aws_credentials
+        end
+
+    end
+
+end