Skip to content

docs(ingest): document missing custom filters and Jinja test operators#3077

Open
aheuze wants to merge 1 commit into
mainfrom
docs/ingest-parser-missing-filters-and-operators
Open

docs(ingest): document missing custom filters and Jinja test operators#3077
aheuze wants to merge 1 commit into
mainfrom
docs/ingest-parser-missing-filters-and-operators

Conversation

@aheuze

@aheuze aheuze commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary

The parser reference documentation was missing several custom Jinja filters and the test operators section entirely.

Changes

7 undocumented custom filters added:

  • is_ipaddress — tests if the value is a valid IP address (v4 or v6)
  • is_ipv4 — tests if the value is a valid IPv4 address
  • is_ipv6 — tests if the value is a valid IPv6 address
  • is_url — tests if the value is a valid URL
  • from_json — deserializes a JSON string into a dict
  • to_json — serializes a value into a JSON string
  • to_mac_address — normalizes a MAC address to EUI-48 format

New section: Test operators

Documents the btiwise_has_flag(flag) operator usable with Jinja2's is keyword in {% if %} blocks.

Minor fix: typo "an regular" → "a regular".

Add 7 undocumented custom filters to the parser reference:
- is_ipaddress, is_ipv4, is_ipv6: IP address validation
- is_url: URL validation
- from_json / to_json: JSON serialization/deserialization
- to_mac_address: MAC address normalization to EUI-48

Add a new "Test operators" section documenting the btiwise_has_flag
operator usable with Jinja2's `is` keyword in {% if %} blocks.

Also fix a minor typo: "an regular" -> "a regular".

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown

Newest code from aheuze has been published to preview environment

🚀 Latest deployment was built on 2026-06-23 14:29:12 (0228bbbe6138e3857ae5ffac3bd582b1bf2b92c0).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant