pytriper 0.1.0__tar.gz

pytriper-0.1.0/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: pytriper
+Version: 0.1.0
+Summary: Bundle and obfuscate Python projects into one .py file
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# PyTriper
+
+PyTriper bundles a Python project into one `.py` launcher and can obfuscate its Python modules. It does not build `.exe` files and has no runtime dependencies.
+
+## Install for development
+
+```powershell
+python -m pip install -e .
+```
+
+## Build
+
+```powershell
+pytriper C:\path\to\project
+pytriper C:\path\to\project --obfuscation minify
+pytriper C:\path\to\project --obfuscation encode --entry src\main.py --output C:\build\app.py
+pytriper C:\path\to\project --obfuscation mixed
+```
+
+The entry point is detected from `main.py`, `app.py`, `run.py`, or `__main__.py` in the project root. Use `--entry` for another path. The default output is created next to the project folder.
+
+Obfuscation modes are `none` (default), `minify` (remove comments and normalize Python syntax), `encode` (wrap Python source in a Base85 loader), and `mixed` (minify, then encode). Only `.py` files are transformed; other project files are bundled as-is.
+
+The output extracts project files to a temporary directory when launched. It still requires a compatible Python installation and any third-party dependencies used by the project. Virtual environments and common build/cache directories are omitted.
+
+Obfuscation is not encryption and does not prevent determined users from recovering the source. Do not package secrets such as `.env` files or private keys.

pytriper-0.1.0/README.md

@@ -0,0 +1,26 @@
+# PyTriper
+
+PyTriper bundles a Python project into one `.py` launcher and can obfuscate its Python modules. It does not build `.exe` files and has no runtime dependencies.
+
+## Install for development
+
+```powershell
+python -m pip install -e .
+```
+
+## Build
+
+```powershell
+pytriper C:\path\to\project
+pytriper C:\path\to\project --obfuscation minify
+pytriper C:\path\to\project --obfuscation encode --entry src\main.py --output C:\build\app.py
+pytriper C:\path\to\project --obfuscation mixed
+```
+
+The entry point is detected from `main.py`, `app.py`, `run.py`, or `__main__.py` in the project root. Use `--entry` for another path. The default output is created next to the project folder.
+
+Obfuscation modes are `none` (default), `minify` (remove comments and normalize Python syntax), `encode` (wrap Python source in a Base85 loader), and `mixed` (minify, then encode). Only `.py` files are transformed; other project files are bundled as-is.
+
+The output extracts project files to a temporary directory when launched. It still requires a compatible Python installation and any third-party dependencies used by the project. Virtual environments and common build/cache directories are omitted.
+
+Obfuscation is not encryption and does not prevent determined users from recovering the source. Do not package secrets such as `.env` files or private keys.

pytriper-0.1.0/main.py

