kaiju-app

• Create and run apps
• How to use services
• Configuration guide
• Config specification
• Create packages
• Reference

Quickstart

kaiju-app - application and service base classes. They can be used as building blocks for various asyncio server applications. The library provides base classes, configuration loader and application builder and service dependency resolution mechanisms.

Installation

With pip and python 3.12+:

pip3 install kaiju-app

How to use

See the user guide for more info.

Create a service with custom methods, initialization and de-initialization.

from kaiju_app import Service

class CacheService(Service):

    def __init__(self, host: str, port: int, password: str):
        ...

    async def init(self):
        self._transport = await self._initialize_transport()

    async def close(self):
        self._transport.close()

    async def load_cache(self):
        ...

Create a loader and register your service class there.

from kaiju_app import ApplicationLoader

loader = ApplicationLoader()
loader.service_classes['CacheService'] = CacheService

Load your configuration using a configurator and create an application with your services in it. You may use JSON or YAML file loader here instead of implementing the whole config in Python.

from kaiju_app import Configurator, ProjectConfig, AppConfig, ServiceConfig

example_config = ProjectConfig(
    packages=[],
    logging={},
    app=AppConfig(
        name='my_app',
        env='dev',
        services=[
            ServiceConfig(
                cls='CacheService',
                settings={
                    'host': '[cache_host]',
                    'port': '[cache_port]',
                    'password': '[cache_password]'
                }
            )
        ]
    )
)

example_env = {
    'cache_host': 'localhost',
    'cache_port': 6379,
    'cache_password': 'qwerty'
}

configurator = Configurator()
config = configurator.create_configuration([example_config], [example_env])

The idea behind configuration is that it split on two types of files: config (template) files and env files. Config files are structured and must obey ProjectConfig special config format. Env files are flat and used to copy values from, so env file may be a simple plain JSON or a text file or a set of environment variables. You can use any number of template files and env files in your config - they will be merged.

The configurator uses template-dict to fill the templates.

Next you can pass the resulting config to the AppLoader and create an application which can be run in an asyncio loop. The run_app function allows you to run the app forever in an asyncio loop until a ctrl+C signal is received.

from kaiju_app import run_app

app = loader.create_all(config)
run_app(app)

License

MIT License

Copyright (c) 2024 violet-black

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.