from unctools import is_unc_path, parse_unc_path, get_unc_path

# Check if path is UNC
if is_unc_path(r"\\server\share\file.txt"):
    server, share, path = parse_unc_path(r"\\server\share\file.txt")
    print(f"Server: {server}, Share: {share}, Path: {path}")

# Convert drive letter to UNC path
unc_path = get_unc_path("Z:\\")
# Returns: \\server\share (if Z: is mapped to a network share)

from unctools import parse_unc_path

# Parse a UNC path
path = r"\\fileserver\documents\projects\report.docx"
server, share, rel_path = parse_unc_path(path)

print(f"Server: {server}")       # fileserver
print(f"Share: {share}")         # documents
print(f"Path: {rel_path}")       # projects\report.docx

from unctools import is_network_drive, get_network_drives

# Check if drive is network drive
if is_network_drive("Z:"):
    print("Z: is a network drive")

# Get all mapped network drives
network_drives = get_network_drives()
for drive, unc_path in network_drives.items():
    print(f"{drive} -> {unc_path}")

from unctools import get_unc_path, get_drive_letter

# Convert drive letter to UNC
unc = get_unc_path("Z:\\folder\\file.txt")
# Returns: \\server\share\folder\file.txt

# Convert UNC to drive letter (if mapped)
drive = get_drive_letter(r"\\server\share")
# Returns: Z: (if that UNC is mapped to Z:)

from unctools import normalize_long_path

# Handle paths longer than 260 characters
long_path = "C:\\" + "a" * 300 + "\\file.txt"

# Normalize to use \\?\ prefix
normalized = normalize_long_path(long_path)
# Returns: \\?\C:\aaa...aaa\file.txt

# Now can use with Windows file operations
with open(normalized, 'r') as f:
    content = f.read()