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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file codemap_jsp-0.4.10.tar.gz.
File metadata
- Download URL: codemap_jsp-0.4.10.tar.gz
- Upload date:
- Size: 10.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fdc6a25f45e67f594e8ae41a77178cc5c8bf5e15ccbbe01b020d48eaec9cc6a0
|
|
| MD5 |
04760e0def2a357cb56052f1ba261eb9
|
|
| BLAKE2b-256 |
44f23de78f5cfb54600978a0ad81548b845b040643f9b11546aca48b76376e51
|
Provenance
The following attestation bundles were made for codemap_jsp-0.4.10.tar.gz:
Publisher:
publish.yml on qxbyte/codemap
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
codemap_jsp-0.4.10.tar.gz -
Subject digest:
fdc6a25f45e67f594e8ae41a77178cc5c8bf5e15ccbbe01b020d48eaec9cc6a0 - Sigstore transparency entry: 2496875731
- Sigstore integration time:
-
Permalink:
qxbyte/codemap@13709c99dfe26f42eb7185d8b7de695e2df81c37 -
Branch / Tag:
refs/tags/v0.4.10 - Owner: https://github.com/qxbyte
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@13709c99dfe26f42eb7185d8b7de695e2df81c37 -
Trigger Event:
push
-
Statement type:
File details
Details for the file codemap_jsp-0.4.10-py3-none-any.whl.
File metadata
- Download URL: codemap_jsp-0.4.10-py3-none-any.whl
- Upload date:
- Size: 9.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e74ddb12e342a0ba6567c0834ebb89501513f16abd40479a59965cf0a255c9f
|
|
| MD5 |
1a42af0b9135de82720bf254f8e832ba
|
|
| BLAKE2b-256 |
fb9a3cf65d3cb4199a08c90b1157f8f7f6a4bf405a672c9ae66d22c9a2240ed3
|
Provenance
The following attestation bundles were made for codemap_jsp-0.4.10-py3-none-any.whl:
Publisher:
publish.yml on qxbyte/codemap
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
codemap_jsp-0.4.10-py3-none-any.whl -
Subject digest:
3e74ddb12e342a0ba6567c0834ebb89501513f16abd40479a59965cf0a255c9f - Sigstore transparency entry: 2496875829
- Sigstore integration time:
-
Permalink:
qxbyte/codemap@13709c99dfe26f42eb7185d8b7de695e2df81c37 -
Branch / Tag:
refs/tags/v0.4.10 - Owner: https://github.com/qxbyte
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@13709c99dfe26f42eb7185d8b7de695e2df81c37 -
Trigger Event:
push
-
Statement type:
