hat-translator 0.4.0.dev20200430

Hat configuration transformation interface

Hat Open is open-source framework of tools and libraries for developing applications used for remote monitoring, control and management of intelligent electronic devices such as IoT devices, PLCs, industrial automation or home automation systems.

Hat Core is part of Hat Open providing collection of components and libraries on which Hat Open system is based.

Development of Hat Open and associated repositories is sponsored by Končar - Power Plant and Electric Traction Engineering Inc. (Končar KET - https://www.koncar-ket.hr).

For more information see:

• Hat Open homepage - in development

• Hat Core homepage - https://core.hat-open.com

• Hat Core documentation - https://core.hat-open.com/docs

• Hat Core git repository - https://github.com/hat-open/hat-core.git

• Hat Core issues - https://github.com/hat-open/hat-core/issues

Warning

This project is currently in state of active development. Features, functionality and API are unstable.

Installation

Hat Open consists of multiple interconnected parts. Each part implements a specific functionality. For easier reusability, provided implementation is split into multiple packages:

Python packages

Python packages require Python 3.8 and can be installed with pip:

$ pip install <package-name>

where package-name is one of following:

• hat-util (util docs)

  Utility module

• hat-peg (peg docs)

  Parsing expression grammar

• hat-sbs (sbs docs)

  Chatter communication protocol

• hat-chatter (chatter docs)

  Simple binary serialization

• hat-juggler (juggler docs)

  Juggler communication protocol

• hat-duktape (duktape docs)

  Python Duktape JS wrapper

• hat-sqlite3

  Hat specific sqlite3 build

• hat-drivers (drivers docs)

  Communication drivers

• hat-orchestrator (orchestrator docs)

  Simple cross-platform daemon/service manager

• hat-monitor (monitor docs)

  Redundancy and service discovery server

• hat-event (event docs)

  Event pub/sub communication and storage

• hat-gateway (gateway docs)

  Remote communication device gateway

• hat-gui (gui docs)

  GUI server

• hat-translator (translator docs)

  Configuration transformation interface

JavaScript packages

JavaScript packages can be installed with npm:

$ npm install <package-name>

where package-name is one of following:

• @hat-core/util

  Utility module

• @hat-core/renderer

  Virtual DOM renderer

• @hat-core/future

  Async Future implementation

• @hat-core/juggler

  Juggler client library

Build

Build tool used for Hat is pydoit (http://pydoit.org/). It can be installed with pip by running:

$ pip install doit

For listing available doit tasks, use:

$ doit list

Default task:

$ doit

creates dist folder containing built packages.

Dependencies

Package managers used for managing dependencies:

• pacman

  Package manager of Arch linux distribution. Available on Windows as part of msys2 (http://www.msys2.org/).

• pip

  Package manager available as part of CPython installation.

• yarn

  Package manager for NodeJS.

List of all dependencies for building and running hat components is available in:

• requirements.pacman.win.txt (windows only)

• requirements.pacman.linux.txt (archlinux only)

• requirements.pip.txt

• package.json

Python code targets CPython 3.8 only.

Documentation

Documentation can be built with:

$ doit docs

which creates build/docs folder containing documentation.