uncle 1.2.0__tar.gz

uncle-1.2.0/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: uncle
+Version: 1.2.0
+Summary: uncle.show('hmac') -> the exact codes from your CIS Practical Exam Revision Sheet
+Requires-Python: >=3.8

uncle-1.2.0/pyproject.toml

@@ -0,0 +1,12 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "uncle"
+version = "1.2.0"
+description = "uncle.show('hmac') -> the exact codes from your CIS Practical Exam Revision Sheet"
+requires-python = ">=3.8"
+
+[tool.setuptools.packages.find]
+include = ["uncle*"]

uncle-1.2.0/setup.cfg

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

uncle-1.2.0/uncle/__init__.py

@@ -0,0 +1,151 @@
+"""uncle — CIS & AI Practical Exam Revision Sheets, one `import` away.
+
+    import uncle
+    uncle.show("hmac")            # CIS sheet, by name (like the original, still works)
+    uncle.show("ai", "svm")       # AI sheet, by name
+    uncle.show("cis")             # list all CIS practicals
+    uncle.show("ai")              # list all AI practicals
+    uncle.topics()                # everything, everywhere, all at once
+
+Every snippet is exactly what's on the sheet, so you can copy-paste it in the exam.
+"""
+__version__ = "1.2.0"
+
+from uncle.snip import SNIPPETS, ALIASES
+from uncle.snippai import AISNIPPETS, AIALIASES
+
+_SHEETS = {
+    "cis": {"dict": SNIPPETS, "aliases": ALIASES, "title": "CIS (Crypto & Network Security) revision sheet"},
+    "ai": {"dict": AISNIPPETS, "aliases": AIALIASES, "title": "AI (Artificial Intelligence) revision sheet"},
+}
+
+# flat alias -> (sheet, key)
+_FLAT_ALIASES = {}
+for _sheet_name, _cfg in _SHEETS.items():
+    for _key, _names in _cfg["aliases"].items():
+        for _n in _names:
+            _ESC = _FLAT_ALIASES.get(_n)
+            _FLAT_ALIASES.setdefault(_n, (_sheet_name, _key))
+            # if an alias collides (e.g. bare name in both sheets), prefer the sheet
+            # the user explicitly asked for via show(sheet, name) -- dict order already
+            # prefers 'cis' for the flat lookup, which matches the original behaviour
+
+
+def _list_sheet(sheet: str, header: str):
+    cfg = _SHEETS[sheet]
+    lines = [header, ""]
+    for key, (title, _code) in cfg["dict"].items():
+        lines.append(f"    {key:<10} ->  {title}")
+    lines += ["", f"Use: uncle.show(\"{sheet}\", \"<name>\")"]
+    out = "\n".join(lines)
+    print(out)
+    return out
+
+
+def _list_all():
+    out_parts = ["╔═ EVERYTHING in uncle:"]
+    for sheet in ("cis", "ai"):
+        out_parts.append(f"│")
+        out_parts.append(f"│ {sheet.upper()} — {_SHEETS[sheet]['title']}")
+        for key, (title, _c) in _SHEETS[sheet]["dict"].items():
+            out_parts.append(f"│     {key:<10} ->  {title}")
+    out_parts.append("")
+    out_parts.append("  uncle.show(\"<name>\")          # CIS direct, e.g. uncle.show(\"hmac\")")
+    out_parts.append("  uncle.show(\"ai\", \"<name>\")    # AI direct, e.g. uncle.show(\"ai\", \"svm\")")
+    out = "\n".join(out_parts)
+    print(out)
+    return out
+
+
+def topics():
+    """Return all snippet names grouped by sheet."""
+    return {sheet: list(cfg["dict"].keys()) for sheet, cfg in _SHEETS.items()}
+
+
+def show(topic: str = "", sheet: str = None):
+    """Print a snippet from a revision sheet and return its code.
+
+    How to talk to uncle:
+        uncle.show()                  -- list everything
+        uncle.show("hmac")            -- CIS sheet by topic name
+        uncle.show("ai", "svm")       -- AI sheet by topic name
+        uncle.show("cis")             -- list the CIS sheet
+        uncle.show("ai")              -- list the AI sheet
+
+    Returns:
+        The snippet code (also printed), or None if no match / list is empty.
+    """
+    t = (topic or "").strip().lower()
+    s = (sheet or "").strip().lower()
+
+    # swap mode: uncle.show("ai", "svm") arrives as topic="ai", sheet="svm"
+    if s and s not in _SHEETS and t in _SHEETS:
+        t, s = s, t
+
+    if not t and not s:          # nothing asked -> list everything
+        return _list_all()
+    if s and s not in _SHEETS:   # sheet name misspelled
+        print(f"no sheet called '{s}' (sheets: cis, ai)")
+        return None
+    if s:                        # sheet-scoped fetch: uncle.show("ai", "svm")
+        return _show_from(t, s)
+    if t in _SHEETS:             # bare sheet word -> list that sheet
+        return _list_sheet(t, f"── {_SHEETS[t]['title']}:")
+    return _show_from(t, None)   # flat lookup across both sheets
+
+
+def _show_from(t: str, sheet_key):
+    if sheet_key is None:
+        hit = _FLAT_ALIASES.get(t)
+        if hit is None:  # substring fallback on titles+names
+            for s_name, cfg in _SHEETS.items():
+                for name, (title, _c) in cfg["dict"].items():
+                    if t in name or t in title.lower():
+                        hit = (s_name, name)
+                        break
+                if hit:
+                    break
+        if not hit:
+            print(f"no snippet called '{t}' on any sheet")
+            return None
+        s_name, key = hit
+    else:
+        cfg = _SHEETS[sheet_key]
+        aliases = cfg["aliases"]
+        key = None
+        for name, names in aliases.items():
+            if t in names or t == name:
+                key = name
+                break
+        if key is None:  # substring fallback, sheet-scoped
+            for name, (title, _c) in cfg["dict"].items():
+                if t in name or t in title.lower():
+                    key = name
+                    break
+        if key is None:
+            print(f"no snippet called '{t}' on the {sheet_key} sheet")
+            _list_sheet(sheet_key, f"── {_SHEETS[sheet_key]['title']}:")
+            return None
+        s_name = sheet_key
+
+    title, code = _SHEETS[s_name]["dict"][key]
+    print(f"── [{s_name.upper()}] {title} " + "─" * max(3, 54 - len(title)))
+    print(code)
+    print("─" * 64)
+    return code
+
+
+
+def all_to_file(path: str = ""):
+    """Dump every snippet into one .py file for offline notes. Returns the path."""
+    if not path:
+        path = "uncle_all_pracs.py"
+    with open(path, "w", encoding="utf-8") as f:
+        f.write("# CIS + AI revision manual -- generated by uncle\n\n")
+        for sheet in ("cis", "ai"):
+            f.write(f"# ================= {sheet.upper()} =================\n")
+            for name, (title, code) in _SHEETS[sheet]["dict"].items():
+                f.write(f"\n# ----------------------------\n# {title}\n# ----------------------------\n")
+                f.write(code + "\n")
+    print("written:", path)
+    return path

