codemap-jsp
A JavaServer Pages (
.jsp) indexer for CodeMap, distributed as an independent PyPI package. Targets legacy Java web projects that still ship.jspviews.
What it captures
JSP files are HTML containers with embedded Java. The indexer scans five top-level constructs:
| JSP construct | Captured as |
|---|---|
<%@ page import="..." %> |
extra.jsp_imports on the page symbol |
<%@ include file="..." %> |
extra.jsp_includes on the page symbol |
<%! ... %> (declaration block) |
Java members parsed by tree-sitter-java; methods → method, fields → variable, nested classes → class |
<% ... %> (scriptlet) |
Skipped — scriptlet locals are per-request state, not a stable interface |
<form action="..." method="..."/> and <a href="..."> |
extra.http_client_calls on the page symbol — consumed by the host's http_route bridge to link the page to its server controller |
Every JSP file produces one page-level pseudo-class symbol plus
zero or more member symbols from any <%! ... %> blocks. The page
name is derived from the file basename (UserList.jsp → UserList).
Why this matters for AI agents on legacy projects
A typical Spring MVC + JSP project has:
src/main/java/com/example/UserController.java
@PostMapping("/api/users") void create(User u) { ... }
src/main/webapp/WEB-INF/views/users.jsp
<form action="/api/users" method="POST"> ... </form>
The http_route bridge ships in codemap-core. Once both files are
indexed, the bridge sees:
- the server route
(POST, /api/users)exposed byUserController.create - the client call
(POST, /api/users)advertised byusers.jsp
…and adds a calls edge from the page to the controller. AI agents
can now answer "what JSP pages submit to this controller?" with a
single codemap callers query — no grepping HTML for URLs.
Install
pip install codemap-jsp
tree-sitter-java is a hard dependency (used to parse declaration
blocks). No tree-sitter-jsp grammar is needed.
SymbolID encoding
scip-jsp . . . src/main/webapp/views/UserList.jsp/UserList#tag().
└──────┘ └──────────────────────────────────────────────────┘
scheme path / page pseudo-class / member
Tests
pip install -e ".[dev]"
pytest
Limits / next steps
- Scriptlet (
<% ... %>) bodies are not indexed for symbol extraction — they would surface per-request locals as noise. A future v0.2.x could optionally extract control-flow shape from scriptlets to support cross-page navigation. - JSTL tags (
<c:if>,<c:forEach>) and EL expressions (${...}) are not parsed. Acodemap-jstlcompanion plugin could surface declared<c:set var="..."/>variables if there's demand. - Tag files (
.tag/.tagx) are supported on the same code path as pages but their unique<%@ attribute name="..." %>directives are not yet surfaced as individual symbols.
License
MIT — same as the host project.
Metadata
Release files for codemap-jsp 0.4.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| codemap_jsp-0.4.10.tar.gz | 10.2 kB | With provenance | Details for codemap_jsp-0.4.10.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| codemap_jsp-0.4.10-py3-none-any.whl | Python 3 | none | any | Details for codemap_jsp-0.4.10-py3-none-any.whl |
Total release size: 20.1 kB
Release files / codemap_jsp-0.4.10.tar.gz
| Download URL | codemap_jsp-0.4.10.tar.gz |
|---|---|
| Size | 10.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fdc6a25f45e67f594e8ae41a77178cc5c8bf5e15ccbbe01b020d48eaec9cc6a0
|
|
BLAKE2b-256 checksum How to use checksums |
44f23de78f5cfb54600978a0ad81548b845b040643f9b11546aca48b76376e51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logRelease files / codemap_jsp-0.4.10-py3-none-any.whl
| Download URL | codemap_jsp-0.4.10-py3-none-any.whl |
|---|---|
| Size | 9.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e74ddb12e342a0ba6567c0834ebb89501513f16abd40479a59965cf0a255c9f
|
|
BLAKE2b-256 checksum How to use checksums |
fb9a3cf65d3cb4199a08c90b1157f8f7f6a4bf405a672c9ae66d22c9a2240ed3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logSecurity for codemap-jsp 0.4.10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for codemap_jsp-0.4.10.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.