pyarmor.cli 9.1.2__tar.gz → 9.2.1__tar.gz

pyarmor_cli-9.2.1/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.1
+Name: pyarmor.cli
+Version: 9.2.1
+Summary: A comand line tool to obfuscate python scripts
+Home-page: https://github.com/dashingsoft/pyarmor
+Author: Jondy Zhao
+Author-email: pyarmor@163.com
+License: Free To Use But Restricted
+Keywords: protect obfuscate encrypt obfuscation distribute
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: Free To Use But Restricted
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Software Distribution
+Requires-Dist: pyarmor.cli.core~=8.1.0
+
+Protect Python Scripts By Pyarmor
+=================================
+
+Pyarmor is a command line tool used to obfuscate python scripts, bind obfuscated scripts to fixed machine or expire obfuscated scripts.
+
+Key Features
+------------
+
+* The obfuscated scritpt is still a normal `.py` script, in most of cases the original python scripts can be replaced with obfuscated scripts seamlessly.
+* Provide many ways to obfuscate the scripts to balance security and performance
+* Rename functions/methods/classes/variables/arguments, irreversible obfuscation
+* Convert part of Python functions to C function, compile to binary by high optimize option, irreversible obfuscation
+* Bind obfuscated scripts to fixed machine or expire obfuscted scripts
+* Protect obfuscated scripts by Themida (Only for Windows)
+
+Support Platforms
+-----------------
+
+* Python 3.7~3.13
+* Windows
+* Many linuxs, include embedded systems
+* Apple Intel and Apple Silicon
+
+Quick Start
+-----------
+
+Install::
+
+    pip install pyarmor
+
+Obfuscate the script `foo.py`::
+
+    pyarmor gen foo.py
+
+This command generates an obfuscated script `dist/foo.py` like this:
+
+.. code:: python
+
+    from pyarmor_runtime import __pyarmor__
+    __pyarmor__(__name__, __file__, b'\x28\x83\x20\x58....')
+
+Run it::
+
+    python dist/foo.py
+
+More Resources
+--------------
+
+- `Home <https://github.com/dashingsoft/pyarmor>`_
+- `Website <http://pyarmor.dashingsoft.com>`_
+- `中文网站 <http://pyarmor.dashingsoft.com/index-zh.html>`_
+- `Issues <https://github.com/dashingsoft/pyarmor/issues>`_
+- `Documentation <https://pyarmor.readthedocs.io/>`_

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/__init__.py

@@ -1,6 +1,6 @@
 import logging
 
-__VERSION__ = '9.1.2'
+__VERSION__ = '9.2.1'
 
 logger = logging.getLogger('cli')
 

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/__main__.py

@@ -309,7 +309,7 @@ def cmd_reg(ctx, args):
             raise CliError('please use ".zip" file to register group device')
         regsvr = WebRegister(ctx)
         regsvr.check_request_interval()
-        regsvr.register_group_device(regfile, args.device)
+        regsvr.request_device_regfile(regfile, args.device)
         logger.info('The device regfile has been generated successfully')
 
     elif args.ci:
@@ -325,7 +325,7 @@ def cmd_reg(ctx, args):
 
     else:
         regsvr = WebRegister(ctx)
-        regsvr.check_request_interval()
+        regsvr.check_request_interval(activation=regfile)
         info, msg = regsvr.prepare(regfile, args.product, upgrade=upgrade)
         prompt = 'Are you sure to continue? (yes/no) '
         if args.confirm:
@@ -764,7 +764,7 @@ def main_entry(argv):
     log_settings(ctx, args)
 
     x, y = sys.version_info[:2]
-    if not (x == 3 and y > 6 and y < 14):
+    if not (x == 3 and y > 6 and y < 16):
         raise CliError('Python %s.%s is not supported' % (x, y))
 
     if args.version:

pyarmor_cli-9.2.1/pyarmor/cli/batch.py

@@ -0,0 +1,62 @@
+#! /usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+#############################################################
+#                                                           #
+#      Copyright @ 2025 -  Dashingsoft corp.                #
+#      All rights reserved.                                 #
+#                                                           #
+#      Pyarmor                                              #
+#                                                           #
+#      Version: 9.2.1 -                                     #
+#                                                           #
+#############################################################
+#
+#
+#  @File: cli/shell.py
+#
+#  @Author: Jondy Zhao (pyarmor@163.com)
+#
+#  @Create Date: Wed Nov  5 20:22:52 CST 2025
+#
+
+"""This script could run batch pyarmor commands.
+
+For example:
+
+    python3 -m pyarmor.cli.batch build-script.sh
+
+cd abc
+pyarmor
+
+The main purpose is to fix pyarmor CI License send too many request issues.
+
+"""
+import shlex
+import os
+
+from pyarmor.cli.__main__ import main_entry as pyarmor_run
+
+# Do not run `pyarmor reg pyarmor-ci-xxxx.zip` here, run it before this script
+
+build_commands = """
+pyarmor gen main.py
+cd ../package1
+pyarmor gen -R --enable-bcc src/
+cd ../package2
+pyarmor gen -R --enable-jit --private src/
+"""
+
+for cmd in build_commands.splitlines():
+    if cmd.startswith('#'):
+        continue
+
+    if cmd.startswith('cd '):
+        path = cmd[3:].strip()
+        print('Change current path:', path)
+        os.chdir(path)
+
+    elif cmd.startswith('pyarmor '):
+        print('Execute: ', cmd)
+        args = shlex.split(cmd[8:].strip())
+        pyarmor_run(args)

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/command.py

