maya-umbrella 0.13.0__tar.gz → 0.14.1__tar.gz

maya_umbrella-0.13.0/README.md → maya_umbrella-0.14.1/PKG-INFO

@@ -1,4 +1,29 @@
-# maya-umbrella
+Metadata-Version: 2.1
+Name: maya_umbrella
+Version: 0.14.1
+Summary: A better Autodesk Maya antivirus tool detects and removes malicious.
+Home-page: https://github.com/loonghao/maya_umbrella
+License: MIT
+Keywords: Autodesk Maya,python,Maya,dcc,antivirus,Security Tools,maya_umbrella
+Author: longhao
+Author-email: hal.long@outlook.com
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Project-URL: Documentation, https://github.com/loonghao/maya_umbrella
+Project-URL: Repository, https://github.com/loonghao/maya_umbrella
+Description-Content-Type: text/markdown
+
+![maya_umbrella.ing Banner](https://raw.githubusercontent.com/loonghao/maya_umbrella/main/resources/banner.png)
 
 [![Python Version](https://img.shields.io/pypi/pyversions/maya-umbrella)](https://img.shields.io/pypi/pyversions/maya-umbrella)
 [![Nox](https://img.shields.io/badge/%F0%9F%A6%8A-Nox-D85E00.svg)](https://github.com/wntrblm/nox)
@@ -21,6 +46,8 @@
 [![All Contributors](https://img.shields.io/badge/all_contributors-8-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
+A better Autodesk Maya antivirus tool detects and removes malicious.
+
 This tool is designed to provide a robust solution for identifying and resolving any potential viruses within Autodesk
 Maya.
 It ensures a secure and seamless user experience by proactively scanning for threats and effectively neutralizing them.
@@ -30,11 +57,15 @@ It can be provided as an API for seamless integration into your existing pipelin
 # 安装
 
 ## pip 安装
+maya_umbrella is distributed as a standard pipy package, so we can install it via pip install.
+
 maya_umbrella是以标准pipy包去发布的，所以我们可以通过pip install去安装
 ```shell
 your/maya-root/mayapy -m pip install maya-umbrella
 ```
 ## 一键安装
+Download the corresponding version of the zip package in the release, unzip it and double-click `install.bat` to install it.
+
 在release里面下载对应版本的zip包，解压后双击`install.bat`即可安装
 
 更新版本
@@ -63,13 +94,21 @@ pip install -r requirements-dev.txt
 
 
 ## 在maya中测试
+With `nox -s maya -- <maya version>`, start maya.
+Nox will dynamically register a nox session based on your local installation of maya,
+e.g. if you have `maya-2020` installed locally, then you can start maya with a test environment.
+Then you can start maya with a test environment via
 
 通过`nox -s maya -- <maya version>`, 启动maya.
 nox会动态根据你本地安装得maya去注册nox session, 比如你本地安装了`maya-2020`，
 那么通过可以启动带有测试环境的maya
+
 ```shell
 nox -s maya -- 2018
 ```
+**Note: there are two `-` between maya and the version number**.
+
+Starting maya and executing the following code in the script editor will dynamically open the ma file from `<repo>/tests/virus/` to test it.
 
 **注意：maya 与 版本号之间有 俩个`-`**
 
@@ -80,23 +119,29 @@ import manual_test_in_maya
 
 manual_test_in_maya.start()
 ```
+It is also possible to execute the corresponding tests via pytest, which also requires a local installation of the corresponding maya
 
 也可以通过pytest去执行对应的测试，也需要本地安装了对应的maya
 
 ```shell
 nox -s maya -- 2018 --test
 ```
+**Note: Command line crash may occur in versions below maya-2022 (PY2)**.
 
 **注意：在maya-2022 (PY2) 以下的版本可能会出现命令行crash的情况**
 
 
 ## 增加新的疫苗
+Create a new py in `<repo>/maya_umbrella/vaccines/`, since many viruses don't have a specific name, we'll use `vaccine<id>.py`.
+Inherit `from maya_umbrella.vaccine import AbstractVaccine` and call the class `Vaccine`, and then write the virus collection logic.
 
 在`<repo>/maya_umbrella/vaccines/` 新建一个py, 因为有很多病毒没有具体的名字代号，我们统一以`vaccine<id>.py`
 继承`from maya_umbrella.vaccine import AbstractVaccine`并且class名字叫`Vaccine`即可, 然后去写具体的收集病毒逻辑
 
 ## 代码检查
 
+We can use the encapsulated `nox` command to perform a code check.
+
 我们可以利用封装好的`nox`命令去执行进行代码检查
 
 ```shell
@@ -109,6 +154,9 @@ nox -s lint-fix
 ```
 
 # 生成安装包
+Execute the following command to create a zip under <repo>/.zip, with `--version` the version number of the current tool.
+
+**Note: between `make-zip` and `--version` there are two `-`**.
 
 执行下面的命令可以在<repo>/.zip下面创建zip，参数 `--version` 当前工具的版本号
 
@@ -235,3 +283,4 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
 
 This project follows the [all-contributors](https://allcontributors.org) specification.
 Contributions of any kind are welcome!
+

maya_umbrella-0.13.0/PKG-INFO → maya_umbrella-0.14.1/README.md

@@ -1,29 +1,4 @@
-Metadata-Version: 2.1
-Name: maya_umbrella
-Version: 0.13.0
-Summary: Check and fix maya virus.
-Home-page: https://github.com/loonghao/maya_umbrella
-License: MIT
-Keywords: notifiers,python,Maya,dcc
-Author: longhao
-Author-email: hal.long@outlook.com
-Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.7
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Project-URL: Documentation, https://github.com/loonghao/maya_umbrella
-Project-URL: Repository, https://github.com/loonghao/maya_umbrella
-Description-Content-Type: text/markdown
-
-# maya-umbrella
+![maya_umbrella.ing Banner](https://raw.githubusercontent.com/loonghao/maya_umbrella/main/resources/banner.png)
 
 [![Python Version](https://img.shields.io/pypi/pyversions/maya-umbrella)](https://img.shields.io/pypi/pyversions/maya-umbrella)
 [![Nox](https://img.shields.io/badge/%F0%9F%A6%8A-Nox-D85E00.svg)](https://github.com/wntrblm/nox)
@@ -46,6 +21,8 @@ Description-Content-Type: text/markdown
 [![All Contributors](https://img.shields.io/badge/all_contributors-8-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
+A better Autodesk Maya antivirus tool detects and removes malicious.
+
 This tool is designed to provide a robust solution for identifying and resolving any potential viruses within Autodesk
 Maya.
 It ensures a secure and seamless user experience by proactively scanning for threats and effectively neutralizing them.
@@ -55,11 +32,15 @@ It can be provided as an API for seamless integration into your existing pipelin
 # 安装
 
 ## pip 安装
+maya_umbrella is distributed as a standard pipy package, so we can install it via pip install.
+
 maya_umbrella是以标准pipy包去发布的，所以我们可以通过pip install去安装
 ```shell
 your/maya-root/mayapy -m pip install maya-umbrella
 ```
 ## 一键安装
+Download the corresponding version of the zip package in the release, unzip it and double-click `install.bat` to install it.
+
 在release里面下载对应版本的zip包，解压后双击`install.bat`即可安装
 
 更新版本
@@ -88,13 +69,21 @@ pip install -r requirements-dev.txt
 
 
 ## 在maya中测试
+With `nox -s maya -- <maya version>`, start maya.
+Nox will dynamically register a nox session based on your local installation of maya,
+e.g. if you have `maya-2020` installed locally, then you can start maya with a test environment.
+Then you can start maya with a test environment via
 
 通过`nox -s maya -- <maya version>`, 启动maya.
 nox会动态根据你本地安装得maya去注册nox session, 比如你本地安装了`maya-2020`，
 那么通过可以启动带有测试环境的maya
+
 ```shell
 nox -s maya -- 2018
 ```
+**Note: there are two `-` between maya and the version number**.
+
+Starting maya and executing the following code in the script editor will dynamically open the ma file from `<repo>/tests/virus/` to test it.
 
 **注意：maya 与 版本号之间有 俩个`-`**
 
@@ -105,23 +94,29 @@ import manual_test_in_maya
 
 manual_test_in_maya.start()
 ```
+It is also possible to execute the corresponding tests via pytest, which also requires a local installation of the corresponding maya
 
 也可以通过pytest去执行对应的测试，也需要本地安装了对应的maya
 
 ```shell
 nox -s maya -- 2018 --test
 ```
+**Note: Command line crash may occur in versions below maya-2022 (PY2)**.
 
 **注意：在maya-2022 (PY2) 以下的版本可能会出现命令行crash的情况**
 
 
 ## 增加新的疫苗
+Create a new py in `<repo>/maya_umbrella/vaccines/`, since many viruses don't have a specific name, we'll use `vaccine<id>.py`.
+Inherit `from maya_umbrella.vaccine import AbstractVaccine` and call the class `Vaccine`, and then write the virus collection logic.
 
 在`<repo>/maya_umbrella/vaccines/` 新建一个py, 因为有很多病毒没有具体的名字代号，我们统一以`vaccine<id>.py`
 继承`from maya_umbrella.vaccine import AbstractVaccine`并且class名字叫`Vaccine`即可, 然后去写具体的收集病毒逻辑
 
 ## 代码检查
 
+We can use the encapsulated `nox` command to perform a code check.
+
 我们可以利用封装好的`nox`命令去执行进行代码检查
 
 ```shell
@@ -134,6 +129,9 @@ nox -s lint-fix
 ```
 
 # 生成安装包
+Execute the following command to create a zip under <repo>/.zip, with `--version` the version number of the current tool.
+
+**Note: between `make-zip` and `--version` there are two `-`**.
 
 执行下面的命令可以在<repo>/.zip下面创建zip，参数 `--version` 当前工具的版本号
 
@@ -260,4 +258,3 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
 
 This project follows the [all-contributors](https://allcontributors.org) specification.
 Contributions of any kind are welcome!
-

maya_umbrella-0.14.1/maya_umbrella/__version__.py

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

{maya_umbrella-0.13.0 → maya_umbrella-0.14.1}/maya_umbrella/cleaner.py

@@ -22,6 +22,7 @@ class MayaVirusCleaner(object):
         translator (Translator): Translator object for translation purposes.
         collector (MayaVirusCollector): MayaVirusCollector object for collecting issues.
     """
+
     def __init__(self, collector, logger=None):
         """Initialize the MayaVirusCleaner.
 
@@ -50,6 +51,9 @@ class MayaVirusCleaner(object):
     def fix_malicious_files(self):
         """Fix malicious files."""
         for file_ in self.collector.malicious_files:
+            if not os.access(file_, os.W_OK):
+                self.logger.debug(self.translator.translate("file_not_writable", name=file_))
+                continue
             if os.path.exists(file_):
                 if os.path.isfile(file_):
                     self.logger.debug(self.translator.translate("remove_file", name=file_))
@@ -94,6 +98,9 @@ class MayaVirusCleaner(object):
         """Fix infected files."""
         for file_path in self.collector.infected_files:
             self.logger.info(self.translator.translate("fix_infected_files", name=file_path))
+            if not os.access(file_path, os.W_OK):
+                self.logger.debug(self.translator.translate("file_not_writable", name=file_path))
+                continue
             remove_virus_file_by_signature(file_path, FILE_VIRUS_SIGNATURES)
             self.collector.remove_infected_file(file_path)
 

maya_umbrella-0.14.1/maya_umbrella/locales/en_US.json

@@ -0,0 +1,20 @@
+{
+    "start_fix_issues": "Start fixing all problems related to Maya virus $name",
+    "finish_fix_issues": "Repair completed.",
+    "init_message": "Successfully loaded <hl>maya_umbrella</hl> protection.",
+    "init_standalone_message": "----------------------- successfully loaded maya_umbrella-----------------------",
+    "report_issue": "$name: Maliciously infected!",
+    "infected_nodes": "Infected node: $name:",
+    "bad_files": "Files to be cleaned up: $name",
+    "infected_script_jobs": "Infected Script jobs: $name",
+    "infected_files": "Infected file: $name",
+    "infected_reference_files": "Infected reference file: $name",
+    "fix_infected_files": "Clean up infected files: $name",
+    "fix_infected_nodes": "Delete infected node: $name",
+    "fix_infected_reference_nodes": "Attempt to repair the infected reference node: $name",
+    "delete": "Delete infected files: $name",
+    "remove_file": "Delete file: $name",
+    "remove_path": "Delete folder: $name",
+    "fix_script_job": "Delete infected node: $name",
+    "file_not_writable": "The file is not writable: $name"
+}

{maya_umbrella-0.13.0 → maya_umbrella-0.14.1}/maya_umbrella/locales/zh_CN.json

@@ -6,8 +6,8 @@
   "report_issue": "$name：被恶意感染！",
   "infected_nodes": "被感染节点：$name: ",
   "bad_files": "需要被清理的文件：$name",
-  "infected_script_jobs": "被感染的script jobs：$name",
-  "infected_files": "被感染的脚本：$name",
+  "infected_script_jobs": "被感染的Script jobs：$name",
+  "infected_files": "被感染的文件：$name",
   "infected_reference_files": "被感染的参考文件：$name",
   "fix_infected_files": "清理被感染的文件：$name",
   "fix_infected_nodes": "删除被感染的节点：$name",
@@ -15,5 +15,6 @@
   "delete": "删除感染文件：$name",
   "remove_file": "删除文件：$name",
   "remove_path": "删除文件夹：$name",
-  "fix_script_job": "删除被感染的节点：$name"
+  "fix_script_job": "删除被感染的节点：$name",
+  "file_not_writable": "文件不可写：$name"
 }

{maya_umbrella-0.13.0 → maya_umbrella-0.14.1}/maya_umbrella/vaccines/vaccine3.py

@@ -1,6 +1,7 @@
 # Import built-in modules
 import glob
 import os
+import platform
 
 # Import local modules
 from maya_umbrella.filesystem import check_virus_by_signature
@@ -81,7 +82,8 @@ class Vaccine(AbstractVaccine):
 
     def collect_issues(self):
         """Collect all issues related to the virus."""
-        self.api.add_malicious_file(os.path.join(os.getenv("APPDATA"), "syssst"))
+        if platform.system() == "Windows":
+            self.api.add_malicious_file(os.path.join(os.getenv("APPDATA"), "syssst"))
         self.collect_infected_mel_files()
         self.collect_infected_hik_files()
         self.collect_infected_nodes()

{maya_umbrella-0.13.0 → maya_umbrella-0.14.1}/pyproject.toml

@@ -1,11 +1,11 @@
 [tool.poetry]
 name = "maya_umbrella"
-version = "0.13.0"
-description = "Check and fix maya virus."
+version = "0.14.1"
+description = "A better Autodesk Maya antivirus tool detects and removes malicious."
 homepage = "https://github.com/loonghao/maya_umbrella"
 repository = "https://github.com/loonghao/maya_umbrella"
 documentation = "https://github.com/loonghao/maya_umbrella"
-keywords = ["notifiers", "python", "Maya", "dcc"]
+keywords = ["Autodesk Maya", "python", "Maya", "dcc", "antivirus", "Security Tools", "maya_umbrella"]
 authors = ["longhao <hal.long@outlook.com>"]
 license = "MIT"
 readme = "README.md"
@@ -36,7 +36,7 @@ nox = { version = "^2024.3.2", python = ">=3.8.1,<3.11" }
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.13.0"
+version = "0.14.1"
 tag_format = "v$version"
 version_files = [
     "pyproject.toml:version",

maya_umbrella-0.13.0/maya_umbrella/__version__.py

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

maya_umbrella-0.13.0/maya_umbrella/locales/en_US.json

@@ -1,19 +0,0 @@
-{
-  "start_fix_issues": "Start fixing all problems related to Maya virus $name",
-  "finish_fix_issues": "Done.",
-  "init_message": "Successfully loaded <hl>maya_umbrella</hl> under protection.",
-  "init_standalone_message": "-----------------------Loading maya_umbrella successfully----------------------",
-  "report_issue": "$name: Infected by Malware!",
-  "infected_nodes": "Infected nodes: $name: ",
-  "bad_files": "Bad files: $name",
-  "infected_script_jobs": "Infected script jobs: $name",
-  "infected_files": "Infected files: $name",
-  "infected_reference_files": "Infected reference files: $name",
-  "fix_infected_files": "Clean infected files: $name",
-  "fix_infected_nodes": "Delete infected nodes：$name",
-  "fix_infected_reference_nodes": "trying fix infected nodes from reference：$name",
-  "delete": "Deleting: $name",
-  "remove_file": "Deleting file：$name",
-  "remove_path": "Deleting path：$name",
-  "fix_script_job": "Kill script job: %s"
-}