uncle-1.2.0/uncle/snip.py

@@ -0,0 +1,147 @@
+"""All snippets from the CIS Practical Exam Revision Sheet (single-page summary)."""
+
+# (title, code_and_steps) per topic, in sheet order
+SNIPPETS = {}
+
+
+def _s(name, title, code):
+    SNIPPETS[name] = (title, code)
+
+
+_s("caesar", "1A. CAESAR CIPHER", '''def encrypt(msg, k):
+    result = ""
+    for ch in msg:
+        if ch.isalpha():
+            result += chr((ord(ch)-65+k)%26+65)
+        else: result += ch
+    return result
+
+msg = input("Enter Message: ").upper()
+k = int(input("Enter Shift: "))
+e = encrypt(msg, k)
+print("Encrypted:", e)
+print("Decrypted:", encrypt(e, -k))''')
+
+_s("railfence", "1B. RAIL FENCE CIPHER", '''def encrypt(msg, rails):
+    fence = [""] * rails
+    row, step = 0, 1
+    for ch in msg:
+        fence[row] += ch
+        if row == 0: step = 1
+        elif row == rails - 1: step = -1
+        row += step
+    return "".join(fence)
+
+msg = input("Enter Message: ")
+rails = int(input("Enter Rails: "))
+print("Encrypted:", encrypt(msg, rails))''')
+
+_s("hmac", "2. HMAC AUTHENTICATION", '''import hmac, hashlib
+msg = input("Enter Message: ")
+key = input("Enter Secret Key: ")
+
+mac = hmac.new(key.encode(), msg.encode(), hashlib.sha256).hexdigest()
+print("Generated HMAC:", mac)
+
+check = hmac.new(key.encode(), msg.encode(), hashlib.sha256).hexdigest()
+if hmac.compare_digest(mac, check):
+    print("Message is Authentic")
+else:
+    print("Authentication Failed")''')
+
+_s("signature", "3. DIGITAL SIGNATURE (RSA)", '''from cryptography.hazmat.primitives.asymmetric import rsa, padding
+from cryptography.hazmat.primitives import hashes
+
+key = rsa.generate_private_key(public_exponent=65537, key_size=2048)
+msg = b"Hello"
+
+sig = key.sign(msg, padding.PSS(mgf=padding.MGF1(hashes.SHA256()),
+        salt_length=padding.PSS.MAX_LENGTH), hashes.SHA256())
+
+key.public_key().verify(sig, msg, padding.PSS(mgf=padding.MGF1(hashes.SHA256()),
+        salt_length=padding.PSS.MAX_LENGTH), hashes.SHA256())
+
+print("Signature Verified Successfully")''')
+
+_s("rsa", "4. RSA ENCRYPTION", '''p = 11; q = 13
+n = p * q
+phi = (p-1) * (q-1)
+e = 7; d = 103
+
+msg = input("Enter Message: ")
+cipher = [pow(ord(c), e, n) for c in msg]
+print("Encrypted:", cipher)
+plain = "".join(chr(pow(c, d, n)) for c in cipher)
+print("Decrypted:", plain)''')
+
+_s("dh", "5. DIFFIE-HELLMAN KEY EXCHANGE", '''p = 23; g = 5
+a = 6; b = 15
+
+A = pow(g, a, p)
+B = pow(g, b, p)
+
+key1 = pow(B, a, p)
+key2 = pow(A, b, p)
+
+print("Sender Public Key:", A)
+print("Receiver Public Key:", B)
+print("Sender Secret Key:", key1)
+print("Receiver Secret Key:", key2)''')
+
+_s("malware", "6. MALWARE DETECTION (VIRUSTOTAL)", '''Steps:
+1. Open VirusTotal website.
+2. Click 'Choose File' & upload sample file.
+3. Wait for scanning to complete.
+4. Check detection ratio & SHA-256 hash report.''')
+
+_s("firewall", "7. FIREWALL CONFIGURATION", '''Steps:
+1. Control Panel > Windows Defender Firewall.
+2. Click Advanced Settings > Inbound Rules > New Rule.
+3. Select Port > Choose TCP > Enter Port number.
+4. Select 'Block the Connection' > Next > Finish.''')
+
+_s("ssl", "8. SSL/TLS CLIENT-SERVER", '''# Server.py
+import socket, ssl
+ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER)
+ctx.load_cert_chain("server.crt", "server.key")
+s = socket.socket(); s.bind(("localhost", 5000)); s.listen(1)
+c, addr = s.accept()
+with ctx.wrap_socket(c, server_side=True) as conn:
+    print("Client:", conn.recv(1024).decode())
+    conn.sendall(b"Message Received")
+
+# Client.py
+import socket, ssl
+ctx = ssl.create_default_context(); ctx.check_hostname = False; ctx.verify_mode = ssl.CERT_NONE
+with socket.create_connection(("localhost", 5000)) as s:
+    with ctx.wrap_socket(s, server_hostname="localhost") as c:
+        c.sendall(b"Hello Server")
+        print(c.recv(1024).decode())''')
+
+_s("ids", "9. INTRUSION DETECTION SYSTEM (IDS)", '''from scapy.all import sniff, IP, TCP
+ports = {}
+def detect(pkt):
+    if IP in pkt and TCP in pkt:
+        if pkt[TCP].flags == "S":
+            ip = pkt[IP].src
+            ports[ip] = ports.get(ip, set())
+            ports[ip].add(pkt[TCP].dport)
+            if len(ports[ip]) >= 5:
+                print("Alert! Port Scanning Detected:", ip)
+
+print("IDS Started...")
+sniff(filter="tcp", prn=detect)''')
+
+
+ALIASES = {
+    "caesar": ["caesar", "ceaser", "shift cipher", "1", "1a", "caesar cipher"],
+    "railfence": ["rail", "rail fence", "railfence", "zigzag", "rail fence cipher", "1b"],
+    "hmac": ["hmac", "hash", "auth", "authentication", "2", "hmac authentication"],
+    "signature": ["signature", "digital signature", "sign", "dsa", "3", "digital"],
+    "rsa": ["rsa", "rsa encryption", "4"],
+    "dh": ["dh", "diffie", "key exchange", "diffie-hellman", "diffiehellman", "5"],
+    "malware": ["malware", "virustotal", "virus total", "vt", "6", "malware detection"],
+    "firewall": ["firewall", "7", "firewall configuration"],
+    "ssl": ["ssl", "tls", "8", "ssl tls", "ssltls"],
+    "ids": ["ids", "intrusion", "intrusion detection", "port scan", "sniff", "sniffer", "9", "ids system"],
+}

