Skip to content

Add cohesive codebase analysis tools #119

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 113 commits into
base: develop
Choose a base branch
from

Conversation

codegen-sh[bot]
Copy link

@codegen-sh codegen-sh bot commented May 15, 2025

This PR adds a cohesive set of codebase analysis tools that consolidate and improve upon the existing functionality in the error_analyzer.py and the analyzers directory.

Changes

  1. Added codebase_analyzer.py - A comprehensive analyzer that identifies code quality issues, dependency problems, and structural concerns.

  2. Added context_retriever.py - A utility for retrieving and organizing context from a codebase, focusing on code structure, dependencies, and relationships.

  3. Added analyze.py - A command-line interface for running analyses and retrieving context from codebases.

  4. Added README_CODEBASE_ANALYSIS.md - Documentation for the new codebase analysis tools.

Features

The new tools provide the following capabilities:

  • Code Quality Analysis: Identify unused functions, unused imports, unused parameters, and complex functions.
  • Dependency Analysis: Detect parameter mismatches in function calls and circular imports.
  • Structure Analysis: Find excessively large files and deeply nested functions.
  • Context Retrieval: Get detailed context about files, functions, and classes.
  • Multiple Output Formats: Generate reports in text, JSON, or HTML format.

Benefits

These tools offer several advantages over the existing implementation:

  1. Simplified Interface: The new tools provide a clean, intuitive interface for analyzing codebases.
  2. Consolidated Functionality: The functionality previously spread across multiple files is now consolidated into a few focused modules.
  3. Improved Documentation: Comprehensive documentation is provided to help users understand and use the tools.
  4. Better Code Organization: The code is organized in a more modular and maintainable way.

Usage

See the README_CODEBASE_ANALYSIS.md file for detailed usage instructions and examples.


💻 View my workAbout Codegen

Note

I'm currently writing a description for your pull request. I should be done shortly (<1 minute). Please don't edit the description field until I'm finished, or we may overwrite each other. If I find nothing to write about, I'll delete this message.

Summary by Sourcery

Introduce a cohesive suite of codebase analysis tools, including a comprehensive analyzer, context retriever, and unified CLI, to assess code quality, dependencies, structure, and provide detailed context with flexible output formats.

New Features:

  • Add CodebaseAnalyzer for end-to-end code quality, dependency, and structure analysis
  • Add ContextRetriever to extract summaries and detailed file/function/class context
  • Add analyze.py CLI to run analysis, context, and summary commands from the command line
  • Support text, JSON, and HTML report formats for analysis results

Enhancements:

  • Consolidate existing error_analyzer and analyzer modules into modular, maintainable components

Documentation:

  • Add README_CODEBASE_ANALYSIS.md with installation instructions, usage examples, and feature descriptions

clee-codegen and others added 30 commits February 26, 2025 23:54
# Motivation

The **Codegen on OSS** package provides a pipeline that:

- **Collects repository URLs** from different sources (e.g., CSV files
or GitHub searches).
- **Parses repositories** using the codegen tool.
- **Profiles performance** and logs metrics for each parsing run.
- **Logs errors** to help pinpoint parsing failures or performance
bottlenecks.

<!-- Why is this change necessary? -->

# Content

