move modules to private for now

SimonBlanke · SimonBlanke · commit 1a9a92f63090 · 2026-04-11T11:03:37.000+02:00
diff --git a/docs/source/api_reference.rst b/docs/source/api_reference.rst
@@ -220,43 +220,3 @@ Control output during search:
     verbosity = ["progress_bar"]      # Progress bar only
     verbosity = ["print_results"]     # Print final results
     verbosity = ["progress_bar", "print_results"]  # Both (default)
-
-
-Distributed Evaluation
-----------------------
-
-Backends for parallel objective function evaluation. Sync backends evaluate
-full batches, async backends process results as they arrive.
-
-.. code-block:: python
-
-    from gradient_free_optimizers.distributed import Joblib, Ray, Dask
-
-.. autosummary::
-    :toctree: api_reference/generated/
-    :template: class.rst
-
-    gradient_free_optimizers.distributed.BaseDistribution
-    gradient_free_optimizers.distributed.Multiprocessing
-    gradient_free_optimizers.distributed.Joblib
-    gradient_free_optimizers.distributed.Ray
-    gradient_free_optimizers.distributed.Dask
-
-
-Evaluation Storage
-------------------
-
-Pluggable backends for caching objective function evaluations. Pass a storage
-instance to the ``memory`` parameter of ``search()``.
-
-.. code-block:: python
-
-    from gradient_free_optimizers.storage import SQLiteStorage
-
-.. autosummary::
-    :toctree: api_reference/generated/
-    :template: class.rst
-
-    gradient_free_optimizers.storage.BaseStorage
-    gradient_free_optimizers.storage.MemoryStorage
-    gradient_free_optimizers.storage.SQLiteStorage
diff --git a/docs/source/user_guide.rst b/docs/source/user_guide.rst
@@ -149,13 +149,6 @@ Guide Sections
       Using the simple ``.search()``
       method.
 
-   .. grid-item-card:: Evaluation Storage
-      :link: user_guide/storage
-      :link-type: doc
-
-      Persistent caching and crash
-      recovery with pluggable backends.
-
 ----
 
 Algorithms
@@ -219,7 +212,6 @@ GFO provides 22 optimization algorithms organized into four categories:
    user_guide/memory
    user_guide/stopping_conditions
    user_guide/search_interface
-   user_guide/storage
 
 .. toctree::
    :maxdepth: 2
diff --git a/docs/source/user_guide/distributed.rst b/docs/source/user_guide/distributed.rst
@@ -191,27 +191,6 @@ failed evaluation:
     opt.search(flaky_model, n_iter=100, catch={ValueError: -1000.0})
 
 
-Storage Integration
--------------------
-
-Distributed evaluation works with :doc:`storage backends <storage>`. Positions
-are checked against the cache before being dispatched to workers, and new
-results are stored after evaluation. This avoids redundant computations and
-enables crash recovery:
-
-.. code-block:: python
-
-    from gradient_free_optimizers.distributed import Joblib
-    from gradient_free_optimizers.storage import SQLiteStorage
-
-    @Joblib(n_workers=4).distribute
-    def model(para):
-        return expensive_training(para)
-
-    storage = SQLiteStorage("results.db")
-    opt.search(model, n_iter=100, memory=storage)
-
-
 Custom Backends
 ---------------
 
diff --git a/src/gradient_free_optimizers/_memory.py b/src/gradient_free_optimizers/_memory.py
@@ -10,7 +10,7 @@
 import pandas as pd
 
 from ._objective_adapter import ObjectiveAdapter
-from .storage import BaseStorage, MemoryStorage
+from ._storage import BaseStorage, MemoryStorage
 
 
 class CachedObjectiveAdapter(ObjectiveAdapter):
diff --git a/src/gradient_free_optimizers/_storage/__init__.py b/src/gradient_free_optimizers/_storage/__init__.py
@@ -3,7 +3,7 @@
 Storage backends control where objective function evaluation results are
 persisted. They can be passed to the ``memory`` parameter of ``search()``::
 
-    from gradient_free_optimizers.storage import SQLiteStorage
+    from gradient_free_optimizers._storage import SQLiteStorage
 
     storage = SQLiteStorage("results.db")
     opt.search(objective, n_iter=100, memory=storage)
diff --git a/src/gradient_free_optimizers/_storage/_base.py b/src/gradient_free_optimizers/_storage/_base.py
diff --git a/src/gradient_free_optimizers/_storage/_memory.py b/src/gradient_free_optimizers/_storage/_memory.py
diff --git a/src/gradient_free_optimizers/_storage/_sqlite.py b/src/gradient_free_optimizers/_storage/_sqlite.py
diff --git a/src/gradient_free_optimizers/search.py b/src/gradient_free_optimizers/search.py
@@ -22,8 +22,8 @@
 from ._results_manager import ResultsManager
 from ._search_statistics import SearchStatistics
 from ._stopping_conditions import OptimizationStopper
+from ._storage import BaseStorage
 from ._times_tracker import TimesTracker
-from .storage import BaseStorage
 
 if TYPE_CHECKING:
     import pandas as pd
@@ -212,10 +212,10 @@ def objective_with_metrics(params):
             Controls evaluation caching. When ``True``, uses an in-memory
             dictionary (equivalent to ``MemoryStorage()``). When ``False``,
             disables caching entirely. A
-            :class:`~gradient_free_optimizers.storage.BaseStorage` instance
+            :class:`~gradient_free_optimizers._storage.BaseStorage` instance
             enables custom storage backends::
 
-                from gradient_free_optimizers.storage import SQLiteStorage
+                from gradient_free_optimizers._storage import SQLiteStorage
                 opt.search(objective, memory=SQLiteStorage("results.db"))
 
             ``SQLiteStorage`` persists results to disk, enabling crash
diff --git a/tests/test_main/test_distributed.py b/tests/test_main/test_distributed.py
@@ -19,7 +19,7 @@
     Joblib,
     Multiprocessing,
 )
-from gradient_free_optimizers.storage import MemoryStorage
+from gradient_free_optimizers._storage import MemoryStorage
 
 search_space = {"x": np.linspace(-10, 10, 100), "y": np.linspace(-10, 10, 100)}
 tiny_space = {"x": np.linspace(0, 1, 10)}
diff --git a/tests/test_main/test_storage.py b/tests/test_main/test_storage.py
@@ -8,7 +8,7 @@
 
 from gradient_free_optimizers import HillClimbingOptimizer, RandomSearchOptimizer
 from gradient_free_optimizers._result import Result
-from gradient_free_optimizers.storage import BaseStorage, MemoryStorage, SQLiteStorage
+from gradient_free_optimizers._storage import BaseStorage, MemoryStorage, SQLiteStorage
 
 search_space = {"x": np.linspace(-10, 10, 100)}
 

Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@`
`19`	`19`	`Joblib,`
`20`	`20`	`Multiprocessing,`
`21`	`21`	`)`
`22`		`-from gradient_free_optimizers.storage import MemoryStorage`
	`22`	`+from gradient_free_optimizers._storage import MemoryStorage`
`23`	`23`
`24`	`24`	`search_space = {"x": np.linspace(-10, 10, 100), "y": np.linspace(-10, 10, 100)}`
`25`	`25`	`tiny_space = {"x": np.linspace(0, 1, 10)}`