{"id":23416,"library":"certificates","title":"certificates","description":"A Python library for generating event certificates easily. Version 2.3.3 supports Python >=3.12, with a simple API to create PDF certificates from templates or data models. Active development on GitHub.","status":"active","version":"2.3.3","language":"python","source_language":"en","source_url":"https://github.com/cassiobotaro/certificates","tags":["certificates","pdf","event","generator"],"install":[{"cmd":"pip install certificates","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"PDF generation","package":"reportlab","optional":false},{"reason":"data validation for certificate models","package":"pydantic","optional":false}],"imports":[{"note":"Main class for creating a single certificate.","wrong":"","symbol":"Certificate","correct":"from certificates import Certificate"},{"note":"In older versions (pre-2.3) the class was in a submodule.","wrong":"from certificates.event import CertificateEvent","symbol":"CertificateEvent","correct":"from certificates import CertificateEvent"}],"quickstart":{"code":"from certificates import Certificate\nfrom datetime import datetime\n\ncert = Certificate(\n    name=\"Jane Doe\",\n    event=\"PyCon 2024\",\n    date=datetime(2024, 5, 10),\n    template=\"modern\"\n)\ncert.generate(\"jane_doe_certificate.pdf\")\nprint(\"Certificate generated!\")","lang":"python","description":"Create a basic certificate with default template and save as PDF."},"warnings":[{"fix":"Pass `template='modern'` or another valid template name.","message":"In version 2.3.0, the API was restructured: `Certificate` now requires a `template` argument (string). Omitting it will raise a TypeError.","severity":"breaking","affected_versions":">=2.3.0"},{"fix":"Change import to `from certificates import CertificateEvent`.","message":"The `from certificates.event import CertificateEvent` import path is deprecated since 2.3.0. Use `from certificates import CertificateEvent` instead.","severity":"deprecated","affected_versions":">=2.3.0,<3.0"},{"fix":"Ensure Python 3.12 or higher is used.","message":"The library requires Python >=3.12. Installing on older Python versions will fail.","severity":"gotcha","affected_versions":">=2.3.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install certificates` in your project environment.","cause":"The library is not installed or virtual environment not activated.","error":"ModuleNotFoundError: No module named 'certificates'"},{"fix":"Provide a template argument: `Certificate(..., template='modern')`.","cause":"Since version 2.3.0, `template` is a required parameter.","error":"TypeError: Certificate.__init__() missing 1 required positional argument: 'template'"},{"fix":"Use `from certificates import CertificateEvent` instead.","cause":"The submodule `event` was removed in 2.3.0; classes moved to top-level.","error":"AttributeError: module 'certificates' has no attribute 'event'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}