refactor the api and tests

Author: soodoku

allocator/__init__.py

@@ -1,10 +1,50 @@
 """
 Allocator package for clustering and routing optimization.
+
+Modern Pythonic API for geographic task allocation, clustering, and routing.
 """
 
 import logging
 import sys
 
+# Import modern API
+from .api import (
+    cluster, kmeans, kahip,
+    shortest_path, tsp_christofides, tsp_ortools, tsp_osrm, tsp_google,
+    sort_by_distance, assign_to_closest,
+    ClusterResult, RouteResult, SortResult, ComparisonResult
+)
+
+# Version
+__version__ = "1.0.0"
+
+# Export public API
+__all__ = [
+    # Main functions
+    'cluster',
+    'shortest_path', 
+    'sort_by_distance',
+    'assign_to_closest',
+    
+    # Specific methods
+    'kmeans',
+    'kahip',
+    'tsp_christofides',
+    'tsp_ortools', 
+    'tsp_osrm',
+    'tsp_google',
+    
+    # Result types
+    'ClusterResult',
+    'RouteResult',
+    'SortResult', 
+    'ComparisonResult',
+    
+    # Utilities
+    'setup_logging',
+    'get_logger',
+]
+
 
 def setup_logging(level=logging.INFO):
     """

allocator/algorithms.py

@@ -0,0 +1,36 @@
+"""
+Public API for allocator package.
+
+This module provides a modern, Pythonic interface to the allocator package.
+"""
+from .cluster import cluster, kmeans, kahip
+from .route import shortest_path, tsp_christofides, tsp_ortools, tsp_osrm, tsp_google
+from .distance import sort_by_distance, assign_to_closest, distance_assignment
+from .types import ClusterResult, RouteResult, SortResult, ComparisonResult
+
+__all__ = [
+    # Main high-level functions
+    'cluster',
+    'shortest_path', 
+    'sort_by_distance',
+    
+    # Specific clustering methods
+    'kmeans',
+    'kahip',
+    
+    # Specific routing methods
+    'tsp_christofides',
+    'tsp_ortools',
+    'tsp_osrm',
+    'tsp_google',
+    
+    # Distance assignment methods
+    'assign_to_closest',
+    'distance_assignment',
+    
+    # Result types
+    'ClusterResult',
+    'RouteResult', 
+    'SortResult',
+    'ComparisonResult',
+]