zope-configuration

import sys from zope.interface import Interface, implementer from zope.configuration import xmlconfig from zope.component import getUtility, ComponentLookupError # --- Step 1: Define an interface and an implementation --- # These would typically reside in a real Python module. # For this self-contained quickstart, we simulate a module. class IMyService(Interface): """An interface for a dummy service.""" def do_something(): """Perform a dummy action.""" @implementer(IMyService) class MyService: """A simple implementation of IMyService.""" def do_something(self): return "Service action complete from ZCML!" # Simulate a module for ZCML to find the classes # In a real application, 'quickstart_module' would be a package with your classes. class DummyModule: IMyService = IMyService MyService = MyService sys.modules['quickstart_module'] = DummyModule # --- Step 2: Define a ZCML configuration string --- zcml_content = """ <configure xmlns="http://namespaces.zope.org/zope" i18n_domain="my.package"> <utility factory="quickstart_module.MyService" provides="quickstart_module.IMyService" name="my.unique.service" /> </configure> """ # --- Step 3: Load and process the ZCML configuration --- try: # xmlconfig.string processes the ZCML and registers components context = xmlconfig.string(zcml_content) # --- Step 4: Verify the utility was registered --- service = getUtility(IMyService, name="my.unique.service") print(f"Utility loaded successfully. Action: {service.do_something()}") except ComponentLookupError: print("Error: Utility not found after ZCML processing. Check ZCML registration.") except Exception as e: print(f"An error occurred during ZCML loading: {e}") finally: # Clean up the dummy module to avoid side effects in other tests/runs if 'quickstart_module' in sys.modules: del sys.modules['quickstart_module']