rbcsv 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 351d11d92922c2f119bf0e273abddd2cfdbe55fa46eaf2577710f0ef241ceacb
-  data.tar.gz: adee292996af62f55eaf70ab0d927c9fc4b2a5c85cc1687775e6c6507d1851a4
+  metadata.gz: 6081f5083fa0f62ff08812aed7b6ff8fe47fbbc2a2170fc3d5ff3a4c6ef21661
+  data.tar.gz: a73748f6fefbf4a8fced9bf15f1f5db5ae3b4ef4fc11512e0f30a4ceb09b2e3f
 SHA512:
-  metadata.gz: ea495c0d2d329c59b31fe64a9de7643bfb7e6a7d70ec3bbb18c4316659004bb30b88f1ec7a8b197888f877bcf4b1cc335e9042644b1d1e377efdee3cb1912a3c
-  data.tar.gz: d20567b6ca4f1650190ffc74d16405bf6e68d2606dd873e978806c0e132c97b7ca102bb1a00e81d2298d5a539de1c09227596fb5f2a94971beace577bad7fa7c
+  metadata.gz: f2bc15f8586443f6be96a47525688312938141f5d509fe1365b0c83c6e4776c2624678e4e2bdabb926b319875218d03e6e519e317acb42ab7749861197e72a8e
+  data.tar.gz: c0e37e6c24bae12583a538f79b9a0bba74d9b7ce06b16198c9b8764de1a2dd87cbcd1ca0681f580b65220d2a9c532c98fe7cc6fe04ad72cd6fb5a403ead1024a

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [0.1.8] - 2025-01-28
+
+### Added
+- CSV file writing functionality with `RbCsv.write(file_path, data)` method
+- Comprehensive data validation (empty data check, field count consistency)
+- Enhanced error handling for write operations (permission errors, invalid data)
+- Full test coverage for write functionality with executable test script
+
+### Fixed
+- **CRITICAL**: Fixed special character handling in CSV parsing
+  - Removed problematic `escape_sanitize` function that interfered with standard CSV escaping
+  - Now properly preserves backslashes, newlines, tabs, and other special characters
+  - Ensures perfect round-trip fidelity for write/read operations
+- Updated RSpec tests to reflect correct CSV parsing behavior
+
 ## [0.1.7] - 2025-01-28
 
 ### Changed

data/DEVELOPMENT.md

@@ -16,39 +16,6 @@
 - **Linux**: x86_64 / aarch64
 - **Windows**: x86_64（実験的サポート）
 
-## プロジェクト構成
-
-```
-r_csv/
-├── lib/
-│   ├── rbcsv.rb                    # メインのRubyエントリーポイント
-│   └── rbcsv/
-│       ├── version.rb              # バージョン定義
-│       └── rbcsv.bundle            # コンパイル済みネイティブ拡張（生成される）
-├── ext/
-│   └── rbcsv/
-│       ├── src/
-│       │   ├── lib.rs              # Rust拡張のエントリーポイント、Magnus初期化
-│       │   ├── parser.rs           # CSV解析コア、CsvParseOptions定義
-│       │   ├── ruby_api.rs         # Ruby APIバインディング、オプション処理
-│       │   └── error.rs            # エラーハンドリング
-│       ├── Cargo.toml              # Rust依存関係（Magnus 0.8.1使用）
-│       └── extconf.rb              # Ruby拡張ビルド設定
-├── spec/
-│   ├── rbcsv_spec.rb               # メインのRubyテスト
-│   └── spec_helper.rb              # テスト設定
-├── docs/                           # ドキュメント
-├── target/                         # Rustビルド出力（git無視）
-├── tmp/                            # Ruby拡張ビルド中間ファイル（git無視）
-├── *.gem                           # ビルド済みgemファイル
-├── rbcsv.gemspec                   # Gem仕様
-├── Rakefile                        # ビルドタスク（rb_sys使用）
-├── Gemfile                         # Ruby依存関係
-├── Cargo.toml                      # ワークスペース設定
-├── CHANGELOG.md                    # 変更履歴
-├── README.md                       # 使用法ガイド
-└── DEVELOPMENT.md                  # このファイル
-```
 
 ## 開発環境のセットアップ
 
@@ -77,16 +44,100 @@ bundle exec rake compile
 
 ### 4. 動作確認
 
+#### CSV パース機能
+
 ```bash
-# 基本的な動作確認
-ruby -I lib -e "require 'rbcsv'; p RbCsv.parse('a,b\n1,2', {})"
+# 基本的なパース
+ruby -I lib -e "require 'rbcsv'; p RbCsv.parse('a,b\n1,2')"
 # 期待される出力: [["a", "b"], ["1", "2"]]
 
-# オプション付きテスト
-ruby -I lib -e "require 'rbcsv'; p RbCsv.parse(' a , b \n 1 , 2 ', {trim: true})"
+# trim機能付きパース
+ruby -I lib -e "require 'rbcsv'; p RbCsv.parse!(' a , b \n 1 , 2 ')"
 # 期待される出力: [["a", "b"], ["1", "2"]]
 ```
 
+#### CSV ファイル読み込み機能
+
+```bash
+# CSVファイル読み込み
+ruby -I lib -e "require 'rbcsv'; p RbCsv.read('spec/fixtures/test.csv')"
+# 期待される出力: [["name", "age", "city"], ["Alice", "25", "Tokyo"], ...]
+
+# trim機能付きファイル読み込み
+ruby -I lib -e "require 'rbcsv'; p RbCsv.read!('spec/fixtures/test_with_spaces.csv')"
+# 期待される出力: [["name", "age", "city"], ["Alice", "25", "Tokyo"], ...]
+```
+
+#### CSV ファイル書き込み機能
+
+```bash
+# 基本的なファイル書き込み
+ruby -I lib -e "
+require 'rbcsv'
+data = [['name', 'age', 'city'], ['Alice', '25', 'Tokyo'], ['Bob', '30', 'Osaka']]
+RbCsv.write('/tmp/test_output.csv', data)
+puts 'File written successfully!'
+puts File.read('/tmp/test_output.csv')
+"
+# 期待される出力:
+# File written successfully!
+# name,age,city
+# Alice,25,Tokyo
+# Bob,30,Osaka
+
+# 書き込み→読み込みの往復テスト
+ruby -I lib -e "
+require 'rbcsv'
+data = [['product', 'price'], ['Apple', '100'], ['Orange', '80']]
+RbCsv.write('/tmp/roundtrip.csv', data)
+result = RbCsv.read('/tmp/roundtrip.csv')
+puts 'Original data:'
+p data
+puts 'Read back data:'
+p result
+puts 'Match: #{data == result}'
+"
+# 期待される出力: Match: true
+
+# エラーハンドリングテスト（空データ）
+ruby -I lib -e "
+require 'rbcsv'
+begin
+  RbCsv.write('/tmp/empty.csv', [])
+rescue => e
+  puts 'Error caught: #{e.message}'
+end
+"
+# 期待される出力: Error caught: Invalid Data Error: CSV data is empty
+
+# エラーハンドリングテスト（フィールド数不一致）
+ruby -I lib -e "
+require 'rbcsv'
+begin
+  data = [['name', 'age'], ['Alice', '25', 'Tokyo']]
+  RbCsv.write('/tmp/mismatch.csv', data)
+rescue => e
+  puts 'Error caught: #{e.message}'
+end
+"
+# 期待される出力: Error caught: Invalid Data Error: Field count mismatch at line 2: expected 2 fields, got 3 fields
+
+# ファイル上書きテスト
+ruby -I lib -e "
+require 'rbcsv'
+# 最初のデータを書き込み
+RbCsv.write('/tmp/overwrite_test.csv', [['old'], ['data']])
+puts 'First write:'
+puts File.read('/tmp/overwrite_test.csv')
+
+# 新しいデータで上書き
+RbCsv.write('/tmp/overwrite_test.csv', [['new', 'data'], ['updated', 'content']])
+puts 'After overwrite:'
+puts File.read('/tmp/overwrite_test.csv')
+"
+# 期待される出力: 最初にold,dataが出力され、その後new,data形式に変わる
+```
+
 ## ビルドプロセス
 
 ### 自動ビルド（推奨）
