Package: gaiaclient
Gaia Python ClientThis project introduces thin client for JOT Gaia HTTP API written on python. See API description bellow. Usage of the client is described on example.py.InstallationPreferred way to install is to use pippip install gaiaclientJOT Gaia HTTP API quick startGaia MachinesG5M BoxWhat it is?Low-ceremony, simple and self-assisting HATEOAS RestFul API for controlling JOT Automation Gaia platform testers.Browse the APIUse any web browser to browse through the API. Responses are in a JSON format so if your browser doesn't pretty print JSON automatically, you may want to install an extension that will do it for you. And yes everything you can do with the API is readable from the API itself.Gaia API followsSirenwith some additions.API is found from address [URL]/api, where URL is URL to your gaia machine or virtual gaia instance.ApplicationsEvery piece of hardware you want to control is an application. To list applications make GET request to URL/api/applications. You will get list of entities i.e. applications. To get more information about the application make GET request to "href". Now you will get all information about the application. To control the application see list of  actions on response.When you need to change state of entity (remember action is an entity), run robot movement or execute any other action, you need to find action field of the entity. Every action has the same structure.Action defines always:name (name is unique in the context of the gaia machine)href (URL of the action)fields (see bellow)type (content type, almost always application/json)method (POST or GET)title (Description of what the action does)If there is limited amount of options on fields they all are listed.Here I will list some applications types. This is not a comprehensive list of applications. The API itself will guide you to control any type of application and if you need assistance we are happy to help you.Stateful applicationsStateful application is type of application that defines limited number of states. In most cases there is two states: work/home, open/close etc.CNC robotCNC robot application is type of application that is able to execute robot movements defined as G-code.Stateful application action exampleHere is an example of a stateful application action (Snip from GEThttp://URL/api/applications/BatteryConnectorresponse){
  "type": "application/json",
  "href": "http://URL/api/applications/BatteryConnector/state",
  "requiredActions": {},
  "method": "POST",
  "stateConditions": {},
  "title": "Trigger state change to Home",
  "name": "set-Home",
  "fields": [
              {
                "type": "text",
                "name": "value",
                "value": "Home"
               }
            ]
}As you see there is some additional fields compared to standard action response. Those are used mainly for UI and can be omitted now. We are mainly interested on fields. To "trigger state change to Home"(title) you need to POST(method) to URL(href) with JSON(type) body containing field (fields) that has name "value" with value "Home". The whole command with cURL tool:curl -X POST -H "Content-Type: application/json" -d '{"value":"Work"}' http://URL/api/applications/BatteryConnector/stateCNC robot applicationHere is an example of a cnc application action (Snip from GEThttp://URL/api/applications/MainRobotresponse){
  "title": "Execute CNC/G-code run",
  "href": "http://URL/api/applications/MainRobot/cnc_run",
  "type": "text/plain",
  "method": "POST",
  "name": "cnc_run",
  "fields": [
              {
              "type": "text",
              "name": "G-code"
              }
            ]
}To "execute CNC/G-code run"(title) you need to POST(method) to URL(href) with text/plain(type) body containing G-code. The whole command with cURL tool:curl -X POST -H "Content-Type: text/plain" -d 'N010 G01 X133.964 Y41.984 Z73.5' http://URL/api/applications/MainRobot/cnc_runThis example contains only one line of G-code. Real G-codes are of course longer. Whole G-code is sent as is with linux line endings.Tool to use with G-code can be set with comment line before real G-code starts. Syntax is "(ToolToUse:Finger1)" without quotes.State actionsState actions do change state of main state machine. State actions are found fromhttp://URL/api.Blocked actions vs actionsIf it is not allowed to execute the action, the action is listed under blocked actions instead of actions.Client examplesWe have created free open-source clients to help the integration work. Find clients with example code here:.NET/C#PythonTips to create your own clientKeep it simple. As you can see from our examples we don't define application or action types on client side. Instead we call applications and actions by name. This way client side is super thin and still capable of controlling any application. Thus you don't need to introduce new application type on client side when new application type is introduced on server side.