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:
-
Clone the repository:
git clone https://github.com/ad3002/code2claude
-
Navigate to the project directory:
cd code2claude
-
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, eitherxml
orraw
(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:
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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
Release history Release notifications | RSS feed
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
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9d6be27bf2363cb2c38a72bcf5c9ede2377fac9c27382a1f681d53c046f88278 |
|
MD5 | b7f805a936dcbccf678d71ec7a92239b |
|
BLAKE2b-256 | b4e768283ed467e119d40c604b0c4fe4220313d7100a74d9db2096d84cf1023a |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56eec01a700a1b1f7c682a3df0674cf02c1bd6a07630b9b5e5f66bb071e73661 |
|
MD5 | afb906210f97b043570822d4b33eea8c |
|
BLAKE2b-256 | fd9ba155b5e209ca5b59af93c2f3dd05f2860ca00c7c9a8b420fe461dca30c0b |