ne_api 0.0.20 → 0.0.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e241f3b24f869c7bcb7050bbee61f91d7c0c99c11bda2518281c8dbde419b803
-  data.tar.gz: a363f2cf97b9e42d46ca3ccab11f68a0ba54db984666f1e1e21c0988b16c3dd8
+  metadata.gz: 7c0274cd24bfbca15098ae69851b86bab0fd70bef4df5b802c42208525ddfb01
+  data.tar.gz: f1456cf436fd67297e14e30d3fd869279d69582ff77fd6b131f2d4acfd253f5c
 SHA512:
-  metadata.gz: 1d9a90de06e6932495889e9df2894cc057a5d53f3f49f168792f4cb18ce1c40d20d199ebd7e47daa1b549dd691b572bd474302e32dac1ba83dcdb10f6886b746
-  data.tar.gz: dc0c006a3f0aedda28f2dbdc290eddf8f053152f7adab62979e0256854925b6d5771deafba3eec13356e5cbf1869a5f7aaeb850be9c6fdecb762a8b5b2a80e0a
+  metadata.gz: c56d55baa11ef1e6b321d6de18e76cebb971837c74da56fde6f49d2292620c1a7d4dcbef49a7a8c1c9b8ee30cbc719a610ee66ac8b0dcb6c41222ff59950d5f1
+  data.tar.gz: 578330d042baf2e7de275f37bd07480be2368ef361828c7e1c8369bc0b8c71ef5da694f2bdc552cb1da3f0a32c14dbfda6b06d5f5122d474e6575478bf317faf

data/README.md

