ترميز Base64 في Python: دليل b64encode الكامل

import base64

# ترميز زوج من بيانات اعتماد API لترويسة HTTP Basic Auth
service_id = "deploy-svc"
api_key    = "sk-prod-9f2a1c3e8b4d"

credential_bytes   = f"{service_id}:{api_key}".encode("utf-8")
encoded_bytes      = base64.b64encode(credential_bytes)
encoded_str        = encoded_bytes.decode("ascii")  # bytes → str

print(encoded_str)
# ZGVwbG95LXN2Yzpzay1wcm9kLTlmMmExYzNlOGI0ZA==

import urllib.request

req = urllib.request.Request("https://api.internal/v1/deployments")
req.add_header("Authorization", f"Basic {encoded_str}")
# قيمة الترويسة: Basic ZGVwbG95LXN2Yzpzay1wcm9kLTlmMmExYzNlOGI0ZA==

import base64
import json

# ترميز إعدادات خادم منظَّمة لمتغير بيئة
server_config = {
    "host":           "db-primary.eu-west-1.internal",
    "port":           5432,
    "database":       "analytics_prod",
    "max_connections": 150,
    "ssl": {
        "mode":          "verify-full",
        "cert_path":     "/etc/ssl/certs/db-client.crt",
        "reject_self_signed": True,
    },
}

config_json    = json.dumps(server_config, sort_keys=True)
encoded_bytes  = base64.b64encode(config_json.encode("utf-8"))
encoded_str    = encoded_bytes.decode("ascii")

print(encoded_str[:60] + "...")
# eyJkYXRhYmFzZSI6ICJhbmFseXRpY3NfcHJvZCIsICJob3N0IjogImRi...

# فك الترميز والتحقق من رحلة الذهاب والإياب
decoded_json   = base64.b64decode(encoded_str).decode("utf-8")
restored       = json.loads(decoded_json)

print(restored["host"])            # db-primary.eu-west-1.internal
print(restored["ssl"]["mode"])     # verify-full

import base64

# ترميز محتوى متعدد اللغات — أسماء العرض للمستخدمين من منصة دولية
user_names = [
    "أحمد العمري",         # عربي — Unicode
    "田中太郎",              # رموز CJK الأيديوغرافية — 3 بايت لكل منها في UTF-8
    "Мария Соколова",      # سيريلي — U+041C فما فوق
    "فاطمة السيد",         # عربي — Unicode
]

for name in user_names:
    encoded = base64.b64encode(name.encode("utf-8")).decode("ascii")
    decoded = base64.b64decode(encoded).decode("utf-8")

    print(f"الأصلي  : {name}")
    print(f"مُرمَّز  : {encoded}")
    print(f"ذهاب وإياب: {decoded}")
    print(f"تطابق   : {name == decoded}")
    print()

# الأصلي  : Мария Соколова
# مُرمَّز  : 0JzQsNGA0LjRjyDQodC+0LrQvtC70L7QstCw
# ذهاب وإياب: Мария Соколова
# تطابق   : True

import base64
import json

def encode_jwt_segment(data: dict) -> str:
    """رمِّز قاموسًا كسلسلة Base64 آمنة للـ URL بدون حشو (تنسيق JWT)."""
    json_bytes = json.dumps(data, separators=(",", ":")).encode("utf-8")
    return base64.urlsafe_b64encode(json_bytes).rstrip(b"=").decode("ascii")

def decode_jwt_segment(segment: str) -> dict:
    """افكّ ترميز مقطع JWT Base64 الآمن للـ URL (يعالج الحشو المفقود)."""
    # أضف الحشو مجددًا: يتطلب Base64 أن يكون الطول من مضاعفات 4
    padding  = 4 - len(segment) % 4
    padded   = segment + ("=" * (padding % 4))
    raw      = base64.urlsafe_b64decode(padded)
    return json.loads(raw)

# بناء ترويسة JWT وحمولتها
header  = {"alg": "HS256", "typ": "JWT"}
payload = {
    "sub":       "usr_7c3a9f1b2d",
    "workspace": "ws_eu-west-1-prod",
    "role":      "data-engineer",
    "iat":       1741824000,
    "exp":       1741910400,
}

header_segment  = encode_jwt_segment(header)
payload_segment = encode_jwt_segment(payload)

print(header_segment)
# eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9

print(payload_segment)
# eyJzdWIiOiJ1c3JfN2MzYTlmMWIyZCIsIndvcmtzcGFjZSI6IndzX2...

# التحقق من رحلة الذهاب والإياب
restored = decode_jwt_segment(payload_segment)
print(restored["role"])  # data-engineer

import base64
import json
from pathlib import Path

