gulp-versioniser v1.0.2

Gulp Env Modify

Add, edit, delete and read variables from a .env file. There is also functionality to help manage version named files.

Installation

npm i gulp-env-modify --save

Setup

const envmod = require('gulp-env-modify')
const env = envmod.getData()
console.log(env)

Data functions

Get File string

Get the .env file contents as a string

envmod.getFile()

First parameter can be the path to your .env file relative to the gulpfile.js

Get Data object

Get the .env file content with all the variables and values passed into an object

envmod.getData()

First parameter can be a direct request for a variable. Second parameter can be the path to your .env file relative to the gulpfile.js

Get & Set functions

Set Variable

Add a variable and value to the .env file. Variable will be created if it isn't found. It will be overwritten if it does exists.

envmod.setVariable(variable, value)

Get Variable string

Get variable from .env file.

envmod.getVariable(variable)

Versioning functions

There are a few options to manage variables that are suffixed with "_VERSION". The purpose for this (and the reason I built this plugin), is to increment a variable each time a certain gulp task is called. Allowing me to generate unique file names for concatenated files. Ultimately this helps avoid browsers from caching old files whilst avoiding the use of ugly and unreliable url parameters.

Get Version int

Get the version number of a variable

envmod.getVersion(variable)

Update Version int

Update the version number of a variable by incrementing the number by one. | Parameter | Type | Description | | - | - | - | | name | string | The name of the variable that prefixes the _VERSION variable | | force | int | By default this function will increment by one. However, you can update a variable to a specific number.|

envmod.updateVersion(variable)

Get Version Name

To modify the filename for your gulp task, you will need to generate a dynamic name to match your latest version. This gives you that new filename.

modenv.getVersionName('main.min.js', 'js', true)

This will look for the JS_VERSION=12 in your .env file and return a string that looks like this

main.v12.min.js

If you set the end boolean to false, this would be returned instead:

main.min.v12.js

Update Version Name

This essentially does the exact same thing as getVersionName, only it will increment the version in the .env file before returning the name filename.

Delete Versions

Versioned files may start to get overwhelming and unnecessary. This lets you keep a set amount of versioned files.

envmod.deleteVersions('assets/js/', 'main.min.js', 3)

Credit

Couldn't have built this without gulp-dotenv. Thank you.