__init__.py

"""
Algorithm Recommender System
============================

A research-grade algorithm recommendation system that automatically selects
the optimal algorithm for sorting, array searching, and graph searching
problems based on instance-level feature extraction and machine learning.

Key Features:
- Automatic feature extraction from raw input (no precomputed features needed)
- ML-based algorithm selection using RandomForest classifiers
- Strict correctness constraints for searching algorithms
- Human-readable explanations for all recommendations
- Modular, extensible architecture

Domains Supported:
1. SORTING: Insertion, Selection, Merge, Quick, Heap Sort
2. ARRAY SEARCHING: Linear, Binary, Jump, Exponential Search
3. GRAPH SEARCHING: BFS, Dijkstra, Bellman-Ford, A*

Quick Start:
    from algorithm_recommender import AlgorithmRecommender

    recommender = AlgorithmRecommender()
    recommender.train_all()  # Or load_models() if pre-trained

    # Sorting
    result = recommender.recommend_sorting([5, 2, 8, 1, 9])
    print(result['algorithm'], result['explanation'])

    # Array search
    result = recommender.recommend_array_search([1, 2, 3, 4, 5])

    # Graph search
    graph = {0: [(1, 1.0)], 1: [(2, 1.0)], 2: []}
    result = recommender.recommend_graph_search(graph)

Author: Algorithm Recommender Research Team
Version: 1.0.0
License: MIT
"""

__version__ = '1.0.0'
__author__ = 'Algorithm Recommender Research Team'

from .unified_interface import AlgorithmRecommender

# Make key classes easily accessible
from .sorting import (
    SortingRecommender,
    SortingFeatureExtractor,
    SORTING_ALGORITHMS
)
from .searching.array_search import (
    ArraySearchRecommender,
    ArraySearchFeatureExtractor,
    ARRAY_SEARCH_ALGORITHMS
)
from .searching.graph_search import (
    GraphSearchRecommender,
    GraphSearchFeatureExtractor,
    GRAPH_SEARCH_ALGORITHMS
)

__all__ = [
    'AlgorithmRecommender',
    'SortingRecommender',
    'SortingFeatureExtractor',
    'SORTING_ALGORITHMS',
    'ArraySearchRecommender',
    'ArraySearchFeatureExtractor',
    'ARRAY_SEARCH_ALGORITHMS',
    'GraphSearchRecommender',
    'GraphSearchFeatureExtractor',
    'GRAPH_SEARCH_ALGORITHMS'
]