Skip to main content

A Python tool that consolidates code from a repository into a unified format for AI-assisted analysis and manipulation.

Project description

Here’s the updated README file to match the provided code and setup configuration:


code2claude: Code Consolidator

A Python tool that consolidates code from a repository into a unified format for AI-assisted analysis and manipulation.

Code Consolidator is a Python tool that traverses a code repository, extracts code from specified files, and consolidates it into a unified format. The consolidated code is optimized for AI-assisted analysis and manipulation, enabling seamless collaboration between humans and AI in understanding and working with the codebase.

Features

  • Traverse a repository: Identifies relevant code files based on specified file extensions.
  • Code extraction: Extracts code from each file without any preprocessing.
  • Code consolidation: Consolidates the extracted code into a single, unified format (XML or raw).
  • Metadata inclusion: Includes file paths for context.
  • Skip options: Optionally skips test files and specified folders.
  • Selective inclusion: Filters files containing a specified string in the file path.

Installation

From PyPI:

pip install code2claude

From source:

  1. Clone the repository:

    git clone https://github.com/ad3002/code2claude
    
  2. Navigate to the project directory:

    cd code2claude
    
  3. Install the required dependencies:

    pip install -r requirements.txt
    

Usage

python code2claude.py -r /path/to/repo -o output.xml -f xml --skiptests --skipfolders folder1,folder2 --contain keyword -e .py .js
  • -r/--repo_path: Path to the code repository (required).
  • -o/--output_file: Path to the output file (default: consolidated_code.code).
  • -f/--format: Output format, either xml or raw (default: xml).
  • --skiptests: Skip test files that contain "test" in their name (default: False).
  • -s/--skipfolders: Comma-separated list of folders to skip (default: False).
  • --contain: Include files containing this string in the file path.
  • -e/--extensions: Space-separated list of file extensions to include (default: .py).

Example Command

python code2claude.py -r /path/to/repo -o consolidated_code.xml -f xml --skiptests True -s folder_to_skip --contain utils -e .py .java

Output Formats

XML Format:

<file>
   <path>/path/to/file.py</path>
   <content>
      # Python code here
   </content>
</file>

...

Raw Format:

###### /path/to/file.py ###
# Python code here
###### end of file /path/to/file.py ###

Possbile prompt for the AI system

<prompt>
   <consolidated_code>
      <instruction>Claude, please, see the attached file</instruction>
   </consolidated_code>

   <question>
   Your question or request goes here. For example:
   - Can you identify any potential performance issues in the code?
   - How can I refactor the code to improve readability and maintainability?
   - Are there any security vulnerabilities or best practices violations in the code?
   </question>
</prompt>

How to improve the code before running the consolidator

Remember, the specific details and format of the consolidated code may vary based on your project's needs and the programming language being used. The key is to provide a clear, organized, and well-documented representation of your codebase that facilitates effective analysis and collaboration between humans and AI.

To process the consolidated code as a whole and provide effective analysis and manipulation, there are a few additional things that would be helpful:

  1. Code Structure and Organization:

    • Clearly indicate the boundaries between different code files or modules within the consolidated code. This can be done using comments, delimiters, or specific markers.
    • Include information about the file paths or module names to provide context about the code's organization.
    • Maintain a consistent indentation level throughout the consolidated code to ensure readability.
  2. Dependency and Import Statements:

    • If the code relies on external libraries or modules, include the necessary import statements at the beginning of the consolidated code.
    • If there are inter-dependencies between the code files, ensure that the order of the consolidated code reflects the proper dependency hierarchy.
  3. Documentation and Comments:

    • Include relevant comments and documentation within the code to provide explanations and context.
    • Use docstrings to describe the purpose, parameters, and return values of functions and classes.
    • Provide high-level comments to explain the overall structure and flow of the code.
  4. Test Cases and Examples:

    • If available, include test cases or example usage of the code within the consolidated format.
    • This helps in understanding how the code is intended to be used and what expected outcomes should be.
  5. Configuration and Environment:

    • If the code relies on specific configuration files or environment variables, include them or provide instructions on how to set them up.
    • Specify any required dependencies or libraries that need to be installed for the code to run successfully.
  6. Error Handling and Logging:

    • Include error handling and logging statements within the code to aid in debugging and understanding potential issues.
    • Provide information on how to interpret and resolve common errors or exceptions that may occur.
  7. Code Analysis Preferences:

    • If you have specific preferences or requirements for code analysis, such as focusing on certain aspects like performance, security, or style, mention them along with the consolidated code.
    • This helps me tailor the analysis and provide targeted insights based on your priorities.

By incorporating these additional elements, you can provide a more comprehensive and context-rich representation of your codebase. It enables me to understand the code's structure, dependencies, and intended usage more effectively, leading to more accurate and valuable analysis and manipulation.

Contributing

Contributions are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

code2claude-0.2.9.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

code2claude-0.2.9-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file code2claude-0.2.9.tar.gz.

File metadata

  • Download URL: code2claude-0.2.9.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.19

File hashes

Hashes for code2claude-0.2.9.tar.gz
Algorithm Hash digest
SHA256 9d6be27bf2363cb2c38a72bcf5c9ede2377fac9c27382a1f681d53c046f88278
MD5 b7f805a936dcbccf678d71ec7a92239b
BLAKE2b-256 b4e768283ed467e119d40c604b0c4fe4220313d7100a74d9db2096d84cf1023a

See more details on using hashes here.

File details

Details for the file code2claude-0.2.9-py3-none-any.whl.

File metadata

  • Download URL: code2claude-0.2.9-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.19

File hashes

Hashes for code2claude-0.2.9-py3-none-any.whl
Algorithm Hash digest
SHA256 56eec01a700a1b1f7c682a3df0674cf02c1bd6a07630b9b5e5f66bb071e73661
MD5 afb906210f97b043570822d4b33eea8c
BLAKE2b-256 fd9ba155b5e209ca5b59af93c2f3dd05f2860ca00c7c9a8b420fe461dca30c0b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page