class twisted.application.service.IServiceCollection(Interface): (source)
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.
| Parameters | name | Undocumented (type: str) |
| Returns | Undocumented (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.
| Parameters | service | Undocumented (type: IService) |
| 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.
| Parameters | service | Undocumented (type: IService) |
| 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. |