Plots v2 a.k.a 2.0

.codecov.yml

@@ -0,0 +1,3 @@
+comment: false
+github_checks:
+  annotations: false

.github/FUNDING.yml

@@ -2,4 +2,3 @@
 
 github: JuliaPlots
 open_collective: plotsjl
-

.github/ISSUE_TEMPLATE/bug.md

@@ -1,8 +1,7 @@
 ---
 name: Bug report
 about: Create a bug report
-title: "[BUG]"
-labels: bug
+type: bug
 assignees: ''
 
 ---
@@ -19,11 +18,11 @@ This bug occurs on ( insert `x` below )
 Backend      | yes | no  | untested
 -------------|-----|-----|---------
 gr (default) |     |     |
+unicodeplots |     |     |
 pythonplot   |     |     |
-plotlyjs     |     |     |
 pgfplotsx    |     |     |
-unicodeplots |     |     |
-inspectdr    |     |     |
+plotlyjs     |     |     |
+plotly       |     |     |
 gaston       |     |     |
 
 ### Versions

.github/ISSUE_TEMPLATE/feature request.md

@@ -1,8 +1,7 @@
 ---
 name: Feature request
 about: Suggest a feature or enhancement
-title: "[FR]"
-labels: feature request
+type: feature
 assignees: ''
 
 ---

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,8 +1,7 @@
-<!-- Plots is in a 2.0 transition phase. Consider (also) targeting the v2 branch with this change -->
 ## Description
 
 ## Attribution
