getFileStream()

// Get file from default branch
const resp = await repo.getFileStream({ path: 'README.md' });
const text = await resp.text();
console.log(text);

// Get file from specific branch, tag, or commit
const historicalResp = await repo.getFileStream({
  path: 'package.json',
  ref: 'v1.0.0', // branch name, tag, or commit SHA
});
const historicalText = await historicalResp.text();

// Fetch from the ephemeral namespace
const ephemeralResp = await repo.getFileStream({
  path: 'notes.md',
  ref: 'feature/demo-work',
  ephemeral: true,
});

const rangedResp = await repo.getFileStream({
  path: 'README.md',
  headers: { range: 'bytes=0-1023' },
});
console.log(rangedResp.status, rangedResp.headers.get('content-range'));

resp = await repo.get_file_stream(
    path="README.md",
    ref="main",       # optional, defaults to the default branch
    ephemeral=False,   # set True to read from the ephemeral namespace
)
text = await resp.aread()
print(text.decode())

historical_resp = await repo.get_file_stream(
    path="package.json",
    ref="v1.0.0",  # branch name, tag, or commit SHA
)
historical_text = await historical_resp.aread()

# Fetch from the ephemeral namespace
ephemeral_resp = await repo.get_file_stream(
    path="notes.md",
    ref="feature/demo-work",
    ephemeral=True,
)

ranged_resp = await repo.get_file_stream(
    path="README.md",
    headers={"range": "bytes=0-1023"},
)
print(ranged_resp.status_code, ranged_resp.headers.get("content-range"))

// Get file content as a stream
resp, err := repo.FileStream(context.Background(), storage.GetFileOptions{
	Path: "README.md",
	Ref:  "main",
})
if err != nil {
	fmt.Printf("Failed to fetch file: %v\n", err)
	return
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
	fmt.Printf("Failed to read file: %v\n", err)
	return
}
fmt.Println(string(body))

// Fetch from the ephemeral namespace
ephemeral := true
ephemeralResp, err := repo.FileStream(context.Background(), storage.GetFileOptions{
	Path:      "notes.md",
	Ref:       "feature/demo-work",
	Ephemeral: &ephemeral,
})
if err != nil {
	fmt.Printf("Failed to read ephemeral file: %v\n", err)
	return
}
defer ephemeralResp.Body.Close()

rangedResp, err := repo.FileStream(context.Background(), storage.GetFileOptions{
	Path: "README.md",
	Headers: storage.FileRequestHeaders{
		Range: "bytes=0-1023",
	},
})
if err != nil {
	fmt.Printf("Failed to fetch range: %v\n", err)
	return
}
defer rangedResp.Body.Close()
fmt.Println(rangedResp.StatusCode, rangedResp.Header.Get("Content-Range"))