uncle-1.2.0/uncle/snippai.py

@@ -0,0 +1,198 @@
+"""AI practicals — snippets from the AI Practical Exam Revision Sheet."""
+
+AISNIPPETS = {}
+
+
+def _add(name, title, code):
+    AISNIPPETS[name] = (title, code)
+
+
+_add("bfs", "1. BFS & IDDFS", '''from collections import deque
+G = {'A':['B','C'], 'B':['D','E'], 'C':['F'], 'E':['G','H'], 'F':['I']}
+
+def bfs(s, goal):
+    q = deque([[s]]); seen = set()
+    while q:
+        p = q.popleft(); n = p[-1]
+        if n == goal: return p
+        if n not in seen:
+            seen.add(n)
+            for x in G.get(n, []): q.append(p + [x])
+
+def dfs(n, goal, limit, path):
+    if n == goal: return path
+    if limit == 0: return None
+    for x in G.get(n, []):
+        if x not in path:
+            r = dfs(x, goal, limit-1, path+[x])
+            if r: return r
+
+print("BFS:", bfs('A','I'))
+for d in range(10):
+    r = dfs('A','I',d,['A'])
+    if r: print("IDDFS:", r); break''')
+
+_add("astar", "2-A. A* SEARCH", '''import heapq
+G = {'A':[('B',4),('C',5)], 'B':[('D',7)], 'C':[('D',2)], 'D':[('E',9)], 'E':[]}
+H = {'A':7,'B':6,'C':2,'D':1,'E':0}
+
+q = [(H['A'], 0, 'A')]; cost = {'A':0}; parent = {}
+while q:
+    f, g, n = heapq.heappop(q)
+    if n == 'E': break
+    for x, w in G[n]:
+        new = g + w
+        if new < cost.get(x, float('inf')):
+            cost[x] = new; parent[x] = n
+            heapq.heappush(q, (new+H[x], new, x))
+
+p = ['E']
+while p[-1] != 'A': p.append(parent[p[-1]])
+p.reverse()
+print("Path:", " -> ".join(p), "| Cost:", cost['E'])''')
+
+_add("rbfs", "2-B. RECURSIVE BEST FIRST SEARCH (RBFS)", '''G = {'A':[('B',1),('C',4)], 'B':[('C',2),('D',5)], 'C':[('D',1)], 'D':[('E',3)], 'E':[]}
+H = {'A':7,'B':6,'C':2,'D':1,'E':0}
+
+def rbfs(n, g, limit, path):
+    if n == 'E': return path, g
+    s = [(max(g+w+H[x], H[n]), x, g+w) for x,w in G[n]]
+    while s:
+        s.sort()
+        f, x, ng = s[0]
+        if f > limit: return None, f
+        alt = s[1][0] if len(s) > 1 else float('inf')
+        r, nf = rbfs(x, ng, min(limit, alt), path+[x])
+        if r: return r, nf
+        s[0] = (nf, x, ng)
+    return None, float('inf')
+
+p, c = rbfs('A', 0, float('inf'), ['A'])
+print("Path:", " -> ".join(p), "| Cost:", c)''')
+
+_add("tree", "3. DECISION TREE", '''from sklearn.datasets import load_iris
+from sklearn.model_selection import train_test_split
+from sklearn.tree import DecisionTreeClassifier, export_text
+from sklearn.metrics import accuracy_score, confusion_matrix
+
+X, y = load_iris(return_X_y=True)
+a, b, c, d = train_test_split(X, y, test_size=.25, random_state=42)
+m = DecisionTreeClassifier(random_state=42)
+m.fit(a, c)
+p = m.predict(b)
+print("Accuracy:", accuracy_score(d,p))
+print("Confusion Matrix:\\n", confusion_matrix(d,p))
+print(export_text(m))''')
+
+_add("nn", "4. FEED FORWARD BACKPROPAGATION NN", '''from sklearn.datasets import load_iris
+from sklearn.model_selection import train_test_split
+from sklearn.preprocessing import StandardScaler
+from sklearn.neural_network import MLPClassifier
+from sklearn.metrics import accuracy_score
+
+X, y = load_iris(return_X_y=True)
+a, b, c, d = train_test_split(X, y, test_size=.25, random_state=42)
+s = StandardScaler()
+a = s.fit_transform(a); b = s.transform(b)
+m = MLPClassifier(hidden_layer_sizes=(10,), max_iter=1000, random_state=42)
+m.fit(a, c); p = m.predict(b)
+print("Actual:", d); print("Predicted:", p)
+print("Accuracy:", accuracy_score(d,p))''')
+
+_add("svm", "5. SUPPORT VECTOR MACHINE (SVM)", '''from sklearn.datasets import load_iris
+from sklearn.model_selection import train_test_split
+from sklearn.svm import SVC
+from sklearn.metrics import accuracy_score, confusion_matrix
+
+X, y = load_iris(return_X_y=True)
+X, y = X[:100], y[:100]
+a, b, c, d = train_test_split(X, y, test_size=.2, random_state=4)
+m = SVC(kernel='linear', C=1)
+m.fit(a, c); p = m.predict(b)
+print("Accuracy:", accuracy_score(d,p))
+print(confusion_matrix(d,p))''')
+
+_add("adaboost", "6. ADABOOST", '''from sklearn.datasets import load_breast_cancer
+from sklearn.model_selection import train_test_split
+from sklearn.tree import DecisionTreeClassifier
+from sklearn.ensemble import AdaBoostClassifier
+from sklearn.metrics import accuracy_score
+
+X, y = load_breast_cancer(return_X_y=True)
+a, b, c, d = train_test_split(X, y, test_size=.3, random_state=4)
+m1 = DecisionTreeClassifier(max_depth=1, random_state=4)
+m1.fit(a, c)
+print("Weak stump:", accuracy_score(d, m1.predict(b)))
+m2 = AdaBoostClassifier(n_estimators=50, random_state=4)
+m2.fit(a, c)
+print("AdaBoost:", accuracy_score(d, m2.predict(b)))''')
+
+_add("bayes", "7. NAIVE BAYES", '''from sklearn.datasets import load_iris
+from sklearn.model_selection import train_test_split
+from sklearn.naive_bayes import GaussianNB
+from sklearn.metrics import accuracy_score, confusion_matrix
+import numpy as np
+
+X, y = load_iris(return_X_y=True)
+a, b, c, d = train_test_split(X, y, test_size=.2, random_state=42)
+m = GaussianNB(); m.fit(a, c); p = m.predict(b)
+print("Accuracy:", accuracy_score(d,p)*100, "%")
+print("Probabilities:\\n", np.round(m.predict_proba(b[:3]),3))
+print("Confusion Matrix:\\n", confusion_matrix(d,p))''')
+
+_add("knn", "8. K-NEAREST NEIGHBOUR (KNN)", '''from sklearn.datasets import load_iris
+from sklearn.model_selection import train_test_split
+from sklearn.neighbors import KNeighborsClassifier
+from sklearn.metrics import accuracy_score
+
+iris = load_iris()
+X, y = iris.data[:,:2], iris.target
+a, b, c, d = train_test_split(X, y, test_size=.3, random_state=43)
+m = KNeighborsClassifier(n_neighbors=3)
+m.fit(a, c); p = m.predict(b)
+print("Accuracy:", accuracy_score(d,p)*100, "%")
+new = [[5.0,3.5]]
+print("New data:", iris.target_names[m.predict(new)[0]])''')
+
+_add("apriori", "9. APRIORI ALGORITHM", '''import pandas as pd
+from mlxtend.preprocessing import TransactionEncoder
+from mlxtend.frequent_patterns import apriori
+
+T = [['Milk','Bread'], ['Bread','Butter'],
+     ['Milk','Bread','Butter'], ['Milk','Butter'],
+     ['Bread','Butter']]
+te = TransactionEncoder()
+df = pd.DataFrame(te.fit(T).transform(T), columns=te.columns_)
+print(df.astype(int))
+print(apriori(df, min_support=.4, use_colnames=True))''')
+
+_add("tf", "10. TENSORFLOW - FASHION MNIST", '''import tensorflow as tf
+from tensorflow.keras import layers, models
+
+(X,y), (A,B) = tf.keras.datasets.fashion_mnist.load_data()
+X, A = X/255.0, A/255.0
+m = models.Sequential([
+    layers.Input(shape=(28,28)),
+    layers.Flatten(),
+    layers.Dense(128, activation='relu'),
+    layers.Dense(10, activation='softmax')
+])
+m.compile(optimizer='adam', loss='sparse_categorical_crossentropy', metrics=['accuracy'])
+m.fit(X, y, epochs=3, batch_size=64, validation_split=.1)
+loss, acc = m.evaluate(A, B)
+print("Test Accuracy:", acc)''')
+
+
+AIALIASES = {
+    "bfs": ["bfs", "iddfs", "idf", "breadth", "1", "bfs iddfs", "search"],
+    "astar": ["astar", "a*", "a star", "star", "heuristic", "2a", "a* search"],
+    "rbfs": ["rbfs", "recursive best", "best first", "2b"],
+    "tree": ["tree", "decision", "dt", "3", "decision tree"],
+    "nn": ["nn", "neural", "neural network", "nnetwork", "backprop", "ann", "4", "mlp", "nnetwork"],
+    "svm": ["svm", "support vector", "5", "support vector machine"],
+    "adaboost": ["adaboost", "boost", "boosting", "6", "ensemble"],
+    "bayes": ["bayes", "naive", "naivebayes", "nb", "gaussian", "7", "naive bayes"],
+    "knn": ["knn", "nearest", "8", "k-nearest", "k nearest"],
+    "apriori": ["apriori", "apriori algorithm", "9", "frequent", "market basket"],
+    "tf": ["tf", "tensorflow", "mnist", "fashion", "fashion mnist", "10", "cnn"],
+}

uncle-1.2.0/uncle.egg-info/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: uncle
+Version: 1.2.0
+Summary: uncle.show('hmac') -> the exact codes from your CIS Practical Exam Revision Sheet
+Requires-Python: >=3.8

uncle-1.2.0/uncle.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+pyproject.toml
+uncle/__init__.py
+uncle/snip.py
+uncle/snippai.py
+uncle.egg-info/PKG-INFO
+uncle.egg-info/SOURCES.txt
+uncle.egg-info/dependency_links.txt
+uncle.egg-info/top_level.txt

uncle-1.2.0/uncle.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

uncle-1.2.0/uncle.egg-info/top_level.txt

@@ -0,0 +1 @@
+uncle