pbk 2.0.0__tar.gz

pbk-2.0.0/LICENSE

@@ -0,0 +1,10 @@
+PRESTON SECURITY FRAMEWORK - PROPRIETARY LICENSE
+Copyright (c) 2026 Preston. All Rights Reserved.
+
+1. This software and its source code are the sole property of Preston.
+2. Unauthorized copying, modification, or distribution of this file, 
+   via any medium, is strictly prohibited.
+3. This software is provided for personal, educational use only. 
+   Commercial use or redistribution is strictly forbidden without 
+   express written permission from the owner.
+4. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

pbk-2.0.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: pbk
+Version: 2.0.0
+Summary: Advanced Admin Panel Finder for Kali Linux
+Home-page: https://github.com/prest0nn/pbk
+Author: prest0nn
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+⚡ PRESTON BREACHER v2.0
+Path Discovery & Reconnaissance Framework
+Preston Breacher is a high-speed reconnaissance tool designed to identify administrative interfaces and Exposure of Sensitive Information (EAR) vulnerabilities. Optimized for speed and stealth with a modernized terminal interface.
+
+🛠 CORE CAPABILITIES
+Parallel Execution: Multi-threaded path discovery for rapid analysis.
+
+Deep Dictionary: Ship-ready with a curated list of 400+ high-value paths.
+
+Extension Filtering: Target specific environments (PHP, ASP, HTML).
+
+Vulnerability Detection: Automated checks for EAR (Execute After Redirect) flaws.
+
+Metadata Analysis: Integrated robots.txt and Urmum.txt intelligence gathering.
+
+Custom Scoping: Inject custom path prefixes for localized directory testing.
+
+🚀 OPERATIONAL USAGE
+1. Targeted Extension Discovery
+Identify PHP-based entry points:
+
+Bash
+python preston.py -u example.com --type php
+2. High-Speed Multi-Threaded Scan
+Engage threading for faster results on robust targets:
+
+Bash
+python preston.py -u example.com --type php --fast
+3. Standard Enumeration
+Run a default scan across the full payload buffer:
+
+Bash
+python preston.py -u example.com
+4. Custom Path Prefixing
+Scope the discovery to a specific directory (e.g., example.com/assets/admin/):
+
+Bash
+python preston.py -u example.com --path /assets
+PRO TIP: When using the --type flag, the framework intelligently includes extensionless paths (e.g., /dashboard) alongside your specified format to ensure no entry point is missed.
+
+📺 DEMONSTRATION
+⚠️ OPERATIONAL NOTICE
+This framework is for authorized security auditing only. Ensure you have explicit permission before initiating path discovery against any target. Use it or lose it. Safe.

pbk-2.0.0/README.md

@@ -0,0 +1,43 @@
+⚡ PRESTON BREACHER v2.0
+Path Discovery & Reconnaissance Framework
+Preston Breacher is a high-speed reconnaissance tool designed to identify administrative interfaces and Exposure of Sensitive Information (EAR) vulnerabilities. Optimized for speed and stealth with a modernized terminal interface.
+
+🛠 CORE CAPABILITIES
+Parallel Execution: Multi-threaded path discovery for rapid analysis.
+
+Deep Dictionary: Ship-ready with a curated list of 400+ high-value paths.
+
+Extension Filtering: Target specific environments (PHP, ASP, HTML).
+
+Vulnerability Detection: Automated checks for EAR (Execute After Redirect) flaws.
+
+Metadata Analysis: Integrated robots.txt and Urmum.txt intelligence gathering.
+
+Custom Scoping: Inject custom path prefixes for localized directory testing.
+
+🚀 OPERATIONAL USAGE
+1. Targeted Extension Discovery
+Identify PHP-based entry points:
+
+Bash
+python preston.py -u example.com --type php
+2. High-Speed Multi-Threaded Scan
+Engage threading for faster results on robust targets:
+
+Bash
+python preston.py -u example.com --type php --fast
+3. Standard Enumeration
+Run a default scan across the full payload buffer:
+
+Bash
+python preston.py -u example.com
+4. Custom Path Prefixing
+Scope the discovery to a specific directory (e.g., example.com/assets/admin/):
+
+Bash
+python preston.py -u example.com --path /assets
+PRO TIP: When using the --type flag, the framework intelligently includes extensionless paths (e.g., /dashboard) alongside your specified format to ensure no entry point is missed.
+
+📺 DEMONSTRATION
+⚠️ OPERATIONAL NOTICE
+This framework is for authorized security auditing only. Ensure you have explicit permission before initiating path discovery against any target. Use it or lose it. Safe.

pbk-2.0.0/pbk.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: pbk
+Version: 2.0.0
+Summary: Advanced Admin Panel Finder for Kali Linux
+Home-page: https://github.com/prest0nn/pbk
+Author: prest0nn
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+⚡ PRESTON BREACHER v2.0
+Path Discovery & Reconnaissance Framework
+Preston Breacher is a high-speed reconnaissance tool designed to identify administrative interfaces and Exposure of Sensitive Information (EAR) vulnerabilities. Optimized for speed and stealth with a modernized terminal interface.
+
+🛠 CORE CAPABILITIES
+Parallel Execution: Multi-threaded path discovery for rapid analysis.
+
+Deep Dictionary: Ship-ready with a curated list of 400+ high-value paths.
+
+Extension Filtering: Target specific environments (PHP, ASP, HTML).
+
+Vulnerability Detection: Automated checks for EAR (Execute After Redirect) flaws.
+
+Metadata Analysis: Integrated robots.txt and Urmum.txt intelligence gathering.
+
+Custom Scoping: Inject custom path prefixes for localized directory testing.
+
+🚀 OPERATIONAL USAGE
+1. Targeted Extension Discovery
+Identify PHP-based entry points:
+
+Bash
+python preston.py -u example.com --type php
+2. High-Speed Multi-Threaded Scan
+Engage threading for faster results on robust targets:
+
+Bash
+python preston.py -u example.com --type php --fast
+3. Standard Enumeration
+Run a default scan across the full payload buffer:
+
+Bash
+python preston.py -u example.com
+4. Custom Path Prefixing
+Scope the discovery to a specific directory (e.g., example.com/assets/admin/):
+
+Bash
+python preston.py -u example.com --path /assets
+PRO TIP: When using the --type flag, the framework intelligently includes extensionless paths (e.g., /dashboard) alongside your specified format to ensure no entry point is missed.
+
+📺 DEMONSTRATION
+⚠️ OPERATIONAL NOTICE
+This framework is for authorized security auditing only. Ensure you have explicit permission before initiating path discovery against any target. Use it or lose it. Safe.

pbk-2.0.0/pbk.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+preston.py
+setup.py
+pbk.egg-info/PKG-INFO
+pbk.egg-info/SOURCES.txt
+pbk.egg-info/dependency_links.txt
+pbk.egg-info/entry_points.txt
+pbk.egg-info/requires.txt
+pbk.egg-info/top_level.txt

pbk-2.0.0/pbk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pbk-2.0.0/pbk.egg-info/entry_points.txt

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

pbk-2.0.0/pbk.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

pbk-2.0.0/pbk.egg-info/top_level.txt

@@ -0,0 +1 @@
+preston

pbk-2.0.0/preston.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+import requests 
+import threading 
+import argparse 
+import time
+import sys
+import random
+import os  
+from datetime import datetime
+
+# MSF-style status messages
+def msf_log(status, msg):
+    colors = {"*": "\033[1;34m", "+": "\033[1;32m", "-": "\033[1;31m", "!": "\033[1;33m"}
+    prefix = colors.get(status, "\033[37m")
+    print(f"[{prefix}{status}\033[m] {msg}")
+
+def msf_boot():
+    print(f"\033[1;32m[*] \033[mStarting the Preston Breacher Framework v2.0...")
+    steps = [
+        "Initializing core modules...",
+        "Loading wordlist plugins...",
+        "Validating network interface...",
+        "Establishing listener on 0.0.0.0..."
+    ]
+    for step in steps:
+        msf_log("*", step)
+        time.sleep(random.uniform(0.1, 0.2))
+    print("")
+
+def scan(target, links): # Added target as an argument for the function
+    for link in links:
+        url = target + (link if link.startswith("/") else "/" + link)
+        try:
+            r = requests.get(url, timeout=5)
+            if r.status_code == 200:
+                if 'Page Not Found' in r.text or ('404' in r.text and len(r.text) > 1500):
+                    sys.stdout.write(f"\033[K\033[1;30m[*] Analyzing: {link} (Filtered)\033[m\r")
+                    sys.stdout.flush()
+                else:
+                    print(f"\n\033[1;32m[+]\033[m Identified: {url}")
+            elif r.status_code in [301, 302]:
+                print(f"\n\033[1;33m[!]\033[m Redirect Found: {url}")
+            else:
+                sys.stdout.write(f"\033[K\033[1;30m[*] Testing path: {link}\033[m\r")
+                sys.stdout.flush()
+        except:
+            pass
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("-u", help="target url", dest='target')
+    parser.add_argument("--path", help="custom path prefix", dest='prefix')
+    parser.add_argument("--type", help="set the type i.e. html, asp, php", dest='type')
+    parser.add_argument("--fast", help="uses multithreading", dest='fast', action="store_true")
+    args = parser.parse_args()
+
+    target = args.target 
+    if not target:
+        print('\033[1;31m[-]\033[1;m Error: -u <url> is required.')
+        quit()
+
+    msf_boot()
+
+    print ('''\033[1;32m
+      o__ __o                                        o                             
+ <|     v\\                                      <|>                            
+ / \\     <\\                                     < >                            
+ \\o/     o/  \\o__ __o     o__  __o       __o__   |        o__ __o    \\o__ __o  
+  |__  _<|/   |     |>   /v      |>     />  \\    o__/_   /v     v\\    |     |> 
+  |          / \\   < >  />      //      \\o       |      />       <\\  / \\   / \\ 
+ <o>         \\o/        \\o    o/         v\\      |      \\         /  \\o/   \\o/ 
+  |           |          v\\  /v __o       <\\     o       o       o    |     |  
+ / \\         / \\          <\\/> __/>  _\\o__</     <\\__    <\\__ __/>   / \\   / \\ 
+                                                                               
+                                                                               
+                                                                                
+       =[ preston-breacher v2.0-dev           ]
++ -- --=[ Made with ur mum                     ]
++ -- --=[ Preston Security Framework          ]''')
+
+    print ('''\n\033[1;33m[!] LEGAL WARNING: \033[37mOi, listen. I’m not responsible for your long day. 
+    If this deads out or you’re catching errors, it’s because the 
+    target’s moving peak or your own setup is clapped. Use it or lose it. Safe.\n''')
+
+    target = target.replace('https://', '').replace('http://', '')
+    if target.endswith('/'): target = target[:-1]
+    target = 'http://' + target
+    if args.prefix:
+        target = target + ("/" + args.prefix if not args.prefix.startswith("/") else args.prefix)
+
+    msf_log("*", f"Target configured: {target}")
+
+    paths = []
+    base_path = os.path.dirname(os.path.realpath(__file__))
+    wordlist_path = os.path.join(base_path, 'paths.txt')
+    
+    try:
+        with open(wordlist_path,'r') as wordlist:
+            for path in wordlist:
+                path = path.strip()
+                if not args.type or args.type in path:
+                    paths.append(path)
+    except IOError:
+        msf_log("-", f"Failed to load wordlist at {wordlist_path}")
+        quit()
+
+    msf_log("*", f"Payload buffer: {len(paths)} paths loaded.")
+    msf_log("*", "Initiating path discovery...")
+
+    if args.fast:
+        mid = len(paths) // 2
+        t1 = threading.Thread(target=scan, args=(target, paths[:mid],))
+        t2 = threading.Thread(target=scan, args=(target, paths[mid:],))
+        t1.start(); t2.start()
+        t1.join(); t2.join()
+    else:
+        scan(target, paths)
+
+    print("\n")
+    msf_log("+", "Scan completed successfully. Session closed.")
+
+if __name__ == "__main__":
+    main()

pbk-2.0.0/setup.cfg

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

pbk-2.0.0/setup.py

@@ -0,0 +1,34 @@
+from setuptools import setup
+
+# This pulls your README into PyPI so the page isn't blank
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name='pbk',      # Use 'preston-pbk' because 'pbk' is likely taken on PyPI
+    version='2.0.0',
+    author='prest0nn',
+    description='Advanced Admin Panel Finder for Kali Linux',
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url='https://github.com/prest0nn/pbk',
+    py_modules=['preston'],  # This looks for preston.py
+    install_requires=[
+        'requests',          # Tells pip to install requests if the user doesn't have it
+    ],
+    include_package_data=True,
+    package_data={
+        '': ['paths.txt'],   # This forces paths.txt to be included in the download
+    },
+    entry_points={
+        'console_scripts': [
+            'pbk=preston:main', # This makes the 'pbk' command work
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.6',
+)