Merge branch 'main' of github.com:oracle/accelerated-data-science into release/2.8.x

Author: z7ye

.github/workflows/run-unittests.yml

@@ -0,0 +1,69 @@
+name: Unit Tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+      - 'release/**'
+      - develop
+    paths:
+      - '!docs/**'
+
+  pull_request:
+
+# Cancel in progress workflows on pull_requests.
+# https://docs.github.com/en/actions/using-jobs/using-concurrency#example-using-a-fallback-value
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: ${{ matrix.tests-type }}, python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.7","3.8","3.9","3.10"]
+        tests-type: ["DefaultSetup"]
+
+    steps:
+      - uses: actions/checkout@v3
+#      - uses: actions/cache@v3
+#        with:
+#          path: ~/.cache/pip
+#          key: ${{ runner.os }}-pip-${{ hashFiles('**/test-requirements.txt') }}
+#          restore-keys: |
+#            ${{ runner.os }}-pip-
+      - uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: "Setup test env"
+        run: |
+          pip install coverage pytest-codecov tox==4.2.8
+
+      - name: "Run unit tests"
+        timeout-minutes: 45
+        shell: bash
+        run: |
+          set -x # print commands that are executed
+#          coverage erase
+#          ./scripts/runtox.sh "${{ matrix.python-version }}-${{ matrix.tests-type }}" --cov --cov-report=
+#          coverage combine .coverage-*
+#          coverage html -i
+
+      # Uploading test artifacts
+      # https://docs.github.com/en/actions/using-workflows/storing-workflow-data-as-artifacts#uploading-build-and-test-artifacts
+#      - name: "Upload artifact"
+#        uses: actions/upload-artifact@v3
+#        with:
+#          name: code-coverage-report
+#          path: htmlcov/
+#          retention-days: 10

README.md

@@ -166,7 +166,7 @@ This example uses SQL injection safe binding variables.
 
 ## Contributing
 
