Skip to content

ContextMapper/vscode-extension

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8d0fb62 · Jan 11, 2024
Nov 24, 2023
Jun 2, 2020
Apr 17, 2020
Nov 4, 2022
May 6, 2020
Jan 11, 2024
Jan 4, 2024
Sep 21, 2020
Jun 4, 2020
Jun 24, 2020
Apr 17, 2020
Jan 4, 2024
Nov 4, 2022
Jul 23, 2020
Jan 11, 2024
Apr 17, 2020
Apr 17, 2020
Jan 4, 2024
Jan 11, 2024
Jul 23, 2020
Apr 17, 2020
Apr 17, 2020

Repository files navigation

Context Mapper

Context Mapper VS Code Extension

Build License

ContextMapper is an open source tool providing a Domain-specific Language based on Domain-Driven Design (DDD) patterns for context mapping and service decomposition.

Context Mapper VS Code Extension

Related repositories are:

With the ContextMapper DSL language you can express DDD Context Maps. Once you have modeled your system with the language, you can use the provided generators to create graphical Context Maps, UML diagrams, service contracts and Spring Boot applications (via JHipster JDL).

Checkout our website https://contextmapper.org/ to get started. The Context Mapper project has been developed as part of projects at OST (former HSR) and you can find the project reports and further background information here.

Installation Links:

System Requirements

To use the ContextMapper VS Code extension you need the following tools (besides VS Code and our extension) installed locally:

  • Oracle Java or OpenJDK (JRE 11 or newer)
  • If you want to use our Context Map generator you need to have Graphviz installed on your system.
    • Ensure that the binaries are part of the PATH environment variable and can be called from the terminal.
    • Especially on Windows this is not the case after the installation of Graphviz. The default installation path is C:\Program Files (x86)\GraphvizX.XX, which means you have to add C:\Program Files (x86)\GraphvizX.XX\bin to your PATH variable.
  • Maybe you want to install the PlantUML extension for the generated PlantUML diagrams.

Getting Started

  • The extension can be downloaded and installed via the Marketplace.

  • Or: search for "Context Mapper" the extensions view of your running VS code (Ctrl+Shift+X).

  • Next steps after installation: Consult our website to learn how to get started with Context Mapper.

Build and/or Run Extension Locally

This project uses Gradle to build the VS code extension.

Once you cloned this repository, you can build the project with the following command:

./gradlew clean snapshot vscodeExtension

Use the following command to build and run the extension in your VS code:

./gradlew snapshot startCode

Note: VS Code must be available on the command line as code to use the command above.

Setup Development Environment

We use VS Code to develop this extension. You can simply clone this repo and import the sources into VS Code. You can run the extension with F5 and Enter (select npm:compile build task).

Contributing

Contribution is always welcome! Here are some ways how you can contribute:

Licence

ContextMapper is released under the Apache License, Version 2.0.