Merge pull request #87 from mindsdb/staging

Release 2.1.0

Author: ea-rus

.github/workflows/add_to_pr_review.yml

@@ -0,0 +1,16 @@
+name: Add Pull Requests to PR review project
+
+on:
+  pull_request:
+    types:
+      - opened
+
+jobs:
+  add-to-project:
+    name: Add issue to project
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/add-to-project@v0.5.0
+        with:
+          project-url: https://github.com/orgs/mindsdb/projects/65
+          github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}

.github/workflows/add_to_roadmap_project_v2.yml

@@ -0,0 +1,14 @@
+name: Add issue to roadmap project
+on:
+  issues:
+    types:
+      - opened
+jobs:
+  add-to-project:
+    name: Add issue to roadmap project
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/add-to-project@v0.4.0
+        with:
+          project-url: https://github.com/orgs/mindsdb/projects/53
+          github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}

.github/workflows/mindsdb_python_sdk.yml

@@ -1,7 +1,6 @@
-name: MindsDB Native workflow
+name: PR workflow
 
 on:
-  push:
   pull_request:
     branches:
       - stable
@@ -43,6 +42,8 @@ jobs:
     needs: test
     if: github.ref != 'refs/heads/stable'
     runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
     steps:
       - uses: actions/checkout@v3
       - name: Set up Python 3.8
@@ -65,25 +66,3 @@ jobs:
         with:
           pytest-coverage-path: ./pytest-coverage.txt
           junitxml-path: ./pytest.xml
-
-  deploy:
-    runs-on: ubuntu-latest
-    needs: test
-    if: github.ref == 'refs/heads/stable'
-    steps:
-    - uses: actions/checkout@v2
-    - name: Set up Python
-      uses: actions/setup-python@v2
-      with:
-        python-version: '3.7'
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip==20.2.4
-        pip install setuptools wheel twine
-    - name: Build and publish
-      env:
-        TWINE_USERNAME:  __token__
-        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
-      run: |
-        python setup.py sdist
-        twine upload dist/*

.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - stable
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        python-version: [3.7,3.8,3.9]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip==22.0.4
+        pip install -r requirements.txt
+        pip install --no-cache-dir .
+    - name: Run tests
+      run: |
+        if [ "$RUNNER_OS" == "Linux" ]; then
+        
+          env PYTHONPATH=./ pytest tests/
+
+        fi
+      shell: bash
+      env:
+        CHECK_FOR_UPDATES: False
+        DATABASE_CREDENTIALS_STRINGIFIED_JSON: ${{ secrets.DATABASE_CREDENTIALS }}
+        CLOUD_TEST_EMAIL: ${{ secrets.CLOUD_TEST_EMAIL }}
+        CLOUD_TEST_PASSWORD: ${{ secrets.CLOUD_TEST_PASSWORD }}
+
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.ref == 'refs/heads/stable'
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.7'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip==20.2.4
+        pip install setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME:  __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist
+        twine upload dist/*

README.md

@@ -107,7 +107,7 @@ https://github.com/mindsdb/mindsdb_python_sdk/tree/staging/examples
 
 ## API Documentation
 
-The API documentation for the MindsDB SDK can be found at https://mindsdb.github.io/mindsdb_python_sdk/. You can generate the API documentation locally by following these steps:
+The API documentation for the MindsDB SDK can be found at https://mindsdb.github.io/mindsdb_python_sdk/.
 
 ### Generating API docs locally:
 

docs/source/conf.py

@@ -16,7 +16,11 @@
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.napoleon']
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.napoleon',
+    'sphinx.ext.autosectionlabel'
+]
 
 templates_path = ['_templates']
 exclude_patterns = []

docs/source/index.rst

@@ -90,7 +90,7 @@ Base usage
     More
 
 More examples
------------
+-------------
 
 `<https://github.com/mindsdb/mindsdb_python_sdk/examples>`_
 
@@ -107,12 +107,13 @@ API documentation
    :maxdepth: 1
    :caption: Modules:
 
-
    server
    database
+
+   project
    handlers
+
    ml_engines
-   project
    model
    tables
    views

docs/source/jobs.rst

@@ -1,6 +1,9 @@
 Jobs
 -------------------------
 
+.. _my-reference-label:
+
+
 .. automodule:: mindsdb_sdk.jobs
    :members:
    :undoc-members:

docs/source/server.rst

@@ -4,4 +4,7 @@ Server
 .. automodule:: mindsdb_sdk.server
    :members:
    :undoc-members:
-   :show-inheritance:
+   :show-inheritance:
+
+
+   :ref:`jobs<Jobs>`

examples/working_with_tables.py

@@ -3,21 +3,44 @@
 
 con = mindsdb_sdk.connect()
 
-# get user's database (connected to mindsdb as rental_db)
-db = con.databases.rental_db
+# connect to mindsdb example database
+example_db = con.databases.create(
+    'example_db',
+    engine='postgres',
+    connection_args={
+        "user": "demo_user",
+        "password": "demo_password",
+        "host": "3.220.66.106",
+        "port": "5432",
+        "database": "demo"
+    }
+)
 
-# get table
-table1 = db.tables.house_sales
+# connect to the empty user database
+my_db = con.databases.create(
+    'my_db',
+    engine='postgres',
+    connection_args={
+        "user": "postgres",
+        "host": "localhost",
+        "port": "5432",
+        "database": "my_database"
+    }
+)
 
+# get home_rentals table
+table1 = example_db.tables.get('demo_data.home_rentals')
 
 # ---- create new table ----
 
-# copy create table house_sales and fill it with rows with type=house
-table2 = db.tables.create('house_sales2', table1.filter(type='house'))
+# create table home_rentals in user db and fill it with rows with location=great
+table2 = my_db.tables.create('home_rentals', table1.filter(location='great'))
+
 
 # create table from csv file
+
 df = pd.read_csv('my_data.csv')
-table3 = db.tables.create('my_table', df)
+table3 = my_db.tables.create('my_table', df)
 
 
 # ---- insert into table ----
@@ -28,16 +51,16 @@
 
 # ---- update data in table ----
 
-# get all rows with type=house from table1 and update values in table2 using key ('saledate', 'type', 'bedrooms')
+# get all rows with number_of_rooms=1 from table1 and update values in table2 using key ('location', 'neighborhood')
 table2.update(
-    table1.filter(type='house'),
-    on=['saledate', 'type', 'bedrooms']
+    table1.filter(number_of_rooms=1),
+    on=['location', 'neighborhood']
 )
 
 
 # ---- delete rows from table ----
 
 # delete all rows where bedrooms=2
-table2.delete(bedrooms=2)
+table2.delete(number_of_rooms=1)