ZJS-Tools 1.1.0
ZJS Python 工具包
License: MIT
Requires Python: >=3.6

# ZJS-Tools => v1.0.0   
## 主函数前置代码 (Preceding Code of Main Function)   
### 1. 获取程序基础路径 (Get_Base_Path)   
* 功能：获取当前程序的根目录路径 (可用于pyinstall下的根目录定义) 。   
* 参数说明：   
=> Main_Path: 主函数路径, 若未传入，自动尝试获取调用者路径   
<= Main_Path (str): 主程序运行的根路径   
#### 代码示例：   
     >>> Main_Path = os.path.dirname(f"{__file__}")   
     ... Main_Path = os.path.dirname()   
### 2. 日志配置 (Log_Configuration)   
* 功能：初始化日志实例,定义日志输出格式、存储路径及级别。   
* 参数说明：   
=> Main_Path (str): 当前程序的根目录路径   
=> log_name (str): 日志名称,用于区分不同模块日志   
<= log (str): 包含 debug / info / warning / error   
#### 代码示例：   
     >>> log = Log_FCN(Main_Path, "日志名称")   
     >>> log.debug("函数名称“, f"日志内容")   
     ... log.info("函数名称“, f"日志内容")   
     ... log.warning("函数名称“, f"日志内容")   
     ... log.error("函数名称“, f"日志内容")   
# ZJS-Tools => v1.1.0   
## 添加函数   
### 1. 采集卡客户端 (Capture_Card_Client)   
* 功能：实时读取和接收服务器采集到的数据 (暂未支持多线程)。   
======================== 基础设置 -> Capture_Card_Client_Configure ========================    
* 参数说明：   
Capture_Card_Client_Name (str): 采集卡客户端初始名称   
Capture_Card_Client_IP (str): 采集卡客户端初始 IP   
Capture_Card_Client_PORT(int): 采集卡客户端初始 PORT   
Capture_Card_ChannelNum(int): 采集卡通初始道数   
Capture_Card_RequestBytes(bytes): 采集卡初始请求字节   
Capture_Card_RequestHeaderBytes(bytes): 采集卡初始请求头字节   
Capture_Card_ProtocolHeaderNum(int): 采集卡返回数据初始协议头长度   
Capture_Card_ChannelBytesNum(int): 采集卡通道数初始所占字节数   
Capture_Card_ChannelBytesParsingMethod(str): 采集卡初始解析方法   
Capture_Card_ChannelDataGain(float): 采集卡初始通道增益系数   
======================== Class -> Capture_Card_Client ========================   
* 参数说明：   
=> config: 客户端配置   
#### 代码示例：   
     >>> config = Capture_Card_Client_Configure(Main_Log = None,   
                                     Capture_Card_Client_Name = "采集卡客户端初始名称",   
                                     Capture_Card_Client_IP = "采集卡客户端初始 IP",   
                                     Capture_Card_Client_Port = "采集卡客户端初始 PORT",   
                                     Capture_Card_ChannelNum = "采集卡通初始道数",   
                                     Capture_Card_RequestBytes = "采集卡初始请求字节",   
                                     Capture_Card_RequestHeaderBytes = "采集卡初始请求头字节",   
                                     Capture_Card_ProtocolHeaderNum = "采集卡返回数据初始协议头长度",   
                                     Capture_Card_ChannelBytesNum = "采集卡通道数初始所占字节数",   
                                     Capture_Card_ChannelBytesParsingMethod = "采集卡初始解析方法",   
                                     Capture_Card_ChannelDataGain = "采集卡初始通道增益系数")    
     >>> Capture_Card_Client = Capture_Card_Client(config)   
     >>> Capture_Card_Client.connect(Connect_Timeout = "采集卡客户端连接超时时间",   
                                        Socket_Timeout = "采集卡客户端初始 Socket 超时时间“)   
     >>> Capture_Card_Client.disconnect()   
     >>> Capture_Card_Client.send_request()   
     >>> Capture_Card_Client.rcv_response(recv_buffer_size = "接收缓冲区大小")   
     >>> running(is_ret_raw_data = "是否返回原始数据", Send_Recv_Interval = "收发间隔时间", Loop_Interval = "循环间隔时间") => 惰性执行   
     -> for idx, data in enumerate(generator)