aasm 0.0.27

Agents Assembly translator

Agents Assembly Translator

Table of Contents

• About
• Getting Started
• Structure
• Design

About

A target agnostic translator for Agents Assembly.

Getting Started

Prerequisites

Python 3.10

Installation

The translator can be installed by running:

pip install aasm

If you are afraid of pip, you can download this repository. No additional dependencies are required.

Usage

You can run the translator as a package. To translate agent.aasm to SPADE, run:

python -m aasm.translate agent.aasm

For more information about usage run:

python -m aasm.translate --help

Structure

• generating
  • code.py - generated code
  • python_code.py - Python code base class
  • python_graph.py - Python graph code generation from the intermediate representation
  • python_spade.py - SPADE agent code generation from the intermediate representation
• intermediate
  • action.py
  • agent.py
  • argument.py - arguments used in instructions
  • behaviour.py
  • block.py - block of code representation
  • declaration.py - declarations used in actions
  • graph.py
  • instruction.py - instructions used in actions
  • message.py
• parsing
  • parse.py - parsing environment from Agents Assembly file
  • op/ - Agents Assembly operations
  • state.py - state definition used for the parsing process
• utils
  • exception.py
  • validation.py
  • iteration.py
• translate.py - entrypoint

Design

• Message
  • Parameter
    • Type
• Agent
  • Parameter
    • Type
    • Value
  • Behaviour
    • Type
    • Parameter
    • Received message
    • Actions
      • Message to be sent
      • Block
        • Declaration
          • Name
          • Argument
            • Types
        • Instruction
          • Argument
            • Types
        • Block
• Graph
  • Parameter