# PythonProtector
[](https://www.python.org/)
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:
```sh
py -3 -m pip install -U PythonProtector
```
You may also install the development version:
```sh
pip install git+https://github.com/xFGhoul/PythonProtector.git
```
## Usage
Quick Example:
```py
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](https://github.com/xFGhoul/PythonProtector/blob/dev/examples/) directory.
## Files and Explanations
`├──`[`.github`](https://github.com/xFGhoul/PythonProtector/blob/dev/.github) — GitHub configuration including CI/CD workflows<br>
`├──`[`.vscode`](https://github.com/xFGhoul/PythonProtector/blob/dev/.vscode) — VSCode Related Settings<br>
`├──`[`data`](https://github.com/xFGhoul/PythonProtector/blob/dev/data) — Data Files Needed By PythonProtector<br>
`├──`[`examples`](https://github.com/xFGhoul/PythonProtector/blob/dev/examples) — Examples Showing How To Use PythonProtector<br>
`├──`[`pyprotector`](https://github.com/xFGhoul/PythonProtector/blob/dev/pyprotector) — Source Code Of PythonProtector<br>
`├──`[`scripts`](https://github.com/xFGhoul/PythonProtector/blob/dev/scripts) — Scripts Used In The Development Process<br>
## Links
- [Documentation](http://ghouldev.me/PythonProtector/)
- [Official Discord Server](https://discord.gg/yMu9qjdrmp)
> 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
- **Live Documentation** - Docs are now public at http://ghouldev.me/PythonProtector
- **Event System** - Event System, see docs for more info
### 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
Raw data
{
"_id": null,
"home_page": "https://github.com/xFGhoul/PythonProtecttor",
"name": "PythonProtector",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "",
"keywords": "keyauth,protection,protect,obfuscate,obfuscation,WMI,windows",
"author": "Ghoul & Marci",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/63/8c/db07eb1d94f8d794c156dd5e4b83f1096416fff09c99bf23054ed2dc2465/PythonProtector-1.8.tar.gz",
"platform": null,
"description": "# PythonProtector\r\n\r\n\r\n\r\n[](https://www.python.org/)\r\n\r\nA modern, easy to use and feature-rich way to protect your Python Programs.\r\n\r\n## Features\r\n\r\n- Completely Configurable Module System \r\n- Completely Configurable On Detection System\r\n- Encrypted Logging System With Remote Uploading\r\n- Discord Webhook Support\r\n- Clean, Optimized Code\r\n- Constant Updates\r\n\r\n## Installation\r\n\r\n**Python 3.11 or higher is required**\r\n\r\nInstall The PyPi Version:\r\n\r\n```sh\r\npy -3 -m pip install -U PythonProtector\r\n```\r\n\r\nYou may also install the development version:\r\n```sh\r\npip install git+https://github.com/xFGhoul/PythonProtector.git\r\n```\r\n\r\n## Usage\r\n\r\nQuick Example:\r\n```py\r\nfrom pathlib import Path\r\nfrom threading import Thread\r\n\r\nfrom pyprotector import PythonProtector\r\n\r\n# -- Define Constants\r\nLOGGING_PATH = (\r\n Path.home() / \"AppData/Roaming/PythonProtector/logs/[Security].log\"\r\n) # -- This can be any path\r\n\r\n# -- Construct Class\r\nsecurity = PythonProtector(\r\n debug=True,\r\n modules=[\r\n \"AntiProcess\",\r\n \"AntiVM\",\r\n \"Miscellaneous\",\r\n \"AntiDLL\",\r\n \"AntiAnalysis\",\r\n \"AntiDump\"],\r\n logs_path=LOGGING_PATH,\r\n webhook_url=\"\",\r\n on_detect=[\r\n \"Report\",\r\n \"Exit\",\r\n \"Screenshot\"],\r\n)\r\n\r\n# -- Main Code\r\nif __name__ == \"__main__\":\r\n SecurityThread = Thread(\r\n name=\"Python Protector\", target=security.start\r\n ) # -- Start Before Any Other Code Is Run\r\n SecurityThread.start()\r\n # Other Code\r\n```\r\n\r\nYou can find more examples in the [examples](https://github.com/xFGhoul/PythonProtector/blob/dev/examples/) directory.\r\n\r\n## Files and Explanations\r\n\r\n`\u251c\u2500\u2500`[`.github`](https://github.com/xFGhoul/PythonProtector/blob/dev/.github) \u2014 GitHub configuration including CI/CD workflows<br>\r\n`\u251c\u2500\u2500`[`.vscode`](https://github.com/xFGhoul/PythonProtector/blob/dev/.vscode) \u2014 VSCode Related Settings<br>\r\n`\u251c\u2500\u2500`[`data`](https://github.com/xFGhoul/PythonProtector/blob/dev/data) \u2014 Data Files Needed By PythonProtector<br>\r\n`\u251c\u2500\u2500`[`examples`](https://github.com/xFGhoul/PythonProtector/blob/dev/examples) \u2014 Examples Showing How To Use PythonProtector<br>\r\n`\u251c\u2500\u2500`[`pyprotector`](https://github.com/xFGhoul/PythonProtector/blob/dev/pyprotector) \u2014 Source Code Of PythonProtector<br>\r\n`\u251c\u2500\u2500`[`scripts`](https://github.com/xFGhoul/PythonProtector/blob/dev/scripts) \u2014 Scripts Used In The Development Process<br>\r\n\r\n## Links\r\n\r\n- [Documentation](http://ghouldev.me/PythonProtector/)\r\n- [Official Discord Server](https://discord.gg/yMu9qjdrmp)\r\n\r\n> Made With \u2764\ufe0f By `ghoul#1337` and `Marci#0101`\r\n\r\n## 1.0 - 2022-09-18\r\n\r\nRelease Initial Project\r\n\r\n## 1.1 - 2022-12-28\r\n\r\nSo 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.\r\n\r\n- 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.\r\n\r\n- `should_exit` argument - gives users the ability to decide if the program should exit if one of the detections were raised.\r\n\r\n- 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\r\n\r\n## 1.5 - 2023-01-05\r\n\r\nI 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.\r\n\r\n### Major Changes:\r\n\r\n- **Encrypted Logging** - Instead of logs that anybody can read, logs are now encrypted at runtime and are only decrypted if malicious activity is detected\r\n\r\n- **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\r\n\r\n- **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\r\n\r\n### Minor Changes\r\n\r\n- **Updated Minimum Python Requirement To 3.11**\r\n\r\n- **Refactoring and Misc Improvements**\r\n\r\n## 1.6 - 2023-01-07\r\n\r\nMinor bump for `setup.py` bug that didn't allow importing.\r\n\r\n## 1.7 - 2023-01-25\r\n\r\n### Major Changes\r\n\r\n- **Live Documentation** - Docs are now public at http://ghouldev.me/PythonProtector\r\n\r\n- **Event System** - Event System, see docs for more info\r\n\r\n### Minor Changes\r\n\r\n- **Miscellaneous Changes/Refactoring** - For A Better User Experience\r\n\r\n## 1.8 0 2023-02-11\r\n\r\n### Major Changes\r\n\r\n- **Anti Dump** - New Anti Dump Module\r\n\r\n### Minor Changes\r\n\r\n- **Miscellaneous Changes/Refactoring** - For A Better User Experience\r\n- **Bug Fixes** - Many Bug Fixes For Edge Cases\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Library for protecting your python files",
"version": "1.8",
"split_keywords": [
"keyauth",
"protection",
"protect",
"obfuscate",
"obfuscation",
"wmi",
"windows"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2d60428302e68a1b292f81ecf375b84fb9726dfb1e612f430f8ff50d7c6195f2",
"md5": "4354086b41ac64d4d8b0dab4ac798318",
"sha256": "2b19f268b2ee66ba5789b05deb2f6873e9f6c5619580c9589d1399da09035697"
},
"downloads": -1,
"filename": "PythonProtector-1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4354086b41ac64d4d8b0dab4ac798318",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 37377,
"upload_time": "2023-02-11T16:22:10",
"upload_time_iso_8601": "2023-02-11T16:22:10.442699Z",
"url": "https://files.pythonhosted.org/packages/2d/60/428302e68a1b292f81ecf375b84fb9726dfb1e612f430f8ff50d7c6195f2/PythonProtector-1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "638cdb07eb1d94f8d794c156dd5e4b83f1096416fff09c99bf23054ed2dc2465",
"md5": "49aedfc8e9fe134b0b780046e74820a1",
"sha256": "10bc9c7acd74dbc6167e77962f67d83b4d9aa7c3faf51d02242fe42438d23237"
},
"downloads": -1,
"filename": "PythonProtector-1.8.tar.gz",
"has_sig": false,
"md5_digest": "49aedfc8e9fe134b0b780046e74820a1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 30622,
"upload_time": "2023-02-11T16:22:12",
"upload_time_iso_8601": "2023-02-11T16:22:12.483938Z",
"url": "https://files.pythonhosted.org/packages/63/8c/db07eb1d94f8d794c156dd5e4b83f1096416fff09c99bf23054ed2dc2465/PythonProtector-1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-11 16:22:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "xFGhoul",
"github_project": "PythonProtecttor",
"lcname": "pythonprotector"
}
JSON
