code-engine-destination-filesystem

CodeEngine Filesystem Destination

This is a CodeEngine plugin that writes files to the filesystem (local disk or network).

NOTE: This plugin is already built-into the CodeEngine CLI, so you may not need to use it directly unless you are using CodeEngine's programmatic API.

Installation

Install using npm.

npm install code-engine-destination-filesystem

Usage

If you're using the CodeEngine CLI, then this plugin is already built-in, and you can use it simply by specifying a destination path in your generator.

export default {
  destination: "my/output/directory",
};

If you need to set more advanced options, then you will need to explicitly import and use code-engine-destination-filesystem.

import filesystem from "code-engine-destination-filesystem";

export default {
  destination: filesystem({
    path: "my/output/directory",
    filter: "*.html"
  }),
};

Options

You can set several options to customize the behavior of the code-engine-destination-filesystem plugin. The only required option is path. All others are optional.

path

The relative or absolute path of the destination directory. The directory will be created if it doesn't exist. If it does already exist, then the existing directory and its contents will be moved to trash (recycle bin on Windows), and a new directory will be created.

filter

One or more glob patterns, regular expressions, or filter functions that limit which files are written. By default, all files are written.

The filter option can be set to a glob pattern, like this:

import filesystem from "code-engine-destination-filesystem";

export default {
  destination: filesystem({
    path: "my/output/directory",
    filter: "**/*.html"
  }),
};

It can also be set to a regular expression. For example, here's a filter that only writes .htm and .html files:

import filesystem from "code-engine-destination-filesystem";

export default {
  destination: filesystem({
    path: "my/output/directory",
    filter: /\.html?$/
  }),
};

You can also use a custom function that accepts a CodeEngine File object and returns true if the file should be written. Here's a filter that only writes files that do not have the word "draft" in their name:

import filesystem from "code-engine-destination-filesystem";

export default {
  destination: filesystem({
    path: "my/output/directory",
    filter: (file) => !file.name.includes("draft")
  }),
};

You can even specify multiple filters using an array. The plugin will write files that match any of the filter criteria. Here's a filter that will write HTML files, any file in the img directory, or any file that does not have the word "draft" in the name:

import filesystem from "code-engine-destination-filesystem";

export default {
  destination: filesystem({
    path: "my/output/directory",
    filter: [
      /\.html?$/,
      "img/**/*",
      (file) => !file.name.includes("draft")
    ]
  }),
};

Another option is to specify separate include and exclude criteria. Each of these can be a single filter or an array of filters. For example, here's a filter that will write HTML files or files in in the img directory, but only if they don't contain the word "draft" in the name:

import filesystem from "code-engine-destination-filesystem";

export default {
  destination: filesystem({
    path: "my/output/directory",
    filter: {
      include: [
        /\.html?$/,
        "img/**/*",
      },
      exclude: (file) => file.name.includes("draft")
    }
  }),
};

fs

This option allows you to provide your own custom implementation of the Node.js filesystem module. Examples of packages you could substitute include:

• graceful-fs
• virtual-fs
• fs-in-memory

Contributing

Contributions, enhancements, and bug-fixes are welcome! Open an issue on GitHub and submit a pull request.

Building

To build the project locally on your computer:

1. Clone this repo
   git clone https://github.com/CodeEngineOrg/code-engine-destination-filesystem.git

2. Install dependencies
   npm install

3. Build the code
   npm run build

4. Run the tests
   npm test

License

Code Engine Destination Filesystem is 100% free and open-source, under the MIT license. Use it however you want.

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

Big Thanks To

Thanks to these awesome companies for their support of Open Source developers ❤