Repo brief: json-path/JsonPath

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T06:50:39.519Z · commit 62a4c9f0f65b

Verdict

Healthy — Strong maintenance signals

• Last commit 3mo ago
• 39+ active contributors
• Distributed ownership (top contributor 42% of recent commits)
• Apache-2.0 licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Jayway JsonPath is a Java DSL for querying and extracting data from JSON documents using XPath-like expressions (e.g., $.store.book[0].title). It provides both dot-notation and bracket-notation path syntax, supporting wildcards, deep scans, array slicing, and filter predicates to navigate complex JSON structures without manual parsing. Two-module Gradle monorepo: json-path/ contains the core engine (path parsing, expression evaluation, object navigation) and json-path-assert/ provides Hamcrest matchers for test assertions. Both follow standard Maven layout (src/main/java, src/test/java). The assert module depends on core and wraps it for fluent test DSL (JsonAssert, JsonAsserter).

Start here

Open these first:

• json-path/src/main/java/com/jayway/jsonpath/JsonPath.java — Main entry point API; all JsonPath queries start here—every contributor must understand the public API surface
• json-path/src/main/java/com/jayway/jsonpath/internal/ParseContextImpl.java — Core parser that converts JsonPath expressions into executable paths—critical for understanding expression evaluation flow
• json-path/src/main/java/com/jayway/jsonpath/internal/filter/FilterCompiler.java — Compiles filter expressions (e.g., [?(...)]) into evaluators—essential for conditional path resolution
• json-path/src/main/java/com/jayway/jsonpath/Configuration.java — Global configuration registry for JSON providers and options—defines extensibility points for different JSON libraries
• json-path/src/main/java/com/jayway/jsonpath/internal/EvaluationContext.java — Runtime evaluation state machine tracking current position and results—core abstraction for path traversal

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/json-path/JsonPath.git
cd JsonPath
./gradlew build
./gradlew test

(Gradle wrapper included; requires Java 17+)

Daily commands:

This is a library, not an application. To validate locally: ./gradlew build runs full test suite. For development: ./gradlew classes compiles, ./gradlew test runs unit tests across both modules, ./gradlew jar bu…

…shortened for this brief.

Key cautions & unknowns

• Java 17 baseline is hard requirement (version 3.0.0+), will not compile or run on Java 8–16. Multiple JSON parser backends are pluggable but must be on classpath; missing a parser will cause runtime failures if that…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.