@@ -0,0 +1,181 @@
+from __future__ import annotations
+
+import argparse
+import ast
+import base64
+import io
+import re
+import sys
+import tempfile
+import tokenize
+import zipfile
+from pathlib import Path
+
+
+IGNORED_DIRECTORIES = {
+	".git",
+	".hg",
+	".svn",
+	".venv",
+	"venv",
+	"env",
+	"__pycache__",
+	".pytest_cache",
+	".mypy_cache",
+	".ruff_cache",
+	"build",
+	"dist",
+}
+ENTRY_POINT_CANDIDATES = ("main.py", "app.py", "run.py", "__main__.py")
+OBFUSCATION_MODES = ("none", "minify", "encode", "mixed")
+
+
+class BuildError(Exception):
+	pass
+
+
+def find_entry_point(project_dir: Path, entry: str | None) -> Path:
+	if entry:
+		candidate = (project_dir / entry).resolve()
+		if not candidate.is_relative_to(project_dir.resolve()):
+			raise BuildError("Точка входа должна находиться внутри папки проекта.")
+		if candidate.is_file() and candidate.suffix == ".py":
+			return candidate
+		raise BuildError(f"Файл точки входа не найден: {entry}")
+
+	for name in ENTRY_POINT_CANDIDATES:
+		candidate = project_dir / name
+		if candidate.is_file():
+			return candidate.resolve()
+
+	raise BuildError(
+		"Не найдена точка входа. Добавьте main.py или укажите файл через --entry."
+	)
+
+
+def collect_project_files(project_dir: Path, exclude: Path | None = None) -> list[Path]:
+	excluded_path = exclude.resolve() if exclude else None
+	files = []
+	for path in sorted(project_dir.rglob("*")):
+		relative = path.relative_to(project_dir)
+		if any(part in IGNORED_DIRECTORIES for part in relative.parts):
+			continue
+		if excluded_path and path.resolve() == excluded_path:
+			continue
+		if path.is_file() and not path.is_symlink():
+			files.append(path)
+	return files
+
+
+def obfuscate_python(path: Path, mode: str) -> bytes:
+	try:
+		with tokenize.open(str(path)) as source_file:
+			source = source_file.read()
+	except (OSError, SyntaxError, UnicodeError) as error:
+		raise BuildError(f"Не удалось прочитать {path}: {error}") from error
+
+	if mode in ("minify", "mixed"):
+		try:
+			source = ast.unparse(ast.parse(source, filename=str(path)))
+		except SyntaxError as error:
+			raise BuildError(f"Синтаксическая ошибка в {path}, строка {error.lineno}.") from error
+
+	if mode in ("encode", "mixed"):
+		encoded = base64.b85encode(source.encode("utf-8")).decode("ascii")
+		source = (
+			"exec(compile(__import__('base64').b85decode("
+			f"{encoded!r}), __file__, 'exec'))\n"
+		)
+
+	return source.encode("utf-8")
+
+
+def build_python(
+	project_dir: Path, entry_point: Path, output: Path, obfuscation: str = "none"
+) -> None:
+	archive_buffer = io.BytesIO()
+	with zipfile.ZipFile(archive_buffer, "w", zipfile.ZIP_DEFLATED) as archive:
+		for path in collect_project_files(project_dir, exclude=output):
+			archive_path = path.relative_to(project_dir).as_posix()
+			if path.suffix == ".py" and obfuscation != "none":
+				archive.writestr(archive_path, obfuscate_python(path, obfuscation))
+			else:
+				archive.write(path, archive_path)
+
+	encoded = base64.b85encode(archive_buffer.getvalue()).decode("ascii")
+	payload_lines = "\n".join(
+		f"    {encoded[index:index + 100]!r}"
+		for index in range(0, len(encoded), 100)
+	)
+	entry_relative = entry_point.relative_to(project_dir).as_posix()
+	launcher = f'''import base64
+import io
+import os
+import runpy
+import sys
+import tempfile
+import zipfile
+
+_PAYLOAD = (
+{payload_lines}
+)
+_ENTRY_POINT = {entry_relative!r}
+
+with tempfile.TemporaryDirectory(prefix="pytriper-") as _directory:
+	with zipfile.ZipFile(io.BytesIO(base64.b85decode(_PAYLOAD))) as _archive:
+		_archive.extractall(_directory)
+	_entry = os.path.join(_directory, _ENTRY_POINT)
+	sys.path.insert(0, _directory)
+	sys.argv[0] = _entry
+	runpy.run_path(_entry, run_name="__main__")
+'''
+	output.parent.mkdir(parents=True, exist_ok=True)
+	output.write_text(launcher, encoding="utf-8")
+
+
+def make_parser() -> argparse.ArgumentParser:
+	parser = argparse.ArgumentParser(
+		prog="pytriper",
+		description="Собирает Python-проект в один .py-файл с выбранной обфускацией.",
+	)
+	parser.add_argument("project", type=Path, help="Путь к папке проекта")
+	parser.add_argument(
+		"--obfuscation",
+		choices=OBFUSCATION_MODES,
+		default="none",
+		help="Режим: none, minify, encode или mixed",
+	)
+	parser.add_argument("--entry", help="Точка входа, например src/main.py")
+	parser.add_argument("--output", type=Path, help="Путь к выходному файлу")
+	return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+	args = make_parser().parse_args(argv)
+	project_dir = args.project.expanduser().resolve()
+	if not project_dir.is_dir():
+		print(f"Ошибка: папка проекта не найдена: {project_dir}", file=sys.stderr)
+		return 2
+
+	try:
+		entry_point = find_entry_point(project_dir, args.entry)
+		default_name = re.sub(r"[^A-Za-z0-9_.-]+", "_", project_dir.name) or "app"
+		output = (
+			args.output.expanduser().resolve()
+			if args.output
+			else project_dir.parent / f"{default_name}.py"
+		)
+		if output.suffix.lower() != ".py":
+			output = output.with_suffix(".py")
+
+		build_python(project_dir, entry_point, output, args.obfuscation)
+	except (BuildError, OSError) as error:
+		print(f"Ошибка: {error}", file=sys.stderr)
+		return 1
+
+	print(f"Готово: {output}")
+	return 0
+
+
+if __name__ == "__main__":
+	raise SystemExit(main())

