spatialdata 0.3.0__tar.gz → 0.4.0__tar.gz

{spatialdata-0.3.0 → spatialdata-0.4.0}/.github/ISSUE_TEMPLATE/bug_report.md

@@ -9,7 +9,7 @@ assignees: ""
 **Recommendation: attach a minimal working example**
 Generally, the easier it is for us to reproduce the issue, the faster we can work on it. It is not required, but if you can, please:
 
-1. Reproduce using the [`blobs` dataset](https://spatialdata.scverse.org/en/latest/generated/spatialdata.datasets.blobs.html)
+1. Reproduce using the [`blobs` dataset](https://spatialdata.scverse.org/en/stable/api/datasets.html#spatialdata.datasets.blobs)
 
     ```python
     from spatialdata.datasets import blobs
@@ -17,7 +17,8 @@ Generally, the easier it is for us to reproduce the issue, the faster we can wor
     sdata = blobs()
     ```
 
-    You can also use [`blobs_annotating_element`](https://spatialdata.scverse.org/en/latest/generated/spatialdata.datasets.blobs_annotating_element.html) for more control:
+    You can also use [`blobs_annotating_element`](https://spatialdata.scverse.org/en/stable/api/datasets.html#spatialdata.datasets.blobs_annotating_element) for more
+    control:
 
     ```
     from spatialdata.datasets import blobs_annotating_element

{spatialdata-0.3.0 → spatialdata-0.4.0}/.github/release.yml

@@ -5,18 +5,24 @@ changelog:
         authors:
             - pre-commit-ci
     categories:
-        - title: Major
+        - title: Added
           labels:
-              - "release-major"
-        - title: Minor
-          labels:
-              - "release-minor"
+              - "release-added"
         - title: Changed
           labels:
               - "release-changed"
+        - title: Deprecated
+          labels:
+              - "release-deprecated"
+        - title: Removed
+          labels:
+              - "release-removed"
         - title: Fixed
           labels:
               - "release-fixed"
+        - title: Security
+          labels:
+              - "release-security"
         - title: Other Changes
           labels:
               - "*"

spatialdata-0.4.0/.github/workflows/build_image.yml

@@ -0,0 +1,100 @@
+name: Build Docker image
+
+on:
+    workflow_dispatch:
+#    schedule:
+#        -   cron: '0 0 * * *'  # run daily at midnight UTC
+
+env:
+    REGISTRY: ghcr.io
+    IMAGE_NAME: ${{ github.repository }}
+
+concurrency:
+    group: ${{ github.workflow }}-${{ github.ref }}
+    cancel-in-progress: true
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+
+        defaults:
+            run:
+                shell: bash -e {0} # -e to fail on error
+
+        permissions:
+            contents: read
+            packages: write
+            attestations: write
+            id-token: write
+
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+
+            - name: Set up Python
+              uses: actions/setup-python@v4
+              with:
+                  python-version: "3.x"
+
+            - name: Upgrade pip
+              run: pip install pip
+
+            - name: Get latest versions
+              id: get_versions
+              run: |
+                  SPATIALDATA_VERSION=$(pip index versions spatialdata | grep "Available versions" | sed 's/Available versions: //' | awk -F', ' '{print $1}')
+                  SPATIALDATA_IO_VERSION=$(pip index versions spatialdata-io | grep "Available versions" | sed 's/Available versions: //' | awk -F', ' '{print $1}')
+                  SPATIALDATA_PLOT_VERSION=$(pip index versions spatialdata-plot | grep "Available versions" | sed 's/Available versions: //' | awk -F', ' '{print $1}')
+                  echo "SPATIALDATA_VERSION=${SPATIALDATA_VERSION}" >> $GITHUB_ENV
+                  echo "SPATIALDATA_IO_VERSION=${SPATIALDATA_IO_VERSION}" >> $GITHUB_ENV
+                  echo "SPATIALDATA_PLOT_VERSION=${SPATIALDATA_PLOT_VERSION}" >> $GITHUB_ENV
+
+            - name: Check if image tag exists
+              id: check_tag
+              env:
+                  IMAGE_TAG_SUFFIX: spatialdata${{ env.SPATIALDATA_VERSION }}_spatialdata-io${{ env.SPATIALDATA_IO_VERSION }}_spatialdata-plot${{ env.SPATIALDATA_PLOT_VERSION }}
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              run: |
+                  # Define the API URL
+                  API_URL="https://api.github.com/orgs/scverse/packages/container/spatialdata/versions"
+
+                  # Fetch all existing versions
+                  existing_tags=$(curl -s -H "Authorization: token $GITHUB_TOKEN" $API_URL | jq -r '.[].metadata.container.tags[]')
+
+                  # Debug: Output all existing tags
+                  echo "Existing tags:"
+                  echo "$existing_tags"
+
+                  # Check if the constructed tag exists
+                  if echo "$existing_tags" | grep -q "$IMAGE_TAG_SUFFIX"; then
+                    echo "Image tag $IMAGE_TAG_SUFFIX already exists. Skipping build."
+                    echo "skip_build=true" >> $GITHUB_ENV
+                  else
+                    echo "Image tag $IMAGE_TAG_SUFFIX does not exist. Proceeding with build."
+                    echo "skip_build=false" >> $GITHUB_ENV
+                    echo "IMAGE_TAG_SUFFIX=${IMAGE_TAG_SUFFIX}" >> $GITHUB_ENV
+                  fi
+
+            - name: Login to GitHub Container Registry
+              if: ${{ env.skip_build == 'false' }}
+              uses: docker/login-action@v3
+              with:
+                  registry: ${{ env.REGISTRY }}
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
+
+            - uses: docker/build-push-action@v5
+              if: ${{ env.skip_build == 'false' }}
+              env:
+                  IMAGE_TAG: ${{ env.REGISTRY }}/scverse/spatialdata:${{ env.IMAGE_TAG_SUFFIX }}
+              with:
+                  context: .
+                  file: ./Dockerfile
+                  push: true
+                  cache-from: type=registry,ref=${{ env.REGISTRY }}/scverse/spatialdata:buildcache
+                  cache-to: type=inline,ref=${{ env.REGISTRY }}/scverse/spatialdata:buildcache
+                  build-args: |
+                      SPATIALDATA_VERSION=${{ env.SPATIALDATA_VERSION }}
+                      SPATIALDATA_IO_VERSION=${{ env.SPATIALDATA_IO_VERSION }}
+                      SPATIALDATA_PLOT_VERSION=${{ env.SPATIALDATA_PLOT_VERSION }}
+                  tags: ${{ env.IMAGE_TAG }}

{spatialdata-0.3.0 → spatialdata-0.4.0}/.github/workflows/test.yaml

@@ -34,37 +34,20 @@ jobs:
 
         steps:
             - uses: actions/checkout@v2
-            - name: Set up Python ${{ matrix.python }}
-              uses: actions/setup-python@v4
+            - uses: astral-sh/setup-uv@v5
+              id: setup-uv
               with:
+                  version: "latest"
                   python-version: ${{ matrix.python }}
-                  cache: pip
-
-            - name: Get pip cache dir
-              id: pip-cache-dir
-              run: |
-                  echo "::set-output name=dir::$(pip cache dir)"
-            - name: Restore pip cache
-              uses: actions/cache@v2
-              with:
-                  path: ${{ steps.pip-cache-dir.outputs.dir }}
-                  key: pip-${{ runner.os }}-${{ env.pythonLocation }}-${{ hashFiles('**/pyproject.toml') }}
-                  restore-keys: |
-                      pip-${{ runner.os }}-${{ env.pythonLocation }}-
-            - name: Install test dependencies
-              run: |
-                  python -m pip install --upgrade pip wheel
-                  pip install pytest-cov
             - name: Install dependencies
-              run: |
-                  pip install ${{ matrix.pip-flags }} -e ".[dev,test,torch]"
+              run: "uv sync --extra test"
             - name: Test
               env:
                   MPLBACKEND: agg
                   PLATFORM: ${{ matrix.os }}
                   DISPLAY: :42
               run: |
-                  pytest --cov --color=yes --cov-report=xml
+                  uv run pytest --cov --color=yes --cov-report=xml
             - name: Upload coverage to Codecov
               uses: codecov/codecov-action@v4
               with:

{spatialdata-0.3.0 → spatialdata-0.4.0}/.pre-commit-config.yaml

@@ -8,26 +8,19 @@ minimum_pre_commit_version: 2.16.0
 ci:
     skip: []
 repos:
-    - repo: https://github.com/psf/black
-      rev: 24.10.0
-      hooks:
-          - id: black
     - repo: https://github.com/rbubley/mirrors-prettier
-      rev: v3.4.2
+      rev: v3.5.3
       hooks:
           - id: prettier
-    - repo: https://github.com/asottile/blacken-docs
-      rev: 1.19.1
-      hooks:
-          - id: blacken-docs
     - repo: https://github.com/pre-commit/mirrors-mypy
-      rev: v1.14.1
+      rev: v1.15.0
       hooks:
           - id: mypy
             additional_dependencies: [numpy, types-requests]
             exclude: tests/|docs/
     - repo: https://github.com/astral-sh/ruff-pre-commit
-      rev: v0.9.1
+      rev: v0.11.6
       hooks:
           - id: ruff
             args: [--fix, --exit-non-zero-on-fix]
+          - id: ruff-format

spatialdata-0.4.0/Dockerfile

@@ -0,0 +1,51 @@
+ARG TARGETPLATFORM=linux/amd64
+
+# Use the specified platform to pull the correct base image.
+# Override TARGETPLATFORM during build for different architectures, such as linux/arm64 for Apple Silicon.
+# For example, to build for ARM64 architecture (e.g., Apple Silicon),
+# use the following command on the command line:
+#
+#     docker build --build-arg TARGETPLATFORM=linux/arm64 -t my-arm-image .
+#
+# Similarly, to build for the default x86_64 architecture, you can use:
+#
+#     docker build --build-arg TARGETPLATFORM=linux/amd64 -t my-amd64-image .
+#
+FROM --platform=$TARGETPLATFORM ubuntu:latest
+LABEL authors="Luca Marconato"
+
+ENV PYTHONUNBUFFERED=1
+
+ARG SPATIALDATA_VERSION
+ARG SPATIALDATA_IO_VERSION
+ARG SPATIALDATA_PLOT_VERSION
+
+# debugging
+RUN echo "Target Platform: ${TARGETPLATFORM}" && \
+    echo "spatialdata version: ${SPATIALDATA_VERSION}" && \
+    echo "spatialdata-io version: ${SPATIALDATA_IO_VERSION}" && \
+    echo "spatialdata-plot version: ${SPATIALDATA_PLOT_VERSION}"
+
+# Update and install system dependencies.
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    build-essential \
+    python3-venv \
+    python3-dev \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+# setup python virtual environment
+RUN python3 -m venv /opt/venv
+ENV PATH="/opt/venv/bin:$PATH"
+RUN pip install --upgrade pip wheel
+
+# Install the libraries with specific versions
+RUN pip install --no-cache-dir \
+    spatialdata[torch]==${SPATIALDATA_VERSION} \
+    spatialdata-io==${SPATIALDATA_IO_VERSION} \
+    spatialdata-plot==${SPATIALDATA_PLOT_VERSION}
+
+LABEL spatialdata_version="${SPATIALDATA_VERSION}" \
+      spatialdata_io_version="${SPATIALDATA_IO_VERSION}" \
+      spatialdata_plot_version="${SPATIALDATA_PLOT_VERSION}"

{spatialdata-0.3.0 → spatialdata-0.4.0}/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2022, scverse
+Copyright (c) 2022, scverse®
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

{spatialdata-0.3.0 → spatialdata-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spatialdata
-Version: 0.3.0
+Version: 0.4.0
 Summary: Spatial data format.
 Project-URL: Documentation, https://spatialdata.scverse.org/en/latest
 Project-URL: Source, https://github.com/scverse/spatialdata.git
@@ -9,7 +9,7 @@ Author: scverse
 Maintainer-email: scverse <giov.pll@gmail.com>
 License: BSD 3-Clause License
         
-        Copyright (c) 2022, scverse
+        Copyright (c) 2022, scverse®
         All rights reserved.
         
         Redistribution and use in source and binary forms, with or without
@@ -46,7 +46,7 @@ Requires-Dist: fsspec
 Requires-Dist: geopandas>=0.14
 Requires-Dist: multiscale-spatial-image>=2.0.2
 Requires-Dist: networkx
-Requires-Dist: numba
+Requires-Dist: numba>=0.55.0
 Requires-Dist: numpy
 Requires-Dist: ome-zarr>=0.8.4
 Requires-Dist: pandas
@@ -59,6 +59,7 @@ Requires-Dist: setuptools
 Requires-Dist: shapely>=2.0.1
 Requires-Dist: spatial-image>=1.1.0
 Requires-Dist: typing-extensions>=4.8.0
+Requires-Dist: xarray-dataclasses>=1.8.0
 Requires-Dist: xarray-schema
 Requires-Dist: xarray-spatial>=0.3.5
 Requires-Dist: xarray>=2024.10.0
@@ -111,14 +112,15 @@ SpatialData is a data framework that comprises a FAIR storage format and a colle
 
 [//]: # "numfocus-fiscal-sponsor-attribution"
 
-The spatialdata project uses a [consensus based governance model](https://scverse.org/about/roles/) and is fiscally sponsored by [NumFOCUS](https://numfocus.org/). Consider making a [tax-deductible donation](https://numfocus.org/donate-to-scverse) to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.
+spatialdata is part of the scverse® project ([website](https://scverse.org), [governance](https://scverse.org/about/roles)) and is fiscally sponsored by [NumFOCUS](https://numfocus.org/).
+If you like scverse® and want to support our mission, please consider making a tax-deductible [donation](https://numfocus.org/donate-to-scverse) to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.
 
 The spatialdata project also received support by the Chan Zuckerberg Initiative.
 
 <div align="center">
   <a href="https://numfocus.org/project/scverse">
-    <img height="60px" 
-         src="https://raw.githubusercontent.com/numfocus/templates/master/images/numfocus-logo.png" 
+    <img height="60px"
+         src="https://raw.githubusercontent.com/numfocus/templates/master/images/numfocus-logo.png"
          align="center">
   </a>
 </div>
@@ -134,7 +136,7 @@ The spatialdata project also received support by the Chan Zuckerberg Initiative.
 Please refer to the [documentation][link-docs]. In particular:
 
 - [API documentation][link-api].
-- [Design doc][link-design-doc].
+- [Design doc][link-design-doc] (includes the roadmap).
 - [Example notebooks][link-notebooks].
 
 Another useful resource to get started is the source code of the [`spatialdata-io`](https://github.com/scverse/spatialdata-io) package, which shows example of how to read data from common technologies.
@@ -147,7 +149,8 @@ Check out the docs for more complete [installation instructions](https://spatial
 pip install "spatialdata[extra]"
 ```
 
-or via conda:
+~~or via conda:~~
+Update Feb 2025: `spatialdata` cannot be currently be installed via `conda` because some dependencies of our dependencies are not updated in `conda-forge` and we are still waiting for an update. Please install from `pip`; the latest versions of the `spatialdata` libraries are always available via `PyPI`.
 
 ```bash
 mamba install -c conda-forge spatialdata napari-spatialdata spatialdata-io spatialdata-plot
@@ -178,11 +181,10 @@ Marconato, L., Palla, G., Yamauchi, K.A. et al. SpatialData: an open and univers
 
 [scverse-discourse]: https://discourse.scverse.org/
 [issue-tracker]: https://github.com/scverse/spatialdata/issues
-[changelog]: https://spatialdata.readthedocs.io/latest/changelog.html
-[design doc]: https://scverse-spatialdata.readthedocs.io/en/latest/design_doc.html
-[link-docs]: https://spatialdata.scverse.org/en/latest/
-[link-api]: https://spatialdata.scverse.org/en/latest/api.html
-[link-design-doc]: https://spatialdata.scverse.org/en/latest/design_doc.html
-[link-notebooks]: https://spatialdata.scverse.org/en/latest/tutorials/notebooks/notebooks.html
+[design doc]: https://scverse-spatialdata.readthedocs.io/en/stable/design_doc.html
+[link-docs]: https://spatialdata.scverse.org/en/stable/
+[link-api]: https://spatialdata.scverse.org/en/stable/api.html
+[link-design-doc]: https://spatialdata.scverse.org/en/stable/design_doc.html
+[link-notebooks]: https://spatialdata.scverse.org/en/stable/tutorials/notebooks/notebooks.html
 [badge-tests]: https://github.com/scverse/spatialdata/actions/workflows/test.yaml/badge.svg
 [link-tests]: https://github.com/scverse/spatialdata/actions/workflows/test.yaml

{spatialdata-0.3.0 → spatialdata-0.4.0}/README.md

@@ -18,14 +18,15 @@ SpatialData is a data framework that comprises a FAIR storage format and a colle
 
 [//]: # "numfocus-fiscal-sponsor-attribution"
 
-The spatialdata project uses a [consensus based governance model](https://scverse.org/about/roles/) and is fiscally sponsored by [NumFOCUS](https://numfocus.org/). Consider making a [tax-deductible donation](https://numfocus.org/donate-to-scverse) to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.
+spatialdata is part of the scverse® project ([website](https://scverse.org), [governance](https://scverse.org/about/roles)) and is fiscally sponsored by [NumFOCUS](https://numfocus.org/).
+If you like scverse® and want to support our mission, please consider making a tax-deductible [donation](https://numfocus.org/donate-to-scverse) to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.
 
 The spatialdata project also received support by the Chan Zuckerberg Initiative.
 
 <div align="center">
   <a href="https://numfocus.org/project/scverse">
-    <img height="60px" 
-         src="https://raw.githubusercontent.com/numfocus/templates/master/images/numfocus-logo.png" 
+    <img height="60px"
+         src="https://raw.githubusercontent.com/numfocus/templates/master/images/numfocus-logo.png"
          align="center">
   </a>
 </div>
@@ -41,7 +42,7 @@ The spatialdata project also received support by the Chan Zuckerberg Initiative.
 Please refer to the [documentation][link-docs]. In particular:
 
 - [API documentation][link-api].
-- [Design doc][link-design-doc].
+- [Design doc][link-design-doc] (includes the roadmap).
 - [Example notebooks][link-notebooks].
 
 Another useful resource to get started is the source code of the [`spatialdata-io`](https://github.com/scverse/spatialdata-io) package, which shows example of how to read data from common technologies.
@@ -54,7 +55,8 @@ Check out the docs for more complete [installation instructions](https://spatial
 pip install "spatialdata[extra]"
 ```
 
-or via conda:
+~~or via conda:~~
+Update Feb 2025: `spatialdata` cannot be currently be installed via `conda` because some dependencies of our dependencies are not updated in `conda-forge` and we are still waiting for an update. Please install from `pip`; the latest versions of the `spatialdata` libraries are always available via `PyPI`.
 
 ```bash
 mamba install -c conda-forge spatialdata napari-spatialdata spatialdata-io spatialdata-plot
@@ -85,11 +87,10 @@ Marconato, L., Palla, G., Yamauchi, K.A. et al. SpatialData: an open and univers
 
 [scverse-discourse]: https://discourse.scverse.org/
 [issue-tracker]: https://github.com/scverse/spatialdata/issues
-[changelog]: https://spatialdata.readthedocs.io/latest/changelog.html
-[design doc]: https://scverse-spatialdata.readthedocs.io/en/latest/design_doc.html
-[link-docs]: https://spatialdata.scverse.org/en/latest/
-[link-api]: https://spatialdata.scverse.org/en/latest/api.html
-[link-design-doc]: https://spatialdata.scverse.org/en/latest/design_doc.html
-[link-notebooks]: https://spatialdata.scverse.org/en/latest/tutorials/notebooks/notebooks.html
+[design doc]: https://scverse-spatialdata.readthedocs.io/en/stable/design_doc.html
+[link-docs]: https://spatialdata.scverse.org/en/stable/
+[link-api]: https://spatialdata.scverse.org/en/stable/api.html
+[link-design-doc]: https://spatialdata.scverse.org/en/stable/design_doc.html
+[link-notebooks]: https://spatialdata.scverse.org/en/stable/tutorials/notebooks/notebooks.html
 [badge-tests]: https://github.com/scverse/spatialdata/actions/workflows/test.yaml/badge.svg
 [link-tests]: https://github.com/scverse/spatialdata/actions/workflows/test.yaml

{spatialdata-0.3.0 → spatialdata-0.4.0}/_version.py

@@ -1,8 +1,13 @@
-# file generated by setuptools_scm
+# file generated by setuptools-scm
 # don't change, don't track in version control
+
+__all__ = ["__version__", "__version_tuple__", "version", "version_tuple"]
+
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from typing import Tuple, Union
+    from typing import Tuple
+    from typing import Union
+
     VERSION_TUPLE = Tuple[Union[int, str], ...]
 else:
     VERSION_TUPLE = object
@@ -12,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.3.0'
-__version_tuple__ = version_tuple = (0, 3, 0)
+__version__ = version = '0.4.0'
+__version_tuple__ = version_tuple = (0, 4, 0)

{spatialdata-0.3.0 → spatialdata-0.4.0}/benchmarks/spatialdata_benchmark.py

@@ -44,7 +44,6 @@ class TimeMapRaster:
 
 
 class TimeQueries:
-
     params = ([100, 1_000, 10_000], [True, False], [100, 1_000])
     param_names = ["length", "filter_table", "n_transcripts_per_cell"]
 

{spatialdata-0.3.0 → spatialdata-0.4.0}/benchmarks/utils.py

@@ -8,7 +8,7 @@ Functions that make running and debugging benchmarks easier:
 - function run_benchmark is used to run the benchmarks.
 
 Performant dataset generation functions so the benchmarks run fast even for large artificial datasets.
-The object is to generate a dataset containing many cells. By copying the same cell values instead of 
+The object is to generate a dataset containing many cells. By copying the same cell values instead of
 doing gaussian blur on the whole image, we can generate the same dataset in a fraction of the time.
 - function labeled_particles is used to generate labeled blobs.
 - function _generate_ball is used to generate a ball of given radius and dimension.

{spatialdata-0.3.0 → spatialdata-0.4.0}/docs/api/io.md

@@ -1,6 +1,7 @@
 # Input/Output
 
-To read the data from a specific technology (e.g., Xenium, MERSCOPE, ...), you can use any of the [spatialdata-io readers](https://spatialdata.scverse.org/projects/io/en/latest/api.html).
+To read the data from a specific technology (e.g., Xenium, MERSCOPE, ...), you can
+use any of the [spatialdata-io readers](https://spatialdata.scverse.org/projects/io/en/stable/api.html).
 
 ```{eval-rst}
 .. currentmodule:: spatialdata

{spatialdata-0.3.0 → spatialdata-0.4.0}/docs/api/operations.md

@@ -14,6 +14,7 @@ Operations on `SpatialData` objects.
 .. autofunction:: join_spatialelement_table
 .. autofunction:: match_element_to_table
 .. autofunction:: match_table_to_element
+.. autofunction:: match_sdata_to_table
 .. autofunction:: concatenate
 .. autofunction:: transform
 .. autofunction:: rasterize

{spatialdata-0.3.0 → spatialdata-0.4.0}/docs/contributing.md

@@ -231,7 +231,6 @@ To find out the time or memory performance of your code, profilers can help. Aga
 <!-- Links -->
 
 [scanpy developer guide]: https://scanpy.readthedocs.io/en/latest/dev/index.html
-[spatialdata-io]: https://spatialdata-io.readthedocs.io/en/latest/template_usage.html
 [github quickstart guide]: https://docs.github.com/en/get-started/quickstart/create-a-repo?tool=webui
 [codecov]: https://about.codecov.io/sign-up/
 [codecov docs]: https://docs.codecov.com/docs