mps-plaintextgen

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

mps-plaintextgen

★ 21 Open GitHub ↗

Alternative Textgen for JetBrains MPS using the standard model to model generation mechanisms

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# This repository is archived
The plugin mps-plaintextgen has been moved from this repository to https://github.com/JetBrains/MPS-extensions. From now on, it will be maintained there. Please submit feedback and issues there.

# JetBrains MPS Text Generator Plugin

This plugin is an alternative text generator for MPS, using the standard model to model generation mechanisms (node macros, loop macros, property macros, etc.) to generate plain text, as opposed to MPS's programmatical textgens.

It allows you to:
* generate directly to plain text without modeling your generation target language
* generate to multiple text formats in the same generator run
* create multiple textgens that obey generator priority rules

The plugin also enables copy/pasting an existing piece of text and parameterizing parts of this text using macros.

For fine-grained control of whitespaces and indent-characters, the plaintextflow extension is available. It can be imported as a separate language (extending the plaintextgen language), so it doesn't disrupt existing plaintextgen functionality.

## Quickstart
The quickest way to install the plaintextgen plugin is to add it from the JetBrains plugins repository:
* in MPS, select `File` -> `Settings` -> `Plugins` -> `Browse repositories...`
* search for `plaintextgen`
* press `Install`

After installation, add `com.dslfoundry.plaintextgen` to the `Used Languages` of your generator (`main@generator` model) and create a `TextgenText` template in your generator.
For examples, see the test language in this repository.

## Main features
* Group and layout your content using horizontal, vertical, and indented collections
* Split plain text into various cells to apply MPS generator macros to them
* Paste unstructured text from a buffer to MPS. The structure of this text (indentations, new lines, tabs) will be automatically analyzed and converted into a `TextgenText` structure which you can then parameterize at your convenience.

## Advantages of this plugin over the default textgen
In short, this plugin brings MPS -> plaintext connectivity in a pretty usable way to MPS.

* Text generation can be part of your normal generator chain and can thus have a place in the generator priorities
* The language looks similar to the MPS editor language, which helps you to structure/layout your text, including indentation
* Different use cases are accomodated:
 * Pasting in larger amounts of text from the clipboard and parametrizing some of it
 * Making text from scratch and parameterizing some of it

## Differences with standard textgen mechanism
The standard textgen approach assumes that you model your target language (e.g. XML, or C in mbeddr) as an MPS language with all its concepts. Concept textgens provide a simple translation from concept to text. This approach is great for language extensibility, but requires that you model concepts of your target language, which in some cases is too large an investment.

This plugin allows you to to write a text template and fill in the gaps using standard macros.
For example: You generate from your DSL directly to VHDL, but VHDL has not yet been modeled in MPS.

Additionally, because text is now also an MPS model, all standard generator mechanisms (including reductions and generator priorities) apply. This is not the case for the default textgens, which are only triggered after all model to model transformations are complete.
Also, this approach enables you to implement the textgen as a language extension (and therefore define multiple textgens for the same concept).

Build instructions
------------------
To run the build, you need `ant`.
The build is run by performing the following command on the command line:
```
ant -Dmps_home=<your MPS install directory> clean generate assemble
```

mps-plaintextgen

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README