File & directory metadata

entries = volume.files.list("/datasets")
for item in entries:
    print(item.path, item.type, item.size)

nullspace volume ls-files team-data /
nullspace volume ls-files team-data /datasets

curl -X GET "${NULLSPACE_API_URL}/v1/volumes/vol_123/files?path=/datasets" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}"

info = volume.files.info("/datasets/report.txt")
print(info.path, info.type, info.size, info.modified_at)

same = volume.files.get_info("/datasets/report.txt")

nullspace volume info team-data /datasets/report.txt
nullspace volume stat team-data /datasets/report.txt

curl -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/info" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets/report.txt"}'

if volume.files.exists("/datasets/report.txt"):
    print("present")

nullspace volume exists team-data /datasets/report.txt

curl -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/exists" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets/report.txt"}'

volume.files.make_dir("/datasets")

nullspace volume mkdir team-data /datasets

curl -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/mkdir" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets"}'

content_matches = volume.files.find_files("/datasets", "needle")
name_matches = volume.files.search_files("/datasets", "*.json")

nullspace volume find team-data /datasets "needle"
nullspace volume search team-data /datasets "*.json"

curl -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/find" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets", "pattern": "needle"}'

curl -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/search" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets", "pattern": "*.json"}'

def on_event(event):
    print(event.type, event.path)

with volume.files.watch_dir("/datasets", on_event=on_event, recursive=True):
    ...

nullspace volume watch team-data /datasets --recursive --timeout 30