{"id":1439,"date":"2026-01-29T09:41:05","date_gmt":"2026-01-29T08:41:05","guid":{"rendered":"https:\/\/ahassan.inscastellbisbal.net\/?page_id=1439"},"modified":"2026-01-29T10:38:12","modified_gmt":"2026-01-29T09:38:12","slug":"depuracio-del-codi-de-python","status":"publish","type":"page","link":"https:\/\/ahassan.inscastellbisbal.net\/?page_id=1439","title":{"rendered":"Depuraci\u00f3 del codi de Python"},"content":{"rendered":"\n

La depuraci\u00f3 (o debugging<\/em>) no \u00e9s nom\u00e9s l’acte de “arreglar el que est\u00e0 trencat”. En un entorn de producci\u00f3, \u00e9s una estrat\u00e8gia de defensa<\/strong> i una pe\u00e7a clau de l’experi\u00e8ncia d’usuari (UX). Un programa que falla sense explicaci\u00f3 perd la confian\u00e7a de l’usuari; un programa que no valida entrades \u00e9s una porta oberta a atacants.<\/p>\n\n\n\n

\n\n\n\n

1. La Depuraci\u00f3 com a pilar de Seguretat i UX<\/h2>\n\n\n\n

Seguretat: El perill de la confian\u00e7a<\/h3>\n\n\n\n

Si no depurem i validem, el sistema pot ser vulnerable a injeccions de codi o desbordaments de mem\u00f2ria. La depuraci\u00f3 permet identificar on el codi \u00e9s “fr\u00e0gil” davant d’entrades inesperades que un atacant podria aprofitar per saltar-se la l\u00f2gica de negoci.<\/p>\n\n\n\n

UX: La fallida silenciosa vs. la fallida graciosa<\/h3>\n\n\n\n
    \n
  • Crash (Mala UX):<\/strong> L’usuari prem un bot\u00f3, l’aplicaci\u00f3 es tanca o mostra un error 500 Internal Server Error<\/code>. L’usuari se sent frustrat i perd les dades no guardades.<\/li>\n\n\n\n
  • Gesti\u00f3 d’errors (Bona UX):<\/strong> El sistema detecta l’error, l’atura abans que bloquegi el servidor i mostra un missatge amable: “Sembla que el format del DNI no \u00e9s correcte, si us plau, revisa-ho”<\/em>.<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    2. Validaci\u00f3 d’Entrades i Integritat de Dades<\/h2>\n\n\n\n

    Validar dades com el DNI<\/strong> o el Correu Electr\u00f2nic<\/strong> no \u00e9s nom\u00e9s per est\u00e8tica, sin\u00f3 per garantir la integritat referencial<\/strong>:<\/p>\n\n\n\n

      \n
    1. Evitar el “Garbage In, Garbage Out”:<\/strong> Si guardem un DNI malament, mai podrem vincular correctament les tasques d’aquell usuari en el futur.<\/li>\n\n\n\n
    2. Consist\u00e8ncia:<\/strong> El format 12345678Z<\/code> ha de ser universal en tota la base de dades per permetre cerques i \u00edndexs eficients.<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n

      3. Implementaci\u00f3 en Python<\/h2>\n\n\n\n

      A continuaci\u00f3, presento un exemple d’un m\u00f2dul de registre d’usuaris que utilitza blocs try-except<\/code>, validacions amb expressions regulars (Regex) i un sistema de logs professional.<\/p>\n\n\n\n

      Python<\/p>\n\n\n\n

      import re\nimport logging\n\n# Configuraci\u00f3 del sistema de logs per rastrejar errors complexos\nlogging.basicConfig(\n    level=logging.INFO,\n    format='%(asctime)s - %(levelname)s - %(message)s',\n    handlers=[\n        logging.FileHandler(\"app_errors.log\"), # Desa els errors en un fitxer\n        logging.StreamHandler()                # Tamb\u00e9 els mostra per terminal\n    ]\n)\n\ndef validar_dni(dni):\n    \"\"\"Valida si un DNI t\u00e9 8 n\u00fameros i una lletra correcta.\"\"\"\n    lletres = \"TRWAGMYFPDXBNJZSQVHLCKE\"\n    if not re.match(r\"^\\d{8}[A-Z]$\", dni):\n        return False\n    \n    # L\u00f2gica matem\u00e0tica del DNI\n    numero = int(dni[:8])\n    lletra = dni[8]\n    return lletres[numero % 23] == lletra\n\ndef validar_email(email):\n    \"\"\"Valida el format d'un correu electr\u00f2nic.\"\"\"\n    regex = r'^[a-z0-9]+[\\._]?[a-z0-9]+[@]\\w+[.]\\w{2,3}$'\n    return re.search(regex, email)\n\ndef processar_registre(dades_usuari):\n    \"\"\"Funci\u00f3 principal amb gesti\u00f3 d'errors.\"\"\"\n    try:\n        logging.info(f\"Intentant processar registre per: {dades_usuari.get('email')}\")\n        \n        # 1. Validaci\u00f3 de dades\n        email = dades_usuari.get('email')\n        dni = dades_usuari.get('dni')\n\n        if not validar_email(email):\n            raise ValueError(f\"Format de correu inv\u00e0lid: {email}\")\n        \n        if not validar_dni(dni):\n            raise ValueError(f\"DNI no v\u00e0lid o lletra incorrecta: {dni}\")\n\n        # Simulaci\u00f3 d'inserci\u00f3 a base de dades\n        logging.info(\"Usuari validat correctament. Guardant a la BD...\")\n        # Aqu\u00ed aniria la l\u00f2gica de la PK i FK comentada anteriorment\n        \n    except ValueError as ve:\n        # Errors controlats de validaci\u00f3 (UX)\n        logging.warning(f\"Error de validaci\u00f3: {ve}\")\n        return {\"status\": \"error\", \"message\": str(ve)}\n    \n    except Exception as e:\n        # Errors cr\u00edtics (Seguretat\/Sistema)\n        logging.error(f\"Error cr\u00edtic inesperat: {e}\", exc_info=True)\n        return {\"status\": \"error\", \"message\": \"S'ha produ\u00eft un error intern. Torni a intentar-ho m\u00e9s tard.\"}\n\n# --- CAS D'\u00daS ---\nusuari_exemple = {\"email\": \"alumne@codi.cat\", \"dni\": \"12345678Z\"}\nresultat = processar_registre(usuari_exemple)\nprint(resultat)\n<\/code><\/pre>\n\n\n\n
      Vegem el proc\u00e9s de depuraci\u00f3<\/strong> de codi Python<\/strong> al Visual studio code<\/strong>.<\/p>\n\n\n\n
      Primer necessitem un codi<\/strong>, aix\u00ed que demanarem a qualsevol IA<\/strong> (Intel\u00b7lig\u00e8ncia Artificial<\/strong>) el codi<\/strong> de depuraci\u00f3<\/strong>.Un cop tinguem el nostre codi<\/strong><\/p>\n\n\n\n
      Obriu<\/strong> el codi<\/strong> del Visual Studio<\/strong> i a la part superior<\/strong> esquerra<\/strong> hi haur\u00e0 l’opci\u00f3 d‘obrir un fitxer nou.<\/strong><\/p>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Despr\u00e9s d’obrir el fitxer, enganxeu<\/strong> el vostre codi<\/strong> de depuraci\u00f3<\/strong> al fitxer.<\/p>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      despr\u00e9s d’enganxar el codi<\/strong> al fitxer superior<\/strong> inferior<\/strong> hi haur\u00e0 l’opci\u00f3 d’Executar<\/strong>(Run<\/strong>) el codi<\/strong>,Feu clic<\/strong> a la primera<\/strong> opci\u00f3<\/strong>.<\/p>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Despr\u00e9s d’aix\u00f2 ens demanen que seleccionem<\/strong> una opci\u00f3<\/strong> de les llibreria<\/strong> per depuracio<\/strong> del codi<\/strong>.farem clic<\/strong> a la primera<\/strong> opci\u00f3<\/strong> que tamb\u00e9 estigui marcada suggerit<\/strong>(Suggested<\/strong>).<\/p>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      I despr\u00e9s a la part superior apareixer\u00e0<\/strong> un terminal<\/strong> i all\u00e0 hi haur\u00e0 escrit<\/strong> que la depuraci\u00f3<\/strong> s’ha fet o si es produeix algun error<\/strong>, que ens ho recordar\u00e0<\/strong>.<\/p>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Justificaci\u00f3 dels elements utilitzats:<\/h3>\n\n\n\n
        \n
      • try-except-else<\/code><\/strong>: El bloc try<\/code> envolta nom\u00e9s el codi perill\u00f3s. L’\u00fas de ValueError<\/code> permet separar els errors d’usuari (dades mal introdu\u00efdes) dels errors de sistema (caiguda de la base de dades).<\/li>\n\n\n\n
      • logging.error(..., exc_info=True)<\/code><\/strong>: Aix\u00f2 \u00e9s vital per a la depuraci\u00f3. Captura el stack trace<\/em> complet (la l\u00ednia exacta on ha fallat), facilitant la feina al programador sense mostrar aquesta informaci\u00f3 sensible a l’usuari final.<\/li>\n\n\n\n
      • Regex (re<\/code>)<\/strong>: Garanteix que les dades segueixen un patr\u00f3 estricte abans de ser processades, actuant com un filtre de seguretat.<\/li>\n<\/ul>\n\n\n