<!-- Please include a summary of the change -->
see
[codegen-on-oss/README.md](https://github.com/codegen-sh/codegen-sdk/blob/acfe3dc07b65670af33b977fa1e7bc8627fd714e/codegen-on-oss/README.md)

# Testing

<!-- How was the change tested? -->
`uv run modal run modal_run.py`
No unit tests yet 😿 

# Please check the following before marking your PR as ready for review

- [ ] I have added tests for my changes
- [x] I have updated the documentation or added new documentation as
needed
Original commit by Tawsif Kamal: Revert "Revert "Adding Schema for Tool Outputs"" (codegen-sh#894)

Reverts codegen-sh#892

---------

Co-authored-by: Rushil Patel <rpatel@codegen.com>
Co-authored-by: rushilpatel0 <171610820+rushilpatel0@users.noreply.github.com>
Original commit by Ellen Agarwal: fix: Workaround for relace not adding newlines (codegen-sh#907)
Copy link

korbit-ai bot commented May 15, 2025

By default, I don't review pull requests opened by bots. If you would like me to review this pull request anyway, you can request a review via the /korbit-review command in a comment.

Copy link

sourcery-ai bot commented May 15, 2025

Reviewer's Guide

This PR consolidates and extends existing codebase analysis functionality into a cohesive toolkit built on the Codegen SDK by adding a comprehensive analyzer module, a context retriever utility, a unified CLI, and accompanying documentation.

Class Diagram for Codebase Context Retriever

classDiagram
    direction LR
    class CodebaseContext {
        -codebase: Codebase
        -files: List[SourceFile]
        -functions: List[Function]
        -classes: List[Class]
        -imports: List[Import]
        -_function_call_graph: Optional[Dict]
        -_import_graph: Optional[Dict]
        -_symbol_usage_map: Optional[Dict]
        +__init__(codebase: Codebase)
        +get_codebase_summary() Dict[str, Any]
        +get_unused_functions() List[Function]
        +get_unused_imports() List[Import]
        +get_functions_with_unused_parameters() List[Tuple[Function, List[str]]]
        +get_parameter_mismatches() List[Tuple[Function, List[str]]]
        +get_function_call_graph() Dict[str, List[str]]
        +get_import_graph() Dict[str, List[str]]
        +get_circular_imports() List[Tuple[str, str]]
        +get_symbol_usage_map() Dict[str, List[str]]
        +get_recursive_functions() List[Function]
        +get_complex_functions(threshold: int) List[Tuple[Function, int]]
        +get_file_context(file_path: str) Dict[str, Any]
        +get_function_context(function_name: str) Dict[str, Any]
        +get_class_context(class_name: str) Dict[str, Any]
    }
    CodebaseContext ..> Codebase : uses
    note for Codebase "Provided by Codegen SDK"
    note for CodebaseContext "Retrieves and organizes context from a Codebase object provided by the Codegen SDK."
Loading

File-Level Changes

Change Details Files
Added a comprehensive codebase analyzer consolidating quality, dependency, and structure checks
  • Defined IssueSeverity and IssueCategory enums and CodeIssue model
  • Initialized Codebase via Codegen SDK with custom _init_codebase logic
  • Implemented analysis pipelines for code quality, dependencies, and structure
  • Provided multi-format report generation (text, JSON, HTML)
codegen_on_oss/codebase_analyzer.py
Added context retriever utility encapsulating codebase context access
  • Implemented CodebaseContext with summary, file/function/class context methods
  • Provided call graph, import graph, symbol usage map, and issue-collection methods
  • Exposed analyze_codebase helper for combined summary and issue counts
codegen_on_oss/context_retriever.py
Introduced CLI entrypoint enabling subcommands for analysis, context, and summary
  • Configured argparse subparsers for analyze, context, and summary commands
  • Wired commands to CodebaseAnalyzer, get_codebase_context, and analyze_codebase
  • Standardized logging setup and centralized error handling
codegen_on_oss/analyze.py
Added documentation for the new analysis tools
  • Documented overview, installation, CLI usage, and programmatic examples
  • Outlined feature set and supported output formats
  • Provided contribution guidelines and licensing information
codegen_on_oss/README_CODEBASE_ANALYSIS.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link

coderabbitai bot commented May 15, 2025

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Join our Discord community for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Author

codegen-sh bot commented May 15, 2025

I see a check failed - I'm on it! 🫡

💻 View my work

Copy link
Author

codegen-sh bot commented May 15, 2025

✅ Fixed the failing mypy checks in this commit. The issues were related to missing type annotations and improper null handling in the codebase analysis tools. I've added proper type annotations and null checks throughout the code to ensure type safety.

💻 View my work • React 👍 or 👎

Copy link
Author

codegen-sh bot commented May 15, 2025

I see a check failed - I'm on it! 🫡

💻 View my work

Copy link
Author

codegen-sh bot commented May 15, 2025

✅ Fixed the failing pre-commit checks in this commit. The issues were related to ruff linting rules, including:

  1. Replaced Python 3.10+ type annotations (str | None) with Optional[str] for better compatibility
  2. Fixed exception handling in logging statements
  3. Improved import organization
  4. Fixed other minor formatting issues

The PR should now pass all checks.

💻 View my work • React 👍 or 👎

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.

2 participants