uniquefilename

uniquefilename

A module to get a unique filename using incremental values.

Installing

npm install uniquefilename

Basic example

var uniquefilename = require('uniquefilename');
options = {};
uniquefilename.get('/path/to/dir/file.jpg', options, function(filename) {
	// your code here: filename might be "/path/to/dir/file.jpg", 
	// "/path/to/dir/file-2.jpg", "/path/to/dir/file-3.jpg", etc...
	// depending on the files that exist on your filesystem
});

Advanced example

var uniquefilename = require('uniquefilename');
options = {separator: '~', paddingCharacter: '0', paddingSize: 4, mode: 'alphanumeric'};
uniquefilename.get('/path/to/dir/file.jpg', options, function(filename) {
	// your code here: filename might be "/path/to/dir/file.jpg", 
	// "/path/to/dir/file~000h.jpg", "/path/to/dir/file~00h9.jpg", etc...
	// depending on the files that exist on your filesystem
});

Options

separator

If the specified filename exists, the separator will be added before the incremental value such as: file{separator}2.jpg

The default value is '-'.

mode

The mode allows you to specify which characters to use to generate the incremental value (the string after the separator)

The default value is 'numeric'.

• 'numeric' Using the following characters: 1234567890
• 'alpha' Using the following characters: abcdefghijklmnopqrstuvwxyz
• 'ALPHA' Using the following characters: ABCDEFGHIJKLMNOPQRSTUVWXYZ
• 'alphanumeric' Using the following characters: 0123456789abcdefghijklmnopqrstuvwxyz
• 'ALPHANUMERIC' Using the following characters: 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ
• 'charset' You must specify the characters you wish to use in the charset option

paddingCharacter && paddingSize

If you wish to left-pad the incremental values with a character, use this option. Here's an example :

var uniquefilename = require('uniquefilename');
options = {mode: 'alpha', paddingCharacter: '0', paddingSize: 3};
uniquefilename.get('/path/to/dir/file.jpg', options, function(filename) {
	// your code here: filename might be "/path/to/dir/file.jpg", 
	// "/path/to/dir/file-002.jpg", "/path/to/dir/file-045.jpg", etc...
	// depending on the files that exist on your filesystem
});