Merge branch 'pola-rs:main' into main

.github/CODEOWNERS

@@ -1,7 +1,8 @@
 *  @ritchie46
 
-/.github/ @ritchie46 @stinodego
+/.github/  @ritchie46 @stinodego
 /crates/  @ritchie46 @orlp
 /crates/polars-sql/  @ritchie46 @orlp @universalmind303
 /crates/polars-time/  @ritchie46 @orlp @MarcoGorelli
 /py-polars/  @ritchie46 @stinodego @alexander-beedie
+/docs/  @ritchie46 @c-peters @braaannigan

.github/ISSUE_TEMPLATE/bug_report_python.yml

@@ -1,5 +1,5 @@
 name: '🐞 Bug report - Python'
-description: An issue with Python Polars
+description: Report an issue with Python Polars.
 labels: [bug, python]
 
 body:
@@ -30,6 +30,15 @@ body:
     validations:
       required: true
 
+  - type: textarea
+    id: logs
+    attributes:
+      label: Log output
+      description: >
+        Set the environment variable ``POLARS_VERBOSE=1`` before running the query.
+        Paste the output of ``stderr`` here.
+      render: shell
+
   - type: textarea
     id: problem
     attributes:
@@ -64,3 +73,4 @@ body:
         </details>
     validations:
       required: true
+

.github/ISSUE_TEMPLATE/bug_report_rust.yml

@@ -1,5 +1,5 @@
 name: '🐞 Bug report - Rust'
-description: An issue with Rust Polars
+description: Report an issue with Rust Polars.
 labels: [bug, rust]
 
 body:
@@ -30,6 +30,15 @@ body:
     validations:
       required: true
 
+  - type: textarea
+    id: logs
+    attributes:
+      label: Log output
+      description: >
+        Set the environment variable ``POLARS_VERBOSE=1`` before running the query.
+        Paste the output of ``stderr`` here.
+      render: shell
+
   - type: textarea
     id: problem
     attributes:

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,23 @@
+name: '📖 Documentation improvement'
+description: Report an issue with the documentation.
+labels: [documentation]
+
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: >
+        Describe the issue with the documentation and how it can be fixed or improved.
+    validations:
+      required: true
+
+  - type: input
+    id: link
+    attributes:
+      label: Link
+      description: >
+        Provide a link to the existing documentation, if applicable.
+      placeholder: ex. https://pola-rs.github.io/polars/docs/python/dev/...
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,14 +1,14 @@
 name: '✨ Feature request'
-description: Suggest a new feature or enhancement for Polars
+description: Suggest a new feature or enhancement for Polars.
 labels: [enhancement]
 
 body:
   - type: textarea
     id: description
     attributes:
-      label: Problem description
+      label: Description
       description: >
-        Please describe the feature or enhancement and explain why it should be implemented.
+        Describe the feature or enhancement and explain why it should be implemented.
         Include a code example if applicable.
     validations:
       required: true

.github/release-drafter-python.yml

@@ -13,3 +13,24 @@ version-resolver:
       - breaking
       - breaking python
   default: patch
+
+categories:
+  - title: 🏆 Highlights
+    labels: highlight
+  - title: 💥 Breaking changes
+    labels:
+      - breaking
+      - breaking python
+  - title: ⚠️ Deprecations
+    labels: deprecation
+  - title: 🚀 Performance improvements
+    labels: performance
+  - title: ✨ Enhancements
+    labels: enhancement
+  - title: 🐞 Bug fixes
+    labels: fix
+  - title: 🛠️ Other improvements
+    labels:
+      - build
+      - documentation
+      - internal

.github/release-drafter-rust.yml

@@ -13,3 +13,23 @@ version-resolver:
       - breaking
       - breaking rust
   default: patch
