Repo brief: square/javapoet

Generated by RepoPilot · document generated 2026-09-14 · concise human review Evidence snapshot · analyzed 2026-09-14T15:44:38.318Z · commit b9017a9503b7

Verdict

Mixed — Stale — last commit 2y ago

• 10 active contributors
• Distributed ownership (top contributor 49% of recent commits)
• Apache-2.0 licensed
• CI configured
• 1 more receipt on the live page

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

What it is

JavaPoet is a Java API for programmatically generating .java source files at runtime. It provides a fluent builder interface to construct classes, methods, fields, annotations, and type declarations as immutable objects, then serialize them to valid Java source code. Commonly used for annotation processors, code generators, and metadata-driven code generation (e.g., database schema → DAOs). Single-package monolith: core API lives in src/main/java/com/squareup/javapoet/ with ~16 specification classes (TypeSpec.java, MethodSpec.java, FieldSpec.java, AnnotationSpec.java, etc.) that build immutable models. CodeWriter.java handles serialization; NameAllocator.java avoids name collisions.…

Start here

Open these first:

• src/main/java/com/squareup/javapoet/JavaFile.java — Entry point for generating complete .java source files; orchestrates package, imports, and type declarations.
• src/main/java/com/squareup/javapoet/TypeSpec.java — Core abstraction for class, interface, enum, and annotation type generation; every class-like construct flows through here.
• src/main/java/com/squareup/javapoet/CodeBlock.java — Manages code fragment generation with format placeholders and parameter substitution; powers all method bodies and field…
• src/main/java/com/squareup/javapoet/TypeName.java — Abstract base for all Java type representations; critical for type hierarchy, generics, and import resolution.
• src/main/java/com/squareup/javapoet/CodeWriter.java — Handles low-level emission of code to output streams with indentation, import management, and line wrapping.

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/square/javapoet.git
cd javapoet
mvn clean install
mvn test

Daily commands:

No server/runtime. Build project with mvn clean install to generate JAR at target/javapoet-1.14.0-SNAPSHOT.jar. Use in your own code by adding to your project's classpath and calling builder APIs (see README example…

…shortened for this brief.

Key cautions & unknowns

• Stale — last commit 2y ago
• No required env vars or external services. Java 8+ required (pom.xml: <java.version>1.8</java.version>). No support for Java 17+ features (records, sealed classes, pattern matching) due to project…
• 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.