ldsuv 0.1.0__tar.gz

ldsuv-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+# sphinx build directories
+_build/
+
+# dotfiles
+.*
+!.gitignore
+# compiled python files
+*.py[co]
+__pycache__/
+# setup.py egg_info
+*.egg-info
+build/
+dist/
+# emacs backup files
+*~
+*-
+_

ldsuv-0.1.0/.idea/.gitignore

@@ -0,0 +1,10 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/
+# 已忽略包含查询文件的默认文件夹
+/queries/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

ldsuv-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# 更改日志
+
+此项目的所有显着更改都将记录在此文件中。
+
+此项目遵循[语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.0.1] 
+
+**初始版本**
+
+### Added
+- 无
+### Changed
+- 无
+### Fixed
+- 无
+

ldsuv-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: ldsuv
+Version: 0.1.0
+Summary: 基于 uv 的环境管理与依赖备注工具
+Author-email: Lds <85176878@qq.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# lds_uv_env
+
+查看 [更改日志](https://github.com/ldsxp/lds_uv_env/blob/master/CHANGELOG.md)
+
+https://github.com/ldsxp/lds_uv_env
+

ldsuv-0.1.0/README.md

@@ -0,0 +1,6 @@
+# lds_uv_env
+
+查看 [更改日志](https://github.com/ldsxp/lds_uv_env/blob/master/CHANGELOG.md)
+
+https://github.com/ldsxp/lds_uv_env
+

ldsuv-0.1.0/dist/.gitignore

@@ -0,0 +1 @@
+*

ldsuv-0.1.0/publish.py

@@ -0,0 +1,69 @@
+import os
+import shutil
+import subprocess
+
+
+def setup_token():
+    """
+    配置 Token 环境变量：
+    1. 优先检查系统环境变量
+    2. 如果没有，则尝试从本地 .env 文件中读取
+    """
+    # 优先检查系统环境变量是否已经存在 Token
+    if os.getenv("UV_PUBLISH_TOKEN"):
+        print("✅ 检测到已存在系统环境变量: UV_PUBLISH_TOKEN")
+        return True
+
+    # 如果系统没有，尝试读取 .env 文件
+    env_file = ".env"
+    if os.path.exists(env_file):
+        with open(env_file, "r", encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                # 忽略空行和注释
+                if line and not line.startswith("#") and "=" in line:
+                    key, value = line.split("=", 1)
+                    if key.strip() == "UV_PUBLISH_TOKEN":
+                        # 找到后，将其注入到当前运行的环境变量中
+                        os.environ["UV_PUBLISH_TOKEN"] = value.strip()
+                        print("✅ 已从本地 .env 文件中读取并注入 Token")
+                        return True
+
+    return False
+
+
+def main():
+    print("🚀 准备发布项目...\n")
+
+    # 配置 Token
+    if not setup_token():
+        print("❌ 错误: 未在系统环境变量或 .env 文件中找到 UV_PUBLISH_TOKEN")
+        print("💡 请配置环境变量，或在项目根目录创建包含 'UV_PUBLISH_TOKEN=你的token' 的 .env 文件。")
+        return
+
+    # 清理旧的构建文件
+    dist_dir = "dist"
+    if os.path.exists(dist_dir):
+        print(f"\n🧹 清理旧的 {dist_dir} 目录...")
+        shutil.rmtree(dist_dir)
+
+    try:
+        # 运行 uv build
+        print("📦 正在构建项目 (uv build)...")
+        subprocess.run(["uv", "build"], check=True)
+        print("✅ 构建成功！\n")
+
+        # 运行 uv publish
+        # 此时环境变量中一定已经有 UV_PUBLISH_TOKEN，uv publish 会自动获取它
+        print("🌐 正在发布到 PyPI (uv publish)...")
+        subprocess.run(["uv", "publish"], check=True)
+        print("🎉 发布成功！")
+
+    except subprocess.CalledProcessError as e:
+        print(f"\n❌ 执行失败，命令退出状态码: {e.returncode}")
+    except FileNotFoundError:
+        print("\n❌ 找不到 'uv' 命令，请确认 uv 已正确安装并配置在系统环境变量中。")
+
+
+if __name__ == "__main__":
+    main()

ldsuv-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "ldsuv"
+version = "0.1.0"
+description = "基于 uv 的环境管理与依赖备注工具"
+authors = [
+    { name = "Lds", email = "85176878@qq.com" }
+]
+dependencies = [
+]
+readme = "README.md"
+requires-python = ">=3.10"
+
+[project.scripts]
+ldsuv = "ldsuv.main:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

ldsuv-0.1.0/src/ldsuv/main.py

@@ -0,0 +1,252 @@
+import os
+import sys
+import json
+import subprocess
+
+# 兼容性处理 tomllib
+try:
+    import tomllib
+except ImportError:
+    import pip._vendor.tomli as tomllib
+
+SETTINGS_FILE = 'env_settings.json'
+PYTHON_VERSION_FILE = '.python-version'
+PYPROJECT_FILE = 'pyproject.toml'
+VENV_DIR = '.venv'
+LOCK_FILE = 'uv.lock'
+
+
+def load_settings():
+    if os.path.exists(SETTINGS_FILE):
+        try:
+            with open(SETTINGS_FILE, 'r', encoding='utf-8') as f:
+                return json.load(f)
+        except Exception:
+            pass
+    return {"selected_mirror_name": "PyPI", "package_metadata": {}}
+
+
+def save_settings(settings):
+    with open(SETTINGS_FILE, 'w', encoding='utf-8') as f:
+        json.dump(settings, f, ensure_ascii=False, indent=2)
+
+
+class UVEnvManager:
+    def __init__(self):
+        self.settings = load_settings()
+        self.mirrors = {
+            "阿里": "https://mirrors.aliyun.com/pypi/simple/",
+            "清华大学": "https://pypi.tuna.tsinghua.edu.cn/simple/",
+            "PyPI": "https://pypi.org/simple",
+        }
+        try:
+            subprocess.run(["uv", "--version"], capture_output=True, check=True)
+        except:
+            print("错误: 未检测到 uv。请运行 'pip install uv' 安装。")
+            sys.exit(1)
+
+    def _run_uv(self, args, capture=False):
+        """增强版执行器：支持错误捕获显示"""
+        env = os.environ.copy()
+        if self.settings["selected_mirror_name"] != "PyPI":
+            env["UV_INDEX_URL"] = self.mirrors[self.settings["selected_mirror_name"]]
+
+        try:
+            if capture:
+                res = subprocess.run(["uv"] + args, env=env, capture_output=True, text=True, check=True)
+                return res.stdout
+            else:
+                # 使用 run 而不是 call，以便获取更详细的返回状态
+                res = subprocess.run(["uv"] + args, env=env)
+                return res.returncode == 0
+        except subprocess.CalledProcessError as e:
+            print(f"\n[uv 报错]:\n{e.stderr if e.stderr else e}")
+            return False
+        except Exception as e:
+            print(f"\n[执行异常]: {e}")
+            return False
+
+    def get_project_status(self):
+        status = {"has_toml": os.path.exists(PYPROJECT_FILE), "has_venv": os.path.exists(VENV_DIR),
+                  "project_name": "Unknown", "dep_count": 0, "dev_dep_count": 0, "python_pinned": "未锁定"}
+        if status["has_toml"]:
+            try:
+                with open(PYPROJECT_FILE, "rb") as f:
+                    data = tomllib.load(f)
+                    status["project_name"] = data.get("project", {}).get("name", "未命名")
+                    status["dep_count"] = len(data.get("project", {}).get("dependencies", []))
+                    dev_deps = data.get("dependency-groups", {}).get("dev", [])
+                    status["dev_dep_count"] = len(dev_deps)
+            except:
+                pass
+        if os.path.exists(PYTHON_VERSION_FILE):
+            try:
+                with open(PYTHON_VERSION_FILE, "r") as f:
+                    status["python_pinned"] = f.read().strip()
+            except:
+                pass
+        return status
+
+    def migrate_requirements(self):
+        """智能迁移：自动去重，确保 Dev 组只包含增量库"""
+        print("\n" + "-" * 30)
+        print(" [迁移工具] 正在导入依赖...")
+        print("-" * 30)
+
+        # 预检查：如果手动修改了 toml，建议先删除 lock 文件以强制 uv 重新解析
+        if os.path.exists(LOCK_FILE):
+            confirm = input("检测到已存在 uv.lock，是否删除它以确保导入最新版本？[y/N]: ").strip().lower()
+            if confirm == 'y':
+                os.remove(LOCK_FILE)
+                print("✔ 已删除 uv.lock，将重新解析依赖。")
+
+        prod_pkgs = []
+        # 1. 导入生产依赖
+        if os.path.exists("requirements.txt"):
+            print(">> 正在导入生产依赖 (requirements.txt)...")
+            if self._run_uv(["add", "--requirements", "requirements.txt"]):
+                # 记录已导入的生产库名，防止重复进入 dev
+                st = self.get_project_status()
+                # 简单获取当前已记录的 dependencies (这一步是为了下一步去重)
+                print("✔ 生产依赖导入完成。")
+            else:
+                print("❌ 生产环境导入失败，停止后续操作。")
+                return
+
+        # 2. 导入开发依赖 (带去重逻辑)
+        if os.path.exists("requirements_dev.txt"):
+            print("\n>> 正在处理开发依赖 (requirements_dev.txt)...")
+
+            # 读取 dev 文件内容
+            with open("requirements_dev.txt", "r") as f:
+                lines = f.readlines()
+
+            # 过滤掉包含 "-r requirements.txt" 的行以及注释空行
+            clean_dev_lines = []
+            for line in lines:
+                l = line.strip()
+                if not l or l.startswith("#") or l.startswith("-r"):
+                    continue
+                clean_dev_lines.append(l)
+
+            if clean_dev_lines:
+                # 临时创建一个干净的增量 dev 文件
+                temp_dev = "temp_dev_requirements.txt"
+                with open(temp_dev, "w") as f:
+                    f.write("\n".join(clean_dev_lines))
+
+                print(f">> 正在同步 {len(clean_dev_lines)} 个开发增量库...")
+                success = self._run_uv(["add", "--dev", "--requirements", temp_dev])
+                os.remove(temp_dev)  # 清理临时文件
+
+                if success:
+                    print("✔ 开发依赖 (增量) 导入完成。")
+                else:
+                    print("❌ 开发依赖导入过程中出错。")
+
+        self._run_uv(["sync"])
+        print("\n--- 迁移任务成功结束 ---")
+
+    def install_package(self):
+        pkg = input("\n请输入库名 (如 django): ").strip()
+        if not pkg: return
+
+        is_dev = input("是否安装为开发依赖 (Dev)? [y/N]: ").strip().lower() == 'y'
+        args = ["add", "--dev", pkg] if is_dev else ["add", pkg]
+
+        if self._run_uv(args):
+            # 去掉版本号保留纯净库名
+            pure_name = pkg.split('==')[0].split('>')[0].split('<')[0].split('[')[0].strip()
+            self.settings["package_metadata"].setdefault(pure_name, {"notes": ""})
+            note = input(f"为 {pure_name} 添加备注: ").strip()
+            if note:
+                self.settings["package_metadata"][pure_name]["notes"] = note
+                save_settings(self.settings)
+
+    def main_menu(self):
+        while True:
+            st = self.get_project_status()
+            print("\n" + "=" * 60)
+            print(f" 项目: {st['project_name']} | 生产: {st['dep_count']} | 开发(Dev): {st['dev_dep_count']}")
+            print(f" Python: {st['python_pinned']} | 镜像: {self.settings['selected_mirror_name']}")
+            if not st['has_toml']:
+                print(" ⚠ [状态] 项目未初始化")
+            elif not st['has_venv']:
+                print(" ⚠ [状态] 缺少虚拟环境 (.venv)")
+            print("=" * 60)
+
+            print("0. 初始化项目 (uv init)")
+            print("1. 检查并升级所有库 (uv lock --upgrade)")
+            print("2. 安装新库 (可按 y 选 Dev)")
+            print("3. 管理备注与链接 (JSON)")
+            print("4. Python 版本锁定")
+            print("5. 同步环境 (uv sync)")
+            print("6. 切换镜像源")
+            print("7. 导出 requirements.txt")
+            print("8. 【迁移】从旧文件导入 (带熔断保护)")
+            print("e. 退出")
+
+            c = input("\n指令: ").strip().lower()
+            if c == '0':
+                name = input("项目名称: ").strip()
+                if self._run_uv(["init"] + (["--name", name] if name else [])):
+                    self._run_uv(["python", "pin", "3.12"])
+            elif c == '1':
+                if self._run_uv(["lock", "--upgrade"]): self._run_uv(["sync"])
+            elif c == '2':
+                self.install_package()
+            elif c == '3':
+                self.manage_metadata()
+            elif c == '4':
+                ver = input("版本 (如 3.12): ").strip()
+                if ver: self._run_uv(["python", "pin", ver])
+            elif c == '5':
+                self._run_uv(["sync"])
+            elif c == '6':
+                names = list(self.mirrors.keys())
+                for i, n in enumerate(names, 1): print(f"{i}. {n}")
+                idx = input("选择: ").strip()
+                if idx.isdigit() and 1 <= int(idx) <= len(names):
+                    self.settings["selected_mirror_name"] = names[int(idx) - 1]
+                    save_settings(self.settings)
+            elif c == '7':
+                self._run_uv(["export", "--output-file", "requirements_exported.txt"])
+            elif c == '8':
+                self.migrate_requirements()
+            elif c == 'e':
+                break
+
+    def manage_metadata(self):
+        try:
+            out = self._run_uv(["pip", "list", "--format=json"], capture=True)
+            if not out: return
+            pkgs = json.loads(out)
+        except:
+            print("获取列表失败，请先同步。")
+            return
+
+        search = input("搜索 (直接回车列出): ").strip().lower()
+        filtered = [p for p in pkgs if search in p['name'].lower()]
+        for idx, p in enumerate(filtered[:20], 1):
+            n = p['name']
+            info = self.settings["package_metadata"].get(n, {})
+            print(f"{idx}. {n:<20} | {info.get('notes', '无')}")
+
+        sel = input("\n编辑编号 (b返回): ").strip()
+        if sel.isdigit() and 1 <= int(sel) <= len(filtered):
+            name = filtered[int(sel) - 1]['name']
+            info = self.settings["package_metadata"].setdefault(name, {"repo_url": "", "notes": ""})
+            info["notes"] = input(f"备注: ").strip() or info["notes"]
+            info["repo_url"] = input(f"链接: ").strip() or info["repo_url"]
+            save_settings(self.settings)
+
+
+def main():
+    try:
+        UVEnvManager().main_menu()
+    except KeyboardInterrupt:
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

ldsuv-0.1.0/uv.lock

@@ -0,0 +1,8 @@
+version = 1
+revision = 3
+requires-python = ">=3.10"
+
+[[package]]
+name = "ldsuv"
+version = "0.1.0"
+source = { editable = "." }