pytriper-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pytriper"
+version = "0.1.0"
+description = "Bundle and obfuscate Python projects into one .py file"
+readme = "README.md"
+requires-python = ">=3.10"
+
+[project.scripts]
+pytriper = "main:main"
+
+[tool.setuptools]
+py-modules = ["main"]

pytriper-0.1.0/pytriper.egg-info/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: pytriper
+Version: 0.1.0
+Summary: Bundle and obfuscate Python projects into one .py file
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# PyTriper
+
+PyTriper bundles a Python project into one `.py` launcher and can obfuscate its Python modules. It does not build `.exe` files and has no runtime dependencies.
+
+## Install for development
+
+```powershell
+python -m pip install -e .
+```
+
+## Build
+
+```powershell
+pytriper C:\path\to\project
+pytriper C:\path\to\project --obfuscation minify
+pytriper C:\path\to\project --obfuscation encode --entry src\main.py --output C:\build\app.py
+pytriper C:\path\to\project --obfuscation mixed
+```
+
+The entry point is detected from `main.py`, `app.py`, `run.py`, or `__main__.py` in the project root. Use `--entry` for another path. The default output is created next to the project folder.
+
+Obfuscation modes are `none` (default), `minify` (remove comments and normalize Python syntax), `encode` (wrap Python source in a Base85 loader), and `mixed` (minify, then encode). Only `.py` files are transformed; other project files are bundled as-is.
+
+The output extracts project files to a temporary directory when launched. It still requires a compatible Python installation and any third-party dependencies used by the project. Virtual environments and common build/cache directories are omitted.
+
+Obfuscation is not encryption and does not prevent determined users from recovering the source. Do not package secrets such as `.env` files or private keys.

pytriper-0.1.0/pytriper.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+main.py
+pyproject.toml
+pytriper.egg-info/PKG-INFO
+pytriper.egg-info/SOURCES.txt
+pytriper.egg-info/dependency_links.txt
+pytriper.egg-info/entry_points.txt
+pytriper.egg-info/top_level.txt
+tests/test_main.py

pytriper-0.1.0/pytriper.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pytriper-0.1.0/pytriper.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pytriper = main:main

pytriper-0.1.0/pytriper.egg-info/top_level.txt

@@ -0,0 +1 @@
+main

pytriper-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pytriper-0.1.0/tests/test_main.py

@@ -0,0 +1,62 @@
+import subprocess
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+from main import BuildError, build_python, collect_project_files, find_entry_point, make_parser
+
+
+class PyTriperTests(unittest.TestCase):
+    def test_obfuscation_modes_run_project_and_include_local_module(self) -> None:
+        with tempfile.TemporaryDirectory() as temporary_dir:
+            root = Path(temporary_dir)
+            project = root / "sample"
+            project.mkdir()
+            (project / "helper.py").write_text("MESSAGE = 'bundled'\n", encoding="utf-8")
+            (project / "main.py").write_text(
+                "from helper import MESSAGE\nprint(MESSAGE)\n", encoding="utf-8"
+            )
+            for mode in ("none", "minify", "encode", "mixed"):
+                with self.subTest(mode=mode):
+                    output = root / f"sample-{mode}.py"
+                    build_python(project, project / "main.py", output, mode)
+                    result = subprocess.run(
+                        [sys.executable, str(output)],
+                        capture_output=True,
+                        text=True,
+                        check=False,
+                    )
+                    self.assertEqual(result.returncode, 0, result.stderr)
+                    self.assertEqual(result.stdout.strip(), "bundled")
+
+    def test_executable_format_is_not_available(self) -> None:
+        with self.assertRaises(SystemExit):
+            make_parser().parse_args(["project", "--format", "exe"])
+
+    def test_entry_point_must_be_inside_project(self) -> None:
+        with tempfile.TemporaryDirectory() as temporary_dir:
+            root = Path(temporary_dir)
+            project = root / "sample"
+            project.mkdir()
+            outside_entry = root / "main.py"
+            outside_entry.write_text("pass\n", encoding="utf-8")
+
+            with self.assertRaises(BuildError):
+                find_entry_point(project, "../main.py")
+
+    def test_existing_output_is_not_collected_into_project(self) -> None:
+        with tempfile.TemporaryDirectory() as temporary_dir:
+            project = Path(temporary_dir)
+            source = project / "main.py"
+            output = project / "bundle.py"
+            source.write_text("pass\n", encoding="utf-8")
+            output.write_text("old bundle\n", encoding="utf-8")
+
+            files = collect_project_files(project, exclude=output)
+
+            self.assertEqual(files, [source])
+
+
+if __name__ == "__main__":
+    unittest.main()