Skip to main content

Library for protecting your python files

Project description

PythonProtector

pyprotector

forthebadge made-with-python

A modern, easy to use and feature-rich way to protect your Python Programs.

Features

  • Completely Configurable Module System
  • Completely Configurable On Detection System
  • Encrypted Logging System With Remote Uploading
  • Discord Webhook Support
  • Clean, Optimized Code
  • Constant Updates

Installation

Python 3.11 or higher is required

Install The PyPi Version:

py -3 -m pip install -U PythonProtector

You may also install the development version:

pip install git+https://github.com/xFGhoul/PythonProtector.git

Usage

Quick Example:

from pathlib import Path
from threading import Thread

from pyprotector import PythonProtector

# -- Define Constants
LOGGING_PATH = (
    Path.home() / "AppData/Roaming/PythonProtector/logs/[Security].log"
)  # -- This can be any path

# -- Construct Class
security = PythonProtector(
    debug=True,
    modules=[
        "AntiProcess",
        "AntiVM",
        "Miscellaneous",
        "AntiDLL",
        "AntiAnalysis",
        "AntiDump"],
    logs_path=LOGGING_PATH,
    webhook_url="",
    on_detect=[
        "Report",
        "Exit",
        "Screenshot"],
)

# -- Main Code
if __name__ == "__main__":
    SecurityThread = Thread(
        name="Python Protector", target=security.start
    )  # -- Start Before Any Other Code Is Run
    SecurityThread.start()
    # Other Code

You can find more examples in the examples directory.

Files and Explanations

├──.github — GitHub configuration including CI/CD workflows
├──.vscode — VSCode Related Settings
├──data — Data Files Needed By PythonProtector
├──examples — Examples Showing How To Use PythonProtector
├──pyprotector — Source Code Of PythonProtector
├──scripts — Scripts Used In The Development Process

Links

Made With ❤️ By ghoul#1337 and Marci#0101

1.0 - 2022-09-18

Release Initial Project

1.1 - 2022-12-28

So It's been kind of a while since we released a new update, I had some pretty big stuff going on irl, no time to code, just recently came back and decided to make some updates.

  • Completely Configurable Module System - Users now have the choice of deciding what modules they use, currently there are only the main 4 me and marci provide, but we are open to pull requests and we will be adding more in the future, do check the repository or the example for more information.

  • should_exit argument - gives users the ability to decide if the program should exit if one of the detections were raised.

  • Overall Improvement/Refactoring - This update didn't bring everything me and marci are planning for, but this is just a couple, in the update I made to sure to cover some edge cases so you guys don't get confused

1.5 - 2023-01-05

I know this is a pretty quick release, and the jump from 1.1 to 1.5 but I felt it was only necessary with the amount of changes made.

Major Changes:

  • Encrypted Logging - Instead of logs that anybody can read, logs are now encrypted at runtime and are only decrypted if malicious activity is detected

  • AntiAnalysis - Thanks to the work of Marci, a new module has been made!, this one comes with some pretty neat features, be sure to check it out

  • New On Detection System / on_detect - Similarly to the new configurable module system, I've gone ahead and done the same with what happens when malicious activity is detected, check out the examples for how it's used

Minor Changes

  • Updated Minimum Python Requirement To 3.11

  • Refactoring and Misc Improvements

1.6 - 2023-01-07

Minor bump for setup.py bug that didn't allow importing.

1.7 - 2023-01-25

Major Changes

Minor Changes

  • Miscellaneous Changes/Refactoring - For A Better User Experience

1.8 0 2023-02-11

Major Changes

  • Anti Dump - New Anti Dump Module

Minor Changes

  • Miscellaneous Changes/Refactoring - For A Better User Experience
  • Bug Fixes - Many Bug Fixes For Edge Cases

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PythonProtector-1.8.tar.gz (30.6 kB view details)

Uploaded Source

Built Distribution

PythonProtector-1.8-py3-none-any.whl (37.4 kB view details)

Uploaded Python 3

File details

Details for the file PythonProtector-1.8.tar.gz.

File metadata

  • Download URL: PythonProtector-1.8.tar.gz
  • Upload date:
  • Size: 30.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.0

File hashes

Hashes for PythonProtector-1.8.tar.gz
Algorithm Hash digest
SHA256 10bc9c7acd74dbc6167e77962f67d83b4d9aa7c3faf51d02242fe42438d23237
MD5 49aedfc8e9fe134b0b780046e74820a1
BLAKE2b-256 638cdb07eb1d94f8d794c156dd5e4b83f1096416fff09c99bf23054ed2dc2465

See more details on using hashes here.

Provenance

File details

Details for the file PythonProtector-1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for PythonProtector-1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 2b19f268b2ee66ba5789b05deb2f6873e9f6c5619580c9589d1399da09035697
MD5 4354086b41ac64d4d8b0dab4ac798318
BLAKE2b-256 2d60428302e68a1b292f81ecf375b84fb9726dfb1e612f430f8ff50d7c6195f2

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page