smartrack-sdk 1.0.0__py3-none-any.whl

examples/__init__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+示例包
+包含所有使用示例
+"""

examples/basic_usage.py

@@ -0,0 +1,360 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+SmartRack SDK 基本使用示例
+"""
+
+import logging
+from datetime import datetime
+
+from smartrack_sdk import SmartRackClient
+from smartrack_sdk.models.requests import (
+    StockInRequest, StockOutRequest, StockOutSheetRequest,
+    ClearErrorRequest, ResetCellRequest, RackTestRequest,
+    StockInFinishRequest, StockOutSheetFinishRequest, StockOutSheetCancelRequest
+)
+from smartrack_sdk.models.enums import LedColors, RackTestMode
+from smartrack_sdk.exceptions import SmartRackException
+
+# 配置日志
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger(__name__)
+
+
+class BasicUsageExample:
+    """SmartRack SDK基本使用示例"""
+
+    def __init__(self, base_url: str):
+        """
+        初始化示例
+
+        Args:
+            base_url: SmartRack API基础URL
+        """
+        self.base_url = base_url
+        self.client = None
+
+    def run_all_examples(self):
+        """运行所有示例"""
+        logger.info("开始运行SmartRack SDK示例...")
+        logger.info("=" * 50)
+
+        try:
+            # 创建客户端
+            self._create_client()
+
+            # 运行各种示例
+            self._stock_in_example()
+            self._stock_out_example()
+            self._stock_out_sheet_example()
+            self._stock_query_example()
+            self._rack_test_example()
+            self._clear_error_example()
+            self._reset_cell_example()
+            self._error_handling_example()
+
+            logger.info("=" * 50)
+            logger.info("所有示例运行完成!")
+
+        except Exception as e:
+            logger.error(f"示例运行出错: {e}", exc_info=True)
+
+        finally:
+            self._close_client()
+
+    def _create_client(self):
+        """创建客户端"""
+        logger.info("创建SmartRack客户端...")
+        self.client = SmartRackClient(
+            base_url=self.base_url,
+            timeout=30
+        )
+        logger.info("客户端创建完成")
+
+    def _close_client(self):
+        """关闭客户端"""
+        if self.client:
+            self.client.close()
+            logger.info("客户端已关闭")
+
+    def _stock_in_example(self):
+        """入库操作示例"""
+        logger.info("=== 入库操作示例 ===")
+
+        try:
+            # 生成入库单号
+            sheet_id = f"SI-{datetime.now().strftime('%Y%m%d%H%M%S')}"
+
+            # 创建入库请求
+            request = StockInRequest("test", "MES")
+            request.set_sheet_id(sheet_id)
+            request.set_rack_id("A001")
+            request.set_grn("PRODUCT001")
+            request.set_led_color(LedColors.GREEN)
+            request.set_blink(True)
+
+            logger.info(f"发送入库请求 - 单号: {sheet_id}, 料架: A001, GRN: PRODUCT001")
+            response = self.client.stock_in_request(request)
+
+            logger.info(f"入库请求结果: Code={response.code}, Message={response.message}")
+
+            if response.is_success:
+                logger.info("入库请求成功")
+
+                # 模拟入库完成后清除亮灯
+                import time
+                logger.info("等待5秒模拟入库完成...")
+                time.sleep(5)
+
+                # 入库完成
+                finish_request = StockInFinishRequest("test", "MES")
+                finish_request.set_sheet_id(sheet_id)
+
+                logger.info("发送入库完成请求")
+                finish_response = self.client.stock_in_finish(finish_request)
+                logger.info(f"入库完成结果: Code={finish_response.code}, Message={finish_response.message}")
+            else:
+                logger.error(f"入库请求失败: {response.message}")
+
+        except SmartRackException as e:
+            logger.error(f"入库操作出错: {e}")
+
+    def _stock_out_example(self):
+        """出库操作示例"""
+        logger.info("=== 出库操作示例 ===")
+
+        try:
+            # 生成出库单号
+            sheet_id = f"SO-{datetime.now().strftime('%Y%m%d%H%M%S')}"
+
+            # 创建出库请求
+            request = StockOutRequest("test", "MES")
+            request.set_sheet_id(sheet_id)
+            request.add_grn("PRODUCT001")
+            request.add_grn("PRODUCT002")
+            request.set_led_color(LedColors.RED)
+            request.set_blink(True)
+
+            logger.info(f"发送出库请求 - 单号: {sheet_id}, GRN列表: {request.grn_list}")
+            response = self.client.stock_out_request(request)
+
+            logger.info(f"出库请求结果: Code={response.code}, Message={response.message}")
+
+            if response.is_success and response.result_data:
+                logger.info("出库储位信息:")
+                for item in response.result_data:
+                    logger.info(f"  储位: {item.cell}, GRN: {item.grn}")
+            else:
+                logger.error(f"出库请求失败: {response.message}")
+
+        except SmartRackException as e:
+            logger.error(f"出库操作出错: {e}")
+
+    def _stock_out_sheet_example(self):
+        """单号出库操作示例"""
+        logger.info("=== 单号出库操作示例 ===")
+
+        try:
+            # 生成工单号
+            sheet_id = f"WO-{datetime.now().strftime('%Y%m%d%H%M%S')}"
+
+            # 创建单号出库请求
+            request = StockOutSheetRequest("test", "MES")
+            request.set_sheet_id(sheet_id)
+            request.add_grn("PRODUCT001")
+            request.add_grn("PRODUCT002")
+            request.add_grn("PRODUCT003")
+
+            logger.info(f"发送单号出库请求 - 工单号: {sheet_id}, GRN列表: {request.grn_list}")
+            response = self.client.stock_out_sheet_request(request)
+
+            logger.info(f"单号出库请求结果: Code={response.code}, Message={response.message}")
+
+            if response.is_success:
+                logger.info(f"亮灯颜色: {response.led_color}")
+                logger.info(f"颜色名称: {response.color_name}")
+
+                if response.result_data:
+                    logger.info("出库储位信息:")
+                    for item in response.result_data:
+                        logger.info(f"  储位: {item.cell}, GRN: {item.grn}")
+
+                # 模拟操作完成后
+                import time
+                logger.info("等待10秒模拟操作完成...")
+                time.sleep(10)
+
+                # 完成单号出库
+                finish_request = StockOutSheetFinishRequest("test", "MES")
+                finish_request.set_sheet_id(sheet_id)
+
+                logger.info("发送单号出库完成请求")
+                finish_response = self.client.stock_out_sheet_finish(finish_request)
+                logger.info(f"单号出库完成结果: Code={finish_response.code}, Message={finish_response.message}")
+            else:
+                logger.error(f"单号出库请求失败: {response.message}")
+
+        except SmartRackException as e:
+            logger.error(f"单号出库操作出错: {e}")
+
+    def _stock_query_example(self):
+        """库存查询示例"""
+        logger.info("=== 库存查询示例 ===")
+
+        try:
+            # 查询指定料架的库存
+            logger.info("查询料架A001的库存...")
+            response = self.client.get_stock_data(
+                rack_id="A001",
+                skip_count=0,
+                max_result_count=50
+            )
+
+            logger.info(f"库存查询结果: Code={response.code}, Total={response.total}")
+
+            if response.is_success and response.result_data:
+                logger.info("库存详情:")
+                for stock in response.result_data:
+                    logger.info(f"  料架: {stock.rack_id}, 储位: {stock.cell_id}, GRN: {stock.grn}")
+                    logger.info(f"  状态: {stock.status}, LED颜色: {stock.led_color}")
+                    logger.info("")
+            else:
+                logger.error(f"库存查询失败: {response.message}")
+
+        except SmartRackException as e:
+            logger.error(f"库存查询出错: {e}")
+
+    def _rack_test_example(self):
+        """料架测试示例"""
+        logger.info("=== 料架测试示例 ===")
+
+        try:
+            # RGB测试
+            test_request = RackTestRequest("test", "MES")
+            test_request.set_rack_id("A001")
+            test_request.set_test_mode(RackTestMode.RGB_TEST)
+            test_request.set_led_color(LedColors.WHITE)
+            test_request.set_blink(False)
+
+            logger.info("发送RGB测试请求 - 料架: A001")
+            response = self.client.rack_test(test_request)
+            logger.info(f"RGB测试结果: Code={response.code}, Message={response.message}")
+
+            if response.is_success:
+                # 等待测试完成
+                import time
+                logger.info("等待15秒测试完成...")
+                time.sleep(15)
+
+                # 全部灭灯
+                test_request.set_test_mode(RackTestMode.ALL_OFF)
+                logger.info("发送全部灭灯请求")
+                off_response = self.client.rack_test(test_request)
+                logger.info(f"灭灯结果: Code={off_response.code}, Message={off_response.message}")
+            else:
+                logger.error(f"料架测试失败: {response.message}")
+
+        except SmartRackException as e:
+            logger.error(f"料架测试出错: {e}")
+
+    def _clear_error_example(self):
+        """清除错误示例"""
+        logger.info("=== 清除错误示例 ===")
+
+        try:
+            # 清除指定储位的错误
+            clear_request = ClearErrorRequest("test", "MES")
+            clear_request.set_cell_id("A0010001")  # 可以指定储位ID或料架ID
+
+            logger.info("发送清除错误请求 - 储位: A0010001")
+            response = self.client.clear_error(clear_request)
+
+            logger.info(f"清除错误结果: Code={response.code}, Message={response.message}")
+
+            if response.is_success and response.result_data:
+                logger.info("清错结果:")
+                for item in response.result_data:
+                    status_text = "空" if item.is_empty() else "非空"
+                    logger.info(f"  储位: {item.cell}, GRN: {item.grn}, 状态: {status_text}")
+            else:
+                logger.error(f"清除错误失败: {response.message}")
+
+        except SmartRackException as e:
+            logger.error(f"清除错误出错: {e}")
+
+    def _reset_cell_example(self):
+        """重置储位状态示例"""
+        logger.info("=== 重置储位状态示例 ===")
+
+        try:
+            # 重置多个储位状态
+            reset_request = ResetCellRequest("test", "MES")
+            reset_request.add_cell("A0010001")
+            reset_request.add_cell("A0010002")
+            reset_request.add_cell("A0010003")
+
+            logger.info(f"发送重置储位请求 - 储位列表: {reset_request.cell_list}")
+            response = self.client.reset_cell(reset_request)
+
+            logger.info(f"重置储位结果: Code={response.code}, Message={response.message}")
+
+            if not response.is_success:
+                logger.error(f"重置储位失败: {response.message}")
+
+        except SmartRackException as e:
+            logger.error(f"重置储位出错: {e}")
+
+    def _error_handling_example(self):
+        """错误处理示例"""
+        logger.info("=== 错误处理示例 ===")
+
+        try:
+            # 模拟一个可能导致错误的请求
+            request = StockInRequest("test", "MES")
+            request.set_sheet_id("ERROR_TEST")
+            request.set_rack_id("INVALID_RACK")
+            request.set_grn("")  # 空的GRN
+
+            logger.info("发送可能错误的入库请求...")
+            response = self.client.stock_in_request(request)
+            logger.info(f"意外成功: Code={response.code}, Message={response.message}")
+
+        except SmartRackException as e:
+            logger.info("捕获到SmartRack异常:")
+            logger.info(f"  异常类型: {type(e).__name__}")
+            logger.info(f"  错误消息: {e}")
+
+            # 根据异常类型进行不同处理
+            if hasattr(e, 'api_code'):
+                logger.info(f"  API错误代码: {e.api_code}")
+            if hasattr(e, 'status_code'):
+                logger.info(f"  HTTP状态码: {e.status_code}")
+            if hasattr(e, 'is_timeout') and e.is_timeout():
+                logger.info("  这是一个超时异常")
+            if hasattr(e, 'is_connection_error') and e.is_connection_error():
+                logger.info("  这是一个连接错误")
+
+        except Exception as e:
+            logger.error(f"其他异常: {type(e).__name__}: {e}")
+
+
+def main():
+    """主函数"""
+    # 配置参数
+    base_url = "http://192.168.8.3:7800"
+
+    logger.info("SmartRack SDK基本使用示例")
+    logger.info(f"API地址: {base_url}")
+    logger.info("=" * 50)
+
+    # 创建并运行示例
+    example = BasicUsageExample(base_url)
+    example.run_all_examples()
+
+
+if __name__ == "__main__":
+    main()