Metadata-Version: 2.4
Name: dask_dirac
Version: 2025.3.1
Summary: DIRAC Executor for Dask
Author-email: Luke Kreczko <kreczko@cern.ch>, Sam Eriksen <sam.eriksen@bristol.ac.uk>
Maintainer-email: The SWIFT-HEP admins <UK-SwiftHep@cern.ch>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Scientific/Engineering
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Development Status :: 3 - Alpha
License-File: LICENSE
Requires-Dist: dask
Requires-Dist: dask_jobqueue
Requires-Dist: jinja2
Requires-Dist: requests
Requires-Dist: typer
Requires-Dist: pandas
Requires-Dist: pytest >=6 ; extra == "dev"
Requires-Dist: Sphinx>=4.0 ; extra == "docs"
Requires-Dist: myst_parser>=0.13 ; extra == "docs"
Requires-Dist: sphinx-book-theme>=0.1.0 ; extra == "docs"
Requires-Dist: sphinx_copybutton ; extra == "docs"
Requires-Dist: pytest >=6 ; extra == "test"
Project-URL: homepage, https://github.com/SWIFT-HEP/dask-dirac
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: test

# dask-dirac

[![Actions Status][actions-badge]][actions-link]
[![Documentation Status][rtd-badge]][rtd-link]
[![Code style: black][black-badge]][black-link]

[![PyPI version][pypi-version]][pypi-link]
[![PyPI platforms][pypi-platforms]][pypi-link]


[actions-badge]:            https://github.com/SWIFT-HEP/dask-dirac/workflows/CI/badge.svg
[actions-link]:             https://github.com/SWIFT-HEP/dask-dirac/actions
[black-badge]:              https://img.shields.io/badge/code%20style-black-000000.svg
[black-link]:               https://github.com/psf/black
[pypi-link]:                https://pypi.org/project/dask-dirac/
[pypi-platforms]:           https://img.shields.io/pypi/pyversions/dask-dirac
[pypi-version]:             https://badge.fury.io/py/dask-dirac.svg
[rtd-badge]:                https://readthedocs.org/projects/dask-dirac/badge/?version=latest
[rtd-link]:                 https://dask-dirac.readthedocs.io/en/latest/?badge=latest
[sk-badge]:                 https://scikit-hep.org/assets/images/Scikit--HEP-Project-blue.svg

dask-dirac is a library for launching a [dask](https://www.dask.org/) cluster with [DIRAC](https://dirac.readthedocs.io/en/latest/).

# Installation

dask-dirac can be installed [from PyPI](https://pypi.org/project/dask-dirac/) using pip.

```bash
pip install dask-dirac
```

# Requirements
1. Open port on localhost (default is 8786). Required for scheduler
2. DIRAC grid certificate

# Usage
A dask-dirac cluster can be setup in a similar fashion to other dask clusters.

```python
from dask_dirac import DiracCluster
from dask.distributed import Client

cluster = DiracCluster()
cluster.scale(jobs=5)
client = Client(cluster)
```

# Acknowledgements
<!-- readme: contributors -start -->
<table>
	<tbody>
		<tr>
            <td align="center">
                <a href="https://github.com/seriksen">
                    <img src="https://avatars.githubusercontent.com/u/5619270?v=4" width="100;" alt="seriksen"/>
                    <br />
                    <sub><b>Null</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/kreczko">
                    <img src="https://avatars.githubusercontent.com/u/1213276?v=4" width="100;" alt="kreczko"/>
                    <br />
                    <sub><b>Luke Kreczko</b></sub>
                </a>
            </td>
		</tr>
	<tbody>
</table>
<!-- readme: contributors -end -->

## Bots
<!-- readme: bots -start -->
<table>
	<tbody>
		<tr>
            <td align="center">
                <a href="https://github.com/dependabot[bot]">
                    <img src="https://avatars.githubusercontent.com/in/29110?v=4" width="100;" alt="dependabot[bot]"/>
                    <br />
                    <sub><b>dependabot[bot]</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/github-actions[bot]">
                    <img src="https://avatars.githubusercontent.com/in/15368?v=4" width="100;" alt="github-actions[bot]"/>
                    <br />
                    <sub><b>github-actions[bot]</b></sub>
                </a>
            </td>
		</tr>
	<tbody>
</table>
<!-- readme: bots -end -->

