Skip to content

Commit

Permalink
Create liberty-tools-overview.adoc
Browse files Browse the repository at this point in the history
  • Loading branch information
dmuelle committed Dec 2, 2022
1 parent 06f3361 commit 3bd6075
Showing 1 changed file with 47 additions and 0 deletions.
47 changes: 47 additions & 0 deletions modules/ROOT/pages/liberty-tools-overview.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
// Copyright (c) 2022 IBM Corporation and others.
// Licensed under Creative Commons Attribution-NoDerivatives
// 4.0 International (CC BY-ND 4.0)
// https://creativecommons.org/licenses/by-nd/4.0/
//
// Contributors:
// IBM Corporation
//
:page-layout: general-reference
:page-type: general

= Develop with Liberty Tools

Liberty Tools are a set of extensions for the Eclipse IDE, Visual Studio Code, and Intellij IDEA development environments. These extensions enable fast, iterative development with Liberty dev mode and Maven or Gradle build automation tools.

Liberty Tools automatically detects any projects that specify the Liberty Maven plug-in or Liberty Gradle plug-in in the `pom.xl` file. These projects are added to a special Liberty dashboard view in Eclipse IDE or Visual Studio Code or the Liberty Tools window in Intellij IDEA. From there, you can access a command menu to manage your projects.

Liberty Tools also provides helpful, time-saving features such as code completion, hover descriptions, and configuration diagnostics for the MicroProfile API, Jakarta EE API, and Liberty configuration files.

== Develop, test, and debug in your editor

You can use Liberty Tools extensions to stop, start or interact with Liberty dev mode from the Liberty dashboard view in Eclipse IDE or Visual Studio Code or the Liberty Tools window in Intellij IDEA. Liberty dev mode automatically detects, recompiles, and deploys code changes whenever you save a new change. It also runs unit and integration tests on demand and can attach a debugger to the running server to step through your code at any time.

Liberty tools brings these dev mode features directly into the command menu for the Liberty projects in your editor. With a just few clicks, you can start and stop your Liberty application, run tests, and view test reports.

== Configure with core language support for Liberty, MicroProfile, and Jakarta EE

Liberty tools helps you quickly and easily edit your application and configuration files by providing language support features for MicroProfile, Jakarta EE, and Liberty configuration files.

The following language support features are available for select Liberty configuration files.

* Code completion: start typing a Liberty property, variable, or XML configuration to view a list of possible options
* Hover support: hover your cursor over Liberty properties, variables, or XML configuration to view a description
* Configuration diagnostics: diagnostics highlight potential problems in your configuration, such as invalid values.

These features are available for the following Liberty configuration files.

* `server.env`
* `bootstrap.properties`
* `server.xml` and any XML files that are referenced through the `include` element in the `server.xml` file.
* Any XML files that contain the `server` root element and exist in the `src/main/liberty/config`, `configDropins/overrides`, `configDropins/defaults`, `usr/shared/config`, or `usr/servers` directory.

Language support for MicroProfile includes the following features.



== Try it out

0 comments on commit 3bd6075

Please sign in to comment.