A Crystal reimplementation of the Pygments/Chroma syntax highlighters
Go to file
2024-08-26 16:44:44 -03:00
lexers Integrate heuristics into lexer selection 2024-08-24 21:39:39 -03:00
scripts Integrate heuristics into lexer selection 2024-08-24 21:39:39 -03:00
spec Use classes instead of structs to allow properties of the same type 2024-08-22 21:52:59 -03:00
src Fix bug in ansi formatter 2024-08-26 16:44:44 -03:00
styles Removed duplicate snazzy theme 2024-08-11 11:27:37 -03:00
.ameba.yml Remove Re2 hack 2024-08-12 19:01:13 -03:00
.editorconfig Initial dumb stuff 2024-08-02 17:03:39 -03:00
.gitignore Some template lexers 2024-08-22 16:11:30 -03:00
build_static.sh Added helper files 2024-08-09 10:30:20 -03:00
Dockerfile.static Added helper files 2024-08-09 10:32:15 -03:00
LICENSE Initial dumb stuff 2024-08-02 17:03:39 -03:00
Makefile Implemented decent version of the CLI 2024-08-11 11:49:42 -03:00
README.md Updated README 2024-08-24 22:33:24 -03:00
shard.yml Use forked baked_file_system for now 2024-08-25 17:05:04 -03:00
TODO.md Load lexer by mimetype 2024-08-24 22:20:38 -03:00
x2.html v0.5.0 2024-08-21 21:22:36 -03:00

TARTRAZINE

Tartrazine is a library to syntax-highlight code. It is a port of Pygments to Crystal.

It also provides a CLI tool which can be used to highlight many things in many styles.

Currently Tartrazine supports 247 languages. and it has 331 themes (63 from Chroma, the rest are base16 themes via Sixteen

Installation

From prebuilt binaries:

Each release provides statically-linked binaries that should work on any Linux. Get them from the releases page and put them in your PATH.

To build from source:

  1. Clone this repo
  2. Run make to build the tartrazine binary
  3. Copy the binary somewhere in your PATH.

Usage as a CLI tool

Show a syntax highlighted version of a C source file in your terminal:

$ tartrazine whatever.c -l c -t catppuccin-macchiato --line-numbers -f terminal

Generate a standalone HTML file from a C source file with the syntax highlighted:

$ tartrazine whatever.c -t catppuccin-macchiato --line-numbers \
  --standalone -f html -o whatever.html 

Usage as a Library

This works:

require "tartrazine"

lexer = Tartrazine.lexer("crystal")
theme = Tartrazine.theme("catppuccin-macchiato")
formatter = Tartrazine::Html.new
formatter.theme = theme
puts formatter.format(File.read(ARGV[0]), lexer)

Contributing

  1. Fork it (https://github.com/ralsina/tartrazine/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

A port of what? Why "kind of"?

Pygments is a staple of the Python ecosystem, and it's great. It lets you highlight code in many languages, and it has many themes. Chroma is "Pygments for Go", it's actually a port of Pygments to Go, and it's great too.

I wanted that in Crystal, so I started this project. But I did not read much of the Pygments code. Or much of Chroma's.

Chroma has taken most of the Pygments lexers and turned them into XML descriptions. What I did was take those XML files from Chroma and a pile of test cases from Pygments, and I slapped them together until the tests passed and my code produced the same output as Chroma. Think of it as extreme TDD

Currently the pass rate for tests in the supported languages is 96.8%, which is not bad for a couple days hacking.

This only covers the RegexLexers, which are the most common ones, but it means the supported languages are a subset of Chroma's, which is a subset of Pygments' and DelegatingLexers (useful for things like template languages)

Then performance was bad, so I hacked and hacked and made it significantly faster than chroma which is fun.