adding quotes to pip installs

ahosler · ahosler · commit 17b1116d6362 · 2023-11-22T14:37:04.000Z
diff --git a/docs/source/user_guide/apachespark/setup-installation.rst b/docs/source/user_guide/apachespark/setup-installation.rst
@@ -24,7 +24,7 @@ Activate the conda environment to upgrade to the latest ``oracle-ads``
 .. code-block:: shell
 
     conda activate /home/datascience/conda/pyspark30_p37_cpu_v5
-    pip install oracle-ads[data_science, data, opctl] --upgrade
+    pip install "oracle-ads[data_science, data, opctl]" --upgrade
 
 
 Configuring core-site.xml
@@ -200,4 +200,3 @@ Data Flow to access logs bucket, use a policy like:
    ALLOW SERVICE dataflow TO READ objects IN tenancy WHERE target.bucket.name='dataflow-logs'
 
 For more information, see the `Data Flow documentation <https://docs.oracle.com/en-us/iaas/data-flow/using/dfs_getting_started.htm#set_up_admin>`__.
-
diff --git a/docs/source/user_guide/big_data_service/boilerplate/create_conda.rst b/docs/source/user_guide/big_data_service/boilerplate/create_conda.rst
@@ -4,6 +4,5 @@ The following are the recommended steps to create a conda environment to connect
 - ``odsc conda install -s pyspark30_p37_cpu_v3``: Install the PySpark conda environment.
 - ``conda activate /home/datascience/conda/pyspark30_p37_cpu_v3``: Activate the PySpark conda environment so that you can modify it.
 - ``pip uninstall oracle_ads``: Uninstall the old ADS package in this environment.
-- ``pip install oracle_ads[bds]``: Install the latest version of ADS that contains BDS support.
+- ``pip install "oracle_ads[bds]"``: Install the latest version of ADS that contains BDS support.
 - ``conda install sasl``: Install ``sasl``.
-
diff --git a/docs/source/user_guide/cli/quickstart.rst b/docs/source/user_guide/cli/quickstart.rst
@@ -61,79 +61,79 @@ To work with gradient boosting models, install the ``boosted`` module. This modu
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[boosted]
+    $ python3 -m pip install "oracle-ads[boosted]"
 
 For big data use cases using Oracle Big Data Service (BDS), install the ``bds`` module. It includes the following libraries: ``ibis-framework[impala]``, ``hdfs[kerberos]`` and ``sqlalchemy``.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[bds]
+    $ python3 -m pip install "oracle-ads[bds]"
 
 To work with a broad set of data formats (for example, Excel, Avro, etc.) install the ``data`` module. It includes the following libraries: ``fastavro``, ``openpyxl``, ``pandavro``, ``asteval``, ``datefinder``, ``htmllistparse``, and ``sqlalchemy``.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[data]
+    $ python3 -m pip install "oracle-ads[data]"
 
 To work with geospatial data install the ``geo`` module. It includes the ``geopandas`` and libraries from the ``viz`` module.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[geo]
+    $ python3 -m pip install "oracle-ads[geo]"
 
 Install the ``notebook`` module to use ADS within the Oracle Cloud Infrastructure Data Science service `Notebook Session <https://docs.oracle.com/en-us/iaas/data-science/using/manage-notebook-sessions.htm>`_. This module installs ``ipywidgets`` and ``ipython`` libraries.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[notebook]
+    $ python3 -m pip install "oracle-ads[notebook]"
 
 To work with ONNX-compatible run times and libraries designed to maximize performance and model portability, install the ``onnx`` module. It includes the following libraries, ``onnx``, ``onnxruntime``, ``onnxmltools``, ``skl2onnx``, ``xgboost``, ``lightgbm`` and libraries from the ``viz`` module.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[onnx]
+    $ python3 -m pip install "oracle-ads[onnx]"
 
 For infrastructure tasks, install the ``opctl`` module. It includes the following libraries, ``oci-cli``, ``docker``, ``conda-pack``, ``nbconvert``, ``nbformat``, and ``inflection``.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[opctl]
