---
id: provide-dir
version: "0.1.2"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# provide-dir — Provides a directory with all its parent directories, if it does not yet exist

License: permissive · Maintenance: abandoned · Downloads: 306.4K/mo

## What it is and what it does

provide_dir is a minimal utility that wraps directory creation with a reporting mechanism. It takes a Path object and a sink function (typically print), then creates the directory and all parent directories if needed, writing a message to the sink to indicate whether the directory was newly created or already existed.

The package is straightforward: it solves the common task of ensuring a directory exists before writing to it, while also providing visibility into whether that directory was freshly made. It requires Python 3.9 or later and depends on colorama for output formatting.

Use it for:

- Ensure a log directory exists before writing application logs, with confirmation output.
- Set up nested configuration directories during application initialization.
- Create output directories in build or test scripts with visibility into what was created.

## Worth the install?

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

Creates a directory and all its parent directories if they don't exist, reporting the outcome to a provided sink function like print.

Yes, if you need simple directory creation with reporting. The package is abandoned but stable, carries no vulnerabilities, and has low install friction. Use it for straightforward mkdir-with-parents tasks where you want to know whether the directory was newly created. If you need active maintenance or complex filesystem operations, consider using pathlib.Path.mkdir directly.

## Install

pip install provide-dir
uv add provide-dir
poetry add provide-dir

## Installing provide-dir

Before you install: Low friction to install. The package is abandoned (last commit 2022-04-13, 1584 days old) but carries no known vulnerabilities and depends only on colorama.

License in practice: Licensed under MIT (permissive), so you can use it freely in commercial and open-source projects without restriction.

Quickstart:

from pathlib import Path
from provide_dir import provide_dir

needed_path = Path("/path/to/directory/with/subdirectories")
provide_dir(needed_path, print)

Requires Python 3.9 or later.

Verify before relying:

- Whether colorama is actually used at runtime or only in development/testing.
- Whether the package handles edge cases like permission errors or symlinks gracefully.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 306.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

recursive directory creation, mkdir with parents, create nested directories, makedirs wrapper, directory existence check, filesystem-utilities, path-management

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