sandbox

package
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 18, 2025 License: MIT Imports: 16 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type ExecOptions 

type ExecOptions struct {
	Timeout time.Duration
	WorkDir string
	Env     map[string]string
}

ExecOptions 命令执行选项

type ExecResult 

type ExecResult struct {
	Code   int
	Stdout string
	Stderr string
}

ExecResult 命令执行结果

type Factory 

type Factory struct {
}

Factory 沙箱工厂

func NewFactory 

func NewFactory() *Factory

NewFactory 创建沙箱工厂

func (*Factory) Create 

func (f *Factory) Create(config *types.SandboxConfig) (Sandbox, error)

Create 根据配置创建沙箱

type FileChangeEvent 

type FileChangeEvent struct {
	Path  string
	Mtime time.Time
}

FileChangeEvent 文件变更事件

type FileChangeListener 

type FileChangeListener func(event FileChangeEvent)

FileChangeListener 文件变更监听器

type FileInfo 

type FileInfo struct {
	Path    string
	Size    int64
	ModTime time.Time
	IsDir   bool
	Mode    int
}

FileInfo 文件信息

type GlobOptions 

type GlobOptions struct {
	CWD      string
	Ignore   []string
	Dot      bool
	Absolute bool
}

GlobOptions Glob选项

type LocalFS 

type LocalFS struct {
	// contains filtered or unexported fields
}

LocalFS 本地文件系统实现

func (*LocalFS) Glob 

func (lfs *LocalFS) Glob(ctx context.Context, pattern string, opts *GlobOptions) ([]string, error)

Glob 文件匹配

func (*LocalFS) IsInside 

func (lfs *LocalFS) IsInside(path string) bool

IsInside 检查路径是否在沙箱内

func (*LocalFS) Read 

func (lfs *LocalFS) Read(ctx context.Context, path string) (string, error)

Read 读取文件内容

func (*LocalFS) Resolve 

func (lfs *LocalFS) Resolve(path string) string

Resolve 解析路径为绝对路径

func (*LocalFS) Stat 

func (lfs *LocalFS) Stat(ctx context.Context, path string) (FileInfo, error)

Stat 获取文件状态

func (*LocalFS) Temp 

func (lfs *LocalFS) Temp(name string) string

Temp 生成临时文件路径

func (*LocalFS) Write 

func (lfs *LocalFS) Write(ctx context.Context, path string, content string) error

Write 写入文件内容

type LocalSandbox 

type LocalSandbox struct {
	// contains filtered or unexported fields
}

LocalSandbox 本地沙箱实现

func NewLocalSandbox 

func NewLocalSandbox(config *LocalSandboxConfig) (*LocalSandbox, error)

NewLocalSandbox 创建本地沙箱

func (*LocalSandbox) Dispose 

func (ls *LocalSandbox) Dispose() error

Dispose 释放资源

func (*LocalSandbox) Exec 

func (ls *LocalSandbox) Exec(ctx context.Context, cmd string, opts *ExecOptions) (*ExecResult, error)

Exec 执行命令

func (*LocalSandbox) FS 

func (ls *LocalSandbox) FS() SandboxFS

FS 返回文件系统接口

func (*LocalSandbox) Kind 

func (ls *LocalSandbox) Kind() string

Kind 返回沙箱类型

func (*LocalSandbox) Unwatch 

func (ls *LocalSandbox) Unwatch(watchID string) error

Unwatch 取消监听

func (*LocalSandbox) Watch 

func (ls *LocalSandbox) Watch(paths []string, listener FileChangeListener) (string, error)

Watch 监听文件变更

func (*LocalSandbox) WorkDir 

func (ls *LocalSandbox) WorkDir() string

WorkDir 返回工作目录

type LocalSandboxConfig 

type LocalSandboxConfig struct {
	WorkDir         string
	EnforceBoundary bool
	AllowPaths      []string
	WatchFiles      bool
}