+
+categories:
+  - title: 🏆 Highlights
+    labels: highlight
+  - title: 💥 Breaking changes
+    labels:
+      - breaking
+      - breaking rust
+  - title: 🚀 Performance improvements
+    labels: performance
+  - title: ✨ Enhancements
+    labels: enhancement
+  - title: 🐞 Bug fixes
+    labels: fix
+  - title: 🛠️ Other improvements
+    labels:
+      - build
+      - deprecation
+      - documentation
+      - internal

.github/release-drafter.yml

@@ -1,22 +1,3 @@
-categories:
-  - title: 🏆 Highlights
-    labels: highlight
-  - title: 💥 Breaking changes
-    labels: breaking
-  - title: ⚠️ Deprecations
-    labels: deprecation
-  - title: 🚀 Performance improvements
-    labels: performance
-  - title: ✨ Enhancements
-    labels: enhancement
-  - title: 🐞 Bug fixes
-    labels: fix
-  - title: 🛠️ Other improvements
-    labels:
-      - build
-      - documentation
-      - internal
-
 exclude-labels:
   - skip changelog
   - release

.github/workflows/benchmark.yml

@@ -28,7 +28,7 @@ jobs:
   main:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v4

.github/workflows/clear-caches.yml

@@ -11,7 +11,7 @@ jobs:
   clear-caches:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Clear all caches
         run: gh cache delete --all

.github/workflows/docs-global.yml

@@ -0,0 +1,87 @@
+name: Build documentation
+
+on:
+  pull_request:
+    paths:
+      - docs/**
+      - mkdocs.yml
+      - .github/workflows/docs-global.yml
+  push:
+    tags:
+      - py-**
+
+jobs:
+  markdown-link-check:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: gaurav-nelson/github-action-markdown-link-check@v1
+      with:
+        folder-path: docs
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: psf/black@stable
+        with:
+          src: docs/src/python
+          version: "23.9.1"
+
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: Create virtual environment
+        run: |
+          python -m venv .venv
+          echo "$GITHUB_WORKSPACE/.venv/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        run: |
+          pip install -r py-polars/requirements-dev.txt
+          pip install -r docs/requirements.txt
+
+      - name: Set up Rust
+        run: rustup show
+
+      - name: Cache Rust
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: py-polars
+          save-if: ${{ github.ref_name == 'main' }}
+
+      - name: Install Polars
+        working-directory: py-polars
+        run: |
+          source activate
+          maturin develop
+
+      - name: Set up Graphviz
+        uses: ts-graphviz/setup-graphviz@v1
+
+      - name: Build documentation
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: mkdocs build
+
+      - name: Add .nojekyll
+        if: ${{ github.ref_type == 'tag' }}
+        working-directory: site
+        run: touch .nojekyll
+
+      - name: Deploy docs
+        if: ${{ github.ref_type == 'tag' }}
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          folder: site
+          clean-exclude: |
+            docs/
+            py-polars/
+          single-commit: true

.github/workflows/docs-python.yml

@@ -23,7 +23,7 @@ jobs:
   build-python-docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v4

.github/workflows/docs-rust.yml

@@ -19,7 +19,7 @@ jobs:
   build-rust-docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Rust
         run: rustup component add rust-docs

.github/workflows/lint-global.yml

@@ -11,7 +11,7 @@ jobs:
   main:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Lint Markdown and TOML
         uses: dprint/[email protected]
       - name: Spell Check with Typos

.github/workflows/lint-py-polars.yml

@@ -30,7 +30,7 @@ jobs:
         working-directory: py-polars
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Rust
         run: rustup component add rustfmt clippy
@@ -46,3 +46,6 @@ jobs:
 
       - name: Run clippy
         run: cargo clippy --locked -- -D warnings
+
+      - name: Compile without default features
+        run: cargo check --no-default-features

.github/workflows/lint-python.yml

@@ -18,7 +18,7 @@ jobs:
         working-directory: py-polars
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v4
@@ -45,7 +45,7 @@ jobs:
         working-directory: py-polars
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v4