Container module

Provides an inversion-of-control (IoC) container used to facilitate the development of services and applications composed of loosely coupled components.

Important points

The module contains a basic in-memory container that can be embedded inside a service or application, or can be run by itself. It also has container type can run as a system level process and can be configured via command line arguments.
These containers can read configuration from JSON or YAML files, and use it as a recipe for instantiating and configuring components.
Component factories are used to create components based on their locators (descriptor) defined in the container configuration. The factories shall be registered in containers or dynamically in the container configuration file.

Packages

The module contains the following packages:

Containers - Basic in-memory and process containers
Build - Default container factory
Config - Container configuration components
Refer - Inter-container reference management (implementation of the Referenceable pattern inside an IoC container)

Use

Install the Python package as

pip install pip-services3-container

Create a factory to create components based on their locators (descriptors).

from pip_services3_commons.refer import Descriptor
from pip_services3_components.build import Factory


class MyFactory(Factory):
    MyComponentDescriptor = Descriptor("myservice", "mycomponent", "default", "*", "1.0")

    def __init__(self):
        super(MyFactory, self).__init__()
        self.register_as_type(MyFactory.MyComponentDescriptor, MyComponent)

Then, create a process container and register the factory there. You can also register factories defined in other modules if you plan to include external components into your container.

from pip_services3_container import ProcessContainer
from pip_services3_rpc.build import DefaultRpcFactory


class MyProcess(ProcessContainer):
    def __init__(self):
        super(MyProcess, self).__init__('myservice', 'My service running as a process')

        self._factories.add(DefaultRpcFactory())
        self._factories.add(MyFactory())

Define YAML configuration file with components and their descriptors. The configuration file is pre-processed using Handlebars templating engine that allows to inject configuration parameters or dynamically include/exclude components using conditional blocks. The values for the templating engine are defined via process command line arguments or via environment variables. Support for environment variables works well in docker or other containers like AWS Lambda functions.

---
# Context information
- descriptor: "pip-services:context-info:default:default:1.0"
  name: myservice
  description: My service running in a process container

# Console logger
- descriptor: "pip-services:logger:console:default:1.0"
  level: {{LOG_LEVEL}}{{^LOG_LEVEL}}info{{/LOG_LEVEL}}

# Performance counters that posts values to log
- descriptor: "pip-services:counters:log:default:1.0"
  
# My component
- descriptor: "myservice:mycomponent:default:default:1.0"
  param1: XYZ
  param2: 987
  
{{#if HTTP_ENABLED}}
# HTTP endpoint version 1.0
- descriptor: "pip-services:endpoint:http:default:1.0"
  connection:
    protocol: "http"
    host: "0.0.0.0"
    port: {{HTTP_PORT}}{{^HTTP_PORT}}8080{{/HTTP_PORT}}

 # Default Status
- descriptor: "pip-services:status-service:http:default:1.0"

# Default Heartbeat
- descriptor: "pip-services:heartbeat-service:http:default:1.0"
{{/if}}

To instantiate and run the container we need a simple process launcher.

import sys
from MyFactory import MyFactory

try:
    proc = MyProcess()
    proc._config_path = './config/config.yml'
    proc.run()
except Exception as ex:
    sys.stderr.write(ex)

And, finally, you can run your service launcher as

python service.py