@@ -103,6 +103,160 @@ end
 
 ```
 
+## Testing Support (RSpec)
+
+ne_api provides built-in stub classes for testing in Rails applications.
+
+### Setup
+
+Add to your `spec/rails_helper.rb`:
+
+```ruby
+require 'ne_api/testing'
+
+RSpec.configure do |config|
+  config.include NeAPI::Testing::RSpecHelpers
+end
+```
+
+### Basic Usage
+
+#### Using `with_fake_ne_api` block
+
+```ruby
+RSpec.describe OrderSyncService do
+  it "syncs orders from Next Engine" do
+    with_fake_ne_api do |fake|
+      # Stub API responses
+      fake.stub(:receiveorder_base_search, [
+        ne_receive_order(receive_order_id: "ORDER001", receive_order_total_amount: 5000),
+        ne_receive_order(receive_order_id: "ORDER002", receive_order_total_amount: 3000)
+      ])
+
+      service = OrderSyncService.new
+      result = service.sync
+
+      expect(result.count).to eq 2
+      expect(fake.called?(:receiveorder_base_search)).to be true
+      expect(fake.call_count(:receiveorder_base_search)).to eq 1
+    end
+  end
+end
+```
+
+#### Direct injection (recommended for services with DI)
+
+```ruby
+RSpec.describe StockService do
+  let(:fake_master) { fake_ne_master }
+
+  before do
+    fake_master.stub(:master_stock_search, [
+      ne_stock(stock_goods_id: "GOODS001", stock_quantity: 100)
+    ])
+  end
+
+  it "fetches stock data" do
+    service = StockService.new(ne_api: fake_master)
+    stocks = service.fetch_all
+
+    expect(stocks.first["stock_quantity"]).to eq 100
+  end
+end
+```
+
+### Simulating Errors
+
+```ruby
+it "handles API errors" do
+  with_fake_ne_api do |fake|
+    fake.simulate_error(code: "001001", message: "Authentication failed")
+
+    expect { service.sync }.to raise_error(NeAPIException, /001001/)
+  end
+end
+```
+
+### Authentication Testing
+
+```ruby
+RSpec.describe AuthController do
+  it "authenticates user" do
+    with_fake_ne_auth do |fake_auth|
+      fake_auth.stub_auth_response({
+        "access_token" => "custom_access_token",
+        "refresh_token" => "custom_refresh_token",
+        "company_ne_id" => "NE999999"
+      })
+
+      post :callback, params: { uid: "test_uid", state: "test_state" }
+
+      expect(session[:access_token]).to eq "custom_access_token"
+    end
+  end
+
+  it "handles authentication failure" do
+    with_fake_ne_auth do |fake_auth|
+      fake_auth.stub_auth_failure
+
+      expect {
+        post :callback, params: { uid: "test_uid", state: "test_state" }
+      }.to raise_error(NeAPIException)
+    end
+  end
+end
+```
+
+### Available Factory Methods
+
+| Method | Description |
+|--------|-------------|
+| `ne_goods(**attrs)` | Generate goods master data |
+| `ne_goods_list(count)` | Generate list of goods |
+| `ne_stock(**attrs)` | Generate stock data |
+| `ne_stock_list(count)` | Generate list of stocks |
+| `ne_receive_order(**attrs)` | Generate receive order data |
+| `ne_receive_order_list(count)` | Generate list of orders |
+| `ne_receive_order_row(**attrs)` | Generate order row data |
+| `ne_shop(**attrs)` | Generate shop data |
+| `ne_warehouse_stock(**attrs)` | Generate warehouse stock data |
+| `ne_company_info(**attrs)` | Generate company info |
+| `ne_user_info(**attrs)` | Generate user info |
+| `ne_error(code:, message:)` | Generate error response |
+
+### FakeMaster Methods
+
+| Method | Description |
+|--------|-------------|
+| `stub(method_name, response)` | Stub a specific API method |
+| `simulate_error(code:, message:)` | Enable error mode |
+| `clear_error` | Disable error mode |
+| `reset!` | Clear all stubs and history |
+| `called?(method_name)` | Check if method was called |
+| `call_count(method_name)` | Get call count |
+| `last_call_args(method_name)` | Get last call arguments |
+
+### Service Design for Testability
+
+For best testability, design your services to accept `ne_api` as a dependency:
+
+```ruby
+class OrderSyncService
+  def initialize(ne_api: nil)
+    @ne_api = ne_api || NeAPI::Master.new(
+      access_token: Rails.application.credentials.ne_access_token,
+      refresh_token: Rails.application.credentials.ne_refresh_token
+    )
+  end
+
+  def sync
+    @ne_api.receiveorder_base_search
+  end
+end
+```
+
+This allows easy injection of `FakeMaster` in tests.
+
 ## Contributing
 
 1. Fork it ( https://github.com/[my-github-username]/ne_api/fork )
@@ -112,6 +266,9 @@ end
 5. Create a new Pull Request
 
 ## Update
+### ver0.0.21
+  * 倉庫別の在庫などに対応
+  * rspecも作成
 ### ver0.0.18
   * 受注税金内訳取得APIに対応
 ### ver0.0.17

data/config/api.yaml

@@ -309,3 +309,9 @@
   :prefix: warehouse_stock
   :fields: warehouse_id,goods_id,quantity,allocation_quantity,free_quantity
 
+:warehouse_base:
+  :method
+  - count
+  - search
+  :prefix: warehouse
+  :fields: id,name,create_date

data/lib/ne_api/testing/fake_auth.rb

@@ -0,0 +1,109 @@
+module NeAPI
+  module Testing
+    # NeAPI::Auth のスタブクラス
+    #
+    # @example 基本的な使い方
+    #   fake = NeAPI::Testing::FakeAuth.new(redirect_url: "http://localhost:3000/callback")
+    #   fake.ne_auth("uid123", "state456")
+    #   fake.tokens  #=> { access_token: "...", refresh_token: "..." }
+    #
+    # @example カスタムレスポンス
+    #   fake.stub_auth_response({ "access_token" => "custom_token", ... })
+    #   fake.ne_auth("uid", "state")
+    #
+    # @example 認証失敗のシミュレート
+    #   fake.stub_auth_failure
+    #   fake.ne_auth("uid", "state")  #=> raises NeAPIException
+    #
+    class FakeAuth
+      attr_accessor :redirect_url, :ne_user, :wait_flag
+
+      def initialize(redirect_url: "http://localhost:3000/callback")
+        @redirect_url = redirect_url
+        @ne_user = nil
+        @wait_flag = false
+        @auth_response = nil
+        @should_fail = false
+      end
+
+      # 認証レスポンスをカスタマイズする
+      #
+      # @param response [Hash] 認証レスポンス
+      # @return [self]
+      def stub_auth_response(response)
+        @auth_response = response
+        self
+      end
+
+      # 認証失敗をシミュレートする
+      #
+      # @return [self]
+      def stub_auth_failure
+        @should_fail = true
+        self
+      end
+
+      # スタブをリセットする
+      #
+      # @return [self]
+      def reset!
+        @ne_user = nil
+        @auth_response = nil
+        @should_fail = false
+        self
+      end
+
+      # ブラウザを開かずにサインインURLを返す
+      #
+      # @param client_id [String] クライアントID
+      # @param client_secret [String] クライアントシークレット
+      # @return [String] コールバックURLの例
+      def sign_in(client_id = nil, client_secret = nil)
+        # 実際のブラウザは開かない
+        # テスト用にコールバックURLを返す
+        "#{@redirect_url}?uid=test_uid&state=test_state"
+      end
+
+      # 認証処理のスタブ
+      #
+      # @param uid [String] UID
+      # @param state [String] State
+      # @param client_id [String] クライアントID
+      # @param client_secret [String] クライアントシークレット
+      # @return [Hash] 認証レスポンス
+      # @raise [NeAPIException] 認証失敗時
+      def ne_auth(uid, state, client_id = nil, client_secret = nil)
+        raise NeAPIException, "003001:認証に失敗しました" if @should_fail
+
+        @ne_user = @auth_response || default_auth_response(uid)
+      end
+
+      # トークンを取得する
+      #
+      # @return [Hash, nil] トークン情報
+      def tokens
+        return nil if @ne_user.nil?
+
+        {
+          access_token: @ne_user["access_token"],
+          refresh_token: @ne_user["refresh_token"]
+        }
+      end
+
+      private
+
+      def default_auth_response(uid)
+        {
+          "result" => "success",
+          "uid" => uid,
+          "access_token" => "test_access_token_#{uid}",
+          "refresh_token" => "test_refresh_token_#{uid}",
+          "access_token_end_date" => (Time.now + 3600).strftime("%Y-%m-%d %H:%M:%S"),
+          "refresh_token_end_date" => (Time.now + 86400 * 30).strftime("%Y-%m-%d %H:%M:%S"),
+          "company_app_name" => "Test Company",
+          "company_ne_id" => "NE123456"
+        }
+      end
+    end
+  end
+end

data/lib/ne_api/testing/fake_master.rb

@@ -0,0 +1,177 @@
+module NeAPI
+  module Testing
+    # NeAPI::Master のスタブクラス
+    #
+    # @example 基本的な使い方
+    #   fake = NeAPI::Testing::FakeMaster.new
+    #   fake.stub(:master_goods_search, [{ "goods_id" => "001" }])
+    #   fake.master_goods_search  #=> [{ "goods_id" => "001" }]
+    #
+    # @example エラーのシミュレート
+    #   fake.simulate_error(code: "001001", message: "認証エラー")
+    #   fake.master_goods_search  #=> raises NeAPIException
+    #
+    class FakeMaster
+      attr_accessor :access_token, :refresh_token, :wait_flag, :retry_num, :wait_interval
+      attr_accessor :access_token_end_date, :refresh_token_end_date
+      attr_reader :call_history
+
+      def initialize(access_token: "test_access_token", refresh_token: "test_refresh_token")
+        @access_token = access_token
+        @refresh_token = refresh_token
+        @wait_flag = false
+        @retry_num = 10
+        @wait_interval = 15
+        @stubbed_responses = {}
+        @call_history = []
+        @error_mode = false
+        @error_code = nil
+        @error_message = nil
+      end
+
+      # 特定メソッドのレスポンスをスタブする
+      #
+      # @param method_name [Symbol, String] スタブするメソッド名
+      # @param response [Object] 返却するレスポンス（ブロックも可）
+      # @return [self]
+      def stub(method_name, response = nil, &block)
+        @stubbed_responses[method_name.to_sym] = block || -> (_) { response }
+        self
+      end
+
+      # エラーモードを有効にする
+      #
+      # @param code [String] エラーコード
+      # @param message [String] エラーメッセージ
+      # @return [self]
+      def simulate_error(code: "001001", message: "API Error")
+        @error_mode = true
+        @error_code = code
+        @error_message = message
+        self
+      end
+
+      # エラーモードを解除する
+      #
+      # @return [self]
+      def clear_error
+        @error_mode = false
+        @error_code = nil
+        @error_message = nil
+        self
+      end
+
+      # 全スタブと呼び出し履歴をクリアする
+      #
+      # @return [self]
+      def reset!
+        @stubbed_responses.clear
+        @call_history.clear
+        @error_mode = false
+        @error_code = nil
+        @error_message = nil
+        self
+      end
+
+      # 指定メソッドが呼び出されたかチェック
+      #
+      # @param method_name [Symbol, String] メソッド名
+      # @return [Boolean]
+      def called?(method_name)
+        @call_history.any? { |c| c[:method] == method_name.to_sym }
+      end
+
+      # 指定メソッドの呼び出し回数を取得
+      #
+      # @param method_name [Symbol, String] メソッド名
+      # @return [Integer]
+      def call_count(method_name)
+        @call_history.count { |c| c[:method] == method_name.to_sym }
+      end
+
+      # 指定メソッドの最後の呼び出し引数を取得
+      #
+      # @param method_name [Symbol, String] メソッド名
+      # @return [Hash, nil]
+      def last_call_args(method_name)
+        @call_history.reverse.find { |c| c[:method] == method_name.to_sym }&.[](:args)
+      end
+
+      # 強制インポートモード（本物と同じインターフェース）
+      def force_import
+        @wait_flag = true
+      end
+
+      def method_missing(method_name, args = {})
+        @call_history << { method: method_name.to_sym, args: args, time: Time.now }
+
+        if @error_mode
+          raise NeAPIException, "#{@error_code}:#{@error_message}"
+        end
+
+        if @stubbed_responses.key?(method_name.to_sym)
+          result = @stubbed_responses[method_name.to_sym].call(args)
+          wrap_response(result, method_name)
+        else
+          default_response(method_name, args)
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        true
+      end
+
+      private
+
+      def wrap_response(data, method_name)
+        # 既にHash形式でresultキーがある場合はそのまま返す
+        return data if data.is_a?(Hash) && data.key?("result")
+
+        method_type = method_name.to_s.split("_").last
+        case method_type
+        when "search"
+          # searchはdataキーの値を直接返す
+          data
+        when "count"
+          data.is_a?(Integer) ? data.to_s : data
+        else
+          data
+        end
+      end
+
+      def default_response(method_name, args)
+        method_type = method_name.to_s.split("_").last
+        case method_type
+        when "search"
+          []
+        when "count"
+          "0"
+        when "info"
+          {
+            "result" => "success",
+            "data" => [],
+            "count" => "0",
+            "access_token" => @access_token,
+            "refresh_token" => @refresh_token
+          }
+        when "update", "upload", "receipted", "shipped", "labelprinted", "add", "bulkupdate", "bulkupdatereceipted"
+          "success"
+        when "divide"
+          "new_receive_order_id"
+        when "checkconnect"
+          {
+            "result" => "success",
+            "access_token" => @access_token,
+            "refresh_token" => @refresh_token
+          }
+        else
+          {
+            "result" => "success",
+            "access_token" => @access_token,
+            "refresh_token" => @refresh_token
+          }
+        end
+      end
+    end
+  end
+end

data/lib/ne_api/testing/response_factory.rb

@@ -0,0 +1,227 @@
+require 'securerandom'
+
+module NeAPI
+  module Testing
+    # テスト用レスポンスデータを生成するファクトリ
+    #
+    # @example 商品データ生成
+    #   ResponseFactory.goods(goods_name: "テスト商品A")
+    #   ResponseFactory.goods_list(3)
+    #
+    # @example 受注データ生成
+    #   ResponseFactory.receive_order(receive_order_total_amount: 5000)
+    #
+    class ResponseFactory
+      class << self
+        # 商品マスタデータを生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def goods(overrides = {})
+          {
+            "goods_id" => SecureRandom.hex(8),
+            "goods_name" => "テスト商品",
+            "goods_jan_code" => "4912345678901"
+          }.merge(stringify_keys(overrides))
+        end
+
+        # 商品リストを生成
+        #
+        # @param count [Integer] 生成数
+        # @yield [item, index] 各アイテムをカスタマイズするブロック
+        # @return [Array<Hash>]
+        def goods_list(count = 3, &block)
+          count.times.map do |i|
+            item = goods("goods_id" => "GOODS#{format('%03d', i + 1)}", "goods_name" => "テスト商品#{i + 1}")
+            block ? block.call(item, i) : item
+          end
+        end
+
+        # 在庫マスタデータを生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def stock(overrides = {})
+          {
+            "stock_goods_id" => SecureRandom.hex(8),
+            "stock_quantity" => 100,
+            "stock_allocation_quantity" => 10,
+            "stock_defective_quantity" => 0,
+            "stock_remaining_order_quantity" => 0,
+            "stock_out_quantity" => 0,
+            "stock_free_quantity" => 90
+          }.merge(stringify_keys(overrides))
+        end
+
+        # 在庫リストを生成
+        #
+        # @param count [Integer] 生成数
+        # @return [Array<Hash>]
+        def stock_list(count = 3, &block)
+          count.times.map do |i|
+            item = stock("stock_goods_id" => "GOODS#{format('%03d', i + 1)}")
+            block ? block.call(item, i) : item
+          end
+        end
+
+        # 受注データを生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def receive_order(overrides = {})
+          {
+            "receive_order_id" => SecureRandom.hex(8),
+            "receive_order_shop_id" => "1",
+            "receive_order_shop_cut_form_id" => "ORD-#{SecureRandom.hex(4).upcase}",
+            "receive_order_date" => Time.now.strftime("%Y-%m-%d %H:%M:%S"),
+            "receive_order_order_status_id" => "10",
+            "receive_order_order_status_name" => "新規受付",
+            "receive_order_delivery_id" => "1",
+            "receive_order_delivery_name" => "ヤマト運輸",
+            "receive_order_payment_method_id" => "1",
+            "receive_order_payment_method_name" => "クレジットカード",
+            "receive_order_total_amount" => 1000,
+            "receive_order_tax_amount" => 100,
+            "receive_order_goods_amount" => 900,
+            "receive_order_delivery_fee_amount" => 0,
+            "receive_order_purchaser_name" => "テスト顧客",
+            "receive_order_purchaser_kana" => "テストコキャク",
+            "receive_order_purchaser_zip_code" => "100-0001",
+            "receive_order_purchaser_address1" => "東京都千代田区",
+            "receive_order_purchaser_address2" => "1-1-1",
+            "receive_order_purchaser_tel" => "03-1234-5678",
+            "receive_order_purchaser_mail_address" => "test@example.com",
+            "receive_order_consignee_name" => "テスト顧客",
+            "receive_order_consignee_zip_code" => "100-0001",
+            "receive_order_consignee_address1" => "東京都千代田区",
+            "receive_order_consignee_address2" => "1-1-1",
+            "receive_order_consignee_tel" => "03-1234-5678"
+          }.merge(stringify_keys(overrides))
+        end
+
+        # 受注リストを生成
+        #
+        # @param count [Integer] 生成数
+        # @return [Array<Hash>]
+        def receive_order_list(count = 3, &block)
+          count.times.map do |i|
+            item = receive_order("receive_order_shop_cut_form_id" => "ORD-#{format('%04d', i + 1)}")
+            block ? block.call(item, i) : item
+          end
+        end
+
+        # 受注明細データを生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def receive_order_row(overrides = {})
+          {
+            "receive_order_row_receive_order_id" => SecureRandom.hex(8),
+            "receive_order_row_no" => "1",
+            "receive_order_row_goods_id" => SecureRandom.hex(8),
+            "receive_order_row_goods_name" => "テスト商品",
+            "receive_order_row_quantity" => 1,
+            "receive_order_row_unit_price" => 1000,
+            "receive_order_row_goods_option" => ""
+          }.merge(stringify_keys(overrides))
+        end
+
+        # 会社情報を生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def company_info(overrides = {})
+          {
+            "company_id" => "12345",
+            "company_name" => "テスト会社",
+            "company_ne_id" => "NE123456",
+            "company_kana" => "テストカイシャ"
+          }.merge(stringify_keys(overrides))
+        end
+
+        # ユーザー情報を生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def user_info(overrides = {})
+          {
+            "user_id" => "1",
+            "user_name" => "テストユーザー",
+            "user_mail" => "test@example.com"
+          }.merge(stringify_keys(overrides))
+        end
+
+        # 店舗データを生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def shop(overrides = {})
+          {
+            "shop_id" => "1",
+            "shop_name" => "テスト店舗",
+            "shop_kana" => "テストテンポ",
+            "shop_abbreviated_name" => "テスト",
+            "shop_mall_id" => "1",
+            "shop_deleted_flag" => "0"
+          }.merge(stringify_keys(overrides))
+        end
+
+        # 倉庫在庫データを生成
+        #
+        # @param overrides [Hash] 上書きする属性
+        # @return [Hash]
+        def warehouse_stock(overrides = {})
+          {
+            "warehouse_stock_warehouse_id" => "1",
+            "warehouse_stock_goods_id" => SecureRandom.hex(8),
+            "warehouse_stock_quantity" => 100,
+            "warehouse_stock_allocation_quantity" => 10,
+            "warehouse_stock_free_quantity" => 90
+          }.merge(stringify_keys(overrides))
+        end
+
+        # エラーレスポンスを生成
+        #
+        # @param code [String] エラーコード
+        # @param message [String] エラーメッセージ
+        # @return [Hash]
+        def error(code: "001001", message: "エラーが発生しました")
+          {
+            "result" => "error",
+            "code" => code,
+            "message" => message
+          }
+        end
+
+        # 混雑エラー（リトライ対象）を生成
+        #
+        # @return [Hash]
+        def busy_error
+          error(code: "003001", message: "Next Engineが大変混み合っています")
+        end
+
+        # 成功レスポンスを生成（info系API用）
+        #
+        # @param data [Array] データ配列
+        # @param access_token [String] アクセストークン
+        # @param refresh_token [String] リフレッシュトークン
+        # @return [Hash]
+        def success_response(data: [], access_token: "test_access_token", refresh_token: "test_refresh_token")
+          {
+            "result" => "success",
+            "data" => data,
+            "count" => data.size.to_s,
+            "access_token" => access_token,
+            "refresh_token" => refresh_token
+          }
+        end
+
+        private
+
+        def stringify_keys(hash)
+          hash.transform_keys(&:to_s)
+        end
+      end
+    end
+  end
+end

data/lib/ne_api/testing/rspec_helpers.rb

@@ -0,0 +1,154 @@
+module NeAPI
+  module Testing
+    # RSpec用ヘルパーメソッド
+    #
+    # @example spec/rails_helper.rb での設定
+    #   require 'ne_api/testing'
+    #
+    #   RSpec.configure do |config|
+    #     config.include NeAPI::Testing::RSpecHelpers
+    #   end
+    #
+    # @example テストコードでの使用
+    #   RSpec.describe OrderService do
+    #     it "受注を取得する" do
+    #       with_fake_ne_api do |fake|
+    #         fake.stub(:receiveorder_base_search, [ne_receive_order])
+    #         # ...
+    #       end
+    #     end
+    #   end
+    #
+    module RSpecHelpers
+      # FakeMasterインスタンスを生成
+      #
+      # @param options [Hash] 初期化オプション
+      # @return [FakeMaster]
+      def fake_ne_master(**options)
+        NeAPI::Testing::FakeMaster.new(**options)
+      end
+
+      # FakeAuthインスタンスを生成
+      #
+      # @param options [Hash] 初期化オプション
+      # @return [FakeAuth]
+      def fake_ne_auth(**options)
+        NeAPI::Testing::FakeAuth.new(**options)
+      end
+
+      # NeAPI::Master.newをFakeMasterに差し替えてブロックを実行
+      #
+      # @yield [FakeMaster] FakeMasterインスタンス
+      # @return [Object] ブロックの戻り値
+      #
+      # @example
+      #   with_fake_ne_api do |fake|
+      #     fake.stub(:master_goods_search, [ne_goods])
+      #     service = MyService.new  # 内部でNeAPI::Master.newを呼ぶ
+      #     service.call
+      #   end
+      def with_fake_ne_api(**options)
+        fake = fake_ne_master(**options)
+        allow(NeAPI::Master).to receive(:new).and_return(fake)
+        yield fake
+      end
+
+      # NeAPI::Auth.newをFakeAuthに差し替えてブロックを実行
+      #
+      # @yield [FakeAuth] FakeAuthインスタンス
+      # @return [Object] ブロックの戻り値
+      def with_fake_ne_auth(**options)
+        fake = fake_ne_auth(**options)
+        allow(NeAPI::Auth).to receive(:new).and_return(fake)
+        yield fake
+      end
+
+      # --- ResponseFactoryへのショートカット ---
+
+      # 商品データを生成
+      # @see ResponseFactory.goods
+      def ne_goods(**attrs)
+        NeAPI::Testing::ResponseFactory.goods(attrs)
+      end
+
+      # 商品リストを生成
+      # @see ResponseFactory.goods_list
+      def ne_goods_list(count = 3, &block)
+        NeAPI::Testing::ResponseFactory.goods_list(count, &block)
+      end
+
+      # 在庫データを生成
+      # @see ResponseFactory.stock
+      def ne_stock(**attrs)
+        NeAPI::Testing::ResponseFactory.stock(attrs)
+      end
+
+      # 在庫リストを生成
+      # @see ResponseFactory.stock_list
+      def ne_stock_list(count = 3, &block)
+        NeAPI::Testing::ResponseFactory.stock_list(count, &block)
+      end
+
+      # 受注データを生成
+      # @see ResponseFactory.receive_order
+      def ne_receive_order(**attrs)
+        NeAPI::Testing::ResponseFactory.receive_order(attrs)
+      end
+
+      # 受注リストを生成
+      # @see ResponseFactory.receive_order_list
+      def ne_receive_order_list(count = 3, &block)
+        NeAPI::Testing::ResponseFactory.receive_order_list(count, &block)
+      end
+
+      # 受注明細データを生成
+      # @see ResponseFactory.receive_order_row
+      def ne_receive_order_row(**attrs)
+        NeAPI::Testing::ResponseFactory.receive_order_row(attrs)
+      end
+
+      # 会社情報を生成
+      # @see ResponseFactory.company_info
+      def ne_company_info(**attrs)
+        NeAPI::Testing::ResponseFactory.company_info(attrs)
+      end
+
+      # ユーザー情報を生成
+      # @see ResponseFactory.user_info
+      def ne_user_info(**attrs)
+        NeAPI::Testing::ResponseFactory.user_info(attrs)
+      end
+
+      # 店舗データを生成
+      # @see ResponseFactory.shop
+      def ne_shop(**attrs)
+        NeAPI::Testing::ResponseFactory.shop(attrs)
+      end
+
+      # 倉庫在庫データを生成
+      # @see ResponseFactory.warehouse_stock
+      def ne_warehouse_stock(**attrs)
+        NeAPI::Testing::ResponseFactory.warehouse_stock(attrs)
+      end
+
+      # エラーレスポンスを生成
+      # @see ResponseFactory.error
+      def ne_error(**attrs)
+        NeAPI::Testing::ResponseFactory.error(**attrs)
+      end
+
+      # 成功レスポンスを生成
+      # @see ResponseFactory.success_response
+      def ne_success_response(**attrs)
+        NeAPI::Testing::ResponseFactory.success_response(**attrs)
+      end
+    end
+  end
+end
+
+# RSpecが読み込まれていれば自動設定
+if defined?(RSpec)
+  RSpec.configure do |config|
+    config.include NeAPI::Testing::RSpecHelpers
+  end
+end

data/lib/ne_api/testing.rb

@@ -0,0 +1,44 @@
+# ne_api テスト用スタブ
+#
+# Railsプロジェクトでの設定:
+#
+#   # spec/rails_helper.rb
+#   require 'ne_api/testing'
+#
+#   RSpec.configure do |config|
+#     config.include NeAPI::Testing::RSpecHelpers
+#   end
+#
+# 使用例:
+#
+#   RSpec.describe OrderSyncService do
+#     it "受注を同期する" do
+#       with_fake_ne_api do |fake|
+#         fake.stub(:receiveorder_base_search, [
+#           ne_receive_order(receive_order_id: "ORDER001")
+#         ])
+#
+#         service = OrderSyncService.new(ne_api: fake)
+#         result = service.sync
+#
+#         expect(result.count).to eq 1
+#         expect(fake.called?(:receiveorder_base_search)).to be true
+#       end
+#     end
+#   end
+
+require_relative 'testing/fake_master'
+require_relative 'testing/fake_auth'
+require_relative 'testing/response_factory'
+require_relative 'testing/rspec_helpers'
+
+module NeAPI
+  module Testing
+    class << self
+      # 設定用ブロック（将来の拡張用）
+      def configure
+        yield self if block_given?
+      end
+    end
+  end
+end

data/lib/ne_api/version.rb

@@ -1,3 +1,3 @@
 module NeApi
-  VERSION = "0.0.20"
+  VERSION = "0.0.21"
 end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ne_api
 version: !ruby/object:Gem::Version
-  version: 0.0.20
+  version: 0.0.21
 platform: ruby
 authors:
 - Yuuna Kurita
 - Mika Koizumi
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-29 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -152,6 +151,11 @@ files:
 - Rakefile
 - config/api.yaml
 - lib/ne_api.rb
+- lib/ne_api/testing.rb
+- lib/ne_api/testing/fake_auth.rb
+- lib/ne_api/testing/fake_master.rb
+- lib/ne_api/testing/response_factory.rb
+- lib/ne_api/testing/rspec_helpers.rb
 - lib/ne_api/version.rb
 - ne_api.gemspec
 - spec/ne_api_spec.rb
@@ -159,7 +163,6 @@ homepage: http://github.com/infinity-octaver/ne_api/
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -174,8 +177,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 4.0.1
 specification_version: 4
 summary: Next Engine API for ruby
 test_files: