1.7.28 • Public • Published

QA dsl-toolkit

CI Maintainability Test Coverage FOSSA Statuslerna


npm install directory-fixture-provider --save-dev


..comes to write something like this, when your library that work with files and directories and you want to test the results.


Directory-fixture-provider has its own limited DSL that gives you a few options for now, but can be handy to know about.


const fixturesRoot = '/paht/to/your/fixture/directories/files'
contains files and direcories for examnple:
- file-a.js
- file-b.js
- directory1/file-c.js
- directory2/contains-a-lot-of-files.js
- directory2/directory3/contains-a-lot-of-files-as-well.js

const dfp =  require('directory-fixture-provider')
const fixtureDirectoryProvider = dfp(fixturesRoot)()
const fixtureData = fixtureDirectoryProvider.get('directory2')

// fixtureData contains an object where
{ dir: '/tmp/directory-fixture-provider-destination/KzXwBFDdtAmh/',
  fixturePath: '/home/it/dev/misc/dsl-toolkit/packages/directory-fixture-provider/tests/directory-fixtures/',
  getFixtureFiles: [Function: getFixtureFiles],
  getDestinationFiles: [Function: getDestinationFiles],
  getStatus: [Function: getStatus],
  getFixtureContent: [Function] }

This is how you start working with the tool, but the real fun starts. So you receive all files and subdirectories of the fixtures that subset what you were requesting too so in the example above the directory2 will be given back.

We have a random part of the path that is unique per fixture provider, so if you need clean data, create another directory-fixture-provider.

Sometimes you need it play more deterministic

Imagine a situation, when you are testing a small application that uses your framework, and you want to test your frameworks behaviour in the wild. In this case, you have your sample application, and you want to have installed its the dependencies, but the package.json does not change too often. In this case, it was nice overwriting the files, so you don't need that random part in the deployed directory.

const fixtureDirectoryProvider = dfp(fixturesRoot)('permanent')()

If you like the concept that your temporary files are in a fixed place, but rather you would empty the destination directory first you type: const fixtureDirectoryProvider = dfp(fixturesRoot)('permanent','cleanFirst')()

Check if your data has changed

const fixtureDirectoryProvider = dfp(fixturesRoot)()
const fixtureData = fixtureDirectoryProvider.get('./')
const fixtureDir = fixtureData.dir
// Work with the files
// add/remove/modify files, and you will get relevant info about them


// true if something is changed.



// gives you the number of files changed

If a new file is added, deleted or an existing changed each count as a change here.



Returns an object like this:
  deleted: 0
  changed: 0
  new: 0

Where it tells you how many files changed, deleted or new

If a file is deleted it will increase the changed data tag too.


Create an excellent diff module for the getStatus resulting object.

More information

This library helps you find changes modifications between your working and original fixture files. More examples are coming for more information, please check the tests

Package Sidebar


npm i directory-fixture-provider

Weekly Downloads






Unpacked Size

13.4 kB

Total Files


Last publish


  • jbvdxl
  • vidaxl-devops
  • 311ecode