deprecate instead of replace

Author: Vahid Tavanashad

CHANGELOG.md

@@ -15,7 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 * Adjusted the `pre-commit` configuration to run autoupdate weekly [#2479](https://github.com/IntelPython/dpnp/pull/2479)
 * Improved validation of `--target-hip` build option to only accept a gfx-prefixed value [#2481](https://github.com/IntelPython/dpnp/pull/2481)
 * Cleaned up backend code to remove obsolete and unused parts of functionality [#2485](https://github.com/IntelPython/dpnp/pull/2485)
-* Renamed `--onemkl-interfaces` and `--onemkl-interfaces-dir` options for building script to `--onemath` and `--onemath-dir` to align with [oneMath specification](https://oneapi-spec.uxlfoundation.org/specifications/oneapi/latest/elements/onemath/source/) [#2487](https://github.com/IntelPython/dpnp/pull/2487)
+* `--onemkl-interfaces` and `--onemkl-interfaces-dir` options for building script are deprecated, instead `--onemath` and `--onemath-dir` are introduced to be aligned with [oneMath specification](https://oneapi-spec.uxlfoundation.org/specifications/oneapi/latest/elements/onemath/source/) [#2487](https://github.com/IntelPython/dpnp/pull/2487)
 
 ### Fixed
 

scripts/build_locally.py

@@ -27,6 +27,9 @@
 import os
 import subprocess
 import sys
+import warnings
+
+warnings.simplefilter("default", DeprecationWarning)
 
 
 def run(
@@ -40,6 +43,8 @@ def run(
     cmake_opts="",
     target_cuda=None,
     target_hip=None,
+    onemkl_interfaces=False,
+    onemkl_interfaces_dir=None,
     onemath=False,
     onemath_dir=None,
 ):
@@ -98,6 +103,23 @@ def run(
         if "DPL_ROOT" in os.environ:
             os.environ["DPL_ROOT_HINT"] = os.environ["DPL_ROOT"]
 
+    # TODO: onemkl_interfaces and onemkl_interfaces_dir are deprecated in
+    # dpnp-0.19.0 and should be removed in dpnp-0.20.0.
+    if onemkl_interfaces:
+        warnings.warn(
+            "Using 'onemkl_interfaces' is deprecated. Please use 'onemath' instead.",
+            DeprecationWarning,
+            stacklevel=1,
+        )
+        onemath = True
+    if onemkl_interfaces_dir is not None:
+        warnings.warn(
+            "Using 'onemkl_interfaces_dir' is deprecated. Please use 'onemath_dir' instead.",
+            DeprecationWarning,
+            stacklevel=1,
+        )
+        onemath_dir = onemkl_interfaces_dir
+
     if target_cuda is not None:
         if not target_cuda.strip():
             raise ValueError(
@@ -203,6 +225,19 @@ def run(
         "Must specify HIP architecture (e.g., --target-hip=gfx90a)",
         type=str,
     )
+    driver.add_argument(
+        "--onemkl_interfaces",
+        help="(DEPRECATED) Build using oneMath",
+        dest="onemkl_interfaces",
+        action="store_true",
+    )
+    driver.add_argument(
+        "--onemkl_interfaces_dir",
+        help="(DEPRECATED) Local directory with source of oneMath",
+        dest="onemkl_interfaces_dir",
+        default=None,
+        type=str,
+    )
     driver.add_argument(
         "--onemath",
         help="Build using oneMath",
@@ -271,6 +306,8 @@ def run(
         cmake_opts=args.cmake_opts,
         target_cuda=args.target_cuda,
         target_hip=args.target_hip,
+        onemkl_interfaces=args.onemkl_interfaces,
+        onemkl_interfaces_dir=args.onemkl_interfaces_dir,
         onemath=args.onemath,
         onemath_dir=args.onemath_dir,
     )