amazon-s3-uri

A URI wrapper that can parse out information about an S3 URI

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
amazon-s3-uri
0.1.1a year ago6 years agoMinified + gzip package size for amazon-s3-uri in KB

Readme

AmazonS3URI
Actions Status codecov
A URI wrapper that can parse out information about an S3 URI
Shamelessly adapted from https://github.com/aws/aws-sdk-java/blob/master/aws-java-sdk-s3/src/main/java/com/amazonaws/services/s3/AmazonS3URI.java
with notable exceptions:
  • it doesn't parse version
  • There is no preprocessing on given url string (you have to encode and replace special characters yourself if needed)
  • For a valid S3 uri, region is never null but will default to us-east-1
example
const AmazonS3URI = require('amazon-s3-uri')

try {
  const uri = 'https://bucket.s3-aws-region.amazonaws.com/key'
  const { region, bucket, key } = AmazonS3URI(uri)
} catch (err) {
  console.warn(`${uri} is not a valid S3 uri`) // should not happen because `uri` is valid in that example
}
license
MIT