bcrypt-practical-kit 1.0.0__tar.gz

bcrypt_practical_kit-1.0.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: bcrypt-practical-kit
+Version: 1.0.0
+Summary: Educational Python demonstrations for four ethical hacking practicals
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: bcrypt>=4.0
+Requires-Dist: python-whois>=0.9
+Requires-Dist: Flask>=3.0
+
+# bcrypt-practical-kit
+
+A small educational menu for four Python-based ethical hacking practicals:
+
+1. Caesar cipher and bcrypt password hashing
+2. WHOIS domain lookup
+3. Localhost socket server/client demonstration
+4. Local Flask session-cookie demonstration
+
+## Install
+
+```bash
+python -m pip install bcrypt-practical-kit
+```
+
+## Run
+
+```bash
+python -m bcryptkit
+```
+
+For the socket practical, choose server in one terminal and client in a second terminal. It binds only to `127.0.0.1` for local practice. The Flask demo also binds only to `127.0.0.1` and uses deliberately insecure example credentials/cookies for classroom demonstration only. Do not deploy it or use real credentials.
+
+WHOIS lookups require internet access and may be rate-limited by registries.

bcrypt_practical_kit-1.0.0/README.md

@@ -0,0 +1,24 @@
+# bcrypt-practical-kit
+
+A small educational menu for four Python-based ethical hacking practicals:
+
+1. Caesar cipher and bcrypt password hashing
+2. WHOIS domain lookup
+3. Localhost socket server/client demonstration
+4. Local Flask session-cookie demonstration
+
+## Install
+
+```bash
+python -m pip install bcrypt-practical-kit
+```
+
+## Run
+
+```bash
+python -m bcryptkit
+```
+
+For the socket practical, choose server in one terminal and client in a second terminal. It binds only to `127.0.0.1` for local practice. The Flask demo also binds only to `127.0.0.1` and uses deliberately insecure example credentials/cookies for classroom demonstration only. Do not deploy it or use real credentials.
+
+WHOIS lookups require internet access and may be rate-limited by registries.

bcrypt_practical_kit-1.0.0/bcrypt_practical_kit.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: bcrypt-practical-kit
+Version: 1.0.0
+Summary: Educational Python demonstrations for four ethical hacking practicals
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: bcrypt>=4.0
+Requires-Dist: python-whois>=0.9
+Requires-Dist: Flask>=3.0
+
+# bcrypt-practical-kit
+
+A small educational menu for four Python-based ethical hacking practicals:
+
+1. Caesar cipher and bcrypt password hashing
+2. WHOIS domain lookup
+3. Localhost socket server/client demonstration
+4. Local Flask session-cookie demonstration
+
+## Install
+
+```bash
+python -m pip install bcrypt-practical-kit
+```
+
+## Run
+
+```bash
+python -m bcryptkit
+```
+
+For the socket practical, choose server in one terminal and client in a second terminal. It binds only to `127.0.0.1` for local practice. The Flask demo also binds only to `127.0.0.1` and uses deliberately insecure example credentials/cookies for classroom demonstration only. Do not deploy it or use real credentials.
+
+WHOIS lookups require internet access and may be rate-limited by registries.

bcrypt_practical_kit-1.0.0/bcrypt_practical_kit.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+bcrypt_practical_kit.egg-info/PKG-INFO
+bcrypt_practical_kit.egg-info/SOURCES.txt
+bcrypt_practical_kit.egg-info/dependency_links.txt
+bcrypt_practical_kit.egg-info/entry_points.txt
+bcrypt_practical_kit.egg-info/requires.txt
+bcrypt_practical_kit.egg-info/top_level.txt
+bcryptkit/__init__.py
+bcryptkit/__main__.py
+bcryptkit/cli.py
+bcryptkit/practicals/__init__.py
+bcryptkit/practicals/p01_crypto.py
+bcryptkit/practicals/p03_whois.py
+bcryptkit/practicals/p07_socket.py
+bcryptkit/practicals/p15_flask_session.py

bcrypt_practical_kit-1.0.0/bcrypt_practical_kit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bcrypt_practical_kit-1.0.0/bcrypt_practical_kit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bcryptkit = bcryptkit.cli:main

bcrypt_practical_kit-1.0.0/bcrypt_practical_kit.egg-info/requires.txt

@@ -0,0 +1,3 @@
+bcrypt>=4.0
+python-whois>=0.9
+Flask>=3.0

bcrypt_practical_kit-1.0.0/bcrypt_practical_kit.egg-info/top_level.txt

@@ -0,0 +1 @@
+bcryptkit

bcrypt_practical_kit-1.0.0/bcryptkit/__init__.py

@@ -0,0 +1,2 @@
+"""Educational ethical hacking practicals."""
+__version__ = "1.0.0"

bcrypt_practical_kit-1.0.0/bcryptkit/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

bcrypt_practical_kit-1.0.0/bcryptkit/cli.py

