native

README

Native backend

Supported targets embed one compressed platform library directly in this Go module. The backend loads without CGO, a Rust toolchain, a separately installed shared object, or runtime network access. Relational execution is always delegated to this backend; unsupported targets return an availability error.

Checked-in targets are Linux amd64/arm64 and macOS arm64. Windows support is intentionally deferred.

The checked-in libraries are refreshed from rust/ by release maintainers. The build-tagged embed files are intentionally small and stable; refreshing an asset changes only its compressed binary.

Documentation

Index

• Variables
• type Frame
  • func (f *Frame) Close()
  • func (f *Frame) Height() int64
  • func (f *Frame) IPC() ([]byte, error)
  • func (f *Frame) SchemaIPC() ([]byte, error)
  • func (f *Frame) Width() int
• type Runtime
  • func Open() (*Runtime, error)
  • func (r *Runtime) ABIVersion() uint32
  • func (r *Runtime) ExecuteFrame(request []byte) (*Frame, error)
  • func (r *Runtime) PolarsVersion() (string, error)
  • func (r *Runtime) Probe() uint64

Variables

var ErrUnavailable = errors.New("golars: native backend is unavailable for this platform")

Types

type Frame

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

Frame is an opaque result retained by the native execution backend. Close releases its native allocation deterministically.

func (*Frame) Close

func (f *Frame) Close()

func (*Frame) Height

func (f *Frame) Height() int64

func (*Frame) IPC

func (f *Frame) IPC() ([]byte, error)

func (*Frame) SchemaIPC

func (f *Frame) SchemaIPC() ([]byte, error)

func (*Frame) Width

func (f *Frame) Width() int

type Runtime

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

func Open

func Open() (*Runtime, error)

func (*Runtime) ABIVersion

func (r *Runtime) ABIVersion() uint32

func (*Runtime) ExecuteFrame

func (r *Runtime) ExecuteFrame(request []byte) (*Frame, error)

ExecuteFrame evaluates a request and keeps the result in the native engine. The returned frame owns the native allocation and must be closed.

func (*Runtime) PolarsVersion

func (r *Runtime) PolarsVersion() (string, error)

func (*Runtime) Probe

func (r *Runtime) Probe() uint64