s3-filename
v1.0.0
Published
A helper to make your s3 filenames sane.
Downloads
1,240
Maintainers
Readme
s3-filename
A helper to make your s3 filenames sane. :innocent: Convert this
some 漢字 ćööł % #fíłéñàmé.jpg
into thissome-cool-filename.jpg
Use Case
Uploading files from client side is part of every software project. But the filenames can be very annoying sometimes which creates many issues especially if you're saving them. S3 bucket keys has some policy about this which if not followed can make your file inaccessible because of invalid keys.
Install
$ npm install s3-filename
Usage
const s3Filename = require('s3-filename');
s3Filename('some 漢字 ćööł % #fíłéñàmé.jpg', {separator: '_'});
//=> 'some_cool_filename.jpg'
API
s3Filename(filename, [options])
filename
Type: string
options
Type: Object
separator
Type: string
Default: -
A separator to use when whitespaces are found. The library will collapse all whitespaces to 1 whitespace per group of whitespaces.
License
MIT © Made with :heart: & :coffee: by Hamza Baig