Skip to content

eclipse-tm4e/tm4e

Folders and files

NameName
Last commit message
Last commit date

Latest commit

6bccc03 · Mar 18, 2025
Jan 3, 2025
Oct 23, 2024
Nov 21, 2024
Jan 20, 2025
Mar 18, 2025
Jan 14, 2025
Jan 14, 2025
Mar 18, 2025
Jan 20, 2025
Mar 18, 2025
Jan 14, 2025
Jan 14, 2025
Jan 14, 2025
Jan 14, 2025
Mar 9, 2025
Mar 18, 2025
Feb 21, 2025
Mar 11, 2023
Dec 6, 2021
Aug 14, 2024
Dec 5, 2021
Nov 4, 2024
Oct 23, 2024
Oct 28, 2021
Nov 21, 2024
Nov 4, 2024
Jan 9, 2024
Oct 23, 2024
Oct 23, 2024
Mar 18, 2025

Repository files navigation

Eclipse TM4E - TextMate and language-configuration support for Java and in Eclipse IDE

GitHub Actions Jenkins tests License

TM4E brings Java API to tokenize textual documents according to TextMate grammars with an Eclipse IDE client that can do syntax highlighting according to this tokenization; and Eclipse IDE client for VSCode Language Configuration to support matching bracket, auto close, on enter support.

TM4E is an official Eclipse.org project so it conforms to typical Eclipse.org requirements and guarantees.

📥 Install

1) in Eclipse IDE or RCP applications

You can install TM4E from the update site https://download.eclipse.org/tm4e/releases/latest/. TM4E is usually installed together with its consumers, so end-user should usually not need to directly install it.

The latest snapshot build can be installed from the update site https://download.eclipse.org/tm4e/snapshots/.

Eclipse IDE compatibility

TM4E version Min. Eclipse version
latest 2023-09 (4.29)
0.9.0+ 2023-09 (4.29)
0.8.1+ 2023-06 (4.28)
0.8+ 2023-03 (4.27)
0.6.3+ 2022-12 (4.26)
0.6.2+ 2022-09 (4.25)
0.6.0+ 2022-03 (4.23)

2) as a Java API with Maven

Snapshot binaries of org.eclipse.tm4e.core are available at https://repo.eclipse.org/content/repositories/tm4e-snapshots/org/eclipse/org.eclipse.tm4e.core/. You need to add the following repository configuration to your Maven settings.xml:

<?xml version="1.0" encoding="UTF-8" ?>
<settings>
  <profiles>
    <profile>
      <repositories>
        <repository>
          <id>tm4e-snapshots</id>
          <name>tm4e-snapshots</name>
          <url>https://repo.eclipse.org/content/repositories/tm4e-snapshots/</url>
          <releases><enabled>false</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>tm4e-snapshots</activeProfile>
  </activeProfiles>
</settings>

Then you can reference the dependency in your pom.xml like so:

<dependencies>
  <dependency>
    <groupId>org.eclipse</groupId>
    <artifactId>org.eclipse.tm4e.core</artifactId>
    <version>[VERSION]-SNAPSHOT</version>
  </dependency>
</dependencies>

[more information coming ...]

⌨️ Code

Clone to Eclipse IDE

The following class and modules should be used as entry point provides:

An example with TypeScript:

TypeScript Editor

👪 Who is using tm4e?

Here are some projects that use tm4e:

  • Apache NetBeans - A multi-language IDE written in Java that uses TM4E core parts to support syntax highlighting based on TextMate grammars.
  • Eclipse IDE languages and frameworks integrations

Documentation

See Further documentation for additional information.

👷 Get support and contribute

  • License: TM4E is a community open-source project licensed under the Eclipse Public License 2.0.
  • Support: You can ask (and answer!) questions in the GitHub discussions. Report bugs, and request features using GitHub issues.
  • Source Code: This github.com/eclipse-tm4e/tm4e repository is the reference repository to contribute to TM4E
  • Build: Builds can be performed with a simple ./mvnw clean verify
  • Continuous testing, integration and deployment is performed by CI jobs at https://ci.eclipse.org/tm4e/ and https://github.com/eclipse-tm4e/tm4e/actions
  • Developers mailing-list: Contributors are also expected to subscribe the tm4e-dev mailing-list.
  • Becoming a committer: as usual with Eclipse.org projects, anyone who's made significant contributions and who's upheld quality standards alongside good judgement and open-mindedness.