README.md

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.

It can be provided as an API for seamless integration into your existing pipeline.

安装

pip 安装

maya_umbrella is distributed as a standard pipy package, so we can install it via pip install.

maya_umbrella是以标准pipy包去发布的，所以我们可以通过pip install去安装

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即可安装

更新版本

your/maya-root/mayapy -m pip install maya-umbrella --upgrade

卸载

your/maya-root/mayapy -m pip uninstall  maya-umbrella

开发环境设置

Set up the development environment using a virtual environment, and it is recommended to use Python 3.8 or higher versions.

通过虚拟环境去设置开发环境, 推荐python-3.8以上的版本

通过pip安装相关开发依赖

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-2018 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-2018， 那么通过可以启动带有测试环境的maya

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 与 版本号之间有 俩个-

启动maya后在脚本编辑器中执行下面得代码，就会动态的从<repo>/tests/virus/里面去open ma文件去进行测试.

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

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命令去执行进行代码检查

nox -s lint

进行代码整理

nox -s lint-fix

生成安装包

Execute the following command to create a zip under /.zip, with --version the version number of the current tool.

Note: between make-zip and --version there are two -.

执行下面的命令可以在/.zip下面创建zip，参数 --version 当前工具的版本号

注意：make-zip 与 --version之间有 俩个-

nox -s make-zip -- --version 0.5.0

环境变量

We can use the following environment variables to modify some of the settings of maya_umbrella,

so that companies with pipelines can better integrate them.

Modify the log saving directory of maya umbrella, the default is the windows temp directory.

我们可以通过下列环境变量去修改maya_umbrella的一些设置，方便有pipeline的公司可以更好的集成

修改maya umbrella的日志保存目录，默认是windows temp目录

MAYA_UMBRELLA_LOG_ROOT

Change the name of the log file for maya umbrella, default is maya_umbrella.

修改maya umbrella的日志文件名称, 默认是maya_umbrella

MAYA_UMBRELLA_LOG_NAME

Set the log level, the default is info, can be debug can see more log information.

设置日志级别，默认是info, 可以是debug可以看到更多的日志信息.

MAYA_UMBRELLA_LOG_LEVEL

Change the name of the backup folder for antivirus files, default is _virus.

For example:

Your file path is c:/your/path/file.ma.

Then the backup file path is c:/your/path/_virus/file.ma.

修改杀毒后文件的备份文件夹名称， 默认是_virus 比如: 你文件路径是 c:/your/path/file.ma 那么备份文件路径是 c:/your/path/_virus/file.ma

MAYA_UMBRELLA_BACKUP_FOLDER_NAME

The default display language, including logging printouts, etc.

is set by default according to your current maya interface language,

but of course we can also set it via the following environment variables.

默认的显示语言，包含日志打印输出等，默认是根据你当前maya的界面语言来设置的，当然我们也可以通过下面的环境变量去设置.

MAYA_UMBRELLA_LANG

Ignore saving to the backup folder, please note that if you are not clear about the consequences of this please do not modify it easily, the default batch antivirus will automatically back up the source file to the current file's backup folder after the batch antivirus.

忽略保存到备份文件夹，请注意，如果你不清楚这个会导致的后果请不要轻易修改，默认批量杀毒后会把源文件自动备份到当前文件的备份文件夹.

MAYA_UMBRELLA_IGNORE_BACKUP

If ignored please set to

如果忽略请设置为

SET MAYA_UMBRELLA_IGNORE_BACKUP=true

For the portable version of Maya, you can specify the Maya path by adding the MAYA_LOCATION environment variable.

如果是便携版Maya，可以通过添加 MAYA_LOCATION 环境变量指定Maya路径

SET MAYA_LOCATION=d:/your/path/maya_version/

You can also specify a directory from the command line.

也可以通过命令行指定目录

nox -s maya -- 2018 --install-root /your/local/maya/root

API

Get virus files that have not been repaired in the current scenario.

获取当前场景没有被修复的病毒文件

from maya_umbrella import MayaVirusDefender

api = MayaVirusDefender()
print(api.get_unfixed_references())

Batch repair of files, via regular expressions.

批量修复文件, 通过正则表达式

from maya_umbrella import MayaVirusScanner

api = MayaVirusScanner()
print(api.scan_files_from_pattern("your/path/*.m[ab]"))

案例

If you want to quickly go through maya standalone and batch clean up maya files.

You can either download or git clone the current main branch.

Set up your development environment according to the guidelines above, and Use the nox command to start the maya standalone environment, the version of maya is based on your current local installation of maya. For example, if you have 2018 installed locally, Then nox -s maya -- 2018 --standalone.

The following syntax starts a maya-2020 environment to dynamically check for viruses from the c:/test folder.

如果你想要快速通过maya standalone去批量清理maya文件， 可以下载或者git clone当前main分支的工程， 根据上面指引设置好开发环境, 通过nox命令去启动maya standalone环境，maya版本根据你当前本地安装的maya为准， 比如你本地安装了2018, 那么就是 nox -s maya -- 2018 --standalone 下面的语法是启动一个maya-2020的环境去动态从c:/test文件夹下去查杀病毒

nox -s maya -- 2018 --standalone --pattern c:/test/*.m[ab]

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Hal 💻 🚇 ⚠️	hotwinter0 ⚠️ 💻	lingyunfx ⚠️	yjjjj ⚠️ 💻	Unclechen ⚠️	andyvfx 💻	cundesi 💻
Wenfeng Zhang ⚠️ 💻	rickdave 🐛

This project follows the all-contributors specification. Contributions of any kind are welcome!