How zopefoundation/zope.component works
zope.component is a reusable implementation of the Zope Component Architecture: it registers adapters, utilities, handlers and factories, then resolves them through component lookup APIs. The principal workflow is to declare or configure components, register them with a site manager, and query that manager to obtain a component or adapted result. Event dispatch, site-specific lookup, persistent registries and security-aware configuration are distinct capabilities. Relationships below follow shown imports/calls and README statements; some source modules were indexed but not excerpted, so uncertain links are omitted.
Main entry points: _api.py Component API · zcml.py ZCML handlers · _declaration.py Adapter declarations · hooks.py Site hooks
Components 15
Registration
- Adapter declarations
src/zope/component/_declaration.py - ZCML handlers
src/zope/component/zcml.py - Global registry
src/zope/component/globalregistry.py - Registry events
src/zope/component/registry.py
Lookup
- Architecture contracts
src/zope/component/interfaces.py - Component API
src/zope/component/_api.py - Interface integration
src/zope/component/interface.py - Factory service
src/zope/component/factory.py
Runtime context
- Site hooks
src/zope/component/hooks.py - Persistent registry
src/zope/component/persistentregistry.py - Compatibility support
src/zope/component/_compat.py
Events and extensions
- Security adapters
src/zope/component/security.py - Event dispatch
src/zope/component/event.py - Event setup helpers
src/zope/component/eventtesting.py
Other components
- Application code
Connections 19
- Application code → Adapter declarations: declares adapters
src/zope/component/_declaration.py - Application code → ZCML handlers: configures components
README.rst - Adapter declarations → Global registry: registers components
- ZCML handlers → Component API: queues registration
src/zope/component/zcml.py - Application code → Component API: requests lookup
README.rst - Component API → Global registry: resolves through
src/zope/component/_api.py - Component API → Architecture contracts: uses contracts
src/zope/component/_api.py - Interface integration → Component API: uses lookup
src/zope/component/interface.py - Factory service → Architecture contracts: implements contract
src/zope/component/factory.py - Site hooks → Global registry: gets global manager
src/zope/component/hooks.py - Site hooks → Component API: sets lookup hooks
src/zope/component/hooks.py - ZCML handlers → Adapter declarations: reads declarations
src/zope/component/zcml.py - ZCML handlers → Security adapters: uses security wrappers
src/zope/component/zcml.py - Security adapters → Compatibility support: checks availability
src/zope/component/security.py - Site hooks → Compatibility support: checks availability
src/zope/component/hooks.py - Event dispatch → Component API: dispatches subscribers
src/zope/component/event.py - Event dispatch → Adapter declarations: declares event adapter
src/zope/component/event.py - Event setup helpers → Event dispatch: registers notifier
src/zope/component/eventtesting.py - Event setup helpers → Registry events: registers event handlers
src/zope/component/eventtesting.py