plexiform

Plexiform

v3.0.0

In this document
Introduction
Not a module
Getting started
Contribute
Version history

Introduction

Plexiform is a rudimentary code generator.

It doesn't know any language, nor does it know how to reverse-engineer anything. It's really just a simple formalisation of JavaScript template literals, to expose a basic templating system.

But that's still incredibly useful, as it takes the effort and risk out of any repetitious task.

Perfect the code elsewhere, then use this to churn out more code than you could bear to hand-crank!

Not a module

Please note that this is not a Node module, it is a Node script for running in the shell.

I apologise if my npm etiquette is lacking, please forgive a first-timer :)

Getting started

• npm install -g plexiform
• Define a JSON specification file to represent whatever it is you are building. No special format required - but your templates will be entirely driven from this.
• Plexiform now has a built-in partial MarkDown parser. Define an MD specification file and provide a process method to turn it into your config object.
• Turn your perfect code files into templates.
• Write a build script which applies your templates to your config - e.g. iterates over config collections and saves the output.
• Generate a plexiformconfig.json with plexiform init and edit it accordingly.
• Build from the plexiformconfig simply by invoking plexiform build

See the included boilerplate example to get you started

Gallery

An online gallery to host your specification files and make them centrally available. With versioning.

plexiform gallery new | save | secret | publish
plexiform gallery list | query | fetch

And the back-end was generated by plexiform-build-api, of course :)

Contribute

• Please use this, and improve it.
• Feel free to write a tutorial.
• Contact me raith AT raith.co.uk
• website coming soon.

---