twisted.application.service.IServiceCollection(Interface) interface documentationtwisted.application.service
(View In Hierarchy)
Known implementations: twisted.application.service.MultiService
Collection of services.
Contain several services, and manage their start-up/shut-down. Services can be accessed by name if they have a name, and it is always possible to iterate over them.
| Method | getServiceNamed | Get the child service with a given name. |
| Method | __iter__ | Get an iterator over all child services. |
| Method | addService | Add a child service. |
| Method | removeService | Remove a child service. |
Get the child service with a given name.
| Returns | (type: IService) | |
| Raises | KeyError | Raised if the service has no child with the given name. |
Add a child service.
Only implementations of IService.setServiceParent
should use this method.
| Raises | RuntimeError | Raised if the service has a child with the given name. |
Remove a child service.
Only implementations of IService.disownServiceParent
should use this method.
| Returns | a Deferred
which is triggered when the service has finished shutting down. If shutting
down is immediate, a value can be returned (usually, None). (type: Deferred) | |
| Raises | ValueError | Raised if the given service is not a child. |