dir

What problem does it solve?

References to filesystem paths are error-prone when done with strings; Dir proxies let you model directory structures as interfaces and resolve leaf paths with compile-time checks.

Core Features & Use Cases

• Define interfaces that mirror directory trees and use Dir.of() to obtain a dynamic proxy that resolves to Path objects.
• Navigate subdirectories as nested interfaces and apply @Name annotations to non-identifier filenames.
• Benefit from lazy directory creation and flexible path composition for project scaffolding and resource access.

Quick Start

Create a Dir proxy from your base folder with Dir.of(YourInterface.class, baseDir) and access paths like yourInterface.src().main().resources().