运行时刻模块 pytransform

如果你意识到加密后的脚本对用户来说就是黑盒子,那么有很多事情都可以在 Python 脚本里来做。在这个时候,模块 pytransform 会提供很多有用 的函数和功能。

模块 pytransform 是和加密脚本一起发布,在运行加密脚本之前必须被 导入进来,所以,你可以在你的脚本中直接导入这个模块,使用里面的函数。

内容

exception PytransformError

任何 PyArmor 的 api 失败都会抛出这个异常,传入的参数是错误发生的原因。

get_expired_days()

返回加密脚本的剩余的有效天数。

>0: 剩余的有效天数

-1: 永不过期

注解

如果加密脚本已经过期,会直接抛出异常并退出。加密脚本里面的任何代码 都不会被执行,所以一般情况下这个函数是不会返回 0 的。

get_license_info()

获取加密脚本许可证的相关信息。

返回一个字典,可能的键名有:

  • expired: 许可过期的日期
  • IFMAC:绑定的网卡 MAC 地址
  • HARDDISK: 绑定的硬盘序列号
  • IPV4:绑定的 IPv4 地址
  • DATA:自定义的数据,用于扩展认证方式
  • CODE:许可注册码

如果许可证没有包含对应的键名,那么其值为 None

如果许可文件非法,例如已经过期,会抛出异常 Exception

get_license_code()

返回字符串,该字符串是生成许可文件时指定的注册码参数。

如果认证文件非法或者无效,抛出异常 Exception

get_hd_info(hdtype, size=256)

得到当前机器的硬件信息,通过 hdtype 传入需要获取的硬件类型,可用的 值如下:

  • HT_HARDDISK 返回硬盘序列号
  • HT_IFMAC 返回网卡Mac地址

无法获取硬件信息会抛出异常 Exception

HT_HARDDISK, HT_IFMAC

调用 get_hd_info() 时候 hdtype 的可以使用的常量

示例

下面是一些示例,拷贝这些代码到需要加密的脚本里面,然后加密脚本,运行加密脚本查看效果。

显示加密脚本的剩余的有效天数

from pytransform import PytransformError, get_license_info, get_expired_days
try:
    code = get_license_info()['CODE']
    left_days = get_expired_days()
    if left_days == -1:
        print('This license for %s is never expired' % code)
    else:
        print('This license for %s will be expired in %d days' % (code, left_days))
except Exception as e:
    print(e)

更多内容,请参考 使用插件扩展认证方式

注解

虽然在运行加密脚本的时候 pytransform.py 没有被加密,但是它同样被 PyArmor 所保护。如果对它进行任何修改,运行加密脚本同样会抛出保护异常。

参考 对主脚本的特殊处理