depweaver 0.1.0

A smart dependency resolver for Python data science projects.

PyResolve 🧩

PyResolve is an intelligent Python dependency resolver designed to tackle the complex compatibility challenges of data science and machine learning environments.

It navigates "dependency hell" by analyzing the entire dependency graph for your project, including nested and conditional dependencies, and uses a backtracking algorithm to find a set of package versions that are guaranteed to be compatible with each other.

---

## The Problem

Ever seen errors like these?

• ModuleNotFoundError: No module named 'requests'
• InvalidVersion: Invalid version
• A long traceback caused by conflicting versions of numpy.

These issues arise when different packages in your project require incompatible versions of the same underlying library. PyResolve is built to solve this problem automatically.

---

## How to Use

1. Create a target.txt file in your project's root directory. List the high-level packages you want to use, one per line.

   # target.txt
   
   pandas
   tensorflow
   scikit-learn
   matplotlib
   

2. Run PyResolve. From your terminal, simply run the pyresolve command.

   pyresolve
   

3. Get Your Results. PyResolve will do the hard work and generate a complete, stable requirements.txt file for you. You can then install it with confidence.

   pip install -r requirements.txt
   

---

## Features

• Deep Graph Traversal: Explores the entire dependency tree, not just top-level requirements.
• Intelligent Conflict Resolution: Uses a backtracking solver to find a working set of versions, even with complex conflicts.
• Environment Aware: Understands conditional dependencies and only resolves packages that are compatible with your Python version and OS.
• Fast Caching: Caches package metadata locally to make subsequent runs feel instant.