feat(stdlib): add pathlib module bindings

[github-actions]

🤖 This is an automated pull request from Repo Assist, an AI assistant for this repository.

Summary

Adds F# bindings for Python's [pathlib]((docs.python.org/redacted) module — the modern, object-oriented path-handling library introduced in Python 3.4 and now preferred over os.path.

The core class is pathlib.Path, which Fable.Python users can now use directly from F#.

What's included

src/stdlib/Pathlib.fs

Construction

• Path(string) — single-segment constructor
• Path(string[]) — multi-segment constructor (varargs)
• Path.cwd() / Path.home() — static factory methods

Properties (all pure, no I/O)

• name, stem, suffix, suffixes, parent, parents, parts, root, anchor, drive

Path arithmetic

• / operator (Path / string and Path / Path)
• joinpath(parts...) — varargs join

Pure transformations

• with_name, with_stem (3.9+), with_suffix
• as_posix, as_uri
• is_absolute, is_relative_to (3.9+, string and Path overloads)

I/O predicates

• exists, is_file, is_dir, is_symlink, is_mount

File I/O

• read_text() / read_text(encoding), read_bytes()
• write_text(data) / write_text(data, encoding), write_bytes(data)

Directory and file operations

• mkdir(), mkdir(mode, parents, exist_ok), mkdir_p() (creates all parents)
• rmdir(), unlink(), unlink(missing_ok)
• rename(target), replace(target) — Path and string overloads
• resolve(), relative_to(other) — Path and string overloads
• expanduser()
• iterdir(), glob(pattern), rglob(pattern)

test/TestPathlib.fs — 36 tests

Covers: construction, properties, path arithmetic, transformations, predicates, file round-trips (write_text/read_text, write_bytes/read_bytes), directory operations (mkdir_p, rmdir, iterdir), and glob.

Trade-offs

• Only Path is bound (not PurePath, PurePosixPath, PureWindowsPath, PosixPath, WindowsPath). Those can be added later if needed; Path covers the vast majority of use cases.
• open() is intentionally omitted — F# idiomatic I/O via read_text/write_text/read_bytes/write_bytes is cleaner.

Usage example

open Fable.Python.Pathlib

let dir = Path.cwd () / "data"
dir.mkdir_p ()
let file = dir / "hello.txt"
file.write_text "Hello, pathlib!" |> ignore
printfn "%s" (file.read_text ())

Note

🔒 Integrity filter blocked 10 items

The following items were blocked because they don't meet the GitHub integrity level.

• support for asynchronous context managers #134 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• allow TextIOWrapper to be enumerated #131 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• auto pip installation of dependencies during compilation of scripts #117 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• typeshed: generate bindings automatically ~ python glutinum? #115 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Pandas binding #65 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Support for Attributes? #48 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• string format specifier '{i:X4}' not working #36 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Create Pyi parser #22 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Roadmap #15 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• How does it generate the python source from AST? #5 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Repo Assist · ● 3M · ◷