Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fusesource/jansi
Jansi is a small java library that allows you to use ANSI escape sequences to format your console output which works even on windows.
https://github.com/fusesource/jansi
Last synced: 3 days ago
JSON representation
Jansi is a small java library that allows you to use ANSI escape sequences to format your console output which works even on windows.
- Host: GitHub
- URL: https://github.com/fusesource/jansi
- Owner: fusesource
- License: apache-2.0
- Created: 2009-09-05T10:10:52.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2024-09-25T08:36:24.000Z (3 months ago)
- Last Synced: 2024-11-17T00:35:09.888Z (25 days ago)
- Language: Java
- Homepage: http://fusesource.github.io/jansi/
- Size: 2.37 MB
- Stars: 1,122
- Watchers: 35
- Forks: 139
- Open Issues: 33
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- License: license.txt
Awesome Lists containing this project
- awesome-java - Jansi - ANSI escape codes to format console output. (Projects / CLI)
- awesome-java-zh - Jansi - ANSI转义代码格式化控制台输出。 (项目 / CLI)
- awesome-java - Jansi - ANSI escape codes to format console output. (Projects / CLI)
README
# [![Jansi][logo]][Jansi]
[logo]: http://fusesource.github.io/jansi/images/project-logo.png "Jansi"
## Description
[Jansi][Jansi] is a small java library that allows you to use [ANSI escape
codes][ansi] to format your console output which works even on Windows.
It also provides the required JNI libraries:
- [Kernel32](http://fusesource.github.io/jansi/documentation/native-api/org/fusesource/jansi/internal/Kernel32.html) and [WindowsSupport](http://fusesource.github.io/jansi/documentation/native-api/org/fusesource/jansi/internal/WindowsSupport.html) for ANSI support on Windows
- [CLibrary](http://fusesource.github.io/jansi/documentation/native-api/org/fusesource/jansi/internal/CLibrary.html) for POSIX tty functions on Unix and Windows
[](https://search.maven.org/artifact/org.fusesource.jansi/jansi)
[Jansi]: http://fusesource.github.io/jansi/
[ansi]: http://en.wikipedia.org/wiki/ANSI_escape_code "Wikipedia"
## Features
* Implements ANSI escape colorization/handling that is missing on the Windows
platform, using integrated JNI library.
* Strips ANSI escape codes if process output is is being redirected and not
attached to a terminal.
* Easy to use Ansi escape sequence builder API.
* JNI access to low-level console features.
## Synopsis
Most unix terminals support rendering ANSI escape codes when Java sends them
via `System.out`, but when this is done on Windows, they don't get interpreted
and you get garbage on the console.
Furthermore, even when on Unix, when process output is being redirected to a
file, you typically don't want to output escape codes to the file since most
file viewers and editors will not properly display the escape codes.
Jansi detects and abstracts the ANSI support provided by the attached
terminal. When your Java application uses Jansi, it can always assume that
standard out and error streams support ANSI sequences. Depending on the
platform and if the application output is attached to a real terminal, Jansi
will do one of the following with the ANSI escape codes that it receives:
* Pass them through untouched
* Filter them out
* Use platform specific APIs to implement the terminal commands represented by
the escape sequence
## Example Usage
Enabling the Jansi ANSI support into your application is as simple as doing a
simple static method call:
``` java
import org.fusesource.jansi.AnsiConsole;
...
AnsiConsole.systemInstall();
```
Disabling it is also done via a static method:
``` java
AnsiConsole.systemUninstall();
```
It is safe to call those methods multiple times, they keep track of how many
times `systemInstall()` has been called and only uninstalls when the
`systemUninstall()` method is called a corresponding number of times.
Using the Ansi escape sequence builder:
```java
import static org.fusesource.jansi.Ansi.*;
import static org.fusesource.jansi.Ansi.Color.*;
...
System.out.println( ansi().eraseScreen().fg(RED).a("Hello").fg(GREEN).a(" World").reset() );
```
The above will clear the screen, write `Hello` in red and `World` in green,
then reset the color attributes so that subsequent data printed to the stream
uses the default colors.
But there is an even simpler way to accomplish the above using the `render`
method:
```java
System.out.println( ansi().eraseScreen().render("@|red Hello|@ @|green World|@") );
```
## Project Links
* [Project Home](http://fusesource.github.io/jansi)
* [Release Downloads](http://fusesource.github.io/jansi/download.html)
* [GitHub](https://github.com/fusesource/jansi)
* [Issue Tracker](https://github.com/fusesource/jansi/issues)