def encode_file_to_base64(file_path: str) -> str:
    """اقرأ ملفًا ثنائيًا وأعِد تمثيله المُرمَّز بـ Base64."""
    try:
        raw_bytes = Path(file_path).read_bytes()
        return base64.b64encode(raw_bytes).decode("ascii")
    except FileNotFoundError:
        raise FileNotFoundError(f"الملف غير موجود: {file_path}")
    except PermissionError:
        raise PermissionError(f"تم رفض إذن القراءة: {file_path}")

# إرفاق شهادة TLS ببيان نشر
cert_b64 = encode_file_to_base64("./ssl/service-client.crt")

deployment_manifest = {
    "service":     "payment-processor",
    "environment": "production",
    "region":      "eu-west-1",
    "tls": {
        "client_cert":     cert_b64,
        "cert_format":     "base64-pem",
    },
}

# كتابة البيان — الشهادة مضمَّنة بأمان كسلسلة نصية
with open("./dist/deployment-manifest.json", "w") as f:
    json.dump(deployment_manifest, f, indent=2)

print(f"تم ترميز الشهادة: {len(cert_b64)} محرف")

import base64
import requests  # pip install requests

def fetch_and_encode_binary(url: str, headers: dict | None = None) -> str:
    """جلب مورد ثنائي من API وإعادته كـ Base64."""
    response = requests.get(url, headers=headers or {}, timeout=10)
    response.raise_for_status()  # يُثير HTTPError لـ 4xx/5xx

    content_type = response.headers.get("Content-Type", "unknown")
    encoded      = base64.b64encode(response.content).decode("ascii")

    print(f"نوع المحتوى  : {content_type}")
    print(f"الحجم الخام  : {len(response.content):,} بايت")
    print(f"الحجم المُرمَّز: {len(encoded):,} محرف")
    return encoded

# مثال: تنزيل فاتورة PDF موقَّعة من API فوترة داخلي
invoice_b64 = fetch_and_encode_binary(
    "https://billing.internal/api/v2/invoices/INV-2026-0042/pdf",
    headers={"Authorization": "Bearer eyJhbGc..."},
)

# إرفاقها بحمولة إشعار
notification = {
    "recipient_id":  "team-finance",
    "invoice_id":    "INV-2026-0042",
    "attachment": {
        "filename":     "invoice-2026-0042.pdf",
        "content":      invoice_b64,
        "content_type": "application/pdf",
        "encoding":     "base64",
    },
}
print(f"الحمولة جاهزة: {len(str(notification)):,} محرف")

import base64
import mimetypes
from pathlib import Path

def image_to_data_uri(image_path: str) -> str:
    """حوِّل ملف صورة إلى URI للبيانات Base64 للتضمين المباشر في HTML."""
    path      = Path(image_path)
    mime_type = mimetypes.guess_type(image_path)[0] or "image/octet-stream"
    raw_bytes = path.read_bytes()
    encoded   = base64.b64encode(raw_bytes).decode("ascii")
    return f"data:{mime_type};base64,{encoded}"

# تضمين صور المنتج مباشرةً في قالب بريد إلكتروني HTML
hero_uri      = image_to_data_uri("./assets/product-hero-768px.png")
thumbnail_uri = image_to_data_uri("./assets/product-thumb-128px.webp")

html_fragment = f"""
<img src="{hero_uri}"
     alt="صورة رئيسية للمنتج"
     width="768" height="432"
     style="display:block;max-width:100%" />
"""

print(f"يبدأ URI بيانات PNG بـ: {hero_uri[:60]}...")
# data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAwAAAAA...

import base64
from pathlib import Path

CHUNK_SIZE = 3 * 1024 * 256  # 786,432 بايت — مضاعف لـ 3، ~768 كيلوبايت لكل جزء

def encode_large_file(input_path: str, output_path: str) -> int:
    """
    رمِّز ملفًا ثنائيًا كبيرًا إلى Base64 دون تحميله كاملًا في الذاكرة.
    يُعيد عدد محارف Base64 المكتوبة.
    """
    total_chars = 0
    with open(input_path, "rb") as src, open(output_path, "w") as dst:
        while True:
            chunk = src.read(CHUNK_SIZE)
            if not chunk:
                break
            encoded_chunk = base64.b64encode(chunk).decode("ascii")
            dst.write(encoded_chunk)
            total_chars += len(encoded_chunk)
    return total_chars

# ترميز فيديو منتج 300 ميجابايت لبيان تسليم الأصول
chars_written = encode_large_file(
    "./uploads/product-demo-4k.mp4",
    "./dist/product-demo-4k.b64",
)
print(f"مُرمَّز: {chars_written:,} محرف Base64")
# مُرمَّز: 407,374,184 محرف Base64

import base64
import json
from pathlib import Path

