node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Small utility returning grunt file filter by last modified age


Build status dependencies devdependencies


I described the motivation behind this little filter in Aged to Perfection blog post.


npm install aged --save-dev


function aged(n, units, verbose)
n           - positive number
units       - time units: 'days', 'hours', 'minutes', etc
verbose     - print filename if file is too young

aged can be used to define different metrics to run on different files depending on their age. For example, to pass older, stable source files through static grunt-complexity plugin you can:

// Gruntfile.js 
var aged = require('aged');
var files = ['Gruntfile.js', 'src/index.js'];
    complexity: {
        fresh: {
            src: files,
            options: {
                cyclomatic: 5,
                halstead: 10,
                maintainability: 100
        aged: {
            src: files,
            filter: aged(3, 'days', true),
            options: {
                errorsOnly: false,
                cyclomatic: 2,
                halstead: 10,
                maintainability: 100

This will pass all files though less stringent fresh limits, while passing files older than 3 days though higher limits.

sample output


You can easily define the opposite filter to aged

function fresher(n, units) {
    var isAged = aged(n, units);
    return function (filename) {
        return !isAged(filename);

Any time units are allowed, see momentjs docs.

Small print

Author: Gleb Bahmutov Copyright © 2013

License: MIT - do anything with the code, but don't blame me if it does not work.

Spread the word: tweet, star on github, etc.

Support: if you find any problems with this module, email / tweet / open issue on Github