pygments.rb is a Ruby wrapper forPygments syntax highlighter.

pygments.rb works by talking over a simple pipe to a long-lived Python child process.This library replacesgithub/albino, as well as an older version of pygments.rb that used an embedded Python interpreter.

Each Ruby process that runs has its own 'personal Python'; for example, 4 Unicorn workers will have one Python process each.If a Python process dies, a new one will be spawned on the next pygments.rb request.

• Python >= 3.8

• Ruby >= 2.7

Add this line to your application’s Gemfile:

And then execute:

Or install pygments.rb gem globally:

Require pygments.rb module:

Highlight a file:

Optionally, pass encoding and other lexer/formatter options via an:options hash:

pygments.rb uses HTML formatter by default.To use a different formatter, specify it via:formatter parameter:

To generate CSS for HTML formatted code, use thePygments.css method:

To use a specific pygments style, pass the:style option to thePygments.css method:

Other Pygments high-level API methods are also available.These methods return arrays detailing all the available lexers, formatters, and styles:

To use a custom pygments installation, specify the path toPygments.start:

If you’d like logging, set the environmental variableMENTOS_LOG to a file path for your logfile.

You can apply a timeout to pygments.rb calls by specifying number of seconds inMENTOS_TIMEOUT environmental variable or by passing the:timeout argument (takes precedence overMENTOS_TIMEOUT):

After checking out the repo, runbundle install to install dependencies.Then, runbundle exec rake test to run the tests.

Copyright © Ted Nyman, Aman Gupta, Marat Radchenko, 2012-2021.Free use of this software is granted under the terms of the MIT License.

For the full text of the license, see theLICENSE file.