Add README files to credential provider packages (#52)

* Add README files to credential provider packages

* Be stricter in documentation about which date strings are accepted

Author: jeskew

packages/credential-provider-imds/README.md

@@ -0,0 +1,33 @@
+# AWS Credential Provider for Node.JS - Instance and Container Metadata
+
+This module provides two `CredentialProvider` factory functions,
+`fromContainerMetadata` and `fromInstanceMetadata`, that will create 
+`CredentialProvider` functions that read from the ECS container metadata service
+and the EC2 instance metadata service, respectively. 
+
+A `CredentialProvider` function created with `fromContainerMetadata` will return
+a promise that will resolve with credentials for the IAM role associated with
+containers in an Amazon ECS task. Please see [IAM Roles for Tasks](http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html)
+for more information on using IAM roles with Amazon ECS.
+
+A `CredentialProvider` function created with `fromInstanceMetadata` will return
+a promise that will resolve with credentials for the IAM role associated with
+an EC2 instance. Please see [IAM Roles for Amazon EC2](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html)
+for more information on using IAM roles with Amazon EC2.
+
+## Supported configuration
+
+You may customize how credentials are resolved by providing an options hash to
+the `fromContainerMetadata` and `fromInstanceMetadata` factory functions. The
+following options are supported:
+
+  * `timeout` - The connection timeout (in milliseconds) to apply to any remote
+  requests. If not specified, a default value of `1000` (one second) is used.
+  * `maxRetries` - The maximum number of times any HTTP connections should be
+  retried. If not specified, a default value of `0` will be used.
+
+Additionally, `fromInstanceMetadata` supports the following options:
+
+  * `profile` - The configuration profile to use. If not specified, the provider
+  will use default profile name associated with the EC2 instance as reported by
+  the Instance Metadata Service.

packages/shared-ini-file-loader/README.md

@@ -0,0 +1,95 @@
+# AWS Shared Configuration File Loader
+
+This module provides a function that reads from AWS SDK configuration files and
+returns a promise that will resolve with a hash of the parsed contents of the
+AWS credentials file and of the AWS config file. Given the [sample 
+files](#sample-files) below, the promise returned by `loadSharedConfigFiles`
+would resolve with:
+
+```javascript
+{
+  configFile: {
+    'default': {
+      aws_access_key_id: 'foo',
+      aws_secret_access_key: 'bar',
+    },
+    dev: {
+      aws_access_key_id: 'foo1',
+      aws_secret_access_key: 'bar1',
+    },
+    prod: {
+      aws_access_key_id: 'foo2',
+      aws_secret_access_key: 'bar2',
+    },
+    'testing host': {
+      aws_access_key_id: 'foo4',
+      aws_secret_access_key: 'bar4',
+    }
+  },
+  credentialsFile: {
+    'default': {
+      aws_access_key_id: 'foo',
+      aws_secret_access_key: 'bar',
+    },
+    dev: {
+      aws_access_key_id: 'foo1',
+      aws_secret_access_key: 'bar1',
+    },
+    prod: {
+      aws_access_key_id: 'foo2',
+      aws_secret_access_key: 'bar2',
+    }
+  },
+}
+```
+
+If a file is not found, its key (`configFile` or `credentialsFile`) will instead
+have a value of an empty object.
+
+## Supported configuration
+
+You may customize how the files are loaded by providing an options hash to the
+`loadSharedConfigFiles` function. The following options are supported:
+
+  * `filepath` - The path to the shared credentials file. If not specified, the
+  provider will use the value in the `AWS_SHARED_CREDENTIALS_FILE` environment
+  variable or a default of `~/.aws/credentials`.
+  * `configFilepath` - The path to the shared config file. If not specified, the
+  provider will use the value in the `AWS_CONFIG_FILE` environment variable or a
+  default of `~/.aws/config`.
+
+## Sample files
+
+### `~/.aws/credentials`
+```ini
+[default]
+aws_access_key_id=foo
+aws_secret_access_key=bar
+
+[dev]
+aws_access_key_id=foo2
+aws_secret_access_key=bar2
+
+[prod]
+aws_access_key_id=foo3
+aws_secret_access_key=bar3
+```
+
+### `~/.aws/config`
+```ini
+[default]
+aws_access_key_id=foo
+aws_secret_access_key=bar
+
+[profile dev]
+aws_access_key_id=foo2
+aws_secret_access_key=bar2
+
+[profile prod]
+aws_access_key_id=foo3
+aws_secret_access_key=bar3
+
+[profile "testing host"]
+aws_access_key_id=foo4
+aws_secret_access_key=bar4
+```