---
id: darkgraylib
version: "2.4.1"
license: BSD-3-Clause
license_treatment: permissive
maintenance: aging
---

# darkgraylib — Common supporting code for Darker and Graylint

License: permissive · Maintenance: aging · Downloads: 212.4K/mo

## What it is and what it does

Darkgraylib is a shared library extracted from the Darker codebase to hold common functionality used by both Darker and Graylint. These two tools originated from the same code base but diverged in purpose—Darker focuses on code formatting while Graylint handles linting. Rather than duplicating maintenance effort, the shared under-the-hood pieces were factored into this package.

The package depends only on toml and supports Python 3.9 through 3.14. It is primarily intended to reduce code duplication between Darker and Graylint, though it is published as a public package. The repository is active but aging, with the last release 285 days ago.

Use it for:

- Install as a dependency when using Darker or Graylint, which both rely on this shared library.
- Develop extensions or tools that need to share code patterns with Darker or Graylint.
- Reference implementation patterns from the Darker/Graylint ecosystem for your own code quality tooling.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides shared utility code and abstractions used by Darker and Graylint, two Python code formatting and linting tools that evolved from a common codebase.

Yes, if you are using Darker or Graylint—it will be installed automatically as a dependency. As a standalone package, install it only if you are building tools that need to integrate with or extend the Darker/Graylint ecosystem. The aging maintenance status (285 days since last release) suggests it is stable but not actively developed; check whether Darker or Graylint have recent updates before relying on new features.

## Install

pip install darkgraylib
uv add darkgraylib
poetry add darkgraylib

## Installing darkgraylib

Before you install: Low install friction with a single runtime dependency (toml). Maintenance status is aging—last release was 285 days ago, though the repository remains active with a recent commit on 2025-11-02.

License in practice: BSD-3-Clause permissive license allows use in most projects without significant restriction, though you should review the full license terms if your project has specific licensing requirements.

Quickstart:

pip install darkgraylib

import darkgraylib
# Use shared utilities provided by the package

Requires Python 3.9 or later; supports Python 3.9 through 3.14.

Verify before relying:

- What specific utilities and abstractions does darkgraylib export for direct use outside Darker and Graylint?
- Is this package intended as a public API or primarily as an internal shared dependency for those two tools?

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 212.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

shared code library darker graylint, common utilities code formatting, darker graylint dependencies, python linting shared library, code quality tool infrastructure, code-quality, shared-library

[View on SkillFed](https://skillfed.io/packages/darkgraylib) · [View on PyPI](https://pypi.org/project/darkgraylib/)