files.getInfo() / files.get_info() 方法获取文件或目录的元数据。它会返回文件名、类型、路径等详细信息。
获取文件元数据
from ppio_sandbox import PPIO
ppio = PPIO()
sandbox = ppio.sandbox.create()
# 创建测试文件
file_path_in_sandbox = '/tmp/test-file'
sandbox.files.write(file_path_in_sandbox, 'test-file-content')
# 获取文件元数据
info = sandbox.files.get_info(file_path_in_sandbox)
print(info)
# EntryInfo(
# name='test-file',
# type=<FileType.FILE: 'file'>,
# path='/tmp/test-file',
# size=17,
# mode=420,
# permissions='-rw-r--r--',
# owner='user',
# group='user',
# modified_time=datetime.datetime(2026, 6, 3, 12, 14, 34, 745328),
# symlink_target=None
# )
sandbox.kill()
import { PPIO } from 'ppio-sandbox'
const ppio = new PPIO()
const sandbox = await ppio.sandbox.create()
// 创建测试文件
const filePathInSandbox = '/tmp/test-file'
await sandbox.files.write(filePathInSandbox, 'test-file-content')
// 获取文件元数据
const info = await sandbox.files.getInfo(filePathInSandbox)
console.log(info)
// {
// name: 'test-file',
// type: 'file',
// path: '/tmp/test-file',
// size: 17,
// mode: 420,
// permissions: '-rw-r--r--',
// owner: 'user',
// group: 'user',
// modifiedTime: 2026-06-03T12:12:23.964Z,
// symlinkTarget: undefined
// }
await sandbox.kill()
获取目录元数据
from ppio_sandbox import PPIO
ppio = PPIO()
sandbox = ppio.sandbox.create()
# 创建测试目录
dir_path_in_sandbox = '/tmp/test-dir'
sandbox.files.make_dir(dir_path_in_sandbox)
# 获取目录元数据
info = sandbox.files.get_info(dir_path_in_sandbox)
print(info)
# EntryInfo(
# name='test-dir',
# type=<FileType.DIR: 'dir'>,
# path='/tmp/test-dir',
# size=40,
# mode=493,
# permissions='drwxr-xr-x',
# owner='user',
# group='user',
# modified_time=datetime.datetime(2026, 6, 3, 12, 16, 4, 858056),
# symlink_target=None
# )
sandbox.kill()
import { PPIO } from 'ppio-sandbox'
const ppio = new PPIO()
const sandbox = await ppio.sandbox.create()
// 创建测试目录
const dirPathInSandbox = '/tmp/test-dir'
await sandbox.files.makeDir(dirPathInSandbox)
// 获取目录元数据
const info = await sandbox.files.getInfo(dirPathInSandbox)
console.log(info)
// {
// name: 'test-dir',
// type: 'dir',
// path: '/tmp/test-dir',
// size: 40,
// mode: 493,
// permissions: 'drwxr-xr-x',
// owner: 'user',
// group: 'user',
// modifiedTime: 2026-06-03T12:13:59.194Z,
// symlinkTarget: undefined
// }
await sandbox.kill()