p2private 1.0.4

Python to Private Executable Converter - Encrypt Python scripts to standalone executables

🔐 p2private

Python to Private Executable Converter
Encrypt your Python scripts to standalone executables using Cython

---

📋 Table of Contents

• Features
• Installation
• Quick Start
• CLI Usage
• Python API
• Version Checker
• Complete Setup Guide
• Examples
• Requirements
• Troubleshooting
• License

---

✨ Features

• 🔒 Encrypt Python scripts to C code using Cython
• 🚀 Generate standalone executables that compile on first run
• 🛡️ Optional version checking for Python compatibility
• 📁 Custom output naming and directory support
• 🧹 Automatic cleanup of temporary files
• 💻 Cross-platform support (Linux, macOS, Windows)
• 🎯 Simple CLI and Python API
• 🔧 Auto-fixes mixed tabs/spaces indentation issues
• ✅ Python 3.11+ compatible - no deprecated warnings

---

📦 Installation

From PyPI (Recommended)

pip install p2private

From Source

git clone https://github.com/pooraddy/p2private.git
cd p2private
pip install -e .

Development Installation

git clone https://github.com/pooraddy/p2private.git
cd p2private
pip install -e ".[dev]"

---

🚀 Quick Start

1. Create a Python Script

# hello.py
print("Hello, World!")
name = input("What's your name? ")
print(f"Nice to meet you, {name}!")

2. Encrypt It

p2private hello.py

3. Run the Encrypted File

python Enc_hello.py

---

💻 CLI Usage

Basic Encryption

p2private script.py

Custom Output Name

p2private script.py -o myapp

Specify Output Directory

p2private script.py -d ./output

Add Version Check

p2private script.py -v 3.11

Full Example

p2private script.py -o myapp -d ./build -v 3.12

CLI Options

Option	Short	Description	Example
--output	-o	Custom output filename	-o myapp
--directory	-d	Output directory	-d ./build
--version-check	-v	Python version requirement	-v 3.11
--version	-	Show version	--version
--help	-h	Show help	--help

---

🐍 Python API

Method 1: Using P2PrivateEncryptor Class

from p2private import P2PrivateEncryptor

encryptor = P2PrivateEncryptor()
output_path = encryptor.encrypt('script.py')
print(f"Encrypted file: {output_path}")

Method 2: With Version Check

from p2private import P2PrivateEncryptor

encryptor = P2PrivateEncryptor(version_check='3.11')
output_path = encryptor.encrypt('script.py')

Method 3: Custom Output

from p2private import P2PrivateEncryptor

encryptor = P2PrivateEncryptor()
output_path = encryptor.encrypt(
    file_path='script.py',
    output_dir='./build',
    output_name='myapp.py'
)

Method 4: Using encrypt_file Function

from p2private import encrypt_file

encrypt_file('script.py')

Method 5: encrypt_file with Options

from p2private import encrypt_file

encrypt_file(
    file_path='script.py',
    output_dir='./build',
    output_name='myapp.py',
    version_check='3.12'
)

---

🛡️ Version Checker

When you use the -v or --version-check option, the encrypted file will include a version check at the beginning:

CLI Usage

p2private script.py -v 3.11

Python API Usage

from p2private import encrypt_file

encrypt_file('script.py', version_check='3.11')

Generated Code

This adds the following code to the encrypted output:

PYTHON_VERSION = ".".join(sys.version.split(" ")[0].split(".")[:-1])
if PYTHON_VERSION != "3.11":
    print('[!] No support for 3.11')
    exit(0)

Use Cases

• Ensure compatibility with specific Python versions
• Prevent running on unsupported Python versions
• Add version-specific behavior

---

🔧 Complete Setup Guide

Local Installation

Step 1: Clone the Repository

git clone https://github.com/pooraddy/p2private.git
cd p2private

Step 2: Create Virtual Environment (Recommended)

python -m venv venv

Activate on Linux/macOS:

source venv/bin/activate

Activate on Windows:

venv\Scripts\activate

Step 3: Install Dependencies

pip install -r requirements.txt

Step 4: Install in Development Mode

pip install -e .

Step 5: Verify Installation

p2private --version

---

📝 Examples

Example 1: Simple Script Encryption

