xtquant-share 1.2.2__tar.gz → 1.2.4__tar.gz

{xtquant_share-1.2.2 → xtquant_share-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xtquant-share
-Version: 1.2.2
+Version: 1.2.4
 Summary: Xtreme Quant Share - eXtreme transparent sharing proxy for XtQuant on macOS/Linux
 Author-email: Jason Hu <63170682@qq.com>
 License-Expression: GPL-3.0-only

{xtquant_share-1.2.2 → xtquant_share-1.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xtquant-share"
-version = "1.2.2"
+version = "1.2.4"
 description = "Xtreme Quant Share - eXtreme transparent sharing proxy for XtQuant on macOS/Linux"
 readme = "README.md"
 license = "GPL-3.0-only"

{xtquant_share-1.2.2 → xtquant_share-1.2.4}/xqshare/server.py

@@ -921,8 +921,8 @@ def _cmd_background(args):
         cmd += ["--key", args.key]
     if args.log_level != "INFO":
         cmd += ["--log-level", args.log_level]
-    if args.env_file != ".env":
-        cmd += ["--env-file", args.env_file]
+    # 始终透传 env_file（已经是绝对路径或确定的路径）
+    cmd += ["--env-file", args.env_file]
 
     with open(log_file, "a", encoding="utf-8") as log_f:
         if sys.platform == "win32":
@@ -947,7 +947,7 @@ def _cmd_background(args):
 
     print(f"  xqshare-server 已在后台启动 (PID: {proc.pid})")
     print(f"  日志文件: {log_file}")
-    print(f"  查看日志: xqshare-server logs")
+    print(f"  查看日志: xqshare-server logs -f")
     print(f"  停止服务: xqshare-server stop")
 
 
@@ -1061,6 +1061,17 @@ def _cmd_status(args):
         print(f"  执行 xqshare-server stop 清理残留文件")
 
 
+def _default_env_file():
+    """默认 .env 文件路径：优先查找 exe/脚本所在目录，其次当前目录"""
+    import sys
+    # 获取可执行文件所在目录（pip install 后是 Scripts/ 目录）
+    exe_dir = os.path.dirname(os.path.abspath(sys.executable))
+    exe_env = os.path.join(exe_dir, ".env")
+    if os.path.exists(exe_env):
+        return exe_env
+    return ".env"
+
+
 def main():
     """命令行入口函数"""
     import argparse
@@ -1070,25 +1081,28 @@ def main():
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 示例:
-  xqshare-server                      # 前台启动（默认）
-  xqshare-server start                # 前台启动
-  xqshare-server background           # 后台启动
+  xqshare-server start                # 后台启动（推荐）
+  xqshare-server start --port 18813   # 指定端口后台启动
   xqshare-server stop                 # 停止后台服务
   xqshare-server status               # 查看运行状态
   xqshare-server logs                 # 查看最近 50 行日志
   xqshare-server logs -f              # 实时跟踪日志（tail -f）
   xqshare-server logs -n 100          # 查看最近 100 行日志
-  xqshare-server --port 18813         # 指定端口前台启动
+  xqshare-server fg                   # 前台启动（调试用）
 
 环境变量:
   XQSHARE_PORT      服务端口 (默认: 18812)
   QMT_USERDATA_PATH QMT userdata_mini 目录路径
+
+.env 文件查找顺序:
+  1. xqshare-server.exe 所在目录（如 C:\\install\\qmt_venv\\Scripts\\.env）
+  2. 当前工作目录
         """
     )
 
     subparsers = parser.add_subparsers(dest="command")
 
-    # 公共参数（start 和 background 共用）
+    # 公共参数（start 和 fg 共用）
     def add_server_args(p):
         p.add_argument("--host", default="0.0.0.0", help="监听地址 (默认: 0.0.0.0)")
         p.add_argument("--port", type=int, default=None, help="监听端口 (默认: 18812 或 XQSHARE_PORT)")
@@ -1096,15 +1110,18 @@ def main():
         p.add_argument("--cert", help="SSL 证书文件")
         p.add_argument("--key", help="SSL 私钥文件")
         p.add_argument("--log-level", default="INFO", help="日志级别 (默认: INFO)")
-        p.add_argument("--env-file", default=".env", help="环境变量文件 (默认: .env)")
+        p.add_argument("--env-file", default=None, help="环境变量文件 (默认: 自动查找 exe 目录或当前目录的 .env)")
 
-    # start 子命令（前台）
-    start_parser = subparsers.add_parser("start", help="前台启动 server")
+    # start 子命令（后台，推荐）
+    start_parser = subparsers.add_parser("start", help="后台启动 server（推荐）", aliases=["background", "bg"])
     add_server_args(start_parser)
 
-    # background 子命令（后台）
-    bg_parser = subparsers.add_parser("background", help="后台启动 server", aliases=["bg"])
-    add_server_args(bg_parser)
+    # fg 子命令（前台，调试用）
+    fg_parser = subparsers.add_parser("fg", help="前台启动 server（调试用）", aliases=["foreground"])
+    add_server_args(fg_parser)
+
+    # help 子命令
+    subparsers.add_parser("help", help="显示帮助信息")
 
     # stop 子命令
     subparsers.add_parser("stop", help="停止后台运行的 server")
@@ -1124,11 +1141,17 @@ def main():
     parser.add_argument("--cert", help="SSL 证书文件")
     parser.add_argument("--key", help="SSL 私钥文件")
     parser.add_argument("--log-level", default="INFO", help="日志级别 (默认: INFO)")
-    parser.add_argument("--env-file", default=".env", help="环境变量文件 (默认: .env)")
+    parser.add_argument("--env-file", default=None, help="环境变量文件 (默认: 自动查找 exe 目录或当前目录的 .env)")
 
     args = parser.parse_args()
 
-    if args.command in ("background", "bg"):
+    # --env-file 未指定时自动查找
+    if not hasattr(args, 'env_file') or args.env_file is None:
+        args.env_file = _default_env_file()
+
+    if args.command == "help":
+        parser.print_help()
+    elif args.command in ("start", "background", "bg"):
         _cmd_background(args)
     elif args.command == "stop":
         _cmd_stop(args)
@@ -1137,7 +1160,7 @@ def main():
     elif args.command == "logs":
         _cmd_logs(args)
     else:
-        # start 或无子命令，均为前台启动
+        # fg / foreground 或无子命令，均为前台启动
         start_server(
             host=args.host,
             port=args.port,

{xtquant_share-1.2.2 → xtquant_share-1.2.4}/xtquant_share.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xtquant-share
-Version: 1.2.2
+Version: 1.2.4
 Summary: Xtreme Quant Share - eXtreme transparent sharing proxy for XtQuant on macOS/Linux
 Author-email: Jason Hu <63170682@qq.com>
 License-Expression: GPL-3.0-only