def encode_assets_to_ndjson(asset_dir: str, output_path: str) -> int:
    """
    رمِّز جميع الملفات الثنائية في دليل إلى بيان NDJSON.
    كل سطر كائن JSON: {"path": "...", "mime": "...", "data": "<base64>"}
    يُعيد عدد الملفات المعالَجة.
    """
    import mimetypes

    asset_path = Path(asset_dir)
    count = 0

    with open(output_path, "w") as out:
        for file_path in sorted(asset_path.rglob("*")):
            if not file_path.is_file():
                continue
            mime = mimetypes.guess_type(str(file_path))[0] or "application/octet-stream"
            encoded = base64.b64encode(file_path.read_bytes()).decode("ascii")
            record  = {"path": str(file_path.relative_to(asset_path)), "mime": mime, "data": encoded}
            out.write(json.dumps(record) + "\n")
            count += 1

    return count

processed = encode_assets_to_ndjson("./dist/static/", "./dist/asset-bundle.ndjson")
print(f"تم ترميز {processed} ملفًا في حزمة أصول NDJSON")

# ── python -m base64 ───────────────────────────────────────────────────
# ترميز سلسلة (عبر stdin)
echo -n "deploy-svc:sk-prod-9f2a1c3e8b4d" | python3 -m base64
# ZGVwbG95LXN2Yzpzay1wcm9kLTlmMmExYzNlOGI0ZA==

# ترميز ملف
python3 -m base64 ./ssl/service-client.crt

# فك ترميز سلسلة Base64
echo "ZGVwbG95LXN2Yzpzay1wcm9kLTlmMmExYzNlOGI0ZA==" | python3 -m base64 -d

# فك ترميز ملف Base64 إلى ثنائي
python3 -m base64 -d ./dist/service-client.b64 > ./restored.crt

# ── سطر Python أحادي — عبر الأنظمة، يعمل على Windows ────────────────
# ترميز سلسلة
python3 -c "import base64,sys; print(base64.b64encode(sys.argv[1].encode()).decode())" "my-secret"
# bXktc2VjcmV0

# ترميز آمن للـ URL (بدون حشو)
python3 -c "import base64,sys; print(base64.urlsafe_b64encode(sys.argv[1].encode()).rstrip(b'=').decode())" "my-secret"
# bXktc2VjcmV0

# ترميز ملف مباشرةً (النتيجة على stdout)
python3 -c "import base64,sys; print(base64.b64encode(open(sys.argv[1],'rb').read()).decode())" ./config.json

pip install pybase64

import pybase64
import time

# pybase64 بديل متوافق — نفس توقيعات الدوال في stdlib
sample_payload = b"x" * (1024 * 1024)  # 1 ميجابايت من البيانات الثنائية

# ترميز قياسي — إخراج مطابق لـ base64.b64encode()
encoded = pybase64.b64encode(sample_payload)
decoded = pybase64.b64decode(encoded)
assert decoded == sample_payload

# ترميز آمن للـ URL — إخراج مطابق لـ base64.urlsafe_b64encode()
url_safe = pybase64.urlsafe_b64encode(sample_payload)

# b64encode_as_string() تُعيد str مباشرةً — لا داعي لاستدعاء .decode()
telemetry_event = b'{"event":"page_view","session_id":"sess_3a7f91c2","ts":1741824000}'
encoded_str: str = pybase64.b64encode_as_string(telemetry_event)

print(encoded_str[:48] + "...")
# eyJldmVudCI6InBhZ2VfdmlldyIsInNlc3Npb25faWQi...

# مقارنة الإنتاجية (تقريبية، تتفاوت بحسب العتاد)
# stdlib  base64.b64encode(1 MB):   ~80 MB/s
# pybase64.b64encode(1 MB):         ~800 MB/s (مسار SIMD على معالج AVX2)

pip install rich

import base64
import json
from rich import print as rprint
from rich.syntax import Syntax
from rich.console import Console

console = Console()

def decode_and_pretty_print(encoded: str, label: str = "الحمولة المفككة") -> None:
    """افكّ ترميز سلسلة Base64 وحلِّلها كـ JSON واطبعها مع تمييز بناء الجملة."""
    raw_bytes = base64.b64decode(encoded + "==")  # حشو متسامح
    try:
        parsed  = json.loads(raw_bytes)
        pretty  = json.dumps(parsed, indent=2, ensure_ascii=False)
        syntax  = Syntax(pretty, "json", theme="monokai", line_numbers=False)
        console.rule(f"[bold blue]{label}")
        console.print(syntax)
    except json.JSONDecodeError:
        # ليس JSON — اطبع النص الخام
        console.rule(f"[bold yellow]{label} (نص خام)")
        rprint(raw_bytes.decode("utf-8", errors="replace"))

# فحص مقطع حمولة JWT من طلب مصادقة فاشل
jwt_payload_segment = "eyJzdWIiOiJ1c3JfN2MzYTlmMWIyZCIsInJvbGUiOiJkYXRhLWVuZ2luZWVyIiwiZXhwIjoxNzQxOTEwNDAwfQ"
decode_and_pretty_print(jwt_payload_segment, "حمولة JWT")