@@ -0,0 +1,30 @@
+from .practicals import p01_crypto, p03_whois, p07_socket, p15_flask_session
+
+MENU = {
+    "1": ("Caesar cipher and bcrypt hashing", p01_crypto.run),
+    "2": ("WHOIS domain lookup", p03_whois.run),
+    "3": ("Socket server/client (localhost only)", p07_socket.run),
+    "4": ("Flask session-cookie demonstration", p15_flask_session.run),
+}
+
+def main():
+    while True:
+        print("\nETHICAL HACKING — PYTHON PRACTICALS")
+        for key, (label, _) in MENU.items():
+            print(f"{key}. {label}")
+        print("0. Exit")
+        choice = input("Select practical: ").strip()
+        if choice == "0":
+            print("Goodbye.")
+            return
+        item = MENU.get(choice)
+        if not item:
+            print("Invalid choice. Select 0–4.")
+            continue
+        try:
+            item[1]()
+        except KeyboardInterrupt:
+            print("\nPractical stopped.")
+        except Exception as exc:
+            print(f"\nCould not complete this practical: {exc}")
+        input("\nPress Enter to return to the menu...")

bcrypt_practical_kit-1.0.0/bcryptkit/practicals/__init__.py

@@ -0,0 +1 @@
+"""Individual practical demonstrations."""

bcrypt_practical_kit-1.0.0/bcryptkit/practicals/p01_crypto.py

@@ -0,0 +1,29 @@
+def caesar(text: str, shift: int, decrypt: bool = False) -> str:
+    if decrypt:
+        shift = -shift
+    result = []
+    for char in text:
+        if char.isascii() and char.isalpha():
+            base = ord('A') if char.isupper() else ord('a')
+            result.append(chr((ord(char) - base + shift) % 26 + base))
+        else:
+            result.append(char)
+    return ''.join(result)
+
+def run():
+    print("\n1. Caesar cipher  2. bcrypt password hashing")
+    mode = input("Choose: ").strip()
+    if mode == "1":
+        text = input("Enter text: ")
+        shift = int(input("Enter shift (integer): "))
+        encrypted = caesar(text, shift)
+        print("Encrypted:", encrypted)
+        print("Decrypted:", caesar(encrypted, shift, decrypt=True))
+    elif mode == "2":
+        import bcrypt
+        password = input("Enter a demo password (do not use a real password): ").encode("utf-8")
+        hashed = bcrypt.hashpw(password, bcrypt.gensalt())
+        print("bcrypt hash:", hashed.decode("utf-8"))
+        print("Verification:", bcrypt.checkpw(password, hashed))
+    else:
+        print("Invalid choice.")

bcrypt_practical_kit-1.0.0/bcryptkit/practicals/p03_whois.py

@@ -0,0 +1,8 @@
+def run():
+    import whois
+    domain = input("Enter a domain (e.g. example.com): ").strip()
+    if not domain or any(ch.isspace() for ch in domain):
+        print("Enter a valid domain name.")
+        return
+    result = whois.whois(domain)
+    print(result)

bcrypt_practical_kit-1.0.0/bcryptkit/practicals/p07_socket.py

@@ -0,0 +1,24 @@
+def run():
+    import socket
+    print("Choose: 1. Start local server  2. Run local client")
+    mode = input("Choose: ").strip()
+    host, port = "127.0.0.1", 8080
+    if mode == "1":
+        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as server:
+            server.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            server.bind((host, port))
+            server.listen(1)
+            print(f"Listening on {host}:{port}. Start the client in another terminal.")
+            conn, address = server.accept()
+            with conn:
+                print("Connected by:", address)
+                conn.sendall(b"Thank you for connecting! This is a localhost demo.")
+                print("Sent demo response.")
+    elif mode == "2":
+        try:
+            with socket.create_connection((host, port), timeout=5) as client:
+                print(client.recv(1024).decode("utf-8", errors="replace"))
+        except OSError as exc:
+            print("Could not connect. Start the local server first.", exc)
+    else:
+        print("Invalid choice.")

bcrypt_practical_kit-1.0.0/bcryptkit/practicals/p15_flask_session.py

@@ -0,0 +1,35 @@
+def run():
+    from flask import Flask, request, make_response, redirect
+    app = Flask(__name__)
+    demo_users = {"student": "demo123"}
+
+    @app.route("/", methods=["GET"])
+    def home():
+        if request.cookies.get("demo_session") == "student-demo-session":
+            return '<h2>Welcome Student!</h2><p>Demo session cookie is present.</p><a href="/logout">Logout</a>'
+        return '''<h2>Local Session Demo</h2>
+        <form method="POST" action="/login">
+        <label>Username <input name="username"></label><br>
+        <label>Password <input name="password" type="password"></label><br>
+        <button type="submit">Login</button></form>
+        <p>Demo only: student / demo123</p>'''
+
+    @app.route("/login", methods=["POST"])
+    def login():
+        username = request.form.get("username", "")
+        password = request.form.get("password", "")
+        if demo_users.get(username) == password:
+            response = make_response(redirect("/"))
+            response.set_cookie("demo_session", "student-demo-session", httponly=True, samesite="Lax")
+            return response
+        return "Invalid demo credentials", 401
+
+    @app.route("/logout")
+    def logout():
+        response = make_response(redirect("/"))
+        response.delete_cookie("demo_session")
+        return response
+
+    print("Open http://127.0.0.1:5000 in your browser. Press Ctrl+C to stop.")
+    print("Classroom demo only; do not deploy or use real credentials.")
+    app.run(host="127.0.0.1", port=5000, debug=False)

bcrypt_practical_kit-1.0.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bcrypt-practical-kit"
+version = "1.0.0"
+description = "Educational Python demonstrations for four ethical hacking practicals"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = ["bcrypt>=4.0", "python-whois>=0.9", "Flask>=3.0"]
+
+[project.scripts]
+bcryptkit = "bcryptkit.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["bcryptkit*"]

bcrypt_practical_kit-1.0.0/setup.cfg

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