@@ -205,28 +256,71 @@ cd ../..
 
 ## API設計
 
-### 現在のAPI（v0.1.6+）
+### 現在のAPI（v0.1.7+）
+
+```ruby
+# 関数ベースAPI（`!`サフィックスでtrim機能分離）
+RbCsv.parse(csv_string)          # 通常のパース
+RbCsv.parse!(csv_string)         # trim機能付きパース
+RbCsv.read(file_path)            # 通常のファイル読み込み
+RbCsv.read!(file_path)           # trim機能付きファイル読み込み
+RbCsv.write(file_path, data)     # CSVファイル書き込み
+
+# データ形式
+data = [
+  ["header1", "header2", "header3"],  # ヘッダー行
+  ["value1", "value2", "value3"],     # データ行
+  # ...
+]
+```
+
+### API進化の履歴
 
+#### v0.1.6以前（オプションベース）
 ```ruby
-# 統一されたオプションベースAPI
-RbCsv.parse(csv_string, options = {})
-RbCsv.read(file_path, options = {})
+RbCsv.parse(csv_string, {trim: true})
+RbCsv.read(file_path, {trim: false})
+```
 
-# 利用可能なオプション
-options = {
-  trim: true/false    # 空白文字の除去（デフォルト: false）
-  # 将来の拡張:
-  # headers: true/false
-  # delimiter: ','
-}
+#### v0.1.7+（関数ベース）
+```ruby
+RbCsv.parse!(csv_string)  # trim版
+RbCsv.write(file_path, data)  # 新機能
 ```
 
 ### 実装アーキテクチャ
 
-1. **parser.rs**: CsvParseOptionsと核となるCSV解析機能
-2. **ruby_api.rs**: Rubyハッシュオプションの処理とMagnus API
+1. **parser.rs**: CSV解析・書き込みコア機能、エラーハンドリング
+2. **ruby_api.rs**: Ruby API関数、Magnus バインディング
 3. **lib.rs**: Magnus初期化と関数登録
-4. **error.rs**: エラーハンドリングとRuby例外の変換
+4. **error.rs**: 包括的なエラーハンドリングとRuby例外変換
+
+### 開発時の重要な注意点
+
+#### Ruby拡張ライブラリの特殊性
+
+```bash
+# ❌ 避けるべき: cargo buildは直接使用しない
+# cargo build は通常のRustライブラリ用で、Ruby拡張では適切にリンクされない
+
+# ✅ 推奨される開発フロー:
+cd ext/rbcsv
+cargo check           # 構文チェック（リンクなし）
+cargo test            # Rust単体テスト
+cd ../..
+bundle exec rake compile  # Ruby拡張ビルド
+bundle exec rspec     # Ruby統合テスト
+```
+
+#### ビルドコマンドの使い分け
+
+| コマンド | 用途 | 場所 | 備考 |
+|---------|------|------|------|
+| `cargo check` | 構文・型チェック | ext/rbcsv | 高速、リンクなし |
+| `cargo test` | Rust単体テスト | ext/rbcsv | Rubyシンボル不要 |
+| `cargo build` | **使用不可** | - | リンクエラーが発生 |
+| `bundle exec rake compile` | Ruby拡張ビルド | プロジェクトルート | 本番用ビルド |
+| `bundle exec rspec` | 統合テスト | プロジェクトルート | 完全な機能テスト |
 
 ## リリース手順
 
