bs-python-utils 0.9.3__tar.gz → 1.0__tar.gz

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bs-python-utils
-Version: 0.9.3
+Version: 1.0
 Summary: Utilities programs for my Python code
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -16,7 +16,7 @@ Requires-Dist: numpy>=2.3.3
 Requires-Dist: pandas>=2.3.2
 Requires-Dist: pre-commit>=4.3.0
 Requires-Dist: pytest>=8.4.2
-Requires-Dist: mypy
+Requires-Dist: mypy>=1.18
 Requires-Dist: ruff>=0.14.0
 Requires-Dist: scikit-learn>=1.7.2
 Requires-Dist: scipy>=1.16.2
@@ -25,16 +25,18 @@ Requires-Dist: statsmodels>=0.14.5
 Requires-Dist: streamlit>=1.49.1
 Requires-Dist: vega-datasets>=0.9.0
 Requires-Dist: colorama>=0.4.6
-Requires-Dist: pyarrow>=21.0.0
+Requires-Dist: pyarrow>=23.0.0
 Dynamic: license-file
 
 ## bs-python-utils
 
+[![PyPI version](https://img.shields.io/pypi/v/bs-python-utils)](https://pypi.org/project/bs-python-utils/)
+[![Release](https://img.shields.io/github/v/release/bsalanie/bs-python-utils)](https://github.com/bsalanie/bs-python-utils/releases)
+[![Build status](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/main.yml?branch=main)](https://github.com/bsalanie/bs-python-utils/actions/workflows/main.yml?query=branch%3Amain)
+[![Tests](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/tests.yml?branch=main&label=tests)](https://github.com/bsalanie/bs-python-utils/actions/workflows/tests.yml?query=branch%3Amain)
+[![Commit activity](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils)](https://github.com/bsalanie/bs-python-utils/commits/main)
 ![GitHub last commit](https://img.shields.io/github/last-commit/bsalanie/bs-python-utils)
-
-<!-- [![Release](https://img.shields.io/github/v/release/bsalanie/bs-python-utils)](https://img.shields.io/github/v/release/bsalanie/bs-python-utils) -->
-
-[![Build status](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/main.yml?branch=main)](https://github.com/bsalanie/bs-python-utils/actions/workflows/main.yml?query=branch%3Amain) <!-- [![codecov](https://codecov.io/gh/bsalanie/bs-python-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/bsalanie/bs-python-utils) --> <!-- [![Commit activity](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils)](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils) --> [![License](https://img.shields.io/github/license/bsalanie/bs-python-utils)](https://img.shields.io/github/license/bsalanie/bs-python-utils)
+[![License](https://img.shields.io/github/license/bsalanie/bs-python-utils)](https://img.shields.io/github/license/bsalanie/bs-python-utils)
 
 **My Python utilities**.
 
@@ -43,6 +45,9 @@ Dynamic: license-file
 
 ### Release notes
 
+#### 1.0 (May 9, 2026)
+Created subpackages (no change in the API).
+
 #### 0.9 (March 18, 2026)
 Improved bivariate quantiles.
 

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/README.md

@@ -1,10 +1,12 @@
 ## bs-python-utils
 
+[![PyPI version](https://img.shields.io/pypi/v/bs-python-utils)](https://pypi.org/project/bs-python-utils/)
+[![Release](https://img.shields.io/github/v/release/bsalanie/bs-python-utils)](https://github.com/bsalanie/bs-python-utils/releases)
+[![Build status](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/main.yml?branch=main)](https://github.com/bsalanie/bs-python-utils/actions/workflows/main.yml?query=branch%3Amain)
+[![Tests](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/tests.yml?branch=main&label=tests)](https://github.com/bsalanie/bs-python-utils/actions/workflows/tests.yml?query=branch%3Amain)
+[![Commit activity](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils)](https://github.com/bsalanie/bs-python-utils/commits/main)
 ![GitHub last commit](https://img.shields.io/github/last-commit/bsalanie/bs-python-utils)
-
-<!-- [![Release](https://img.shields.io/github/v/release/bsalanie/bs-python-utils)](https://img.shields.io/github/v/release/bsalanie/bs-python-utils) -->
-
-[![Build status](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/main.yml?branch=main)](https://github.com/bsalanie/bs-python-utils/actions/workflows/main.yml?query=branch%3Amain) <!-- [![codecov](https://codecov.io/gh/bsalanie/bs-python-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/bsalanie/bs-python-utils) --> <!-- [![Commit activity](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils)](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils) --> [![License](https://img.shields.io/github/license/bsalanie/bs-python-utils)](https://img.shields.io/github/license/bsalanie/bs-python-utils)
+[![License](https://img.shields.io/github/license/bsalanie/bs-python-utils)](https://img.shields.io/github/license/bsalanie/bs-python-utils)
 
 **My Python utilities**.
 
@@ -13,6 +15,9 @@
 
 ### Release notes
 
+#### 1.0 (May 9, 2026)
+Created subpackages (no change in the API).
+
 #### 0.9 (March 18, 2026)
 Improved bivariate quantiles.
 

bs_python_utils-1.0/bs_python_utils/Timer.py

@@ -0,0 +1 @@
+from bs_python_utils.core.Timer import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bivariate_quantiles.py

@@ -0,0 +1 @@
+from bs_python_utils.stats.bivariate_quantiles import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_altair.py

@@ -0,0 +1 @@
+from bs_python_utils.viz.bs_altair import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_logging.py

@@ -0,0 +1 @@
+from bs_python_utils.core.bs_logging import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_mathstr.py

@@ -0,0 +1 @@
+from bs_python_utils.core.bs_mathstr import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_mem.py

@@ -0,0 +1 @@
+from bs_python_utils.core.bs_mem import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_opt.py

@@ -0,0 +1 @@
+from bs_python_utils.opt.bs_opt import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_plots.py

@@ -0,0 +1 @@
+from bs_python_utils.viz.bs_plots import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_seaborn.py

@@ -0,0 +1 @@
+from bs_python_utils.viz.bs_seaborn import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bs_sparse_gaussian.py

@@ -0,0 +1 @@
+from bs_python_utils.numerical.bs_sparse_gaussian import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bsmplutils.py

@@ -0,0 +1 @@
+from bs_python_utils.viz.bsmplutils import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bsnputils.py

@@ -0,0 +1 @@
+from bs_python_utils.numerical.bsnputils import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bssputils.py

@@ -0,0 +1 @@
+from bs_python_utils.numerical.bssputils import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bsstats.py

@@ -0,0 +1 @@
+from bs_python_utils.stats.bsstats import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/bsutils.py

@@ -0,0 +1 @@
+from bs_python_utils.core.bsutils import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/chebyshev.py

@@ -0,0 +1 @@
+from bs_python_utils.numerical.chebyshev import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/distance_covariances.py

@@ -0,0 +1 @@
+from bs_python_utils.stats.distance_covariances import *  # noqa: F401, F403

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_altair.py

@@ -5,7 +5,7 @@ import numpy as np
 from vega_datasets import data
 
 
-from bs_python_utils.bs_altair import (
+from bs_python_utils.viz.bs_altair import (
     alt_boxes,
     alt_density,
     alt_faceted_densities,

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_distance_covariances.py

@@ -2,7 +2,11 @@
 
 import numpy as np
 
-from bs_python_utils.distance_covariances import dcov_dcor, pdcov_pdcor, pvalue_pdcov
+from bs_python_utils.stats.distance_covariances import (
+    dcov_dcor,
+    pdcov_pdcor,
+    pvalue_pdcov,
+)
 
 # example page 2396 of Szekely and Rizzo 2014
 n = 2000

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_mem.py

@@ -4,7 +4,7 @@ import tracemalloc
 
 import numpy as np
 
-from bs_python_utils.bs_mem import (
+from bs_python_utils.core.bs_mem import (
     memory_display_top,
     memory_display_top_diffs,
     memory_usage,

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_mpl.py

@@ -2,7 +2,7 @@
 
 import numpy as np
 
-from bs_python_utils.bsmplutils import bs_mpl_plot_dcm_fit
+from bs_python_utils.viz.bsmplutils import bs_mpl_plot_dcm_fit
 
 n_obs = 100
 n_y = 4

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_opt.py

@@ -2,14 +2,14 @@
 
 import numpy as np
 
-from bs_python_utils.bs_opt import (
+from bs_python_utils.core.bsutils import print_stars
+from bs_python_utils.numerical.bssputils import describe_array
+from bs_python_utils.opt.bs_opt import (
     acc_grad_descent,
     armijo_alpha,
     barzilai_borwein_alpha,
     minimize_some_fixed,
 )
-from bs_python_utils.bssputils import describe_array
-from bs_python_utils.bsutils import print_stars
 
 print_stars("Testing acc_grad_descent")
 

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_seaborn.py

@@ -3,7 +3,11 @@
 import matplotlib.pyplot as plt
 import seaborn as sns
 
-from bs_python_utils.bs_seaborn import bs_regplot, bs_sns_bar_x_byf, bs_sns_bar_x_byfg
+from bs_python_utils.viz.bs_seaborn import (
+    bs_regplot,
+    bs_sns_bar_x_byf,
+    bs_sns_bar_x_byfg,
+)
 
 cars = sns.load_dataset("mpg")
 

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_sklearn.py

@@ -4,7 +4,7 @@ import matplotlib.pyplot as plt
 import numpy as np
 from sklearn.preprocessing import PolynomialFeatures, StandardScaler
 
-from bs_python_utils.sklearn_utils import skl_npreg_lasso
+from bs_python_utils.data_anal.sklearn_utils import skl_npreg_lasso
 
 n_obs = 10000
 X1 = -2.0 + 3.0 * np.random.uniform(size=n_obs)

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils/examples/examples_sparse_gaussian.py

@@ -1,9 +1,10 @@
 """Integrate x -> x**4 over N(0, 1) using the sparse Gaussian grids."""
 
 from typing import cast
+
 import numpy as np
 
-from bs_python_utils.bs_sparse_gaussian import setup_sparse_gaussian
+from bs_python_utils.numerical.bs_sparse_gaussian import setup_sparse_gaussian
 
 
 def sum_x_to_the_fourth(x: np.ndarray) -> np.ndarray:

bs_python_utils-1.0/bs_python_utils/pandas_utils.py

@@ -0,0 +1 @@
+from bs_python_utils.data_anal.pandas_utils import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/sklearn_utils.py

@@ -0,0 +1 @@
+from bs_python_utils.data_anal.sklearn_utils import *  # noqa: F401, F403

bs_python_utils-1.0/bs_python_utils/streamlit_utils.py

@@ -0,0 +1 @@
+from bs_python_utils.viz.streamlit_utils import *  # noqa: F401, F403

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bs-python-utils
-Version: 0.9.3
+Version: 1.0
 Summary: Utilities programs for my Python code
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -16,7 +16,7 @@ Requires-Dist: numpy>=2.3.3
 Requires-Dist: pandas>=2.3.2
 Requires-Dist: pre-commit>=4.3.0
 Requires-Dist: pytest>=8.4.2
-Requires-Dist: mypy
+Requires-Dist: mypy>=1.18
 Requires-Dist: ruff>=0.14.0
 Requires-Dist: scikit-learn>=1.7.2
 Requires-Dist: scipy>=1.16.2
@@ -25,16 +25,18 @@ Requires-Dist: statsmodels>=0.14.5
 Requires-Dist: streamlit>=1.49.1
 Requires-Dist: vega-datasets>=0.9.0
 Requires-Dist: colorama>=0.4.6
-Requires-Dist: pyarrow>=21.0.0
+Requires-Dist: pyarrow>=23.0.0
 Dynamic: license-file
 
 ## bs-python-utils
 
+[![PyPI version](https://img.shields.io/pypi/v/bs-python-utils)](https://pypi.org/project/bs-python-utils/)
+[![Release](https://img.shields.io/github/v/release/bsalanie/bs-python-utils)](https://github.com/bsalanie/bs-python-utils/releases)
+[![Build status](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/main.yml?branch=main)](https://github.com/bsalanie/bs-python-utils/actions/workflows/main.yml?query=branch%3Amain)
+[![Tests](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/tests.yml?branch=main&label=tests)](https://github.com/bsalanie/bs-python-utils/actions/workflows/tests.yml?query=branch%3Amain)
+[![Commit activity](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils)](https://github.com/bsalanie/bs-python-utils/commits/main)
 ![GitHub last commit](https://img.shields.io/github/last-commit/bsalanie/bs-python-utils)
-
-<!-- [![Release](https://img.shields.io/github/v/release/bsalanie/bs-python-utils)](https://img.shields.io/github/v/release/bsalanie/bs-python-utils) -->
-
-[![Build status](https://img.shields.io/github/actions/workflow/status/bsalanie/bs-python-utils/main.yml?branch=main)](https://github.com/bsalanie/bs-python-utils/actions/workflows/main.yml?query=branch%3Amain) <!-- [![codecov](https://codecov.io/gh/bsalanie/bs-python-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/bsalanie/bs-python-utils) --> <!-- [![Commit activity](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils)](https://img.shields.io/github/commit-activity/m/bsalanie/bs-python-utils) --> [![License](https://img.shields.io/github/license/bsalanie/bs-python-utils)](https://img.shields.io/github/license/bsalanie/bs-python-utils)
+[![License](https://img.shields.io/github/license/bsalanie/bs-python-utils)](https://img.shields.io/github/license/bsalanie/bs-python-utils)
 
 **My Python utilities**.
 
@@ -43,6 +45,9 @@ Dynamic: license-file
 
 ### Release notes
 
+#### 1.0 (May 9, 2026)
+Created subpackages (no change in the API).
+
 #### 0.9 (March 18, 2026)
 Improved bivariate quantiles.
 

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/bs_python_utils.egg-info/requires.txt

@@ -9,7 +9,7 @@ numpy>=2.3.3
 pandas>=2.3.2
 pre-commit>=4.3.0
 pytest>=8.4.2
-mypy
+mypy>=1.18
 ruff>=0.14.0
 scikit-learn>=1.7.2
 scipy>=1.16.2
@@ -18,4 +18,4 @@ statsmodels>=0.14.5
 streamlit>=1.49.1
 vega-datasets>=0.9.0
 colorama>=0.4.6
-pyarrow>=21.0.0
+pyarrow>=23.0.0

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bs-python-utils"
-version = "0.9.3"
+version = "1.0"
 description = "Utilities programs for my Python code"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -16,7 +16,7 @@ dependencies = [
     "pandas>=2.3.2",
     "pre-commit>=4.3.0",
     "pytest>=8.4.2",
-    "mypy",
+    "mypy>=1.18",
     "ruff>=0.14.0",
     "scikit-learn>=1.7.2",
     "scipy>=1.16.2",
@@ -25,7 +25,7 @@ dependencies = [
     "streamlit>=1.49.1",
     "vega-datasets>=0.9.0",
     "colorama>=0.4.6",
-    "pyarrow>=21.0.0",
+    "pyarrow>=23.0.0",
 ]
 
 [tool.setuptools]

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_bivariate_quantiles.py

@@ -1,10 +1,10 @@
 import numpy as np
 
-from bs_python_utils.bivariate_quantiles import (
+from bs_python_utils.numerical.bsnputils import npmaxabs
+from bs_python_utils.stats.bivariate_quantiles import (
     _compute_ad,
     _solve_for_v,
 )
-from bs_python_utils.bsnputils import npmaxabs
 
 
 def test_bivariate_ranks():
@@ -24,7 +24,7 @@ def test_bivariate_ranks():
             y[:, 1] == y[k, 1]
         )
 
-    assert npmaxabs(bivranks - bivranks_th) < 0.01
+    assert npmaxabs(bivranks - bivranks_th) < 0.1
 
 
 def test_compute_ad():

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_bs_opt.py

@@ -1,6 +1,6 @@
 import numpy as np
 
-from bs_python_utils import bs_opt
+from bs_python_utils.opt import bs_opt
 
 
 def quadratic_objective(x, args):

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_bs_sparse_gaussian.py

@@ -2,7 +2,7 @@ from math import isclose
 
 import numpy as np
 
-from bs_python_utils.bs_sparse_gaussian import setup_sparse_gaussian
+from bs_python_utils.numerical.bs_sparse_gaussian import setup_sparse_gaussian
 
 
 def test_sparse_gaussian():

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_bsnputils.py

@@ -2,7 +2,8 @@ from math import exp, isclose, log, pi, sqrt
 
 import numpy as np
 
-from bs_python_utils.bsnputils import (
+from bs_python_utils.core.bsutils import bsexp, bslog
+from bs_python_utils.numerical.bsnputils import (
     bs_sqrt_pdmatrix,
     bsgrid,
     ecdf,
@@ -23,7 +24,6 @@ from bs_python_utils.bsnputils import (
     print_quantiles,
     rice_stderr,
 )
-from bs_python_utils.bsutils import bsexp, bslog
 
 
 def test_print_quantiles_vec():

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_bssputils.py

@@ -1,7 +1,7 @@
 import numpy as np
 import scipy.stats as sts
 
-from bs_python_utils import bssputils
+from bs_python_utils.numerical import bssputils
 
 
 def test_describe_array_reports_std_deviation(capsys):

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_bsstats.py

@@ -1,6 +1,6 @@
 import numpy as np
 
-from bs_python_utils import bsstats
+from bs_python_utils.stats import bsstats
 
 
 def test_proj_Z_multivariate_degree_two():

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_bsutils.py

@@ -2,7 +2,7 @@ from math import exp, isclose, log, sqrt
 
 import numpy as np
 
-from bs_python_utils.bsutils import (
+from bs_python_utils.core.bsutils import (
     bs_projection_point,
     bs_switch,
     bscomb,

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_chebyshev.py

@@ -3,9 +3,9 @@ from math import exp, isclose, sqrt
 import numpy as np
 import pytest
 
-from bs_python_utils.bsnputils import FloatOrArray, bsgrid
-from bs_python_utils.bsutils import bs_error_abort
-from bs_python_utils.chebyshev import (
+from bs_python_utils.core.bsutils import bs_error_abort
+from bs_python_utils.numerical.bsnputils import FloatOrArray, bsgrid
+from bs_python_utils.numerical.chebyshev import (
     Interval,
     Rectangle,
     cheb_eval_fun_at_nodes_1d,

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_nptri.py

@@ -1,6 +1,6 @@
 import numpy as np
 
-from bs_python_utils.bsnputils import set_elements_abovebelow_diagonal
+from bs_python_utils.numerical.bsnputils import set_elements_abovebelow_diagonal
 
 
 def test_nptril():

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_random_draws.py

@@ -1,6 +1,6 @@
 import numpy as np
 
-from bs_python_utils.bsstats import emcee_draw, kde_resample
+from bs_python_utils.stats.bsstats import emcee_draw, kde_resample
 
 
 def log_gauss2(x, *args):

{bs_python_utils-0.9.3 → bs_python_utils-1.0}/tests/test_sklearn_utils.py

@@ -1,8 +1,9 @@
-import numpy as np
+from typing import cast
 
 import matplotlib.pyplot as plt
+import numpy as np
 
-from bs_python_utils import sklearn_utils
+from bs_python_utils.data_anal import sklearn_utils
 
 
 def test_skl_npreg_lasso_returns_predictions_and_model():
@@ -29,7 +30,7 @@ def test_skl_npreg_lasso_returns_predictions_and_model():
     assert model.named_steps["lasso"].fit_intercept is False
 
     # ensure pipeline can predict out-of-sample without errors
-    preds_new = model.predict(X[:5])
+    preds_new = cast(np.ndarray, model.predict(X[:5]))
     assert preds_new.shape == (5,)
 
 

bs_python_utils-0.9.3/bs_python_utils/Timer.py

@@ -1,81 +0,0 @@
-"""
-Utilities to time code:
-
-* a `Timer` class that can be used as a context manager
-* a `timeit` decorator for functions.
-"""
-
-import time
-from functools import wraps
-from typing import Any, Callable, Iterable
-
-
-def timeit(func: Callable) -> Callable:
-    """
-    Decorator to time a function
-    """
-
-    @wraps(func)
-    def wrapper(*args: Iterable, **kwargs: dict) -> Any:
-        start = time.perf_counter()
-        result = func(*args, **kwargs)
-        end = time.perf_counter()
-        print(f"{func.__name__} executed in {end - start:.3f} seconds")
-        return result
-
-    return wrapper
-
-
-class Timer:
-    """
-    A timer that can be started, stopped, and reset as needed by the user.
-    It keeps track of the total elapsed time in the `elapsed` attribute::
-
-    Examples:
-        >>> with Timer() as t:
-        >>>  ....
-        >>> print(f"... took {t.elapsed} seconds")
-
-    use `Timer(time.process_time)` to get only CPU time.
-
-    can also do:
-
-    Examples:
-        >>> t = Timer()
-        >>> t.start()
-        >>> t.stop()
-        >>> t.start()   # will add to the same counter
-        >>> t.stop()
-        >>> print(f"{t.elapsed} seconds total")
-    """
-
-    def __init__(self, func: Callable = time.perf_counter) -> None:
-        self.elapsed = 0.0
-        self._func = func
-        self._start = None
-
-    def start(self) -> None:
-        if self._start is not None:
-            raise RuntimeError("Already started")
-        self._start = self._func()
-
-    def stop(self) -> None:
-        if self._start is None:
-            raise RuntimeError("Not started")
-        end = self._func()
-        self.elapsed += end - self._start
-        self._start = None
-
-    def reset(self) -> None:
-        self.elapsed = 0.0
-
-    @property
-    def running(self) -> bool:
-        return self._start is not None
-
-    def __enter__(self) -> Any:
-        self.start()
-        return self
-
-    def __exit__(self, *args: Iterable) -> None:
-        self.stop()