fce7555e46
Task 2: FsApi / Ring0FsFileIo 拡張 - FsApi trait に append_all(path, data) メソッド追加 - StdFsApi で append_all() を std::fs::OpenOptions で実装 - Ring0FsFileIo に mode を保持、write() で truncate/append を切り替え - Ring0FsFileIo に内部 metadata() ヘルパ追加（FsApi.metadata() 呼び出し） Task 3: FileHandleBox API 実装 - open(path, mode) で "r"/"w"/"a" 3モードをサポート - write_all() で read-only mode チェック - 内部 Rust API：size / exists / is_file / is_dir メソッド実装 （NyashBox 公開は Phase 112+ に延期） Task 5: テスト + ドキュメント - 4つの新テスト PASS： - test_filehandlebox_append_mode（write→append→内容確認） - test_filehandlebox_metadata_size（size() 取得） - test_filehandlebox_metadata_is_file（is_file()/is_dir()） - test_filehandlebox_write_readonly_error（"r"で write 拒否） 統計： - 9ファイル修正（+316行, -35行） - 4つの新テスト追加（既存15テスト全PASS） - cargo build --release: SUCCESS - 11個のチェックリスト: ✅ ALL PASS 次フェーズ（Phase 112-114）の backlog も指示書で整理済み 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
130 lines
3.5 KiB
Rust
130 lines
3.5 KiB
Rust
//! Phase 88: Ring0 trait 定義
|
||
//!
|
||
//! OS API レイヤーの純粋な抽象化。
|
||
//! Box 名・Nyash 型を一切知らない。
|
||
|
||
use super::errors::{IoError, TimeError};
|
||
use std::path::{Path, PathBuf};
|
||
use std::time::SystemTime;
|
||
|
||
/// メモリ API（Phase 88: noop、将来 hakmem 接続）
|
||
pub trait MemApi: Send + Sync {
|
||
/// メモリ割り当て（Phase 88: 未実装）
|
||
fn alloc(&self, size: usize) -> *mut u8;
|
||
|
||
/// メモリ解放（Phase 88: 未実装）
|
||
fn free(&self, ptr: *mut u8);
|
||
|
||
/// メモリ統計（Phase 88: 未実装）
|
||
fn stats(&self) -> MemStats;
|
||
}
|
||
|
||
/// メモリ統計情報
|
||
#[derive(Debug, Default, Clone)]
|
||
pub struct MemStats {
|
||
pub allocated: usize,
|
||
pub freed: usize,
|
||
pub current: usize,
|
||
}
|
||
|
||
/// IO API
|
||
pub trait IoApi: Send + Sync {
|
||
/// 標準出力への書き込み
|
||
fn stdout_write(&self, data: &[u8]) -> Result<(), IoError>;
|
||
|
||
/// 標準エラー出力への書き込み
|
||
fn stderr_write(&self, data: &[u8]) -> Result<(), IoError>;
|
||
|
||
/// 標準入力からの読み込み
|
||
fn stdin_read(&self, buf: &mut [u8]) -> Result<usize, IoError>;
|
||
}
|
||
|
||
/// 時刻 API
|
||
pub trait TimeApi: Send + Sync {
|
||
/// 現在時刻取得
|
||
fn now(&self) -> Result<SystemTime, TimeError>;
|
||
|
||
/// モノトニック時刻取得（高精度タイマー用）
|
||
fn monotonic_now(&self) -> Result<std::time::Instant, TimeError>;
|
||
|
||
/// 経過時間取得 (Phase 90-C)
|
||
fn elapsed(&self, start: std::time::Instant) -> std::time::Duration;
|
||
}
|
||
|
||
/// ログレベル
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||
pub enum LogLevel {
|
||
Debug,
|
||
Info,
|
||
Warn,
|
||
Error,
|
||
}
|
||
|
||
/// ログ API
|
||
pub trait LogApi: Send + Sync {
|
||
/// ログ出力
|
||
fn log(&self, level: LogLevel, msg: &str);
|
||
|
||
/// デバッグログ（便利メソッド）
|
||
fn debug(&self, msg: &str) {
|
||
self.log(LogLevel::Debug, msg);
|
||
}
|
||
|
||
/// 情報ログ（便利メソッド）
|
||
fn info(&self, msg: &str) {
|
||
self.log(LogLevel::Info, msg);
|
||
}
|
||
|
||
/// 警告ログ（便利メソッド）
|
||
fn warn(&self, msg: &str) {
|
||
self.log(LogLevel::Warn, msg);
|
||
}
|
||
|
||
/// エラーログ（便利メソッド）
|
||
fn error(&self, msg: &str) {
|
||
self.log(LogLevel::Error, msg);
|
||
}
|
||
}
|
||
|
||
/// ファイルシステムメタデータ
|
||
#[derive(Debug, Clone)]
|
||
pub struct FsMetadata {
|
||
pub is_file: bool,
|
||
pub is_dir: bool,
|
||
pub len: u64,
|
||
}
|
||
|
||
/// ファイルシステム API (Phase 90-A)
|
||
pub trait FsApi: Send + Sync {
|
||
/// ファイルを文字列として読み込む
|
||
fn read_to_string(&self, path: &Path) -> Result<String, IoError>;
|
||
|
||
/// ファイルをバイト列として読み込む
|
||
fn read(&self, path: &Path) -> Result<Vec<u8>, IoError>;
|
||
|
||
/// ファイルに書き込む
|
||
fn write_all(&self, path: &Path, data: &[u8]) -> Result<(), IoError>;
|
||
|
||
/// ファイルに追記（append）
|
||
///
|
||
/// ファイルが存在しない場合は新規作成、存在する場合は末尾に追記。
|
||
/// Phase 111: write_all と対称的に提供。
|
||
fn append_all(&self, path: &Path, data: &[u8]) -> Result<(), IoError>;
|
||
|
||
/// パスが存在するか確認
|
||
fn exists(&self, path: &Path) -> bool;
|
||
|
||
/// ファイルメタデータを取得
|
||
fn metadata(&self, path: &Path) -> Result<FsMetadata, IoError>;
|
||
|
||
/// パスを正規化
|
||
fn canonicalize(&self, path: &Path) -> Result<PathBuf, IoError>;
|
||
}
|
||
|
||
/// スレッド API (Phase 90-D)
|
||
pub trait ThreadApi: Send + Sync {
|
||
/// 指定時間スリープ
|
||
fn sleep(&self, duration: std::time::Duration);
|
||
// spawn は Phase 91 以降で追加予定
|
||
}
|