dask-stubs


Namedask-stubs JSON
Version 0.1.6 PyPI version JSON
download
home_pageNone
SummaryTyping stubs for the Dask ecosystem.
upload_time2025-10-29 06:52:57
maintainerNone
docs_urlNone
authorClouder0
requires_python>=3.12
licenseNone
keywords typing type-stubs dask
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # dask-stubs

`dask-stubs` provides third-party typing information for the Dask project. The
goal is to fill the gaps left by the runtime package so that type checkers such
as Mypy and Pyright can reason about typical Dask usage with confidence.

## Project layout

The repository separates runtime helpers from the stub definitions:

- `src/dask-stubs/` holds `.pyi` files that mirror the public Dask API.
- `tests/typecheck/samples/` provides runtime-free Python snippets that mypy
  validates to guard the stubs.
- `noxfile.py` defines automation for linting, type checking, and stub sanity
  checks.

## Quick start

1. Install development dependencies with `uv` (Python 3.12+):

   ```bash
   uv sync --group dev
   ```

2. Run the default automation via `uv`:

   ```bash
   uv run nox
   ```

   This runs Ruff, Mypy against the stubs, and the sample type-check tests.

## Contribution guidelines

1. Prefer working against small slices of the API. It is easier to review and
   iterate on focused modules.
2. Each new stub should be paired with a usage example under
   `tests/typecheck/samples/` (tested via mypy).
3. Keep the stubs faithful to the runtime signatures. Where the runtime is
   dynamic, fall back to `Any` but leave a `TODO` for future improvement.
4. Run the full `uv run nox` suite before sending a pull request.

See `CONTRIBUTING.md` for more detail on project conventions and coding
standards.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "dask-stubs",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": null,
    "keywords": "typing, type-stubs, dask",
    "author": "Clouder0",
    "author_email": "Clouder0 <clouder0@outlook.com>",
    "download_url": "https://files.pythonhosted.org/packages/73/c7/0f8c8bc69a6a2912ac3d1e4b858b6f9118ed233b6dbbb6bd5145b860d793/dask_stubs-0.1.6.tar.gz",
    "platform": null,
    "description": "# dask-stubs\n\n`dask-stubs` provides third-party typing information for the Dask project. The\ngoal is to fill the gaps left by the runtime package so that type checkers such\nas Mypy and Pyright can reason about typical Dask usage with confidence.\n\n## Project layout\n\nThe repository separates runtime helpers from the stub definitions:\n\n- `src/dask-stubs/` holds `.pyi` files that mirror the public Dask API.\n- `tests/typecheck/samples/` provides runtime-free Python snippets that mypy\n  validates to guard the stubs.\n- `noxfile.py` defines automation for linting, type checking, and stub sanity\n  checks.\n\n## Quick start\n\n1. Install development dependencies with `uv` (Python 3.12+):\n\n   ```bash\n   uv sync --group dev\n   ```\n\n2. Run the default automation via `uv`:\n\n   ```bash\n   uv run nox\n   ```\n\n   This runs Ruff, Mypy against the stubs, and the sample type-check tests.\n\n## Contribution guidelines\n\n1. Prefer working against small slices of the API. It is easier to review and\n   iterate on focused modules.\n2. Each new stub should be paired with a usage example under\n   `tests/typecheck/samples/` (tested via mypy).\n3. Keep the stubs faithful to the runtime signatures. Where the runtime is\n   dynamic, fall back to `Any` but leave a `TODO` for future improvement.\n4. Run the full `uv run nox` suite before sending a pull request.\n\nSee `CONTRIBUTING.md` for more detail on project conventions and coding\nstandards.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Typing stubs for the Dask ecosystem.",
    "version": "0.1.6",
    "project_urls": null,
    "split_keywords": [
        "typing",
        " type-stubs",
        " dask"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "10d1db78152e865efca2d9464e0f3490aa73da006d42dcf2e99da04f227846eb",
                "md5": "bb3ac23fa2d4f5c0d63d2c36b7c39a6f",
                "sha256": "87a540bbbdea0a168efebf0534264ce9cd9bcc47a45ecc415f7d6a3eb008a02a"
            },
            "downloads": -1,
            "filename": "dask_stubs-0.1.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bb3ac23fa2d4f5c0d63d2c36b7c39a6f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 9853,
            "upload_time": "2025-10-29T06:52:56",
            "upload_time_iso_8601": "2025-10-29T06:52:56.151138Z",
            "url": "https://files.pythonhosted.org/packages/10/d1/db78152e865efca2d9464e0f3490aa73da006d42dcf2e99da04f227846eb/dask_stubs-0.1.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "73c70f8c8bc69a6a2912ac3d1e4b858b6f9118ed233b6dbbb6bd5145b860d793",
                "md5": "e3ba192f67f25ddf3917db0f4d2856e9",
                "sha256": "02c06e66b179ce7aa7a2976ef250cbefebbb170a09f97d626a32bec5d0728acf"
            },
            "downloads": -1,
            "filename": "dask_stubs-0.1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "e3ba192f67f25ddf3917db0f4d2856e9",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 5582,
            "upload_time": "2025-10-29T06:52:57",
            "upload_time_iso_8601": "2025-10-29T06:52:57.099563Z",
            "url": "https://files.pythonhosted.org/packages/73/c7/0f8c8bc69a6a2912ac3d1e4b858b6f9118ed233b6dbbb6bd5145b860d793/dask_stubs-0.1.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-29 06:52:57",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "dask-stubs"
}
        
Elapsed time: 1.46268s