Original script (calculator.py):

def add(a, b):
    return a + b

def subtract(a, b):
    return a - b

if __name__ == "__main__":
    print("Simple Calculator")
    x = float(input("Enter first number: "))
    y = float(input("Enter second number: "))
    print(f"Sum: {add(x, y)}")
    print(f"Difference: {subtract(x, y)}")

Encrypt:

p2private calculator.py -o calc

Run:

python calc.py

---

Example 2: With Version Check

p2private myapp.py -v 3.11 -o secure_app

---

Example 3: Batch Encryption

for file in *.py; do
    p2private "$file" -d ./encrypted
done

---

Example 4: Python API in Script

#!/usr/bin/env python3
# batch_encrypt.py

import os
from p2private import P2PrivateEncryptor

encryptor = P2PrivateEncryptor(version_check='3.11')

scripts = ['app1.py', 'app2.py', 'app3.py']

for script in scripts:
    if os.path.exists(script):
        try:
            output = encryptor.encrypt(script, output_dir='./encrypted')
            print(f"✓ Encrypted: {script} -> {output}")
        except Exception as e:
            print(f"✗ Failed: {script} - {e}")
    else:
        print(f"✗ Not found: {script}")

---

Example 5: Using encrypt_file Function

from p2private import encrypt_file

# Encrypt single file
encrypt_file('script.py')

# Encrypt with options
encrypt_file(
    file_path='script.py',
    output_dir='./output',
    output_name='myapp',
    version_check='3.12'
)

---

📋 Requirements

System Requirements

• Python 3.11 or higher
• GCC compiler (for compiling C code)
• Cython 0.29.0 or higher

Install System Dependencies

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install python3-dev gcc

CentOS/RHEL/Fedora:

sudo yum install python3-devel gcc

macOS:

xcode-select --install

Windows:

• Install MinGW-w64 or Visual Studio Build Tools

Python Dependencies

Cython>=0.29.0
autopep8>=1.6.0

---

🔍 Troubleshooting

Common Issues

Issue: gcc: command not found

Solution: Install GCC compiler

# Ubuntu/Debian
sudo apt-get install gcc

# macOS
xcode-select --install

---

Issue: Python.h: No such file or directory

Solution: Install Python development headers

# Ubuntu/Debian
sudo apt-get install python3-dev

# CentOS/RHEL
sudo yum install python3-devel

---

Issue: cythonize: command not found

Solution: Install Cython

pip install Cython

---

Issue: Permission denied when running encrypted file

Solution: Make the file executable

chmod +x Enc_script.py

---

Issue: Compilation fails on Windows

Solution: Ensure you have Visual C++ Build Tools installed

# Or use MinGW
pip install --global-option=build_ext --global-option="-c mingw32" Cython

---

Issue: Mixed use of tabs and spaces Error

Solution: This is now automatically fixed by p2private! The tool automatically converts tabs to spaces before compilation.

---

Issue: Deprecated warnings (Py_SetProgramName, PySys_SetArgv)

Solution: Fixed in version 1.0.3! The code now uses conditional compilation to avoid deprecated functions on Python 3.11+.

---

Debug Mode

To see detailed error messages:

import traceback
traceback.print_exc()

---

📂 Project Structure

p2private/
├── p2private/              # Main package
│   ├── __init__.py         # Package initialization
│   ├── encryptor.py        # Core encryption logic
│   └── cli.py              # Command line interface
├── tests/                  # Test suite
│   ├── __init__.py
│   ├── test_encryptor.py
│   └── test_cli.py
├── .github/workflows/      # GitHub Actions
│   ├── publish.yml         # PyPI publishing
│   └── tests.yml           # Test runner
├── setup.py                # Package setup
├── pyproject.toml          # Modern Python packaging
├── requirements.txt        # Dependencies
├── LICENSE                 # MIT License
├── CHANGELOG.md            # Version history
├── MANIFEST.in             # Package manifest
├── .gitignore              # Git ignore rules
└── README.md               # This file

---

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Cython - C-Extensions for Python
• autopep8 - Automatic Python code formatter

---

📧 Contact

• Author: addy
• Email: [e-mail]
• GitHub: @pooraddy
• PyPI: p2private

---

Made with ❤️ using Python & Cython