LocalSandboxConfig 本地沙箱配置

type MockFS 

type MockFS struct {
	// contains filtered or unexported fields
}

MockFS 模拟文件系统

func NewMockFS 

func NewMockFS() *MockFS

func (*MockFS) Glob 

func (mfs *MockFS) Glob(ctx context.Context, pattern string, opts *GlobOptions) ([]string, error)

func (*MockFS) IsInside 

func (mfs *MockFS) IsInside(path string) bool

func (*MockFS) Read 

func (mfs *MockFS) Read(ctx context.Context, path string) (string, error)

func (*MockFS) Resolve 

func (mfs *MockFS) Resolve(path string) string

func (*MockFS) Stat 

func (mfs *MockFS) Stat(ctx context.Context, path string) (FileInfo, error)

func (*MockFS) Temp 

func (mfs *MockFS) Temp(name string) string

func (*MockFS) Write 

func (mfs *MockFS) Write(ctx context.Context, path string, content string) error

type MockSandbox 

type MockSandbox struct {
	// contains filtered or unexported fields
}

MockSandbox 模拟沙箱(用于测试)

func NewMockSandbox 

func NewMockSandbox() *MockSandbox

NewMockSandbox 创建模拟沙箱

func (*MockSandbox) Dispose 

func (ms *MockSandbox) Dispose() error

func (*MockSandbox) Exec 

func (ms *MockSandbox) Exec(ctx context.Context, cmd string, opts *ExecOptions) (*ExecResult, error)

func (*MockSandbox) FS 

func (ms *MockSandbox) FS() SandboxFS

func (*MockSandbox) Kind 

func (ms *MockSandbox) Kind() string

func (*MockSandbox) Unwatch 

func (ms *MockSandbox) Unwatch(watchID string) error

func (*MockSandbox) Watch 

func (ms *MockSandbox) Watch(paths []string, listener FileChangeListener) (string, error)

func (*MockSandbox) WorkDir 

func (ms *MockSandbox) WorkDir() string

type RemoteClient 

type RemoteClient struct {
	// contains filtered or unexported fields
}

RemoteClient 远程沙箱客户端

func NewRemoteClient 

func NewRemoteClient(config *RemoteClientConfig) *RemoteClient

NewRemoteClient 创建远程客户端

func (*RemoteClient) Call 

func (rc *RemoteClient) Call(ctx context.Context, method, path string, body interface{}) (*RemoteResponse, error)

Call 调用远程 API

type RemoteClientConfig 

type RemoteClientConfig struct {
	BaseURL   string
	APIKey    string
	APISecret string
	Timeout   time.Duration
	Headers   map[string]string
}

RemoteClientConfig 远程客户端配置

type RemoteFS 

type RemoteFS struct {
	// contains filtered or unexported fields
}

RemoteFS 远程文件系统

func (*RemoteFS) Glob 

func (rfs *RemoteFS) Glob(ctx context.Context, pattern string, opts *GlobOptions) ([]string, error)

Glob 匹配文件 (需要子类实现)

func (*RemoteFS) IsInside 

func (rfs *RemoteFS) IsInside(path string) bool

IsInside 检查路径是否在沙箱内

func (*RemoteFS) Read 

func (rfs *RemoteFS) Read(ctx context.Context, path string) (string, error)

Read 读取文件 (需要子类实现)

func (*RemoteFS) Resolve 

func (rfs *RemoteFS) Resolve(path string) string

Resolve 解析路径为绝对路径

func (*RemoteFS) Stat 

func (rfs *RemoteFS) Stat(ctx context.Context, path string) (FileInfo, error)

Stat 获取文件信息 (需要子类实现)

func (*RemoteFS) Temp 

func (rfs *RemoteFS) Temp(name string) string

Temp 生成临时文件路径

func (*RemoteFS) Write 

func (rfs *RemoteFS) Write(ctx context.Context, path string, content string) error

Write 写入文件 (需要子类实现)

