# tronkko/dirent

C/C++ library for retrieving information on files and directories

Repository: https://github.com/tronkko/dirent
Canonical: https://ross.abutalabs.com/products/dirent
Language: C
License: MIT
License Family: permissive
Last push: 2025-07-15T16:48:32+00:00

## Health v2 (maintenance only)
Score: 40/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 31, release rhythm 16, longevity 100
- inputs: {"age_days": 3996, "days_push": 414, "days_rel": 414, "gap_med": 100, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1186, forks 510 (observed 2026-08-28T04:03:54.968639+00:00)

## What it is
A C/C++ library that provides the UNIX dirent.h programming interface for retrieving information about files and directories on Microsoft Windows. It lets applications scan directories with a single codebase across Windows and Linux/UNIX.

## Use cases
- list files in a directory on Windows
- port Linux directory-scanning code to Windows
- cross-platform file and directory traversal in C/C++
- enumerate directory entries with Visual Studio
- replace Windows FindFirstFile with POSIX-style API
- scan folders recursively in a C program

## When to choose
- you need POSIX dirent.h functionality on Windows or Visual Studio
- you want one codebase for directory scanning on both Windows and UNIX-like systems
- you prefer a small, header-based MIT-licensed solution

## When to avoid
- you only target Linux/UNIX, where the native dirent.h already exists
- you need higher-level filesystem features like permissions or metadata beyond directory listing
- you are using C++17 and can rely on std::filesystem instead

## Facets
- artifact type: library
- maturity: stable
- function: file-system
- domain: developer-tools, cross-platform, files
- platform: windows, cpp, c
- tags: dirent, posix-compatibility, directory-scanning, cmake, linux

## Member repositories
- tronkko/dirent (main) score 40

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:54.968639+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:24:05.348286+00:00, confidence not recorded.
  - readme: https://github.com/tronkko/dirent (fetched 2026-08-28T04:03:54.968639+00:00, sha eb71c39bfa20)
- Data as of 2026-08-30T08:39:29.467469+00:00.