Skip to content

Commit

Permalink
feat: add npm badges for individual packages (#251)
Browse files Browse the repository at this point in the history
* feat: added README.md files in packages which don't have them
* feat: add npm version and downloads badge
* chore: moved npm badges below package title
* chore: update package-generator scripts to add npm badges
* chore: prefix @aws-sdk/ in README.ms of packages where it's absent
* chore: remove npm badges from private packages
  • Loading branch information
trivikr authored May 21, 2019
1 parent 7eca377 commit 8adc10c
Show file tree
Hide file tree
Showing 121 changed files with 436 additions and 55 deletions.
4 changes: 4 additions & 0 deletions packages/abort-controller/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# @aws-sdk/abort-controller

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/abort-controller.svg)](https://www.npmjs.com/package/@aws-sdk/abort-controller)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/abort-controller.svg)](https://www.npmjs.com/package/@aws-sdk/abort-controller)
5 changes: 4 additions & 1 deletion packages/add-glacier-checksum-headers-browser/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
# add-glacier-checksum-headers-browser
# @aws-sdk/add-glacier-checksum-headers-browser

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/add-glacier-checksum-headers-browser.svg)](https://www.npmjs.com/package/@aws-sdk/add-glacier-checksum-headers-browser)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/add-glacier-checksum-headers-browser.svg)](https://www.npmjs.com/package/@aws-sdk/add-glacier-checksum-headers-browser)
5 changes: 4 additions & 1 deletion packages/add-glacier-checksum-headers-node/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
# add-glacier-checksum-headers-node
# @aws-sdk/add-glacier-checksum-headers-node

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/add-glacier-checksum-headers-node.svg)](https://www.npmjs.com/package/@aws-sdk/add-glacier-checksum-headers-node)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/add-glacier-checksum-headers-node.svg)](https://www.npmjs.com/package/@aws-sdk/add-glacier-checksum-headers-node)
5 changes: 4 additions & 1 deletion packages/add-glacier-checksum-headers-universal/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
# add-glacier-checksum-headers-universal
# @aws-sdk/add-glacier-checksum-headers-universal

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/add-glacier-checksum-headers-universal.svg)](https://www.npmjs.com/package/@aws-sdk/add-glacier-checksum-headers-universal)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/add-glacier-checksum-headers-universal.svg)](https://www.npmjs.com/package/@aws-sdk/add-glacier-checksum-headers-universal)
5 changes: 4 additions & 1 deletion packages/apply-body-checksum-middleware/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,7 @@
# apply-body-checksum-middleware
# @aws-sdk/apply-body-checksum-middleware

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/apply-body-checksum-middleware.svg)](https://www.npmjs.com/package/@aws-sdk/apply-body-checksum-middleware)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/apply-body-checksum-middleware.svg)](https://www.npmjs.com/package/@aws-sdk/apply-body-checksum-middleware)

This package provides AWS SDK for JavaScript middleware that applies a checksum
of the request body as a header.
5 changes: 4 additions & 1 deletion packages/bucket-endpoint-middleware/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
# bucket-endpoint-middleware
# @aws-sdk/bucket-endpoint-middleware

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/bucket-endpoint-middleware.svg)](https://www.npmjs.com/package/@aws-sdk/bucket-endpoint-middleware)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/bucket-endpoint-middleware.svg)](https://www.npmjs.com/package/@aws-sdk/bucket-endpoint-middleware)
2 changes: 1 addition & 1 deletion packages/build-types/README.md
Original file line number Diff line number Diff line change
@@ -1 +1 @@
# build-types
# @aws-sdk/build-types
5 changes: 4 additions & 1 deletion packages/chunked-blob-reader/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
# chunked-blob-reader
# @aws-sdk/chunked-blob-reader

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/chunked-blob-reader.svg)](https://www.npmjs.com/package/@aws-sdk/chunked-blob-reader)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/chunked-blob-reader.svg)](https://www.npmjs.com/package/@aws-sdk/chunked-blob-reader)
5 changes: 4 additions & 1 deletion packages/chunked-stream-reader-node/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,7 @@
# chunked-stream-reader-node
# @aws-sdk/chunked-stream-reader-node

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/chunked-stream-reader-node.svg)](https://www.npmjs.com/package/@aws-sdk/chunked-stream-reader-node)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/chunked-stream-reader-node.svg)](https://www.npmjs.com/package/@aws-sdk/chunked-stream-reader-node)

Exports a streamReader function that accepts a readable stream, a function to call on each chunk, and a chunk size in bytes to buffer interally before calling the supplied function.

Expand Down
3 changes: 3 additions & 0 deletions packages/client-codecommit-node/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# @aws-sdk/client-codecommit-node

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/client-codecommit-node.svg)](https://www.npmjs.com/package/@aws-sdk/client-codecommit-node)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/client-codecommit-node.svg)](https://www.npmjs.com/package/@aws-sdk/client-codecommit-node)

## Description

<fullname>AWS CodeCommit</fullname> <p>This is the <i>AWS CodeCommit API Reference</i>. This reference provides descriptions of the operations and data types for AWS CodeCommit API along with usage examples.</p> <p>You can use the AWS CodeCommit API to work with the following objects:</p> <p>Repositories, by calling the following:</p> <ul> <li> <p> <a>BatchGetRepositories</a>, which returns information about one or more repositories associated with your AWS account.</p> </li> <li> <p> <a>CreateRepository</a>, which creates an AWS CodeCommit repository.</p> </li> <li> <p> <a>DeleteRepository</a>, which deletes an AWS CodeCommit repository.</p> </li> <li> <p> <a>GetRepository</a>, which returns information about a specified repository.</p> </li> <li> <p> <a>ListRepositories</a>, which lists all AWS CodeCommit repositories associated with your AWS account.</p> </li> <li> <p> <a>UpdateRepositoryDescription</a>, which sets or updates the description of the repository.</p> </li> <li> <p> <a>UpdateRepositoryName</a>, which changes the name of the repository. If you change the name of a repository, no other users of that repository will be able to access it until you send them the new HTTPS or SSH URL to use.</p> </li> </ul> <p>Branches, by calling the following:</p> <ul> <li> <p> <a>CreateBranch</a>, which creates a new branch in a specified repository.</p> </li> <li> <p> <a>DeleteBranch</a>, which deletes the specified branch in a repository unless it is the default branch.</p> </li> <li> <p> <a>GetBranch</a>, which returns information about a specified branch.</p> </li> <li> <p> <a>ListBranches</a>, which lists all branches for a specified repository.</p> </li> <li> <p> <a>UpdateDefaultBranch</a>, which changes the default branch for a repository.</p> </li> </ul> <p>Files, by calling the following:</p> <ul> <li> <p> <a>DeleteFile</a>, which deletes the content of a specified file from a specified branch.</p> </li> <li> <p> <a>GetFile</a>, which returns the base-64 encoded content of a specified file.</p> </li> <li> <p> <a>GetFolder</a>, which returns the contents of a specified folder or directory.</p> </li> <li> <p> <a>PutFile</a>, which adds or modifies a file in a specified repository and branch.</p> </li> </ul> <p>Information about committed code in a repository, by calling the following:</p> <ul> <li> <p> <a>GetBlob</a>, which returns the base-64 encoded content of an individual Git blob object within a repository.</p> </li> <li> <p> <a>GetCommit</a>, which returns information about a commit, including commit messages and author and committer information.</p> </li> <li> <p> <a>GetDifferences</a>, which returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference).</p> </li> </ul> <p>Pull requests, by calling the following:</p> <ul> <li> <p> <a>CreatePullRequest</a>, which creates a pull request in a specified repository.</p> </li> <li> <p> <a>DescribePullRequestEvents</a>, which returns information about one or more pull request events.</p> </li> <li> <p> <a>GetCommentsForPullRequest</a>, which returns information about comments on a specified pull request.</p> </li> <li> <p> <a>GetMergeConflicts</a>, which returns information about merge conflicts between the source and destination branch in a pull request.</p> </li> <li> <p> <a>GetPullRequest</a>, which returns information about a specified pull request.</p> </li> <li> <p> <a>ListPullRequests</a>, which lists all pull requests for a repository.</p> </li> <li> <p> <a>MergePullRequestByFastForward</a>, which merges the source destination branch of a pull request into the specified destination branch for that pull request using the fast-forward merge option.</p> </li> <li> <p> <a>PostCommentForPullRequest</a>, which posts a comment to a pull request at the specified line, file, or request.</p> </li> <li> <p> <a>UpdatePullRequestDescription</a>, which updates the description of a pull request.</p> </li> <li> <p> <a>UpdatePullRequestStatus</a>, which updates the status of a pull request.</p> </li> <li> <p> <a>UpdatePullRequestTitle</a>, which updates the title of a pull request.</p> </li> </ul> <p>Information about comments in a repository, by calling the following:</p> <ul> <li> <p> <a>DeleteCommentContent</a>, which deletes the content of a comment on a commit in a repository.</p> </li> <li> <p> <a>GetComment</a>, which returns information about a comment on a commit.</p> </li> <li> <p> <a>GetCommentsForComparedCommit</a>, which returns information about comments on the comparison between two commit specifiers in a repository.</p> </li> <li> <p> <a>PostCommentForComparedCommit</a>, which creates a comment on the comparison between two commit specifiers in a repository.</p> </li> <li> <p> <a>PostCommentReply</a>, which creates a reply to a comment.</p> </li> <li> <p> <a>UpdateComment</a>, which updates the content of a comment on a commit in a repository.</p> </li> </ul> <p>Triggers, by calling the following:</p> <ul> <li> <p> <a>GetRepositoryTriggers</a>, which returns information about triggers configured for a repository.</p> </li> <li> <p> <a>PutRepositoryTriggers</a>, which replaces all triggers for a repository and can be used to create or delete triggers.</p> </li> <li> <p> <a>TestRepositoryTriggers</a>, which tests the functionality of a repository trigger by sending data to the trigger target.</p> </li> </ul> <p>For information about how to use AWS CodeCommit, see the <a href="http://docs.aws.amazon.com/codecommit/latest/userguide/welcome.html">AWS CodeCommit User Guide</a>.</p>
Expand Down
3 changes: 3 additions & 0 deletions packages/client-cognito-identity-browser/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# @aws-sdk/client-cognito-identity-browser

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/client-cognito-identity-browser.svg)](https://www.npmjs.com/package/@aws-sdk/client-cognito-identity-browser)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/client-cognito-identity-browser.svg)](https://www.npmjs.com/package/@aws-sdk/client-cognito-identity-browser)

## Description

<fullname>Amazon Cognito</fullname> <p>Amazon Cognito is a web service that delivers scoped temporary credentials to mobile devices and other untrusted environments. Amazon Cognito uniquely identifies a device and supplies the user with a consistent identity over the lifetime of an application.</p> <p>Using Amazon Cognito, you can enable authentication with one or more third-party identity providers (Facebook, Google, or Login with Amazon), and you can also choose to support unauthenticated access from your app. Cognito delivers a unique identifier for each user and acts as an OpenID token provider trusted by AWS Security Token Service (STS) to access temporary, limited-privilege AWS credentials.</p> <p>To provide end-user credentials, first make an unsigned call to <a>GetId</a>. If the end user is authenticated with one of the supported identity providers, set the <code>Logins</code> map with the identity provider token. <code>GetId</code> returns a unique identifier for the user.</p> <p>Next, make an unsigned call to <a>GetCredentialsForIdentity</a>. This call expects the same <code>Logins</code> map as the <code>GetId</code> call, as well as the <code>IdentityID</code> originally returned by <code>GetId</code>. Assuming your identity pool has been configured via the <a>SetIdentityPoolRoles</a> operation, <code>GetCredentialsForIdentity</code> will return AWS credentials for your use. If your pool has not been configured with <code>SetIdentityPoolRoles</code>, or if you want to follow legacy flow, make an unsigned call to <a>GetOpenIdToken</a>, which returns the OpenID token necessary to call STS and retrieve AWS credentials. This call expects the same <code>Logins</code> map as the <code>GetId</code> call, as well as the <code>IdentityID</code> originally returned by <code>GetId</code>. The token returned by <code>GetOpenIdToken</code> can be passed to the STS operation <a href="http://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html">AssumeRoleWithWebIdentity</a> to retrieve AWS credentials.</p> <p>If you want to use Amazon Cognito in an Android, iOS, or Unity application, you will probably want to make API calls via the AWS Mobile SDK. To learn more, see the <a href="http://docs.aws.amazon.com/mobile/index.html">AWS Mobile SDK Developer Guide</a>.</p>
Expand Down
5 changes: 4 additions & 1 deletion packages/client-documentation-generator/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
# client-documentation-generator
# @aws-sdk/client-documentation-generator

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/client-documentation-generator.svg)](https://www.npmjs.com/package/@aws-sdk/client-documentation-generator)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/client-documentation-generator.svg)](https://www.npmjs.com/package/@aws-sdk/client-documentation-generator)
3 changes: 3 additions & 0 deletions packages/client-dynamodb-browser/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# @aws-sdk/client-dynamodb-browser

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/client-dynamodb-browser.svg)](https://www.npmjs.com/package/@aws-sdk/client-dynamodb-browser)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/client-dynamodb-browser.svg)](https://www.npmjs.com/package/@aws-sdk/client-dynamodb-browser)

## Description

<fullname>Amazon DynamoDB</fullname> <p>Amazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability. DynamoDB lets you offload the administrative burdens of operating and scaling a distributed database, so that you don't have to worry about hardware provisioning, setup and configuration, replication, software patching, or cluster scaling.</p> <p>With DynamoDB, you can create database tables that can store and retrieve any amount of data, and serve any level of request traffic. You can scale up or scale down your tables' throughput capacity without downtime or performance degradation, and use the AWS Management Console to monitor resource utilization and performance metrics.</p> <p>DynamoDB automatically spreads the data and traffic for your tables over a sufficient number of servers to handle your throughput and storage requirements, while maintaining consistent and fast performance. All of your data is stored on solid state disks (SSDs) and automatically replicated across multiple Availability Zones in an AWS region, providing built-in high availability and data durability. </p>
Expand Down
3 changes: 3 additions & 0 deletions packages/client-dynamodb-node/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# @aws-sdk/client-dynamodb-node

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/client-dynamodb-node.svg)](https://www.npmjs.com/package/@aws-sdk/client-dynamodb-node)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/client-dynamodb-node.svg)](https://www.npmjs.com/package/@aws-sdk/client-dynamodb-node)

## Description

<fullname>Amazon DynamoDB</fullname> <p>Amazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability. DynamoDB lets you offload the administrative burdens of operating and scaling a distributed database, so that you don't have to worry about hardware provisioning, setup and configuration, replication, software patching, or cluster scaling.</p> <p>With DynamoDB, you can create database tables that can store and retrieve any amount of data, and serve any level of request traffic. You can scale up or scale down your tables' throughput capacity without downtime or performance degradation, and use the AWS Management Console to monitor resource utilization and performance metrics.</p> <p>DynamoDB automatically spreads the data and traffic for your tables over a sufficient number of servers to handle your throughput and storage requirements, while maintaining consistent and fast performance. All of your data is stored on solid state disks (SSDs) and automatically replicated across multiple Availability Zones in an AWS region, providing built-in high availability and data durability. </p>
Expand Down
3 changes: 3 additions & 0 deletions packages/client-glacier-node/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# @aws-sdk/client-glacier-node

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/client-glacier-node.svg)](https://www.npmjs.com/package/@aws-sdk/client-glacier-node)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/client-glacier-node.svg)](https://www.npmjs.com/package/@aws-sdk/client-glacier-node)

## Description

<p>Amazon Glacier is a storage solution for "cold data."</p> <p>Amazon Glacier is an extremely low-cost storage service that provides secure, durable, and easy-to-use storage for data backup and archival. With Amazon Glacier, customers can store their data cost effectively for months, years, or decades. Amazon Glacier also enables customers to offload the administrative burdens of operating and scaling storage to AWS, so they don't have to worry about capacity planning, hardware provisioning, data replication, hardware failure and recovery, or time-consuming hardware migrations.</p> <p>Amazon Glacier is a great storage choice when low storage cost is paramount and your data is rarely retrieved. If your application requires fast or frequent access to your data, consider using Amazon S3. For more information, see <a href="http://aws.amazon.com/s3/">Amazon Simple Storage Service (Amazon S3)</a>.</p> <p>You can store any kind of data in any format. There is no maximum limit on the total amount of data you can store in Amazon Glacier.</p> <p>If you are a first-time user of Amazon Glacier, we recommend that you begin by reading the following sections in the <i>Amazon Glacier Developer Guide</i>:</p> <ul> <li> <p> <a href="http://docs.aws.amazon.com/amazonglacier/latest/dev/introduction.html">What is Amazon Glacier</a> - This section of the Developer Guide describes the underlying data model, the operations it supports, and the AWS SDKs that you can use to interact with the service.</p> </li> <li> <p> <a href="http://docs.aws.amazon.com/amazonglacier/latest/dev/amazon-glacier-getting-started.html">Getting Started with Amazon Glacier</a> - The Getting Started section walks you through the process of creating a vault, uploading archives, creating jobs to download archives, retrieving the job output, and deleting archives.</p> </li> </ul>
Expand Down
3 changes: 3 additions & 0 deletions packages/client-kinesis-browser/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# @aws-sdk/client-kinesis-browser

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/client-kinesis-browser.svg)](https://www.npmjs.com/package/@aws-sdk/client-kinesis-browser)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/client-kinesis-browser.svg)](https://www.npmjs.com/package/@aws-sdk/client-kinesis-browser)

## Description

<fullname>Amazon Kinesis Data Streams Service API Reference</fullname> <p>Amazon Kinesis Data Streams is a managed service that scales elastically for real-time processing of streaming big data.</p>
Expand Down
Loading

0 comments on commit 8adc10c

Please sign in to comment.