@@ -488,4 +582,4 @@ cd ../..
 - [rb_sys Documentation](https://docs.rs/rb_sys/)
 - [Ruby Extension Guide](https://docs.ruby-lang.org/en/master/extension_rdoc.html)
 - [Cargo Book](https://doc.rust-lang.org/cargo/)
-- [RubyGems Guides](https://guides.rubygems.org/)
+- [RubyGems Guides](https://guides.rubygems.org/)

data/README.md

@@ -1,8 +1,6 @@
-# RCsv
+# RbCsv
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/r_csv`. To experiment with that code, run `bin/console` for an interactive prompt.
+A fast CSV processing library for Ruby, built with Rust for high performance. RbCsv provides simple, efficient methods for parsing CSV strings, reading CSV files, and writing CSV data to files.
 
 ## Installation
 
@@ -22,7 +20,70 @@ gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
 
 ## Usage
 
-TODO: Write usage instructions here
+### Parsing CSV strings
+
+```ruby
+require 'rbcsv'
+
+# Parse CSV string
+csv_data = "name,age,city\nAlice,25,Tokyo\nBob,30,Osaka"
+result = RbCsv.parse(csv_data)
+# => [["name", "age", "city"], ["Alice", "25", "Tokyo"], ["Bob", "30", "Osaka"]]
+
+# Parse CSV with automatic whitespace trimming
+csv_with_spaces = " name , age , city \n Alice , 25 , Tokyo "
+result = RbCsv.parse!(csv_with_spaces)
+# => [["name", "age", "city"], ["Alice", "25", "Tokyo"]]
+```
+
+### Reading CSV files
+
+```ruby
+# Read CSV file
+result = RbCsv.read("data.csv")
+# => [["name", "age", "city"], ["Alice", "25", "Tokyo"], ["Bob", "30", "Osaka"]]
+
+# Read CSV file with automatic whitespace trimming
+result = RbCsv.read!("data_with_spaces.csv")
+# => [["name", "age", "city"], ["Alice", "25", "Tokyo"], ["Bob", "30", "Osaka"]]
+```
+
+### Writing CSV files
+
+```ruby
+# Prepare data
+data = [
+  ["name", "age", "city"],
+  ["Alice", "25", "Tokyo"],
+  ["Bob", "30", "Osaka"]
+]
+
+# Write CSV data to file
+RbCsv.write("output.csv", data)
+# Creates a file with:
+# name,age,city
+# Alice,25,Tokyo
+# Bob,30,Osaka
+```
+
+### Error Handling
+
+RbCsv provides detailed error messages for various scenarios:
+
+```ruby
+# Empty data
+RbCsv.write("output.csv", [])
+# => RuntimeError: Invalid Data Error: CSV data is empty
+
+# Inconsistent field count
+data = [["name", "age"], ["Alice", "25", "Tokyo"]]  # 3 fields in second row
+RbCsv.write("output.csv", data)
+# => RuntimeError: Invalid Data Error: Field count mismatch at line 2: expected 2 fields, got 3 fields
+
+# File not found
+RbCsv.read("nonexistent.csv")
+# => RuntimeError: IO Error: File not found: nonexistent.csv
+```
 
 ## Development
 

data/ext/rbcsv/src/error.rs

@@ -19,6 +19,10 @@ pub enum ErrorKind {
     FieldCountMismatch,
     // 空のCSVデータ
     EmptyData,
+    // 書き込み権限エラー
+    WritePermission,
+    // 無効なデータエラー
+    InvalidData,
     // その他のエラー
     #[allow(dead_code)]
     Other,
@@ -32,6 +36,8 @@ impl fmt::Display for CsvError {
             ErrorKind::Encoding => write!(f, "Encoding Error: {}", self.message),
             ErrorKind::FieldCountMismatch => write!(f, "Field Count Mismatch: {}", self.message),
             ErrorKind::EmptyData => write!(f, "Empty Data: {}", self.message),
+            ErrorKind::WritePermission => write!(f, "Write Permission Error: {}", self.message),
+            ErrorKind::InvalidData => write!(f, "Invalid Data Error: {}", self.message),
             ErrorKind::Other => write!(f, "Error: {}", self.message),
         }
     }
@@ -70,6 +76,14 @@ impl CsvError {
     pub fn empty_data() -> Self {
         Self::new(ErrorKind::EmptyData, "CSV data is empty")
     }
+
+    pub fn write_permission(message: impl Into<String>) -> Self {
+        Self::new(ErrorKind::WritePermission, message)
+    }
+
+    pub fn invalid_data(message: impl Into<String>) -> Self {
+        Self::new(ErrorKind::InvalidData, message)
+    }
 }
 
 // csv crateのエラーからの変換

data/ext/rbcsv/src/lib.rs

@@ -3,7 +3,7 @@ mod parser;
 mod ruby_api;
 
 use magnus::{Object, Ruby};
-use ruby_api::{parse, parse_trim, read, read_trim};
+use ruby_api::{parse, parse_trim, read, read_trim, write};
 
 #[magnus::init]
 fn init(ruby: &Ruby) -> Result<(), magnus::Error> {
@@ -13,6 +13,7 @@ fn init(ruby: &Ruby) -> Result<(), magnus::Error> {
     module.define_singleton_method("parse!", magnus::function!(parse_trim, 1))?;
     module.define_singleton_method("read", magnus::function!(read, 1))?;
     module.define_singleton_method("read!", magnus::function!(read_trim, 1))?;
+    module.define_singleton_method("write", magnus::function!(write, 2))?;
 
     Ok(())
 }

data/ext/rbcsv/src/parser.rs

@@ -4,11 +4,9 @@ use std::path::Path;
 
 /// CSV解析のオプション設定
 #[derive(Debug, Clone)]
+#[allow(dead_code)]
 pub struct CsvParseOptions {
     pub trim: bool,
-    // 将来的な拡張用
-    // pub headers: bool,
-    // pub delimiter: char,
 }
 
 impl Default for CsvParseOptions {
@@ -35,13 +33,11 @@ pub fn parse_csv_core(input: &str, trim_config: csv::Trim) -> Result<Vec<Vec<Str
         return Err(CsvError::empty_data());
     }
 
-    // エスケープシーケンスを実際の文字に変換
-    let processed = escape_sanitize(input);
-
+    // CSV crate に任せて適切なパースを行う（escape_sanitize は削除）
     let mut reader = csv::ReaderBuilder::new()
         .has_headers(false) // ヘッダーを無効にして、すべての行を読み込む
         .trim(trim_config)
-        .from_reader(processed.as_bytes());
+        .from_reader(input.as_bytes());
 
     let mut records = Vec::new();
 
@@ -77,13 +73,13 @@ pub fn parse_csv_core(input: &str, trim_config: csv::Trim) -> Result<Vec<Vec<Str
 }
 
 /// オプション設定を使ったCSV解析（文字列用）
-pub fn parse_csv_with_options(input: &str, options: &CsvParseOptions) -> Result<Vec<Vec<String>>, CsvError> {
+pub fn _parse_csv_with_options(input: &str, options: &CsvParseOptions) -> Result<Vec<Vec<String>>, CsvError> {
     let trim_config = if options.trim { csv::Trim::All } else { csv::Trim::None };
     parse_csv_core(input, trim_config)
 }
 
 /// オプション設定を使ったCSV解析（ファイル用）
-pub fn parse_csv_file_with_options(file_path: &str, options: &CsvParseOptions) -> Result<Vec<Vec<String>>, CsvError> {
+pub fn _parse_csv_file_with_options(file_path: &str, options: &CsvParseOptions) -> Result<Vec<Vec<String>>, CsvError> {
     let trim_config = if options.trim { csv::Trim::All } else { csv::Trim::None };
     parse_csv_file(file_path, trim_config)
 }
@@ -184,4 +180,127 @@ mod tests {
         assert_eq!(records[1], vec!["Alice", "25", "Tokyo"]);
         assert_eq!(records[2], vec!["Bob", "30", "Osaka"]);
     }
-}
+
+    #[test]
+    fn test_write_csv_file_basic() {
+
+        let temp_path = "/tmp/test_write_csv.csv";
+        let test_data = vec![
+            vec!["name".to_string(), "age".to_string(), "city".to_string()],
+            vec!["Alice".to_string(), "25".to_string(), "Tokyo".to_string()],
+            vec!["Bob".to_string(), "30".to_string(), "Osaka".to_string()],
+        ];
+
+        // ファイルに書き込み
+        let result = write_csv_file(temp_path, &test_data);
+        assert!(result.is_ok(), "Write should succeed");
+
+        // 書き込んだファイルを読み込んで検証
+        let content = std::fs::read_to_string(temp_path).expect("Failed to read written file");
+        let expected = "name,age,city\nAlice,25,Tokyo\nBob,30,Osaka\n";
+        assert_eq!(content, expected);
+
+        // クリーンアップ
+        let _ = std::fs::remove_file(temp_path);
+    }
+
+    #[test]
+    fn test_write_csv_file_empty_data() {
+        let temp_path = "/tmp/test_write_empty.csv";
+        let empty_data: Vec<Vec<String>> = vec![];
+
+        let result = write_csv_file(temp_path, &empty_data);
+        assert!(result.is_err());
+        if let Err(e) = result {
+            assert!(e.to_string().contains("CSV data is empty"));
+        }
+    }
+
+    #[test]
+    fn test_write_csv_file_field_count_mismatch() {
+        let temp_path = "/tmp/test_write_mismatch.csv";
+        let inconsistent_data = vec![
+            vec!["name".to_string(), "age".to_string()],
+            vec!["Alice".to_string(), "25".to_string(), "Tokyo".to_string()], // 3 fields instead of 2
+        ];
+
+        let result = write_csv_file(temp_path, &inconsistent_data);
+        assert!(result.is_err());
+        if let Err(e) = result {
+            assert!(e.to_string().contains("Field count mismatch"));
+        }
+    }
+
+    #[test]
+    fn test_write_csv_file_permission_denied() {
+        // 書き込み権限のないパスをテスト（rootディレクトリ）
+        let result = write_csv_file("/root/test.csv", &vec![vec!["test".to_string()]]);
+        assert!(result.is_err());
+        if let Err(e) = result {
+            // Permission deniedまたはParent directory does not existのいずれかになる
+            let error_msg = e.to_string();
+            assert!(error_msg.contains("Permission denied") || error_msg.contains("Parent directory does not exist"));
+        }
+    }
+}
+
+/// CSVデータをファイルに書き込む
+pub fn write_csv_file(file_path: &str, data: &[Vec<String>]) -> Result<(), CsvError> {
+    // データ検証：空配列チェック
+    if data.is_empty() {
+        return Err(CsvError::invalid_data("CSV data is empty"));
+    }
+
+    // データ検証：各行のフィールド数一貫性チェック
+    if data.len() > 1 {
+        let expected_len = data[0].len();
+        for (line_num, row) in data.iter().enumerate() {
+            if row.len() != expected_len {
+                let error_msg = format!(
+                    "Field count mismatch at line {}: expected {} fields, got {} fields",
+                    line_num + 1,
+                    expected_len,
+                    row.len()
+                );
+                return Err(CsvError::invalid_data(error_msg));
+            }
+        }
+    }
+
+    // ファイルパス検証：親ディレクトリの存在確認
+    let path = Path::new(file_path);
+    if let Some(parent) = path.parent() {
+        if !parent.exists() {
+            return Err(CsvError::io(format!("Parent directory does not exist: {}", parent.display())));
+        }
+    }
+
+    // CSV Writer作成とデータ書き込み
+    let file = match fs::File::create(path) {
+        Ok(file) => file,
+        Err(e) => {
+            if e.kind() == std::io::ErrorKind::PermissionDenied {
+                return Err(CsvError::write_permission(format!("Permission denied: {}", file_path)));
+            }
+            return Err(CsvError::io(format!("Failed to create file '{}': {}", file_path, e)));
+        }
+    };
+
+    let mut writer = csv::WriterBuilder::new()
+        .has_headers(false)
+        .from_writer(file);
+
+    // データ書き込み
+    for row in data {
+        if let Err(e) = writer.write_record(row) {
+            return Err(CsvError::from(e));
+        }
+    }
+
+    // ファイルフラッシュ：データの確実な書き込み保証
+    if let Err(e) = writer.flush() {
+        return Err(CsvError::io(format!("Failed to flush data to file '{}': {}", file_path, e)));
+    }
+
+    Ok(())
+}

data/ext/rbcsv/src/ruby_api.rs

@@ -1,5 +1,5 @@
 use magnus::{Error as MagnusError, Ruby};
-use crate::parser::{parse_csv_core, parse_csv_file};
+use crate::parser::{parse_csv_core, parse_csv_file, write_csv_file};
 
 /// CSV文字列をパースする（通常版）
 ///
@@ -53,10 +53,23 @@ pub fn read_trim(ruby: &Ruby, file_path: String) -> Result<Vec<Vec<String>>, Mag
         .map_err(|e| MagnusError::new(ruby.exception_runtime_error(), e.to_string()))
 }
 
+/// CSVファイルに書き込む
+///
+/// # Arguments
+/// * `ruby` - Ruby VMの参照
+/// * `file_path` - 書き込み先ファイルのパス
+/// * `data` - 書き込むCSVデータ（2次元配列）
+///
+/// # Returns
+/// * `Result<(), MagnusError>` - 成功時は空、失敗時はエラー
+pub fn write(ruby: &Ruby, file_path: String, data: Vec<Vec<String>>) -> Result<(), MagnusError> {
+    write_csv_file(&file_path, &data)
+        .map_err(|e| MagnusError::new(ruby.exception_runtime_error(), e.to_string()))
+}
+
 
 #[cfg(test)]
 mod tests {
-    use super::*;
 
     #[test]
     fn test_parse_basic() {

data/lib/rbcsv/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RbCsv
-  VERSION = "0.1.7"
+  VERSION = "0.1.8"
 end

data/test_write_functionality.rb

@@ -0,0 +1,225 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# RbCsv.write() 機能のテストスクリプト
+#
+# 実行方法:
+#   ruby test_write_functionality.rb
+#
+# 前提条件:
+#   - bundle exec rake compile でライブラリがビルド済みであること
+
+require_relative 'lib/rbcsv'
+require 'fileutils'
+
+class RbCsvWriteTest
+  def initialize
+    @test_dir = '/tmp/rbcsv_write_tests'
+    @success_count = 0
+    @total_count = 0
+    setup_test_directory
+  end
+
+  def run_all_tests
+    puts "=" * 60
+    puts "RbCsv.write() 機能テスト開始"
+    puts "=" * 60
+    puts
+
+    test_basic_write
+    test_roundtrip_write_read
+    test_file_overwrite
+    test_empty_data_error
+    test_field_count_mismatch_error
+    test_single_row_write
+    test_unicode_content
+    test_special_characters
+
+    puts
+    puts "=" * 60
+    puts "テスト結果: #{@success_count}/#{@total_count} 成功"
+    puts "=" * 60
+
+    cleanup_test_directory
+
+    if @success_count == @total_count
+      puts "✅ すべてのテストが成功しました！"
+      exit 0
+    else
+      puts "❌ 一部のテストが失敗しました"
+      exit 1
+    end
+  end
+
+  private
+
+  def setup_test_directory
+    FileUtils.mkdir_p(@test_dir)
+    puts "テストディレクトリを作成: #{@test_dir}"
+  end
+
+  def cleanup_test_directory
+    FileUtils.rm_rf(@test_dir)
+    puts "テストディレクトリを削除: #{@test_dir}"
+  end
+
+  def run_test(name)
+    @total_count += 1
+    print "#{name}... "
+
+    begin
+      yield
+      @success_count += 1
+      puts "✅ 成功"
+    rescue => e
+      puts "❌ 失敗: #{e.message}"
+      puts "   #{e.backtrace.first}"
+    end
+  end
+
+  def test_basic_write
+    run_test("基本的なCSV書き込み") do
+      file_path = File.join(@test_dir, 'basic.csv')
+      data = [
+        ['name', 'age', 'city'],
+        ['Alice', '25', 'Tokyo'],
+        ['Bob', '30', 'Osaka']
+      ]
+
+      RbCsv.write(file_path, data)
+
+      content = File.read(file_path)
+      expected = "name,age,city\nAlice,25,Tokyo\nBob,30,Osaka\n"
+
+      raise "書き込み内容が期待値と異なります" unless content == expected
+    end
+  end
+
+  def test_roundtrip_write_read
+    run_test("書き込み→読み込みの往復テスト") do
+      file_path = File.join(@test_dir, 'roundtrip.csv')
+      original_data = [
+        ['product', 'price', 'category'],
+        ['Apple', '100', 'Fruit'],
+        ['Carrot', '50', 'Vegetable']
+      ]
+
+      RbCsv.write(file_path, original_data)
+      read_data = RbCsv.read(file_path)
+
+      raise "往復テストで元データと異なります" unless original_data == read_data
+    end
+  end
+
+  def test_file_overwrite
+    run_test("ファイル上書きテスト") do
+      file_path = File.join(@test_dir, 'overwrite.csv')
+
+      # 最初のデータ
+      first_data = [['old'], ['data']]
+      RbCsv.write(file_path, first_data)
+      first_content = File.read(file_path)
+
+      # 上書き
+      second_data = [['new', 'header'], ['updated', 'content']]
+      RbCsv.write(file_path, second_data)
+      second_content = File.read(file_path)
+
+      expected_first = "old\ndata\n"
+      expected_second = "new,header\nupdated,content\n"
+
+      raise "最初の書き込み内容が不正" unless first_content == expected_first
+      raise "上書き後の内容が不正" unless second_content == expected_second
+    end
+  end
+
+  def test_empty_data_error
+    run_test("空データエラーテスト") do
+      file_path = File.join(@test_dir, 'empty.csv')
+
+      error_raised = false
+      begin
+        RbCsv.write(file_path, [])
+      rescue RuntimeError => e
+        error_raised = true
+        raise "エラーメッセージが期待値と異なります" unless e.message.include?("CSV data is empty")
+      end
+
+      raise "空データでエラーが発生しませんでした" unless error_raised
+    end
+  end
+
+  def test_field_count_mismatch_error
+    run_test("フィールド数不一致エラーテスト") do
+      file_path = File.join(@test_dir, 'mismatch.csv')
+      inconsistent_data = [
+        ['name', 'age'],
+        ['Alice', '25', 'Tokyo']  # 3フィールド（期待は2フィールド）
+      ]
+
+      error_raised = false
+      begin
+        RbCsv.write(file_path, inconsistent_data)
+      rescue RuntimeError => e
+        error_raised = true
+        unless e.message.include?("Field count mismatch") && e.message.include?("line 2")
+          raise "エラーメッセージが期待値と異なります: #{e.message}"
+        end
+      end
+
+      raise "フィールド数不一致でエラーが発生しませんでした" unless error_raised
+    end
+  end
+
+  def test_single_row_write
+    run_test("単一行書き込みテスト") do
+      file_path = File.join(@test_dir, 'single.csv')
+      data = [['single', 'row', 'test']]
+
+      RbCsv.write(file_path, data)
+      content = File.read(file_path)
+      expected = "single,row,test\n"
+
+      raise "単一行の書き込み内容が不正" unless content == expected
+    end
+  end
+
+  def test_unicode_content
+    run_test("Unicode文字テスト") do
+      file_path = File.join(@test_dir, 'unicode.csv')
+      data = [
+        ['名前', '年齢', '都市'],
+        ['田中太郎', '30', '東京'],
+        ['山田花子', '25', '大阪'],
+        ['🎉', '😀', '🌸']
+      ]
+
+      RbCsv.write(file_path, data)
+      read_data = RbCsv.read(file_path)
+
+      raise "Unicode文字の往復テストが失敗" unless data == read_data
+    end
+  end
+
+  def test_special_characters
+    run_test("特殊文字テスト") do
+      file_path = File.join(@test_dir, 'special.csv')
+      data = [
+        ['field1', 'field2', 'field3'],
+        ['comma,test', 'quote"test', 'newline\ntest'],
+        ['tab\ttest', 'backslash\\test', 'normal']
+      ]
+
+      RbCsv.write(file_path, data)
+      read_data = RbCsv.read(file_path)
+
+      raise "特殊文字の往復テストが失敗" unless data == read_data
+    end
+  end
+end
+
+# テスト実行
+if __FILE__ == $0
+  tester = RbCsvWriteTest.new
+  tester.run_all_tests
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rbcsv
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - fujitani sora
@@ -64,6 +64,7 @@ files:
 - test.rb
 - test_fixed.rb
 - test_install.rb
+- test_write_functionality.rb
 homepage: https://github.com/fs0414/rbcsv
 licenses:
 - MIT