🛠 Ultralytics Source Trace

Welcome to the ultralytics/source-trace repository! This specialized tool from Ultralytics is designed to analyze and report potential code duplication between different Git repositories. Building upon the standard Ultralytics Python project template, source-trace focuses specifically on enhancing code integrity and tracking. It empowers developers by identifying code segments that might be copied across repositories, offering detailed insights into the source, destination, and associated metadata for each instance of duplication.

✨ Features

Detailed Comparison: Prints every line of code from the source repository that also appears in the destination repository, after filtering out short lines and common boilerplate.
Summary Statistics: Reports the file and line totals for each repository, the number of duplicated lines found, and how many distinct files on each side those lines came from.
Provenance Pairs: Records the source file and destination file alongside each duplicated line, so every match can be traced back to both repositories.

🚀 Getting Started

To begin using source-trace for your analysis:

Clone the Repository: Use Git clone to copy source-trace to your local machine or server.
```
git clone https://github.com/ultralytics/source-trace.git
cd source-trace
```
Install Dependencies: Install the required Python packages using pip. We recommend using a virtual environment.
```
pip install -e .
```
Set Up Your Analysis: Edit SOURCE_REPO, DEST_REPO, SUFFIXES, and ignore lists in source/run_repo.py to match the repositories and file types you want to compare.
Run the Tool: Execute the comparison script directly:
```
python source/run_repo.py
```

💡 Contribute

Ultralytics thrives on community collaboration, and we deeply appreciate your contributions! Please review our Contributing Guide for detailed information on how you can get involved. We also encourage you to share your feedback through our Survey. A heartfelt thank you 🙏 goes out to all our contributors!

📄 License

Ultralytics offers two licensing options to accommodate diverse needs:

AGPL-3.0 License: This OSI-approved open-source license is ideal for students, enthusiasts, and researchers who value open collaboration and knowledge sharing. See the LICENSE file for details.
Enterprise License: Designed for commercial use, this license permits seamless integration of Ultralytics software and AI models into commercial products and services, bypassing the open-source requirements of AGPL-3.0. For enterprise solutions, please contact us via Ultralytics Licensing.

📮 Contact

For bug reports or feature suggestions related to source-trace, please raise an issue on GitHub Issues. You're also welcome to join our Discord community for discussions, questions, and support!