A Ruby extension for parsing DText markup used by e621.net.
This gem uses the Ragel state machine compiler to generate efficient C++ parsing code for DText syntax.

If you wish to test your changes in a local instance of e621ng, please refer to the "Local DText gem" section of that repo's README file.

1. Build the Docker container: docker compose build
2. Compile the parser: docker compose run --rm rake compile
3. Run tests: docker compose run --rm rake test

The dtext.cpp file is a generated artifact and should not be committed in development branches or pull requests. It will be regenerated during the official release process.

Use the release script to properly bump the version number and compile the artifacts.

./scripts/release.sh [patch|minor|major]

Don't forget to update e621ng's Gemfile to include the new tag name.

If you're new to Ragel, these resources will help you understand the syntax and concepts:

• Unofficial Ragel quickstart guide
• Official Ragel documentation