Skip to content

About

MPS-extensions aims to ease language development within MPS.

Topics

Resources

Code of conduct

Contributing

Stars

91 stars

Watchers

22 watching

Forks

Repository files navigation

MPS Extensions and mbeddr Platform

official JetBrains project

The MPS extensions aim to ease language development within MPS. They are maintained by itemis, JetBrains, and the open source community, and the development is closely aligned with the development of MPS.

Join the discussion on Slack in the #mps-extensions room.

Maven Dependencies

To use MPS Extensions in your project, add a Maven or Gradle dependency on the de.itemis.mps:extensions artifact. See the documentation for examples.

MPS-Extensions

Each maintenance branch is built against the MPS version in gradle/libs.versions.toml of that branch and publishes artifacts for that version. To find the latest published version for an MPS release, use the latest version finder.

mbeddr Platform

The mbeddr platform is developed in code/platform and contains the MPS extensions together with platform plugins and languages. Its Maven ZIP is com.mbeddr:platform:<version>; the extensions-only ZIP remains de.itemis.mps:extensions:<version>. Both artifacts use the same version and are available from itemis Nexus and GitHub Packages.

The MPS-extensions releases include the extensions ZIP and platform-distribution-<version>-MPS-<mps-version>.zip. The platform release ZIP has the same payload as the Maven ZIP, under com.mbeddr.platform/.

Platform changes are recorded in the platform changelog; CHANGELOG.md records extensions changes. Report platform and extensions issues in MPS-extensions issues. The mbeddr C project remains in mbeddr.core.

Building

See the building page of the documentation.

Documentation

If you want more information on the individual extensions, please see our documentation. The documentation's source is in this repository's docs folder if you would like to contribute. To preview the documentation, run the following command:

./gradlew previewDocs # Mac and Linux
gradlew.bat previewDocs # Windows

Creating a PR

Please add your change to the changelog located at de.itemis.mps.extensions.changelog. To update it, rebuild the solution and run ./gradlew copyChangelog or gradlew.bat copyChangelog to regenerate the CHANGELOG.md file. Commit the changes in the MPS model and in the text file. When you open a PR, the build on TeamCity needs to be approved by a colleague at itemis, and a PR review is necessary. If this doesn't happen, please ask in the Slack channel. Often, builds fail at the following step: Check for dirty files. If that happens, some migrations were not executed in the project. Run ./gradlew migrate remigrate or gradlew.bat migrate remigrate on the command line to execute them and commit the changes. You can also copy the diff from the build log and apply it with git apply as a patch. You need to strip the line numbers, though:

  • Mac: pbpaste | sed 's/^.\{13\}//' | git apply
  • Windows Powershell: Get-Clipboard | ForEach-Object { $_ -replace '^.{13}', '' } | git apply
  • Linux solution 1: xclip -o | sed 's/^.\{13\}//' | git apply
  • Linux solution 2: xsel --clipboard --output | sed 's/^.\{13\}//' | git apply

Please select the correct target branch for the PR. The master branch builds against the MPS master and is most likely not the branch you want to contribute to. After the PR is merged, a bot will automatically open a PR to merge the changes into the next maintenance branch. You don't have to do anything at the last step.

Automatic Updating Of Dependencies

The Renovate bot updates the dependencies automatically for the master branch or optionally other branches and creates PRs for those changes. The configuration can be found at renovate.json5. The documentation for the configuration can be found at https://docs.renovatebot.com/configuration-options/.

About

MPS-extensions aims to ease language development within MPS.

Topics

Resources

Code of conduct

Contributing

Stars

91 stars

Watchers

22 watching

Forks

Releases

Packages

Used by

Contributors

Languages