-- [ ] I am listed in [.zenodo.json](https://github.com/JuliaPlots/Plots.jl/blob/2463eb9f8065c52ed8314f6e541664c5b9db88d2/.zenodo.json) (see https://github.com/JuliaPlots/Plots.jl/issues/3503)
+- [ ] I am listed in the appropriate version of `.zenodo.json` for [PRs against v2](https://github.com/JuliaPlots/Plots.jl/blob/v2/.zenodo.json) or [PRs against master](https://github.com/JuliaPlots/Plots.jl/blob/master/.zenodo.json) (see https://github.com/JuliaPlots/Plots.jl/issues/3503)
 
 ## Things to consider
 - [ ] Does it work on log scales?

.github/workflows/benchmark.yml

@@ -1,9 +1,11 @@
 name: benchmarks
 
 on:
+  workflow_dispatch:
   pull_request:
+    branches: [master]
 
-concurrency: 
+concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
@@ -12,9 +14,9 @@ jobs:
     if: "!contains(github.event.head_commit.message, '[skip ci]')"
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: julia-actions/setup-julia@latest
-  
+
       - name: Ubuntu TESTCMD
         run: echo "TESTCMD=xvfb-run --auto-servernum julia" >> $GITHUB_ENV
       - name: Install Plots dependencies

.github/workflows/ci.yml

@@ -1,144 +1,119 @@
 name: ci
 
 on:
+  workflow_dispatch:
   pull_request:
   push:
-    branches: [master]
+    branches: [v2]
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
+# needed to allow julia-actions/cache to delete old caches that it has created
+permissions:
+  actions: write
+  contents: read
+
 defaults:
   run:
     shell: bash
 
 jobs:
   ci:
-    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    if: ${{ !contains(github.event.head_commit.message, '[skip ci]') && !contains(github.event.pull_request.labels.*.name, 'skip ci') }}
     env:
-      GKS_ENCODING: "utf8"
-      GKSwstype: "nul"
-      JULIA_CONDAPKG_BACKEND: "MicroMamba"
-      MPLBACKEND: "agg"
-    name: Julia ${{ matrix.version }} - ${{ matrix.os }}
+      JULIA_PROJECT_CMD: julia --project=@. --check-bounds=yes --color=yes
+      JULIA_CONDAPKG_LIBSTDCXX_NG_VERSION : 'ignore'  # handled ourselves in ci/matplotlib.jl
+      JULIA_CONDAPKG_BACKEND: MicroMamba
+      MPLBACKEND: agg
+      GKS_ENCODING: utf8
+      GKSwstype: nul
+    name: julia ${{ matrix.version }} - ${{ matrix.os }}
     continue-on-error: ${{ matrix.experimental }}
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
+        experimental: [false]
         version:
-          - '1.6' # LTS (minimal declared julia compat in `Project.toml`)
-          - '1' # latest stable
-        experimental:
-          - false
-        os: [ubuntu-latest, windows-latest, macos-latest]
+          - 'lts'  # minimal declared julia compat in `Project.toml`
+          - '1'  # latest stable
+        os: [ubuntu-latest, windows-latest]
         arch: [x64]
         include:
-          - os: ubuntu-latest
-            experimental: false
-            prefix: xvfb-run  # julia-actions/julia-runtest/blob/master/README.md
-          - os: ubuntu-latest
-            experimental: false
-            prefix: xvfb-run
-            version:  '1.7' # only test intermediate release on `ubuntu` to spare resources
-          - os: ubuntu-latest
+          # NOTE: macos-latest resolves to macos-14 (only aarch64), use macos-13 for x86.
+          - os: macos-latest
             experimental: false
-            prefix: xvfb-run
-            version:  '1.8' # only test intermediate release on `ubuntu` to spare resources
-          - os: ubuntu-latest
+            arch: aarch64
+            version: 'lts'
+          - os: macos-latest
             experimental: false
-            prefix: xvfb-run
-            version:  '1.9' # only test intermediate release on `ubuntu` to spare resources
+            arch: aarch64
+            version: '1'
           - os: ubuntu-latest
             experimental: true
-            prefix: xvfb-run
-            version: '~1.11.0-0'  # upcoming julia version, next `rc`
-          - os: ubuntu-latest
-            experimental: true
-            prefix: xvfb-run
-            version: 'nightly'
+            version: 'pre'  # upcoming julia version (`alpha`, `beta` or `rc`)
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
-      - name: Ubuntu LaTeX dependencies
+      - name: setup ubuntu dependencies
         if: startsWith(matrix.os, 'ubuntu')
         run: |
           sudo apt-get -y update
-          sudo apt-get -y install gnuplot poppler-utils texlive-{latex-base,latex-extra,luatex} g++
+          sudo apt-get -y install g++ gnuplot poppler-utils texlive-{latex-base,latex-extra,luatex}  # LaTeX
           sudo fc-cache -vr
-
-      - name: Set LD_PRELOAD
-        if: startsWith(matrix.os, 'ubuntu')
-        run: echo "LD_PRELOAD=$(g++ --print-file-name=libstdc++.so)" >> $GITHUB_ENV
+          echo "LD_PRELOAD=$(g++ --print-file-name=libstdc++.so)" >>$GITHUB_ENV
 
       - uses: julia-actions/setup-julia@latest
         with:
           version: ${{ matrix.version }}
-      - uses: julia-actions/cache@v1
-      - uses: julia-actions/julia-buildpkg@latest
 
-      - name: Run upstream RecipesBase & RecipesPipeline tests
-        shell: julia --project=@. --color=yes {0}
-        run: |
-          using Pkg
-          foreach(("RecipesBase", "RecipesPipeline")) do name
-            Pkg.develop(path=name); Pkg.test(name; coverage=true)
-          end
+      - uses: julia-actions/cache@v2
 
-      - name: Install conda based matplotlib
-        shell: julia --project=@. --color=yes {0}
+      - name: dev downstream pkgs and install mpl deps
+        env:
+          JULIA_PKG_PRECOMPILE_AUTO: 0
         run: |
-          using Pkg; Pkg.add("CondaPkg")
-          using CondaPkg; CondaPkg.resolve()
-          libgcc = if Sys.islinux()
-            # see discourse.julialang.org/t/glibcxx-version-not-found/82209/8
-            # julia 1.8.3 is built with libstdc++.so.6.0.29, so we must restrict to this version (gcc 11.3.0, not gcc 12.2.0)
-            # see gcc.gnu.org/onlinedocs/libstdc++/manual/abi.html
-            specs = Dict(
-              v"3.4.29" => ">=11.1,<12.1",
-              v"3.4.30" => ">=12.1,<13.1",
-              v"3.4.31" => ">=13.1,<14.1",
-              v"3.4.32" => ">=14.1,<15.1",
-              v"3.4.33" => ">=15.1,<16.1",
-              # ... keep this up-to-date with gcc 16
-            )[Base.BinaryPlatforms.detect_libstdcxx_version()]
-            ("libgcc-ng$specs", "libstdcxx-ng$specs")
-          else
-            ()
-          end
-          CondaPkg.PkgREPL.add([libgcc..., "matplotlib"])
-          CondaPkg.status()
+          ${{ env.JULIA_PROJECT_CMD }} -e '
+            using Pkg
+            Pkg.develop([
+              (; path="./RecipesBase"),      # compat for LTS [sources], remove later
+              (; path="./RecipesPipeline"),  # compat for LTS [sources], remove later
+              (; path="./PlotThemes"),       # compat for LTS [sources], remove later
+              (; path="./PlotsBase"),        # compat for LTS [sources], remove later
+              (; path="./GraphRecipes"),
+              (; path="./StatsPlots"),
+            ])
+            include(joinpath(@__DIR__, "ci", "matplotlib.jl"))
+            Pkg.precompile()  # // precompilation
+          '
 
-      - uses: julia-actions/julia-runtest@latest
+      - name: test Plots stack
         timeout-minutes: 60
-        with:
-          prefix: ${{ matrix.prefix }}  # for `xvfb-run`
-
-      - name: Run downstream tests
-        if: startsWith(matrix.os, 'ubuntu')
-        shell: xvfb-run julia --project=@. --color=yes {0}
         run: |
-          using Pkg
-          foreach(("StatsPlots", "GraphRecipes")) do name
-            Pkg.activate(tempdir())
-            foreach(path -> Pkg.develop(; path), ("RecipesBase", "RecipesPipeline", "."))
-            Pkg.add(name); Pkg.test(name; coverage=true)
-          end
+          cmd=(${{ env.JULIA_PROJECT_CMD }} --depwarn=yes)
+          if [ "$RUNNER_OS" == "Linux" ]; then
+            cmd=(xvfb-run ${cmd[@]})
+          fi
+          echo ${cmd[@]}
+          ${cmd[@]} -e 'using Pkg
+          Pkg.test([
+            "RecipesBase",
+            "RecipesPipeline",
+            "PlotThemes",
+            "PlotsBase",
+            "GraphRecipes",
+            "StatsPlots",
+            "Plots",
+          ]; coverage=true)'
 
       - uses: julia-actions/julia-processcoverage@latest
-        if: startsWith(matrix.os, 'ubuntu')
         with:
-          directories: RecipesBase/src,RecipesPipeline/src,src
-      - uses: codecov/codecov-action@v4
-        if: startsWith(matrix.os, 'ubuntu')
+          directories: RecipesBase/src,RecipesPipeline/src,PlotsBase/src,PlotsBase/ext,src,PlotThemes/src,GraphRecipes/src,StatsPlots/src
+      - uses: codecov/codecov-action@v5
         with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
           file: lcov.info
-
-  Skip:
-    if: contains(github.event.head_commit.message, '[skip ci]')
-    runs-on: ubuntu-latest
-    steps:
-      - name: Skip CI 🚫
-        run: echo skip ci

.github/workflows/codespell.yml

@@ -0,0 +1,17 @@
+name: codespell
+
+on: [pull_request]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+    - uses: codespell-project/actions-codespell@v2
+      with:
+        ignore_words_list: nd,nax,namin,namax,linez,ist
+        only_warn: 0

.github/workflows/CompatHelper.yml → .github/workflows/compathelper.yml

@@ -1,6 +1,7 @@
-name: CompatHelper
+name: compathelper
 
 on:
+  workflow_dispatch:
   schedule:
     - cron: '00 00 * * *'
 

.github/workflows/docs.yml

@@ -1,33 +1,35 @@
 name: docs
 
 on:
- workflow_dispatch:
- push:
-  branches: [master]
-  tags: '*'
+  workflow_dispatch:
+  push:
+    branches: [v2]
+    tags: '*'
+  release:
+    types: [published]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref && github.ref || github.run_id }}
+  cancel-in-progress: true
 
 jobs:
-  Build_docs:
+  build:
+    if: ${{ github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'documentation') }}
+    permissions:
+      actions: write
+      contents: write
+      pull-requests: read
+      statuses: write
     runs-on: ubuntu-latest
+    env:
+      PYTHON: ""
+      DOCUMENTER_KEY: ${{secrets.DOCUMENTER_KEY}}
+      GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
     steps:
-      - uses: actions/checkout@v4
-        with:
-          repository: JuliaPlots/PlotDocs.jl
+      - uses: actions/checkout@v5
       - uses: julia-actions/setup-julia@latest
-      - name: Cache artifacts
-        uses: actions/cache@v4
-        env:
-          cache-name: cache-artifacts
-        with:
-          path: ~/.julia/artifacts 
-          key: ${{runner.os}}-test-${{env.cache-name}}-${{hashFiles('**/Project.toml')}}
-          restore-keys: |
-            ${{runner.os}}-test-${{env.cache-name}}-
-            ${{runner.os}}-test-
-            ${{runner.os}}-
-      - name: Build documentation
-        env:
-          PYTHON: ""
-          DOCUMENTER_KEY: ${{secrets.DOCUMENTER_KEY}}
-          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
-        run: bash docs/ci_build.sh
+      - uses: julia-actions/cache@v2
+      - run: bash -c '. ci/build-docs.sh; install_ubuntu_deps'
+      - run: bash -c '. ci/build-docs.sh; install_and_precompile_julia_deps'
+      - run: bash -c '. ci/build-docs.sh; build_documenter_docs'