inprint
TypeScript icon, indicating that this package has built-in type declarations

1.3.2 • Public • Published

inprint

A very simple precompiler (written in typescript). With it you can make a dynamically generated blocks in your code.

Installation

npm i inprint --save-dev
yarn i inprint --save-dev
pnpm i inprint --save-dev

npm i -g inprint
yarn i -g inprint
pnpm i -g inprint

Usage

  1. Anywhere in your code add a block you want to generate like this
console.log("any code can be here");
// @INPRINT_START {my:"own params", json5:'is supported here!'}
// Anything here will be overwritten by generated code!
// @INPRINT_END
console.log("any code can be here");
  1. Now add inprint.cjs (or .js) to your project with the following contents:
module.exports = {
    files:['src/**/*.{ts,tsx,js,jsx}'],
    embeddedFeatures: false,    // Highly recommended if don't use them!
    inprint: function inprint(paramsObject) {
        return "    // " + JSON.stringify(paramsObject);
    }
}
  1. Run inprint

  2. The returned content will be inprinted between @INPRINT tags:

console.log("any code can be here");
// @INPRINT_START {my:"own params", json5:'is supported here!'}
    // {my:"own params", json5:'is supported here!'}
// @INPRINT_END
console.log("any code can be here");

Details

inprint function will receive the following additional paramaters:

  • absolutePath - absolute file path with inprint block

  • content - current content of the block

Options:

  • inprint - required, the function used to generate inprinted content

  • files - optional, globby input patterns, default is ['src/**/*.{ts,tsx,js,jsx}']

  • skipNodeModules- optional, if true will skip all path containing /node_modules/, default is true

  • embeddedFeatures - 'first' | 'last' | false - used to automatically run embedded generation functions (see the list below), 'first' - to run them before your inprint code, 'last' - to run only if your code returned undefined, false - don't run them ever, default is false.

  • prettierOpts - optional, options forwarded to prettier.

  • forceProcessTermination - if defined will call process.exit(0) after finished. Useful in case you include some files with timers to do your generation and don't want or can't get rid of them

Limitations

  • @INPRINT tags can't be nested

Debugging inprint function

Create inprintDebug.cjs with contents

require("inprint").run();

run it in your favorite IDE to debug the scripts.

Run programmatically

require("inprint").run(options);

Embedded Features

This package also contains some functions which I use for my own project automation.

If you want to disable them use:

embeddedFeatures: false,

If you want to use them add to options file:

embeddedFeatures: 'first'

You can also call them with:

require("inprint").callEmbeddedFeatures(params, options);

Using just one function is also possible, for example:

require("inprint").inprintIndexTs(params, options);

List of embedded features:

IndexTs

Generates reexports for each file in folder:

// @INPRINT_START {exclude:[""], merge:[{name:"embeddedFeatures:EmbeddedFeature[]", suffix:"EmbeddedFeature"}]}
export * from "./indexTs";

import {indexTsEmbeddedFeature} from "./indexTs";
export const embeddedFeatures:EmbeddedFeature[] = [indexTsEmbeddedFeature];
// @INPRINT_END
Params:
  • exclude - array of excluded filenames

  • merge - array of merged variables, defined as objects

    • suffix - name of a const exported from each file

    • name - name of result variable

Package Sidebar

Install

npm i inprint

Weekly Downloads

1

Version

1.3.2

License

Unlicense

Unpacked Size

43.6 kB

Total Files

25

Last publish

Collaborators

  • yuyaryshev