maya-umbrella 0.7.0__tar.gz → 0.9.0__tar.gz

{maya_umbrella-0.7.0 → maya_umbrella-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: maya_umbrella
-Version: 0.7.0
+Version: 0.9.0
 Summary: Check and fix maya virus.
 Home-page: https://github.com/loonghao/maya_umbrella
 License: MIT
@@ -53,10 +53,15 @@ It ensures a secure and seamless user experience by proactively scanning for thr
 It can be provided as an API for seamless integration into your existing pipeline.
 
 # 安装
+
+## pip 安装
 maya_umbrella是以标准pipy包去发布的，所以我们可以通过pip install去安装
 ```shell
 your/maya-root/mayapy -m pip install maya-umbrella
 ```
+## 一键安装
+在release里面下载对应版本的zip包，解压后双击`install.bat`即可安装
+
 更新版本
 ```shell
 your/maya-root/mayapy -m pip install maya-umbrella --upgrade
@@ -80,13 +85,15 @@ pip install nox poetry
 # 开发调试
 
 ```shell
-nox -s maya-2020
+nox -s maya -- 2020 --test
 ```
 
 ## 在maya中测试
 
-通过`nox -s maya-xxx`, 启动maya.
-nox会动态根据你本地安装得maya去注册nox session, 比如你本地安装了`maya-2020`，那么通过`nox -s maya-2018`
+通过`nox -s maya -- <maya version>`, 启动maya.
+nox会动态根据你本地安装得maya去注册nox session, 比如你本地安装了`maya-2020`，
+
+那么通过`nox -s maya -- 2018`, **注意：maya 与 版本号之间有 俩个`-`**
 
 启动maya后在脚本编辑器中执行下面得代码，就会动态的从`<repo>/tests/virus/`里面去open ma文件去进行测试.
 
@@ -112,7 +119,7 @@ nox -s ruff_check
 # 生成安装包
 
 执行下面的命令可以在<repo>/.zip下面创建zip，参数 `--version` 当前工具的版本号
-
+ **注意：`make-zip` 与 `--version`之间有 俩个`-`**
 ```shell
 nox -s make-zip -- --version 0.5.0
 ```
@@ -154,6 +161,12 @@ MAYA_UMBRELLA_LANG
 ```shell
 MAYA_UMBRELLA_IGNORE_BACKUP
 ```
+
+如果是便携版Maya，可以通过添加 `MAYA_LOCATION` 环境变量指定Maya路径
+```shell
+SET MAYA_LOCATION=d:/your/path/maya_version/
+```
+
 如果忽略请设置为
 ```shell
 SET MAYA_UMBRELLA_IGNORE_BACKUP=true
@@ -181,8 +194,8 @@ print(api.scan_files_from_pattern("your/path/*.m[ab]"))
 # 案例
 如果你想要快速通过maya standalone去批量清理maya文件，可以`下载`或者`git clone`当前`main`分支的工程，
 根据上面指引设置好开发环境
-通过`nox`命令去启动maya standalone环境，maya版本根据你当前本地安装的maya为准，比如你本地安装了`2018`,
-那么就是 `nox -s maya-2018-s`
+通过`nox`命令去启动maya `standalone`环境，maya版本根据你当前本地安装的maya为准，比如你本地安装了`2018`,
+那么就是 `nox -s maya -- 2018 --standalone`
 下面的语法是启动一个maya-2020的环境去动态从`c:/test`文件夹下去查杀病毒
 ```shell
 nox -s maya-2020-s -- c:/test/*.m[ab]

{maya_umbrella-0.7.0 → maya_umbrella-0.9.0}/README.md

@@ -28,10 +28,15 @@ It ensures a secure and seamless user experience by proactively scanning for thr
 It can be provided as an API for seamless integration into your existing pipeline.
 
 # 安装
+
+## pip 安装
 maya_umbrella是以标准pipy包去发布的，所以我们可以通过pip install去安装
 ```shell
 your/maya-root/mayapy -m pip install maya-umbrella
 ```
+## 一键安装
+在release里面下载对应版本的zip包，解压后双击`install.bat`即可安装
+
 更新版本
 ```shell
 your/maya-root/mayapy -m pip install maya-umbrella --upgrade
@@ -55,13 +60,15 @@ pip install nox poetry
 # 开发调试
 
 ```shell
-nox -s maya-2020
+nox -s maya -- 2020 --test
 ```
 
 ## 在maya中测试
 
-通过`nox -s maya-xxx`, 启动maya.
-nox会动态根据你本地安装得maya去注册nox session, 比如你本地安装了`maya-2020`，那么通过`nox -s maya-2018`
+通过`nox -s maya -- <maya version>`, 启动maya.
+nox会动态根据你本地安装得maya去注册nox session, 比如你本地安装了`maya-2020`，
+
+那么通过`nox -s maya -- 2018`, **注意：maya 与 版本号之间有 俩个`-`**
 
 启动maya后在脚本编辑器中执行下面得代码，就会动态的从`<repo>/tests/virus/`里面去open ma文件去进行测试.
 
@@ -87,7 +94,7 @@ nox -s ruff_check
 # 生成安装包
 
 执行下面的命令可以在<repo>/.zip下面创建zip，参数 `--version` 当前工具的版本号
-
+ **注意：`make-zip` 与 `--version`之间有 俩个`-`**
 ```shell
 nox -s make-zip -- --version 0.5.0
 ```
@@ -129,6 +136,12 @@ MAYA_UMBRELLA_LANG
 ```shell
 MAYA_UMBRELLA_IGNORE_BACKUP
 ```
+
+如果是便携版Maya，可以通过添加 `MAYA_LOCATION` 环境变量指定Maya路径
+```shell
+SET MAYA_LOCATION=d:/your/path/maya_version/
+```
+
 如果忽略请设置为
 ```shell
 SET MAYA_UMBRELLA_IGNORE_BACKUP=true
@@ -156,8 +169,8 @@ print(api.scan_files_from_pattern("your/path/*.m[ab]"))
 # 案例
 如果你想要快速通过maya standalone去批量清理maya文件，可以`下载`或者`git clone`当前`main`分支的工程，
 根据上面指引设置好开发环境
-通过`nox`命令去启动maya standalone环境，maya版本根据你当前本地安装的maya为准，比如你本地安装了`2018`,
-那么就是 `nox -s maya-2018-s`
+通过`nox`命令去启动maya `standalone`环境，maya版本根据你当前本地安装的maya为准，比如你本地安装了`2018`,
+那么就是 `nox -s maya -- 2018 --standalone`
 下面的语法是启动一个maya-2020的环境去动态从`c:/test`文件夹下去查杀病毒
 ```shell
 nox -s maya-2020-s -- c:/test/*.m[ab]

maya_umbrella-0.9.0/maya_umbrella/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.9.0"

{maya_umbrella-0.7.0 → maya_umbrella-0.9.0}/maya_umbrella/filesystem.py

@@ -97,7 +97,6 @@ def atomic_writes(src, mode, **options):
         shutil.move(temp_path, src)
 
 
-
 def id_generator(size=6, chars=string.ascii_uppercase + string.digits):
     """Generate a random string of the given size using the given characters."""
     return "".join(random.choice(chars) for _ in range(size))
@@ -266,3 +265,31 @@ def get_backup_path(path, root_path=None):
     except (OSError, IOError):  # noqa: UP024
         pass
     return os.path.join(backup_path, filename)
+
+
+def get_maya_install_root(maya_version):
+    """Get the Maya install root path."""
+    maya_location = os.environ.get("MAYA_LOCATION")
+    try:
+        # Import built-in modules
+        import winreg
+    except ImportError:
+        return maya_location
+    try:
+        key = winreg.OpenKey(
+            winreg.HKEY_LOCAL_MACHINE,
+            "SOFTWARE\\Autodesk\\Maya\\{maya_version}\\Setup\\InstallPath".format(maya_version=maya_version),
+        )
+        root, _ = winreg.QueryValueEx(key, "MAYA_INSTALL_LOCATION")
+        if not os.path.isdir(root):
+            print("Failed to locate the appropriate Maya path in the registration list.")
+    except OSError:
+        return maya_location
+    maya_location = maya_location or root
+    if not maya_location:
+        print("maya not found.")
+        return
+    maya_exe = os.path.join(maya_location, "bin", "maya.exe")
+    if not os.path.exists(maya_exe):
+        print("maya.exe not found in {maya_location}.".format(maya_location=maya_location))
+    return maya_location

{maya_umbrella-0.7.0 → maya_umbrella-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "maya_umbrella"
-version = "0.7.0"
+version = "0.9.0"
 description = "Check and fix maya virus."
 homepage = "https://github.com/loonghao/maya_umbrella"
 repository = "https://github.com/loonghao/maya_umbrella"
@@ -36,7 +36,7 @@ nox = { version = "^2024.3.2", python = ">=3.8.1,<3.11" }
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.7.0"
+version = "0.9.0"
 tag_format = "v$version"
 version_files = [
     "pyproject.toml:version",

maya_umbrella-0.7.0/maya_umbrella/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.7.0"