-This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide [CONTRIBUTING.md](https://github.com/oracle/accelerated-data-science/blob/main/CONTRIBUTING.md).
+This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)
 
 Find Getting Started instructions for developers in [README-development.md](https://github.com/oracle/accelerated-data-science/blob/main/README-development.md)
 

SECURITY.md

@@ -6,11 +6,10 @@ and privacy of all our users.
 
 Please do NOT raise a GitHub Issue to report a security vulnerability. If you
 believe you have found a security vulnerability, please submit a report to
-[secalert_us@oracle.com](mailto:secalert_us@oracle.com) preferably with a proof of concept. 
-Please review some additional information on 
-[how to report security vulnerabilities to Oracle](https://www.oracle.com/corporate/security-practices/assurance/vulnerability/reporting.html).
+[secalert_us@oracle.com][1] preferably with a proof of concept. Please review
+some additional information on [how to report security vulnerabilities to Oracle][2].
 We encourage people who contact Oracle Security to use email encryption using
-[our encryption key](https://www.oracle.com/security-alerts/encryptionkey.html).
+[our encryption key][3].
 
 We ask that you do not use other channels or contact the project maintainers
 directly.
@@ -22,15 +21,18 @@ security features are welcome on GitHub Issues.
 
 Security updates will be released on a regular cadence. Many of our projects
 will typically release security fixes in conjunction with the
-[Oracle Critical Patch Update](https://www.oracle.com/security-alerts/encryptionkey.html) program. 
-Security updates are released on the Tuesday closest to the 17th day of January, April, July and October. 
-A pre-release announcement will be published on the Thursday preceding each release. Additional
-information, including past advisories, is available on our 
-[security alerts](https://www.oracle.com/security-alerts/) page.
+[Oracle Critical Patch Update][3] program. Additional
+information, including past advisories, is available on our [security alerts][4]
+page.
 
 ## Security-related information
 
 We will provide security related information such as a threat model, considerations
 for secure use, or any known security issues in our documentation. Please note
 that labs and sample code are intended to demonstrate a concept and may not be
 sufficiently hardened for production use.
+
+[1]: mailto:secalert_us@oracle.com
+[2]: https://www.oracle.com/corporate/security-practices/assurance/vulnerability/reporting.html
+[3]: https://www.oracle.com/security-alerts/encryptionkey.html
+[4]: https://www.oracle.com/security-alerts/

build_spec.yaml

@@ -0,0 +1,16 @@
+# Copyright (c) 2023, 2022, Oracle and/or its affiliates.
+
+version: 0.1
+component: build
+timeoutInSeconds: 1000
+shell: bash
+
+steps:
+  - type: Command
+    name: "compress the repo"
+    command: |
+      tar -cvzf ${OCI_WORKSPACE_DIR}/repo.tgz ./
+outputArtifacts:
+  - name: artifact
+    type: BINARY
+    location: ${OCI_WORKSPACE_DIR}/repo.tgz

docs/requirements.txt

@@ -1,4 +1,3 @@
--e .
 autodoc
 nbsphinx
 sphinx

docs/source/user_guide/jobs/run_script.rst

@@ -128,6 +128,10 @@ This example runs a job with CLI arguments:
 
 .. code-block:: python3
 
+  from ads.jobs import Job
+  from ads.jobs import DataScienceJob
+  from ads.jobs import ScriptRuntime
+
   job = Job()
   job.with_infrastructure(
     DataScienceJob()
@@ -161,9 +165,9 @@ You could create the preceding example job with the following YAML file:
 
 .. code-block:: yaml
 
-	kind: job
-	spec:
-	  infrastructure:
+  kind: job
+  spec:
+    infrastructure:
       kind: infrastructure
       type: dataScienceJob
       spec:
@@ -177,14 +181,14 @@ You could create the preceding example job with the following YAML file:
           memoryInGBs: 16
           ocpus: 1
         blockStorageSize: 50
-	  runtime:
-	    kind: runtime
+    runtime:
+      kind: runtime
       type: python
-	    spec:
-	      args:
-	      - <first_argument>
-	      - <second_argument>
-	      scriptPathURI: job_script_argument.py
+      spec:
+        args:
+        - <first_argument>
+        - <second_argument>
+      scriptPathURI: job_script_env.py
 
 
 Environment Variables
@@ -201,12 +205,16 @@ Suppose you want to run the following python script named ``job_script_env.py``:
 
   import os
   import sys
-  print("Hello " + os.environ["KEY1"] + " and " + os.environ["KEY2"])""")
+  print("Hello " + os.environ["KEY1"] + " and " + os.environ["KEY2"])
 
 This example runs a job with environment variables:
 
 .. code-block:: python3
 
+  from ads.jobs import Job
+  from ads.jobs import DataScienceJob
+  from ads.jobs import ScriptRuntime
+
   job = Job()
   job.with_infrastructure(
     DataScienceJob()
@@ -246,12 +254,12 @@ You could create the preceding example job with the following YAML file:
 
 .. code-block:: yaml
 
-	kind: job
-	spec:
-	  infrastructure:
-	    kind: infrastructure
+  kind: job
+  spec:
+    infrastructure:
+      kind: infrastructure
       type: dataScienceJob
-	    spec:
+      spec:
         logGroupId: <log_group_ocid>
         logId: <log_ocid>
         compartmentId: <compartment_ocid>
@@ -262,16 +270,16 @@ You could create the preceding example job with the following YAML file:
           memoryInGBs: 16
           ocpus: 1
         blockStorageSize: 50
-	  runtime:
-	    kind: runtime
+    runtime:
+      kind: runtime
       type: python
-	    spec:
-	      env:
-	      - name: KEY1
-	        value: <first_value>
-	      - name: KEY2
-		      value: <second_value>
-	      scriptPathURI: job_script_env.py
+      spec:
+        env:
+        - name: KEY1
+          value: <first_value>
+        - name: KEY2
+          value: <second_value>
+      scriptPathURI: job_script_env.py