@@ -135,16 +135,6 @@ class Commander:
         #     action="store_const", const='std',
         #     help='genetate standard obfuscated scripts'
         # )
-        # group.add_argument(
-        #     '--ecc', dest='target', default='std',
-        #     action="store_const", const='ecc',
-        #     help='genetate scripts with embedded C code'
-        # )
-        # group.add_argument(
-        #     '--vmc', dest='target', default='std',
-        #     action="store_const", const='vmc',
-        #     help='genetate scripts with vm C code'
-        # )
         group.add_argument(
             '--rft', dest='target', default='std',
             action="store_const", const='rft',
@@ -158,7 +148,27 @@ class Commander:
         group.add_argument(
             '--mini-rft', dest='target', default='std',
             action="store_const", const='mini-rft',
-            help='genetate high performance refactor scripts'
+            help='generate scripts by combining --rft and --mini'
+        )
+        group.add_argument(
+            '--vmc', dest='target', default='std',
+            action="store_const", const='vmc',
+            help='genetate scripts with vmc code'
+        )
+        group.add_argument(
+            '--vmc-rft', dest='target', default='std',
+            action="store_const", const='vmc-rft',
+            help='generate scripts by combining --rft and --vmc'
+        )
+        group.add_argument(
+            '--ecc', dest='target', default='std',
+            action="store_const", const='ecc',
+            help='genetate scripts with embedded C code'
+        )
+        group.add_argument(
+            '--ecc-rft', dest='target', default='std',
+            action="store_const", const='ecc',
+            help='generate scripts by combining --rft and --ecc'
         )
         group.add_argument(
             '--list', dest='target', default='std',
@@ -412,6 +422,8 @@ class Commander:
             logger.info('build target %s ...', args.target)
             output = args.output if args.output else 'dist'
             self._build(project, args.target, output)
+            if args.target.startswith('std'):
+                self._cmd_gen(args)
             logger.info('build target %s end', args.target)
 
     def _build(self, project, target, output, value=None):
@@ -420,6 +432,25 @@ class Commander:
         m = Pytransform3.init(self.ctx)
         m.pre_build(args)
 
+    def _cmd_gen(self, args):
+        """If build target is std, then call `pyarmor gen`
+
+        It will obfuscate the scripts with `pyarmor_runtime.so`
+
+        Most of obfuscated options are got from config file, not from
+        command line
+
+        Option `--pack` may be still got from command line
+        """
+        from .generate import Builder
+        from .plugin import Plugin
+
+        ctx = self.ctx
+        builder = Builder(ctx)
+        Plugin.install(ctx)
+        builder.process(args)
+        Plugin.post_build(ctx)
+
     def cmd_env(self, ctx, args):
         """Check and change pyarmor settings
 

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/default.cfg

@@ -2,14 +2,15 @@
 
 ;; Pyarmor version
 major = 9
-minor = 1
-patch = 2
+minor = 2
+patch = 1
 
-;; Compatible core version
-cli.core = 7.6.4
-mini.core = 1.0
-ecc.core = 1.0
-vmc.core = 1.0
+;; Compatible core version for package: pyarmor.cli.core
+cli.core = 8.1.0
+
+;; Compatible core version for package: pyarmor.mini
+;; Which is required to run MINI, VMC, or ECC mode scripts
+mini.core = 3.0
 
 ;; Deprecated since Pyarmor 8.2.5
 ; cli.runtime = 3.2.5
@@ -147,6 +148,16 @@ enable_jit = 0
 enable_bcc = 0
 enable_rft = 0
 
+;; Not implemented
+;; Enable opcode virtual protection
+;; This feature is meaningless in BCC mode
+enable_vmc = 0
+
+;; New in v9.2.0
+;; Enable to obfuscate attribute name
+;; When obf_code == 2, it's enabled implicitly
+mix_attr = 0
+
 ;; assert: call import
 assert_call = 0
 assert_import = 0
@@ -165,7 +176,16 @@ mix_localnames = 1
 ;; mix argument names, it also clears annotations
 mix_argnames = 0
 
+;; Obfuscate the whole module
 obf_module = 1
+
+;; Obfuscate each code object
+;;
+;;   0: no obfuscation for each co
+;;   1: obfuscate each co
+;;   2: obfuscate each co plus mix attribute name
+;;      this is deprecated since 9.2.0, use
+;;      obf_code == 1 and mix_attr = 1
 obf_code = 1
 
 ;; 0: no wrap mode
@@ -174,8 +194,15 @@ obf_code = 1
 ;; Since Python 3.12, "2" is same as "1", both of them use full wrap mode
 wrap_mode = 1
 
+;; 1: the obfuscated scripts can't be modified
+;; 2: private module, can't be imported by plain scripts
+;; 3: restrict module, module attribute is hidden for outer scripts
+;;
 restrict_module = 1
 
+;; if set to 1, module attribute can't be written by plain scripts
+readonly_module = 0
+
 ;;
 ;; Advanced features
 ;;

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/project.py

@@ -187,7 +187,7 @@ class Module:
 
     @property
     def destpath(self):
-        s = self.qualname + ('' if self._name else '.__init__')
+        s = self.qualname + ('' if self.name else '.__init__')
         return joinpath(*s.split('.')) + splitext(self.path)[-1]
 
     def compile_file(self, force=False):
@@ -241,17 +241,34 @@ class Script(Module):
 class Package(Module):
     """Package concept"""
 
-    def __init__(self, path, name=None, parent=None):
+    def __init__(self, path, name=None, parent=None, excludes=[]):
         super().__init__(path, name=name, parent=parent)
 
         self._modules = None
         self._packages = None
+        self._excludes = excludes if excludes else GLOBAL_EXCLS
+        self._filters = None
+
+    @property
+    def filters(self):
+        if self._filters is None:
+            self._filters = []
+            for x in self._excludes:
+                i = x.find(':')
+                if i == -1:
+                    self._filters.append(x)
+                elif fnmatch(self.qualname, x[:i]):
+                    self._filters.append(x[i+1:])
+        return self._filters
 
     def load(self):
-        excludes = GLOBAL_EXCLS
-        files, dirs = scan_path(self.abspath, excludes=excludes)
+        excls = self.filters
+        files, dirs = scan_path(self.abspath, excludes=excls)
         self._modules = [Module(x, parent=self) for x in files]
-        self._packages = [Package(x, parent=self) for x in dirs]
+        self._packages = [
+            Package(x, parent=self, excludes=self._excludes)
+            for x in dirs
+        ]
 
     @property
     def modules(self):
@@ -858,17 +875,19 @@ class Project:
         src = self.src = data['src']
         name = data.get('name')
         excludes = vlist('excludes') + list(GLOBAL_EXCLS)
+        proexcls = [x.strip(':') for x in excludes
+                    if x.find(':') < 1]
 
         scripts = []
         for pat in vlist('scripts'):
-            scripts.extend(search_item(src, pat, excludes))
+            scripts.extend(search_item(src, pat, proexcls))
         self._scripts.extend([
             Script(self.relsrc(x), parent=self) for x in scripts
         ])
 
         modules = []
         for pat in vlist('modules'):
-            modules.extend(search_item(src, pat, excludes))
+            modules.extend(search_item(src, pat, proexcls))
 
         packages = vlist('packages')
         if packages:
@@ -883,7 +902,10 @@ class Project:
                     path, pkgname = item.split('@')
                 if not isabs(path):
                     path = joinpath(src, path)
-                obj = Package(path, name=pkgname, parent=self)
+                obj = Package(path,
+                              name=pkgname,
+                              parent=self,
+                              excludes=excludes)
                 self._packages.append(obj)
 
         recursive = data.get('recursive', '0')
@@ -891,10 +913,13 @@ class Project:
             pkginit = joinpath(src, '__init__.py')
             if exists(pkginit):
                 pkgname = name if name else basename(src)
-                obj = Package(src, name=pkgname, parent=self)
+                obj = Package(src,
+                              name=pkgname,
+                              parent=self,
+                              excludes=excludes)
                 self._packages.append(obj)
             else:
-                files, dirs = scan_path(src, excludes=excludes)
+                files, dirs = scan_path(src, excludes=proexcls)
                 modules.extend([joinpath(src, x) for x in files])
                 self._packages.extend([
                     Package(x, parent=self) for x in dirs
@@ -939,7 +964,7 @@ class Project:
 
     def _get_external_types(self, modname, pypaths=None):
         from sys import executable
-        from subprocess import check_output, CalledProcessError
+        from subprocess import check_output, CalledProcessError, DEVNULL
         source = Template(dedent("""\
         import json
         import sys
@@ -960,12 +985,16 @@ class Project:
         """)).substitute(name=modname, pypaths=repr(pypaths))
 
         try:
-            output = check_output([executable, '-c', source])
+            output = check_output([executable, '-c', source], stderr=DEVNULL)
             return jsonloads(output)
         except CalledProcessError:
             pass
 
     def get_external_type(self, modname, clsname=None):
+        if not all([x.isidentifier() for x in modname.split('.')]):
+            logger.debug('invalid external module: %s', modname)
+            return []
+
         extypes = self.used_external_types
         if modname not in extypes:
             result = self._get_external_types(modname)

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/register.py

@@ -89,7 +89,7 @@ def parse_token(data):
 
 def show_help_page(prompt, url):
     choice = input('\n'.join(prompt)).lower()[:1]
-    if choice == 'h':
+    if choice in ('h', 'y'):
         import webbrowser
         webbrowser.open(url)
     return choice
@@ -208,7 +208,7 @@ class Register(object):
                 if len(line) == 192 and line.find(' ') == -1:
                     return regname, line
 
-        raise CliError('no registration code found in %s' % filename)
+        raise CliError('invalid activation file "%s"' % filename)
 
     def _register_offline_license(self, fzip, namelist):
         logger.info('machine id in group license: %s', ', '.join(
@@ -279,13 +279,15 @@ class Register(object):
         regname = regname.encode('utf-8')
         product = product.encode('utf-8')
         notes = notes.encode('utf-8')
-        data = pack('<II8x20s28xBB2sB2sB2s', token,
+        sizes = len(regname), len(product), len(notes)
+        data = pack('<II8x20s28xBB{0}sB{1}sB{2}s'.format(*sizes),
+                    token,
                     rev | features << 8,
                     licno.encode('utf-8'),
                     0,
-                    len(regname), b'%s',
-                    len(product), b'%s',
-                    len(notes), b'%s') % (regname, product, notes)
+                    sizes[0], regname,
+                    sizes[1], product,
+                    sizes[2], notes)
         return b64encode(data) + b' *=='
 
     def register_regfile(self, regfile, clean=True):
@@ -443,7 +445,7 @@ class Register(object):
         ]
         if lictype == 'trial':
             self.notes.append('* Can\'t obfuscate big script and mix str')
-        elif lictype in ('bacic', 'pro'):
+        elif lictype in ('basic', 'pro'):
             self.notes.append('* Need verify license online '
                               'when obfuscating scripts')
         elif lictype == 'group':
@@ -478,6 +480,16 @@ The upgraded license information will be''')
 
 class WebRegister(Register):
 
+    # Before v9.0:  1
+    # Pyarmor v9.0: 2
+    # Pyarmor v9.2: 3
+    LICENSE_REVSION = 3
+
+    # Before v9.0: no CI License
+    # Pyarmor v9.0: 1
+    # Pyarmor v9.2: 2
+    CI_LICENSE_REVSION = 2
+
     def _request(self, url):
         from http.client import HTTPSConnection
         n = len('https://')
@@ -486,7 +498,7 @@ class WebRegister(Register):
         conn.request("GET", url[k:])
         return conn.getresponse()
 
-    def check_request_interval(self, delta=30.0):
+    def check_request_interval(self, delta=30.0, activation=False):
         """Make sure no more than 2 requests in 1 minute"""
         tspath = os.path.join(self.ctx.reg_path, 'last_register')
         try:
@@ -497,8 +509,11 @@ class WebRegister(Register):
             from time import sleep, time
             d = delta - (time() - st.st_mtime)
             if d > 0:
-                logger.info('last register was within %d seconds, '
-                            'waiting for %d seconds', delta, d)
+                if activation:
+                    logger.warning(
+                        'caution: this activation file "%s" can only '
+                        'be used no more than 10 times', activation)
+                logger.info('waiting for %d seconds', d)
             while time() - st.st_mtime < delta:
                 logger.info('waiting ...')
                 sleep(3.0)
@@ -566,6 +581,8 @@ class WebRegister(Register):
             else:
                 lines.append(upgrade_to_basic_info.substitute())
         else:
+            if info['lictype'] == 'OLD':
+                raise CliError('old license only works for Pyarmor <= 7.7.4')
             if info['lictype'] not in ('BASIC', 'PRO', 'GROUP', 'CI'):
                 raise CliError('unknown license type %s' % info['lictype'])
             lines.append('This license registration information will be')
@@ -611,7 +628,7 @@ class WebRegister(Register):
 
         logger.info('send upgrade request to server')
         res = self._send_request(url)
-        regfile = self._handle_response(res)
+        regfile, lictype = self._handle_response(res)
 
         logger.info('update license token')
         self.update_token()
@@ -631,15 +648,14 @@ class WebRegister(Register):
         reginfo = self.parse_keyfile(keyfile)
 
         url = self.regurl(reginfo[1], product=product)
-        # Request license file with extra info by rev 2
-        url += '&rev=2'
+        url += '&rev=' + str(self.LICENSE_REVSION)
         if upgrade:
             url += '&upgrade_to_basic=1'
         logger.debug('url: %s', url)
 
         logger.info('send request to server')
         res = self._send_request(url)
-        regfile = self._handle_response(res)
+        regfile, lictype = self._handle_response(res)
 
         logger.info('')
         logger.info('the registration file "%s" has been generated', regfile)
@@ -651,35 +667,22 @@ class WebRegister(Register):
             '* Please backup regfile "%s", and '
             'use this file for next any registration' % regfile,
             '* Do not use this file in docker and CI/CD pipeline',
+            '',
         ]
-
-        if group:
-            notes.append('* Please check `pyarmor reg` in Man page for '
-                         'how to register Pyarmor on offline device')
-            logger.info('\n\nImport Notes:\n%s\n', '\n'.join(notes))
-            return
-
-        notes.append('')
-        notes.append('Next register Pyarmor in build device by this command:')
-
-        notes.append('\tpyarmor reg %s' % regfile)
-        notes.append('')
         logger.info('\n\nImport Notes:\n%s\n', '\n'.join(notes))
 
-        prompt = 'Do you want register Pyarmor in this machine? (Y/n) '
-        choice = input(prompt).lower()[:1]
-        if choice == 'y':
-            logger.info('register "%s"', regfile)
-            self.register_regfile(regfile)
-            logger.info('This license registration information:\n\n%s', self)
+        input('Type Enter to continue ...')
+        LicenseHelper(self).run(lictype, regfile)
 
     def _handle_response(self, res):
         if res and res.code == 200:
+            lictype = None
             dis = res.headers.get('Content-Disposition')
             filename = dis.split('"')[1] if dis else 'pyarmor-regfile.zip'
             logger.info('write registration file "%s"', filename)
             data = res.read()
             if data.startswith(b'{"group":'):
+                lictype = 'G'
                 n = data.find(b'}') + 1
                 with open(filename, 'wb') as f:
                     f.write(data[n:])
@@ -691,13 +694,15 @@ class WebRegister(Register):
                 n += i
                 with open(filename, 'wb') as f:
                     f.write(data[n:])
-                self._write_reg_info(filename, data[i:n])
+                reginfo = data[i:n]
+                lictype = json_loads(reginfo).get('type', None)
+                self._write_reg_info(filename, reginfo)
             else:
                 # Only for request group token
                 logger.debug('no REGINFO found')
                 with open(filename, 'wb') as f:
                     f.write(data)
-            return filename
+            return filename, lictype
 
         elif res:
             data = res.read()
@@ -723,10 +728,11 @@ class WebRegister(Register):
         with ZipFile(filename, 'a') as f:
             f.writestr('group.info', data)
 
-    def register_group_device(self, regfile, devid, rev=2):
+    def request_device_regfile(self, regfile, devid):
         from zipfile import ZipFile
         devfile = self.ctx.group_device_file(devid)
-        logger.info('register device file "%s"', devfile)
+        rev = self.LICENSE_REVSION
+        logger.info('request device regfile "%s" (v%d)', devfile, rev)
         logger.info('use group license "%s"', regfile)
         if not os.path.exists(devfile):
             logger.error('please generate device file in offline device by')
@@ -770,7 +776,7 @@ class WebRegister(Register):
             logger.debug('url: %s', url)
 
             res = self._send_request(url)
-            filename = self._handle_response(res)
+            filename, lictype = self._handle_response(res)
             with open(filename, 'rb') as f:
                 data = f.read()
             os.makedirs(os.path.dirname(tokencache), exist_ok=True)
@@ -786,14 +792,18 @@ class WebRegister(Register):
         logger.info('please copy deivce regfile to offline device and run')
         logger.info('    pyarmor reg %s', filename)
 
+    register_group_device = request_device_regfile
+
     def _write_ci_info(self, filename, data):
         from zipfile import ZipFile
         logger.info('write ci information')
         with ZipFile(filename, 'a') as f:
             f.writestr('ci.token', data)
 
-    def request_ci_regfile(self, regfile, rev=2):
-        logger.info('request ci regfile by "%s"', regfile)
+    def request_ci_regfile(self, regfile):
+        rev = self.LICENSE_REVSION
+        cirev = self.CI_LICENSE_REVSION
+        logger.info('request ci regfile (v%d) by "%s"', cirev, regfile)
         from zipfile import ZipFile
 
         with ZipFile(regfile, 'r') as f:
@@ -810,7 +820,7 @@ class WebRegister(Register):
             raise CliError('invalid registration file "%s"', regfile)
 
         url = self.regurl('ci/%s' % ucode)
-        paras = (('rev', str(rev)),)
+        paras = ('rev', str(rev)), ('cirev', str(cirev))
         url += '&'.join(['='.join(x) for x in paras])
         logger.debug('url: %s', url)
 
@@ -850,3 +860,227 @@ class WebRegister(Register):
                     '\n\tpip install pyarmor==%s\n'
                     '\tpyarmor reg %s\n',
                     cifile, ver, cifile)
+
+
+BASIC_LICENSE_HELP_INFO = Template('''
+Using Basic license in CI/CD pipeline or docker container need extra steps, please check this page
+
+$docurl/how-to/ci.html
+
+More usage about Basic License, check this page
+
+$docurl/how-to/register.html
+
+If need register Pyarmor in build device, run this command:
+
+    pyarmor reg $regfile
+
+''')
+
+PRO_LICENSE_HELP_INFO = Template('''
+Pro license can't be used in CI/CD pipeline or docker container direclty.
+
+A few times for debug purpose, about 60 runs per month, may work.
+
+But there is one workaroud for Pro licnese in CI/CD pipeline, please check this page
+
+$docurl/how-to/ci.html
+
+More usage about Pro License, check this page
+
+$docurl/how-to/register.html
+
+If need register Pyarmor in build device, run this command:
+
+    pyarmor reg $regfile
+
+''')
+
+GROUP_LICENSE_HELP_INFO = Template('''
+Group License file `$regfile` is only used to request device regfile
+
+In order to register Pyarmor in offline device:
+
+1. In the build device (may be offline), generate device info by this command
+
+   pyarmor reg -g 1
+
+2. In any online device, copy device file generated by first step, then request device regfile for this device
+
+   cp pyarmor-group-device.1 .pyarmor/group/
+   pyarmor reg -g 1 $regfile
+
+3. In the build device, register Pyarmor by device regfile
+
+   pyarmor reg pyarmor-device-regfile-xxxx.1.zip
+
+More usage about CI License, check section `Using group licnese`
+
+$docurl/how-to/register.html
+''')
+
+CI_LICENSE_HELP_INFO = Template('''
+CI license file `$regfile` is only used to request CI regfile
+
+CI regfile is used to register Pyarmor in the CI/CD pipeline
+
+If need request CI regfile, run this command:
+
+    pyarmor reg -C $regfile
+
+Note that CI regfile can NOT be used in physical machine, and there is rate limits to register CI regfile in CI/CD pipeline and docker container.
+
+It may need request new CI regfile after Pyarmor is upgraded, please check section `When need to request new CI regfile` in this page
+
+$docurl/how-to/ci.html
+
+More usage about CI License, check these pages
+
+$docurl/how-to/register.html
+$docurl/how-to/ci.html
+''')
+
+
+class LicenseHelper(object):
+    """Only used for first activate license.
+
+    Help the beginner to understand how to use different licenses.
+
+    """
+
+    def __init__(self, parent):
+        self.parent = parent
+        self.docurl = parent.ctx.cfg.get(
+            'pyarmor', 'docurl').rstrip('/').replace('{lang}', 'en')
+        self.print = print
+
+    def run(self, lictype, regfile):
+        if lictype == 'G':
+            self._group_license_helper(regfile)
+
+        elif lictype == 'C':
+            self._ci_license_helper(regfile)
+
+        elif lictype == 'Z':
+            self._pro_license_helper(regfile)
+
+        elif lictype in ('J', 'B', 'P'):
+            self._basic_license_helper(regfile)
+
+        else:
+            raise CliError('unknown license type "%s"' % lictype)
+
+    def _basic_license_helper(self, regfile):
+        self.print(BASIC_LICENSE_HELP_INFO.substitute(
+            docurl=self.docurl, regfile=regfile))
+
+        prompt = 'Yes (y), No (n), Quit (q): '
+        self.print('Show basic license usage in webbrowser? (n)')
+        choice = show_help_page([prompt], self.docurl + '/how-to/register.html')
+        if choice == 'q':
+            return
+
+        self.print('Show basic license for CI/CD pipeline or docker? (n)')
+        choice = show_help_page([prompt], self.docurl + '/how-to/ci.html')
+        if choice == 'q':
+            return
+
+        self.print('Do you want register Pyarmor in this machine? (y)')
+        choice = input(prompt).lower()[:1]
+        if choice == 'q':
+            return
+
+        if choice in ('y', ''):
+            self.print('register "%s"' % regfile)
+            self.parent.register_regfile(regfile)
+            self.print('This license registration information:\n\n'
+                       '%s' % self.parent)
+
+    def _pro_license_helper(self, regfile):
+        self.print(PRO_LICENSE_HELP_INFO.substitute(
+            docurl=self.docurl, regfile=regfile))
+
+        prompt = 'Yes (y), No (n), Quit (q): '
+        self.print('Show pro license usage in webbrowser? (n)')
+        choice = show_help_page([prompt], self.docurl + '/how-to/register.html')
+        if choice == 'q':
+            return
+
+        self.print('Show pro license for CI/CD pipeline or docker? (n)')
+        choice = show_help_page([prompt], self.docurl + '/how-to/ci.html')
+        if choice == 'q':
+            return
+
+        self.print('Do you want register Pyarmor in this machine? (y)')
+        choice = input(prompt).lower()[:1]
+        if choice == 'q':
+            return
+
+        if choice in ('y', ''):
+            self.print('register "%s"' % regfile)
+            self.parent.register_regfile(regfile)
+            self.print('This license registration information:\n\n'
+                       '%s' % self.parent)
+
+    def _group_license_helper(self, regfile):
+        self.print(GROUP_LICENSE_HELP_INFO.substitute(
+            docurl=self.docurl, regfile=regfile))
+
+        prompt = 'Yes (y), No (n), Quit (q): '
+        self.print('Show group license usage in webbrowser? (n)')
+        choice = show_help_page([prompt], self.docurl + '/how-to/register.html')
+        if choice == 'q':
+            return
+
+        self.print('Do you want register Pyarmor in this machine? (n)')
+        choice = input(prompt).lower()[:1]
+        if choice == 'q':
+            return
+
+        if choice != 'y':
+            return
+
+        self.print('Please assign one unused device no. to this device, '
+                   'starts from 1')
+        devid = None
+        while devid is None:
+            a = input('Type device no. (default is 1): ')
+            if a == '':
+                devid = 1
+            elif (not a.isdigit()) or int(a) < 1 or int(a) > 100:
+                self.print('invalid input')
+            else:
+                devid = int(a)
+
+        if devid:
+            sep = '-' * 16
+            devinfo = self.parent.ctx.group_device_file(devid)
+            self.print('%s 1. generate device info' % sep)
+            if os.path.exists(devinfo):
+                logger.warning('old device file has been exists')
+            else:
+                self.parent.generate_group_device(devid)
+            self.print('%s 2. request device regfile' % sep)
+            self.parent.request_device_regfile(regfile, devid)
+            self.print('%s 3. register Pyarmor with device regfile' % sep)
+            self.parent.register(regfile.
+                                 replace('.zip', '.%d.zip' % devid).
+                                 replace('-regfile', '-device-regfile'))
+
+    def _ci_license_helper(self, regfile):
+        self.print(CI_LICENSE_HELP_INFO.substitute(
+            docurl=self.docurl, regfile=regfile))
+
+        prompt = 'Yes (y), No (n), Quit (q): '
+        self.print('Show ci license usage in webbrowser? (n)')
+        choice = show_help_page([prompt], self.docurl + '/how-to/ci.html')
+        if choice == 'q':
+            return
+
+        self.print('Do you want request one CI Regfile now? (y)')
+        choice = input(prompt).lower()[:1]
+        if choice == 'q':
+            return
+
+        if choice in ('y', ''):
+            self.parent.request_ci_regfile(regfile)

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/repack.py

@@ -96,7 +96,7 @@ for name, path, kind in a.binaries:
 
 with open(resfile, 'wb') as f:
     marshal.dump(mlist + list(plist), f)
-with open(hookscript, 'w') as f:
+with open(hookscript, 'w', encoding='utf-8') as f:
     f.write("hiddenimports=[%s]" % ", ".join([repr(x) for x in hiddenimports]))
 '''
 

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor/cli/resource.py

@@ -109,22 +109,34 @@ class FileResource(Resource):
         return self.pyext.lower() == '.pyc'
 
     def _get_encoding(self, encoding):
+        # Maybe: from tokenize import detect_encoding
         from codecs import BOM_UTF8
         from re import search as research
+
+        def find_encoding(line):
+            try:
+                pat = r'coding[=:]\s*([-\w.]+)'
+                n = line.find(b'\n')
+                if n > -1:
+                    m = research(pat, line[:n].decode())
+                    if m:
+                        return m.group(1)
+                    if line[n+1] == 35:
+                        k = n + 1
+                        n = line.find(b'\n', k)
+                        m = research(pat, line[k:n].decode())
+                        if m:
+                            return m.group(1)
+            except Exception:
+                # Ignore decoding error or index error
+                pass
+
         with open(self.fullpath, 'rb') as f:
             line = f.read(80)
             if line and line[:3] == BOM_UTF8:
                 return 'utf-8'
             if line and line[0] == 35:
-                n = line.find(b'\n')
-                m = research(r'coding[=:]\s*([-\w.]+)', line[:n].decode())
-                if m:
-                    return m.group(1)
-                if n > -1 and len(line) > (n+1) and line[n+1] == 35:
-                    k = n + 1
-                    n = line.find(b'\n', k)
-                    m = research(r'coding[=:]\s*([-\w.]+)', line[k:n].decode())
-                    return m and m.group(1)
+                encoding = find_encoding(line) or encoding
         return encoding
 
     def readlines(self, encoding=None):

pyarmor_cli-9.2.1/pyarmor.cli.egg-info/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.1
+Name: pyarmor.cli
+Version: 9.2.1
+Summary: A comand line tool to obfuscate python scripts
+Home-page: https://github.com/dashingsoft/pyarmor
+Author: Jondy Zhao
+Author-email: pyarmor@163.com
+License: Free To Use But Restricted
+Keywords: protect obfuscate encrypt obfuscation distribute
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: Free To Use But Restricted
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Software Distribution
+Requires-Dist: pyarmor.cli.core~=8.1.0
+
+Protect Python Scripts By Pyarmor
+=================================
+
+Pyarmor is a command line tool used to obfuscate python scripts, bind obfuscated scripts to fixed machine or expire obfuscated scripts.
+
+Key Features
+------------
+
+* The obfuscated scritpt is still a normal `.py` script, in most of cases the original python scripts can be replaced with obfuscated scripts seamlessly.
+* Provide many ways to obfuscate the scripts to balance security and performance
+* Rename functions/methods/classes/variables/arguments, irreversible obfuscation
+* Convert part of Python functions to C function, compile to binary by high optimize option, irreversible obfuscation
+* Bind obfuscated scripts to fixed machine or expire obfuscted scripts
+* Protect obfuscated scripts by Themida (Only for Windows)
+
+Support Platforms
+-----------------
+
+* Python 3.7~3.13
+* Windows
+* Many linuxs, include embedded systems
+* Apple Intel and Apple Silicon
+
+Quick Start
+-----------
+
+Install::
+
+    pip install pyarmor
+
+Obfuscate the script `foo.py`::
+
+    pyarmor gen foo.py
+
+This command generates an obfuscated script `dist/foo.py` like this:
+
+.. code:: python
+
+    from pyarmor_runtime import __pyarmor__
+    __pyarmor__(__name__, __file__, b'\x28\x83\x20\x58....')
+
+Run it::
+
+    python dist/foo.py
+
+More Resources
+--------------
+
+- `Home <https://github.com/dashingsoft/pyarmor>`_
+- `Website <http://pyarmor.dashingsoft.com>`_
+- `中文网站 <http://pyarmor.dashingsoft.com/index-zh.html>`_
+- `Issues <https://github.com/dashingsoft/pyarmor/issues>`_
+- `Documentation <https://pyarmor.readthedocs.io/>`_

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor.cli.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ pyarmor.cli.egg-info/requires.txt
 pyarmor.cli.egg-info/top_level.txt
 pyarmor/cli/__init__.py
 pyarmor/cli/__main__.py
+pyarmor/cli/batch.py
 pyarmor/cli/bootstrap.py
 pyarmor/cli/bug.py
 pyarmor/cli/command.py

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/pyarmor.cli.egg-info/entry_points.txt

@@ -1,4 +1,3 @@
 [console_scripts]
 pyarmor = pyarmor.cli.__main__:main
 pyarmor-auth = pyarmor.cli.docker:main
-

pyarmor_cli-9.2.1/pyarmor.cli.egg-info/requires.txt

@@ -0,0 +1 @@
+pyarmor.cli.core~=8.1.0

{pyarmor.cli-9.1.2 → pyarmor_cli-9.2.1}/setup.py

@@ -1,6 +1,6 @@
 from setuptools import setup
 
-__VERSION__ = '9.1.2'
+__VERSION__ = ' 9.2.1'
 
 with open('README.rst') as f:
     long_description = f.read()
@@ -51,7 +51,7 @@ setup(
     package_data={"pyarmor.cli": ["default.cfg", "public_capsule.zip", "core.data.*"]},
 
     install_requires=[
-        'pyarmor.cli.core~=7.6.4'
+        'pyarmor.cli.core~=8.1.0'
     ],
 
     entry_points={

pyarmor.cli-9.1.2/PKG-INFO

@@ -1,74 +0,0 @@
-Metadata-Version: 1.1
-Name: pyarmor.cli
-Version: 9.1.2
-Summary: A comand line tool to obfuscate python scripts
-Home-page: https://github.com/dashingsoft/pyarmor
-Author: Jondy Zhao
-Author-email: pyarmor@163.com
-License: Free To Use But Restricted
-Description: Protect Python Scripts By Pyarmor
-        =================================
-        
-        Pyarmor is a command line tool used to obfuscate python scripts, bind obfuscated scripts to fixed machine or expire obfuscated scripts.
-        
-        Key Features
-        ------------
-        
-        * The obfuscated scritpt is still a normal `.py` script, in most of cases the original python scripts can be replaced with obfuscated scripts seamlessly.
-        * Provide many ways to obfuscate the scripts to balance security and performance
-        * Rename functions/methods/classes/variables/arguments, irreversible obfuscation
-        * Convert part of Python functions to C function, compile to binary by high optimize option, irreversible obfuscation
-        * Bind obfuscated scripts to fixed machine or expire obfuscted scripts
-        * Protect obfuscated scripts by Themida (Only for Windows)
-        
-        Support Platforms
-        -----------------
-        
-        * Python 3.7~3.13
-        * Windows
-        * Many linuxs, include embedded systems
-        * Apple Intel and Apple Silicon
-        
-        Quick Start
-        -----------
-        
-        Install::
-        
-            pip install pyarmor
-        
-        Obfuscate the script `foo.py`::
-        
-            pyarmor gen foo.py
-        
-        This command generates an obfuscated script `dist/foo.py` like this:
-        
-        .. code:: python
-        
-            from pyarmor_runtime import __pyarmor__
-            __pyarmor__(__name__, __file__, b'\x28\x83\x20\x58....')
-        
-        Run it::
-        
-            python dist/foo.py
-        
-        More Resources
-        --------------
-        
-        - `Home <https://github.com/dashingsoft/pyarmor>`_
-        - `Website <http://pyarmor.dashingsoft.com>`_
-        - `中文网站 <http://pyarmor.dashingsoft.com/index-zh.html>`_
-        - `Issues <https://github.com/dashingsoft/pyarmor/issues>`_
-        - `Documentation <https://pyarmor.readthedocs.io/>`_
-        
-Keywords: protect obfuscate encrypt obfuscation distribute
-Platform: UNKNOWN
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: Free To Use But Restricted
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: Utilities
-Classifier: Topic :: Security
-Classifier: Topic :: System :: Software Distribution

pyarmor.cli-9.1.2/pyarmor.cli.egg-info/PKG-INFO

@@ -1,74 +0,0 @@
-Metadata-Version: 1.1
-Name: pyarmor.cli
-Version: 9.1.2
-Summary: A comand line tool to obfuscate python scripts
-Home-page: https://github.com/dashingsoft/pyarmor
-Author: Jondy Zhao
-Author-email: pyarmor@163.com
-License: Free To Use But Restricted
-Description: Protect Python Scripts By Pyarmor
-        =================================
-        
-        Pyarmor is a command line tool used to obfuscate python scripts, bind obfuscated scripts to fixed machine or expire obfuscated scripts.
-        
-        Key Features
-        ------------
-        
-        * The obfuscated scritpt is still a normal `.py` script, in most of cases the original python scripts can be replaced with obfuscated scripts seamlessly.
-        * Provide many ways to obfuscate the scripts to balance security and performance
-        * Rename functions/methods/classes/variables/arguments, irreversible obfuscation
-        * Convert part of Python functions to C function, compile to binary by high optimize option, irreversible obfuscation
-        * Bind obfuscated scripts to fixed machine or expire obfuscted scripts
-        * Protect obfuscated scripts by Themida (Only for Windows)
-        
-        Support Platforms
-        -----------------
-        
-        * Python 3.7~3.13
-        * Windows
-        * Many linuxs, include embedded systems
-        * Apple Intel and Apple Silicon
-        
-        Quick Start
-        -----------
-        
-        Install::
-        
-            pip install pyarmor
-        
-        Obfuscate the script `foo.py`::
-        
-            pyarmor gen foo.py
-        
-        This command generates an obfuscated script `dist/foo.py` like this:
-        
-        .. code:: python
-        
-            from pyarmor_runtime import __pyarmor__
-            __pyarmor__(__name__, __file__, b'\x28\x83\x20\x58....')
-        
-        Run it::
-        
-            python dist/foo.py
-        
-        More Resources
-        --------------
-        
-        - `Home <https://github.com/dashingsoft/pyarmor>`_
-        - `Website <http://pyarmor.dashingsoft.com>`_
-        - `中文网站 <http://pyarmor.dashingsoft.com/index-zh.html>`_
-        - `Issues <https://github.com/dashingsoft/pyarmor/issues>`_
-        - `Documentation <https://pyarmor.readthedocs.io/>`_
-        
-Keywords: protect obfuscate encrypt obfuscation distribute
-Platform: UNKNOWN
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: Free To Use But Restricted
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: Utilities
-Classifier: Topic :: Security
-Classifier: Topic :: System :: Software Distribution

pyarmor.cli-9.1.2/pyarmor.cli.egg-info/requires.txt

@@ -1 +0,0 @@
-pyarmor.cli.core~=7.6.4