+    $ python3 -m pip install "oracle-ads[opctl]"
 
 For hyperparameter optimization tasks install the ``optuna`` module. It includes the ``optuna`` and libraries from the ``viz`` module.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[optuna]
+    $ python3 -m pip install "oracle-ads[optuna]"
 
 For Spark tasks install the ``spark`` module.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[spark]
+    $ python3 -m pip install "oracle-ads[spark]"
 
 Install the ``tensorflow`` module to include ``tensorflow`` and libraries from the ``viz`` module.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[tensorflow]
+    $ python3 -m pip install "oracle-ads[tensorflow]"
 
 For text related tasks, install the ``text`` module. This will include the ``wordcloud``, ``spacy`` libraries.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[text]
+    $ python3 -m pip install "oracle-ads[text]"
 
 Install the ``torch`` module to include ``pytorch`` and libraries from the ``viz`` module.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[torch]
+    $ python3 -m pip install "oracle-ads[torch]"
 
 Install the ``viz`` module to include libraries for visualization tasks. Some of the key packages are ``bokeh``, ``folium``, ``seaborn`` and related packages.
 
 .. code-block:: bash
 
-    $ python3 -m pip install oracle-ads[viz]
+    $ python3 -m pip install "oracle-ads[viz]"
 
 See ``pyproject.toml`` file ``[project.optional-dependencies]`` section for full list of modules and its list of extra libraries.
 
@@ -143,4 +143,4 @@ Multiple extra dependencies can be installed together. For example:
 
 .. code-block:: bash
 
-    $ python3 -m pip install  oracle-ads[notebook,viz,text]
+    $ python3 -m pip install  "oracle-ads[notebook,viz,text]"
diff --git a/docs/source/user_guide/operators/forecasting_operator/install.rst b/docs/source/user_guide/operators/forecasting_operator/install.rst
@@ -13,7 +13,7 @@ If you are running the operator from outside of a Notebook Session, you may down
 
 .. code-block:: bash
 
-    python3 -m pip install oracle_ads[forecast]==2.9.0
+    python3 -m pip install "oracle_ads[forecast]==2.9"
 
 
 After that, the Operator is ready to go!
@@ -24,7 +24,7 @@ In order to run on a job, you will need to create and publish a conda pack with
 
     odsc conda create -n forecast -e
     conda activate /home/datascience/conda/forecast_v1_0
-    python3 -m pip install oracle-ads[forecast]==2.9.0
+    python3 -m pip install "oracle-ads[forecast]==2.9"
     odsc conda publish -s /home/datascience/conda/forecast_v1_0
 
 Ensure that you have properly configured your conda pack namespace and bucket in the Launcher -> Settings -> Object Storage Settings. For more details, see :doc:`ADS Conda Set Up <../../cli/opctl/configure>`
diff --git a/docs/source/user_guide/operators/pii_operator/install.rst b/docs/source/user_guide/operators/pii_operator/install.rst
@@ -7,7 +7,7 @@ The PII Operator can be installed from PyPi.
 
 .. code-block:: bash
 
-    python3 -m pip install oracle_ads[pii]==2.9
+    python3 -m pip install "oracle_ads[pii]==2.9"
 
 
 After that, the Operator is ready to go!
@@ -18,7 +18,7 @@ In order to run on a job, you will need to create and publish a conda pack with
 
     odsc conda create -n ads_pii -e
     conda activate /home/datascience/conda/ads_pii_v1_0
-    python3 -m pip install oracle-ads[pii]==2.9
+    python3 -m "pip install oracle-ads[pii]==2.9"
     odsc conda publish -s /home/datascience/conda/ads_pii_v1_0
 
 Ensure that you have properly configured your conda pack namespace and bucket in the Launcher -> Settings -> Object Storage Settings. For more details, see :doc:`ADS Conda Set Up <../../cli/opctl/configure>`
