Provides an API for easily transforming Delphi Forms
> Process over Delphi Forms (.dfm) files via an AST.
>
> Inspired by the excellent PostCSS tool, motivated by my rage at the Delphi IDE.

!Continuous Integration
!Continuous Deployment

- Installation
- Example Usage
- Reference
- Documentation
- Contributing
- License
The postdfm project is an interface wrapping all the separate modules together.
``shellnpm
$ npm install postdfm
Example Usage
`js
import fs from "fs";
import postdfm from "postdfm";// only if implementing your own plugin
import { Plugin } from "@postdfm/plugin";
class SomePlugin extends Plugin {
install(hooks) {
hooks.string.tap(ast => {
// manipulate AST here
}
// all AST types can be manipulated, see AST.ASTTypes
// also available:
// - "after" hook for certain types
hooks.after.object.tap(ast => {
// manipulate AST here
})
// - "all" hook for everything - excludes "after" hooks
hooks.all.tap(ast => {
// manipulate AST here
})
}
}
const cisDfm = fs.readFileSync(
"cis.dfm",
//.dfm files tend to be ascii instead of utf8
"ascii"
);
const runner = postdfm({
transformers: [new SomePlugin()],
});
const transDfm = runner.processSync(dfm, {
//filename used for reporting errors
from: "cis.dfm",
});
fs.writeFileSync("trans.dfm", transDfm);
`Reference
$3
Create a runner by calling the
postdfm function.`js
import postdfm from "postdfm";const runner = postdfm();
`####
postdfm(options?: RunnerOptions)Create a
Runner instance using RunnerOptions####
runner.process(dfm: string, processingOptions: ProcessingOptions): PromiseProcess a file through the runner asynchronously.
####
runner.processSync(dfm: string, processingOptions: ProcessingOptions): stringProcess a file through the runner synchronously.
$3
Options to pass to an instance of
Runner.####
options.plugins: Plugin[]Array of transformations to perform on AST.
####
options.parser: Parser = "@postdfm/dfm2ast"Parser to use, defaults to
@postdfm/dfm2ast.####
options.stringifier: Stringifier = "@postdfm/ast2dfm"Stringifier to use, defaults to
@postdfm/ast2dfm.$3
A class that extends the
@postdfm/plugin Plugin, extending the install() method.@postdfm/plugin for more information.$3
A function that takes a string, parses it, and returns an AST.
`js
(dfm: string): AST.Root
`$3
A function that takes an AST, stringifies it, and returns a string.
`js
(ast: AST.Root): string
`$3
####
processingOptions.fromThe file which is being processed. Used when throwing syntax errors.
Documentation
You can find the generated
typedoc` documentation here.Bug reports and feature requests are greatly appreciated, as are pull requests.
Please see the Contributing Guide for instructions on how to contribute to this project.
Licensed under the MIT License.