type RemoteResponse 

type RemoteResponse struct {
	StatusCode int
	Body       []byte
	Headers    http.Header
}

RemoteResponse 远程响应

func (*RemoteResponse) JSON 

func (rr *RemoteResponse) JSON(v interface{}) error

JSON 解析 JSON 响应

func (*RemoteResponse) String 

func (rr *RemoteResponse) String() string

String 返回字符串响应

type RemoteSandbox 

type RemoteSandbox struct {
	// contains filtered or unexported fields
}

RemoteSandbox 远程沙箱基础实现

func NewRemoteSandbox 

func NewRemoteSandbox(config *RemoteSandboxConfig) (*RemoteSandbox, error)

NewRemoteSandbox 创建远程沙箱

func (*RemoteSandbox) Dispose 

func (rs *RemoteSandbox) Dispose() error

Dispose 清理资源

func (*RemoteSandbox) Exec 

func (rs *RemoteSandbox) Exec(ctx context.Context, cmd string, opts *ExecOptions) (*ExecResult, error)

Exec 执行命令 (需要子类实现具体的 API 调用)

func (*RemoteSandbox) FS 

func (rs *RemoteSandbox) FS() SandboxFS

FS 返回文件系统接口

func (*RemoteSandbox) Kind 

func (rs *RemoteSandbox) Kind() string

Kind 返回沙箱类型

func (*RemoteSandbox) SessionID 

func (rs *RemoteSandbox) SessionID() string

SessionID 返回会话 ID

func (*RemoteSandbox) SetSessionID 

func (rs *RemoteSandbox) SetSessionID(id string)

SetSessionID 设置会话 ID

func (*RemoteSandbox) Unwatch 

func (rs *RemoteSandbox) Unwatch(watchID string) error

Unwatch 取消监听 (远程沙箱通常不支持)

func (*RemoteSandbox) Watch 

func (rs *RemoteSandbox) Watch(paths []string, listener FileChangeListener) (string, error)

Watch 监听文件变化 (远程沙箱通常不支持)

func (*RemoteSandbox) WorkDir 

func (rs *RemoteSandbox) WorkDir() string

WorkDir 返回工作目录

type RemoteSandboxConfig 

type RemoteSandboxConfig struct {
	BaseURL     string
	APIKey      string
	APISecret   string
	WorkDir     string
	Image       string            // 沙箱镜像
	Region      string            // 区域
	Timeout     time.Duration     // 超时时间
	Environment map[string]string // 环境变量
	Properties  map[string]interface{}
}

RemoteSandboxConfig 远程沙箱配置

type Sandbox 

type Sandbox interface {
	// Kind 返回沙箱类型
	Kind() string

	// WorkDir 返回工作目录
	WorkDir() string

	// FS 返回文件系统接口
	FS() SandboxFS

	// Exec 执行命令
	Exec(ctx context.Context, cmd string, opts *ExecOptions) (*ExecResult, error)

	// Watch 监听文件变更
	Watch(paths []string, listener FileChangeListener) (watchID string, err error)

	// Unwatch 取消监听
	Unwatch(watchID string) error

	// Dispose 释放资源
	Dispose() error
}

Sandbox 沙箱接口

type SandboxFS 

type SandboxFS interface {
	// Resolve 解析路径为绝对路径
	Resolve(path string) string

	// IsInside 检查路径是否在沙箱内
	IsInside(path string) bool

	// Read 读取文件内容
	Read(ctx context.Context, path string) (string, error)

	// Write 写入文件内容
	Write(ctx context.Context, path string, content string) error

	// Temp 生成临时文件路径
	Temp(name string) string

	// Stat 获取文件状态
	Stat(ctx context.Context, path string) (FileInfo, error)

	// Glob 文件匹配
	Glob(ctx context.Context, pattern string, opts *GlobOptions) ([]string, error)
}

SandboxFS 沙箱文件系统接口

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.