JQL is a library for expressing Jira Query Language in an Ecto-like DSL.
We developed this library at TV Labs while trying to build analytics dashboards for Jira Service Desk, and found that it was difficult to compose query fragments together in an expressive way. This library serves to bridge that gap.
After sharing some snippets on X and Bluesky, there seemed to be a lot of community interest in a library like this, so we open sourced our initial proof of concept.
Features
-
Compile-time validation of queries
-
Query composition
-
Syntax highlighting
query = JQL.query(:status == "Done" and :created >= {:days, -5}, order_by: {:desc, :updated})
to_string(query)
~S[status = Done and created >= -5d order by updated desc]
Warning: at this time this library is still experimental. Once v0.1.0 is published, you can consider it stable.
Hex Docs: JQL — JQL v0.0.1
Github:
