ShadowB 0.1__py3-none-any.whl

ShadowB/core.py

@@ -0,0 +1,106 @@
+import time
+from ShadowB.Core.randwords import randw
+from ShadowB.Core.fileorg import florg
+try:
+    from colorama import init, Fore
+except ImportError:
+    import os
+    os.system("pip install colorama")
+    from colorama import init, Fore
+
+
+def start():
+    init()
+    while True:
+        try:
+            print(Fore.GREEN + "="*50)
+            time.sleep(1)
+            print("** welcome to ShadowBoys **")
+            time.sleep(1)
+            print("[1]. Generating random words")
+            time.sleep(1)
+            print("[2]. Organizing files")
+            time.sleep(1)
+            print("[3]. Exit")
+            time.sleep(1)
+            print("** Write here what you need, like 3 , 2 or 1 **")
+            inp = input(">> ")
+            if inp == "3":
+                print(f"** Closed ** \n {'='*50}")
+                break
+            
+            elif inp == "1":
+                others_chars = ""
+                rep = int(input("** How many slots do you want to create? : "))
+                if rep > 5:
+                    print("-- The maximum number of slots you can reach is 5 --")
+                if rep < 2:
+                    print("-- The smallest number of digits possible is 2 --")
+                numbers = input("** Do you want to use numbers? (y/n) : ")
+                if numbers in ["n","no"]:
+                    numbers = False
+                else:
+                    numbers = True
+                symbols = input("** Do you want to use symbols? (y/n) : ")
+                if symbols in ["n","no"]:
+                    symbols = False
+                else:
+                    symbols = True
+                letters = input("** Do you want to use letters? (y/n) : ")
+                if letters in ["n","no"]:
+                    letters = False
+                else:
+                    letters = True
+                form = input("** Do you want to use only uppercase letters (maj), only lowercase letters (min), or both uppercase and lowercase letters (all)? (min/maj/all) : ")   
+                filename = input("** Please write the name of the file where you will save the attempts (like pass or passwords)(only the name) : ")
+                other_char = input("** Do you have any special words, numbers, or dates you want to add? (y/n) : ")
+                while not other_char in ["y","n"]:
+                    other_char = input("** Do you have any special words, numbers, or dates you want to add? (y/n) : ")
+                if other_char == "y":
+                    n = int(input("** How many special words do you want to enter? : (1 or 10 or 88...)"))
+                    for i in range(n):
+                        char = input(f"** Enter the word number {i+1} : ")
+                        others_chars += char
+                randw(filename,rep,others_chars,numbers,symbols,letters,form)
+                time.sleep(1)
+                print("="*50)
+                break
+            
+            elif inp == "2":
+                path = input("** The folder path whose files we are going to organize: ")
+                florg(path)
+                print("="*50)
+                break
+            else:
+                print("-- They was an error, pls try again! --")
+        except:
+            print("-- They was an error, pls try again! --")
+            break
+        
+def owner():
+    print("Adem mzoughi")
+    print("Github : https://github.com/erec2smith")
+
+def vr():
+    print("0.1")
+    
+def team():
+    print("Adem")
+    print("Shadow")
+    print("Berlin")
+
+def hp():
+    print("""
+        1. At the beginning, you should call core like this: from ShadowB import core \n
+        2. After that, it calls the main function core , like that : core.owner() \n
+        3. Call any function you want, like (owner to get info about the library owner, or team to get \n        info about the Shadow Boys team) example: core.owner() \n
+        4. All the functions currently available:\n
+        owner() : To find out information about making the library \n
+        team() : To find out information about the wamithe team \n
+        start() : To start generating random words or organizing files \n
+        hp() : To find out information about the library \n
+        Example : from ShadowB import core \n
+        core.start() \n
+        2026/06/17 python https://github.com/erec2smith
+        """)
+    

ShadowB/getD.py

@@ -0,0 +1,28 @@
+from ShadowB.GetD.my_data import make_file
+from ShadowB.GetD.make_cookies import cookies
+from ShadowB.GetD.my_ip import ip
+from ShadowB.GetD.scan import scan
+from pathlib import Path
+
+def my_data():
+    make_file()
+    return ""
+
+
+
+def my_ip():
+    ip()
+    return ""
+
+
+def get_cookies(filename="cookies"):
+    return cookies(filename)
+
+
+def scan_open_ports(ip):
+    return scan(ip)
+
+def whm():
+    current_path = Path.cwd()
+    print(current_path)
+    return current_path

ShadowB/image.py

@@ -0,0 +1,31 @@
+from ShadowB.Image.check_image import check 
+from ShadowB.Image.export_metadata import exp
+from ShadowB.Image.remove_metadata import remove
+from ShadowB.Image.makeText import hide_text_in_img
+from ShadowB.Image.makeFile import hide_file_in_img
+from ShadowB.Image.extr_hidden_files import extract_file_from_img
+from ShadowB.Image.extr_hidden_text import extract_text_from_img
+
+def check_img(image):
+    return check(image)
+
+
+def expMetadata(image):
+    return exp(image)
+
+
+def removeMetadata(image):
+    return remove(image)
+
+
+def hide_text(image,text):
+    return hide_text_in_img(image,text)
+
+def hide_file(image,file):
+    return hide_file_in_img(image,file)
+
+def extr_file(image):
+    return extract_file_from_img(image)
+
+def extr_text(image):
+    return extract_text_from_img(image)

ShadowB/mail.py

@@ -0,0 +1,21 @@
+from ShadowB.Mail.make_mail import create_temp_email
+from ShadowB.Mail.res_msj import get_messages
+from ShadowB.Mail.send_msj import send_email
+
+def create_email():
+    return create_temp_email()
+
+
+def get_msj(token):
+    if token:
+        return get_messages(token)
+    else:
+        return "Entering the token is mandatory!"
+    
+    
+    
+def send_msj(sender, app_password, to, subject, body):
+    if sender and app_password and to and subject and body:
+        return send_email(sender, app_password, to, subject, body)
+    else:
+        return "(sender, app_password, to, subject, body) must be entered compulsorily!"    

ShadowB/passwords.py

@@ -0,0 +1,47 @@
+import string
+import secrets
+import re
+
+
+def create_password():
+    length = 20
+    all_characters = string.ascii_letters + string.punctuation + string.digits 
+    
+
+    password = "".join(secrets.choice(all_characters) for _ in range(length))
+    
+    return password
+
+
+
+def check_strength(password):
+    pass_list = ["azerty","azerty22","1234","google","insta","yamal","123456789","password","mot passe","abcdefghijklmnopqrstuvwxyz","pass123","password123","pass","password","ronaldo","cr7ronaldo","ronaldo2008","messi","fcmessi","itsme","hacker","azertyuiopmlkjhgfdsqwxcvbn","azertyuiopqsdfghjklmwxcvbn"]
+
+    length_error = len(password) < 8
+    
+
+    lowercase_error = re.search(r"[a-z]", password) is None
+    
+   
+    uppercase_error = re.search(r"[A-Z]", password) is None
+    
+
+    digit_error = re.search(r"\d", password) is None
+    
+   
+    symbol_error = re.search(r"[ !@#$%^&*(),.?\":{}|<>_\-+=\[\]\\/`~;']", password) is None
+    
+
+    errors = [length_error, lowercase_error, uppercase_error, digit_error, symbol_error]
+    passed_conditions = errors.count(False)
+    
+   
+    if len(password) >= 12 and passed_conditions == 5 and password not in pass_list:
+        print("Strong")
+        return ""
+    elif len(password) >= 8 and passed_conditions >= 3 and password not in pass_list:
+        print("Medium")
+        return ""
+    else:
+        print("Weak")
+        return ""

ShadowB/qrcode.py

@@ -0,0 +1,10 @@
+from ShadowB.Qrcode.generate import qrcode
+from ShadowB.Qrcode.scan import scan
+
+def generate_qrcode(text,filename):
+    return qrcode(text,filename)
+
+
+
+def scan_qrcode(qrcode):
+    return scan(qrcode)

ShadowB/safe.py

@@ -0,0 +1,80 @@
+from ShadowB.Safe.filename import real_filename
+from ShadowB.Safe.ext import real_ext
+from ShadowB.Safe.cleanText import is_clean
+from ShadowB.Safe.clean import cleann
+from ShadowB.Safe.safeFile import is_safe
+import os
+
+
+def name(file):
+    name = real_filename(file)
+    return name
+
+
+def ext(file):
+    e = real_ext(file)
+    return e
+
+
+def extR(file):
+    e = real_ext(file)
+    return e.replace(".","")
+
+
+def cleanText(text,check_list=None):
+    if check_list and check_list is not None:
+        clean = is_clean(text,check_list)
+    else:
+        clean = is_clean(text)
+    if clean:
+        print("true")
+        return "true"
+    else:
+        print("false")
+        return "false"
+
+
+
+def clean(file,check_list=None):
+    e = real_ext(file)
+    if e not in ["pdf",".pdf",".txt","txt"]:
+        print("Currently, the accepted files are .pdf and .txt")
+        return "Currently, the accepted files are .pdf and .txt"
+    
+    
+    if check_list and check_list is not None:
+        c = cleann(file,check_list)
+    else:
+        c = cleann(file)
+        
+        
+    if c:
+        print("true")
+        return "true"
+    else:
+        print("false")
+        return "false"
+
+
+
+def size(file):
+    try:
+        size_bytes = os.path.getsize(file)
+        size_mb = size_bytes / (1024 * 1024)
+        print(size_mb)
+        return size_mb
+
+    except Exception as e:
+        print(e)
+        print("error!")
+        return "error!"
+    
+    
+def safeFile(file):
+    safe = is_safe(file)
+    if safe:
+        print("true")
+        return "true"
+    else:
+        print("false")
+        return "false"

ShadowB/search.py

@@ -0,0 +1,50 @@
+import sys
+import os
+
+try:
+    import requests
+except ImportError:
+    os.system(f"{sys.executable} -m pip install requests")
+    import requests
+
+
+def search_by_username(app, username):
+    platforms = {
+        ".insta": {
+            "url": f"https://www.instagram.com/{username}/",
+            "error_indicators": ["this page isn't available", "page not found", "cannot find"]
+        },
+        ".fc": {
+            "url": f"https://www.facebook.com/{username}",
+            "error_indicators": ["this page isn't available", "page not found", "content not found"]
+        },
+        ".yt": {
+            "url": f"https://www.youtube.com/@{username}",
+            "error_indicators": ["this page isn't available", "404 not found", "does not exist"]
+        }
+    }
+
+    if app not in platforms:
+        return "false"
+
+    target = platforms[app]
+    headers = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+        "Accept-Language": "en-US,en;q=0.9"
+    }
+
+    try:
+        response = requests.get(target["url"], headers=headers, timeout=10, allow_redirects=True)
+        
+        if response.status_code == 404:
+            return "false"
+            
+        page_content = response.text.lower()
+        for indicator in target["error_indicators"]:
+            if indicator in page_content:
+                return "false"
+        print(f"url : {target['url']}")        
+        return "true"
+
+    except Exception:
+        return "false"

shadowb-0.1.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adem mzoughi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

shadowb-0.1.dist-info/METADATA

@@ -0,0 +1,200 @@
+Metadata-Version: 2.1
+Name: ShadowB
+Version: 0.1
+Summary: ShadowB is an all-in-one Python toolkit that bundles a wide range of everyday utilities — system info, image steganography, temporary email, QR codes, CAPTCHA generation, password tools, file safety checks, and more — into a single, easy-to-import package.
+Author-email: Adem mzoughi <ademzoughi1312@gmail.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# ShadowB
+
+**ShadowB** is an all-in-one Python toolkit that bundles a wide range of everyday utilities — system info, image steganography, temporary email, QR codes, CAPTCHA generation, password tools, file safety checks, and more — into a single, easy-to-import package.
+
+Instead of installing and learning a dozen different libraries for a dozen small tasks, `ShadowB` collects the most commonly needed helper functions in one place.
+
+> 100% open source. No telemetry, no analytics, no external server. Every function runs **locally** on the user's own machine — nothing is collected or transmitted by the library's maintainers.
+
+---
+
+## Installation
+
+```bash
+pip install ShadowB
+```
+
+---
+
+## Table of Contents
+
+- [core](#core)
+- [getD](#getd)
+- [search](#search)
+- [captcha](#captcha)
+- [qrcode](#qrcode)
+- [mail](#mail)
+- [safe](#safe)
+- [image](#image)
+- [passwords](#passwords)
+- [Responsible Use](#-responsible-use)
+- [License](#-license)
+
+---
+
+## `core`
+
+Basic package metadata and bootstrapping.
+
+```python
+from ShadowB import core
+
+core.start()        # run core app fro : create passwords or usernames / organize the working files
+core.owner()        # -> "Adem mzoughi"
+core.team()         # -> "Adem mzoughi, Berlin, Shadow"
+core.hp()           # print help / usage info
+core.vr()           # print current version
+```
+
+---
+
+## `getD`
+
+Local system & network diagnostics — useful for things like monitoring your own machine's load, debugging your own network setup, or quick scripting.
+
+```python
+from ShadowB import getD
+
+getD.my_ip()             # your public IP address
+getD.my_data()           # IP, country, and basic PC specs (CPU/RAM, etc.)
+getD.get_cookies(filename)   # export your own browser's cookies to a local .txt file
+getD.scan_open_ports()    # check which ports are open on a given website
+getD.whm()                # print the current working directory (e.g. C:/Users/Pc/Desktop)
+```
+
+> ⚠️ `get_cookies()` reads cookies from **your own** browser profile and `scan_open_ports()` should only be run against hosts you own or are authorized to test. See [Responsible Use](#-responsible-use).
+
+---
+
+## `search`
+
+Look up whether a username exists on a given platform.
+
+```python
+from ShadowB import search
+
+search.forgot.search_by_username(app, username)
+# returns True (and prints the profile link) or False
+# app: ".insta" | ".fc" | ".yt"
+```
+
+---
+
+## `captcha`
+
+Generate CAPTCHA images.
+
+```python
+from ShadowB import captcha
+
+captcha.generate_captcha("captcha") # image name
+```
+
+---
+
+## `qrcode`
+
+Generate and read QR codes.
+
+```python
+from ShadowB import qrcode
+
+qrcode.generate_qrcode(text, "qr")   # create a QR code image
+qrcode.scan_qrcode("qr.png")             # -> decoded text (str)
+```
+
+---
+
+## `mail`
+
+Disposable email creation and sending (Gmail SMTP).
+
+```python
+from ShadowB import mail
+
+mail.create_email()                      # -> email, password, token
+mail.get_msj(token)                      # -> list of received messages (id, subject, body, ...)
+mail.send_msj(sender, app_password, to, subject, body)   # send via Gmail SMTP
+```
+
+---
+
+## `safe`
+
+File inspection and sanitation helpers.
+
+```python
+from ShadowB import safe
+
+safe.safeFile(file)              # -> True / False
+safe.size(file)                  # -> file size
+safe.name(file)                  # -> file name
+safe.ext(file)                   # -> file extension
+safe.clean(file, check_list)     # -> True / False
+safe.cleanText(text, check_list) # -> True / False
+```
+
+---
+
+## `image`
+
+Metadata and steganography utilities.
+
+```python
+from ShadowB import image
+
+image.expMetadata(img)          # read EXIF / metadata
+image.check_img(img)            # -> True / False (contains hidden text/file)
+image.extr_file(img)            # extract a hidden file from the image
+image.extr_text(img)            # extract hidden text from the image
+image.removeMetadata(img)       # strip metadata (useful before sharing photos)
+image.hide_text(img, text)      # embed hidden text into the image
+image.hide_file(img, file)      # embed a hidden file into the image
+```
+
+---
+
+## `passwords`
+
+```python
+from ShadowB import passwords
+
+passwords.check_strenght(password)   # rate password strength
+passwords.create_password()          # generate a strong password
+```
+
+---
+
+## ⚖️ Responsible Use
+
+`ShadowB` is a general-purpose utility library, similar in spirit to combining tools like `requests`, `browser_cookie3`, `psutil`, `python-nmap`, and `Pillow`-based steganography helpers into one package. It performs no network exfiltration on its own and contacts no third-party server.
+
+That said, several functions are powerful and should be used responsibly:
+
+- Only run `get_cookies()` against your **own** browser profile.
+- Only use `scan_open_ports()` on systems/websites you **own** or are explicitly authorized to test.
+- Respect each platform's Terms of Service and applicable privacy laws when using `search.forgot.search_by_username`.
+- Don't use the steganography functions (`hide_text`, `hide_file`) to conceal malicious payloads or to deceive other people.
+
+You are responsible for complying with local laws and the terms of any service you interact with through this library.
+
+---
+
+## 📄 License
+
+This project is licensed under the [MIT License](./LICENSE).
+
+---
+
+## 👤 Author
+
+**Adem mzoughi** — 2026/23/06

shadowb-0.1.dist-info/RECORD

@@ -0,0 +1,38 @@
+ShadowB/__init__.py,sha256=64nyKYQ2Nb7ryAO13777RNzqEzFM2kTk14Zz6kIUZcU,977
+ShadowB/captcha.py,sha256=A5GX8uumLsgvCb5POhicMTLSXpdZCj6QX0DL5Ta8d_U,2336
+ShadowB/core.py,sha256=JZ2Xq_TC_pX3sjYCSjIowwJYDQPdi5oAkMGiFIP9ga8,4456
+ShadowB/getD.py,sha256=X1gLgaiE1nmEZnl78PpoihHK-gra7AK6XrdQgKsyQLo,499
+ShadowB/image.py,sha256=E3YcNAtlHx45aQAD3bw25valerXZx_YKp5xuYPXgfJI,816
+ShadowB/mail.py,sha256=iivGLz7uw7v7_pigwS3bffNTIufC4iv_pAPJb0VqucM,646
+ShadowB/passwords.py,sha256=6GkqLCnn3ppCRHtLbwkmXCTLbFeTKfRjgNcd0LzQ06Y,1439
+ShadowB/qrcode.py,sha256=vGu4lBIhVyrs9evNq-KKI4FVRI1nOKJshdRiwX98F5Q,210
+ShadowB/safe.py,sha256=vI7JL9gC4q-gykl8sFQUKt9j9JzX0CMsBHOHogKEYGk,1680
+ShadowB/search.py,sha256=1zpflijUJffPKyKXSxaPvmWfIcxIC5H_yw8VUdIEcpo,1586
+ShadowB/Core/fileorg.py,sha256=LuHPNwKp7CqFDm0OKcoFzF2l3Lxg3yBHiX_is9Vpam0,1280
+ShadowB/Core/randwords.py,sha256=cOJ5x4KtUJuw06BvJ4xJLggOMF0P320yRVYqCZdmQTE,2965
+ShadowB/GetD/make_cookies.py,sha256=teQF0BT_AAENLRVGFfhyll-QYtP1v1KHsb4O3BvWT64,842
+ShadowB/GetD/my_data.py,sha256=RcK066rc-lv9tHUAA7V1_AXudZ5pmF7S7TkYBG947v0,2489
+ShadowB/GetD/my_ip.py,sha256=c41XVHky--U0NfI4GmIFQ86z3rk0Pn872ldwhAW1MZY,285
+ShadowB/GetD/scan.py,sha256=IQBnMIQkeRlRdo-O4o9m37JIEtDsMf0ruyb4R5R-5qg,2043
+ShadowB/Image/check_image.py,sha256=UXNJohgg50vYybt8Si4qlHhTEsCpp8F0AjjSaJ0LVLo,900
+ShadowB/Image/export_metadata.py,sha256=shI16Npbeb0r8shw2TlXIrs_BXdXz_2WnLqOmOOjK_Y,3198
+ShadowB/Image/extr_hidden_files.py,sha256=K4TWowX9wZ4SJk-f-GVEtmPxvKpspNx3rN4TT0iLi-k,1358
+ShadowB/Image/extr_hidden_text.py,sha256=jEZk7e0xk15BYc1ed07KqOEHMBOP3EysPsNpeKVejbM,1067
+ShadowB/Image/makeFile.py,sha256=cp5kuos4icHeHKCTyVW49GUdmKqDN9EZXFcM037rhdc,1557
+ShadowB/Image/makeText.py,sha256=nimXdRJeU1n-7dpBsUN9RT61SVzeA6nHcuLxbTcpRzQ,1147
+ShadowB/Image/remove_metadata.py,sha256=2xJtGqDBY9JfoJnrzBeTa1p4Z-iEX8YXBhsUoE75TwA,1383
+ShadowB/Mail/make_mail.py,sha256=qHWl1yKLX3NvxaN1r6glOPirnL1s9tz1S9o-7k62dd8,1007
+ShadowB/Mail/res_msj.py,sha256=10fQuGs4L1jV1yG4v5m6JhToskgfY--DOj-VMepgSic,1135
+ShadowB/Mail/send_msj.py,sha256=wxrRkrPylT48xBMtTN0NlatL7BKj617aNtfV43C_IQY,360
+ShadowB/Qrcode/generate.py,sha256=j4RvEXasEJBFcQK5whRGNwenbpNwxnDjBXKNgbcs2g0,811
+ShadowB/Qrcode/scan.py,sha256=8cSCsF7i9rh9K7r_eB3WEeSQDIVddwHR58FfqaX8nyE,556
+ShadowB/Safe/clean.py,sha256=-DJOhA5HTk-AFyIekWFtGWtjo9-pCy7dLJ59-bUKRiw,3176
+ShadowB/Safe/cleanText.py,sha256=FY-MdaJ8TwhldAmokuByyY9LCGqibRw2S79c6mu6syo,1178
+ShadowB/Safe/ext.py,sha256=ZRwNv2UmqKai0yXm4jVgHe-fMkoCv1vH0CaUpGd17E0,93
+ShadowB/Safe/filename.py,sha256=JqbZAPecfJx-pYNOMnvWEaosCjjJGiXpwNe6lFyf1rE,119
+ShadowB/Safe/safeFile.py,sha256=M_IVDdjmppqS33Sf878n2b0oIRpp3nrcRONbRKiJlVQ,4649
+shadowb-0.1.dist-info/LICENSE,sha256=S_b4SfEqucyYPdy-YlOD9_oYeV0R0UVboe91jg_3k30,1069
+shadowb-0.1.dist-info/METADATA,sha256=7wpnlrD2OR8x5NXWTTqgbN3ZVi72TjoiGIdhLKieB5c,5998
+shadowb-0.1.dist-info/WHEEL,sha256=BNRMDyzLkkcmlv0J8ppDQkk2VED33SesJDynr9ED1gc,91
+shadowb-0.1.dist-info/top_level.txt,sha256=JWFMWpuhlb6-_wmOs4KrLgXGKhTP1OQgbF5XabVT8a8,8
+shadowb-0.1.dist-info/RECORD,,

shadowb-0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.4)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

shadowb-0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+ShadowB