isar 1.20.2__py3-none-any.whl → 1.34.9__py3-none-any.whl

{isar-1.20.2.dist-info → isar-1.34.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: isar
-Version: 1.20.2
+Version: 1.34.9
 Summary: Integration and Supervisory control of Autonomous Robots
 Author-email: Equinor ASA <fg_robots_dev@equinor.com>
 License: Eclipse Public License version 2.0
@@ -91,15 +91,18 @@ Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Eclipse Public License 2.0 (EPL-2.0)
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.11
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: alitra >=1.1.3
+Requires-Dist: alitra>=1.1.3
 Requires-Dist: azure-identity
 Requires-Dist: azure-keyvault-secrets
 Requires-Dist: azure-storage-blob
@@ -107,35 +110,43 @@ Requires-Dist: backoff
 Requires-Dist: click
 Requires-Dist: dacite
 Requires-Dist: fastapi-azure-auth
-Requires-Dist: fastapi
-Requires-Dist: injector
+Requires-Dist: fastapi>=0.121.0
+Requires-Dist: dependency-injector
 Requires-Dist: numpy
-Requires-Dist: opencensus-ext-azure
-Requires-Dist: opencensus-ext-logging
-Requires-Dist: opencensus-ext-requests
 Requires-Dist: paho-mqtt
-Requires-Dist: pydantic-settings
+Requires-Dist: pydantic_settings
 Requires-Dist: pydantic
 Requires-Dist: PyJWT
 Requires-Dist: python-dotenv
 Requires-Dist: PyYAML
 Requires-Dist: requests-toolbelt
 Requires-Dist: requests
+Requires-Dist: starlette>=0.49.1
 Requires-Dist: transitions
 Requires-Dist: uvicorn
+Requires-Dist: opentelemetry-api
+Requires-Dist: opentelemetry-sdk
+Requires-Dist: opentelemetry-exporter-otlp
+Requires-Dist: opentelemetry-instrumentation-fastapi
+Requires-Dist: azure-monitor-opentelemetry
+Requires-Dist: azure-monitor-opentelemetry-exporter>=1.0.0b38
+Requires-Dist: pymysql
+Requires-Dist: sqlalchemy
+Requires-Dist: psycopg2-binary
 Provides-Extra: dev
-Requires-Dist: black ; extra == 'dev'
-Requires-Dist: flake8 ; extra == 'dev'
-Requires-Dist: mypy ; extra == 'dev'
-Requires-Dist: myst-parser ; extra == 'dev'
-Requires-Dist: pip-tools ; extra == 'dev'
-Requires-Dist: pre-commit ; extra == 'dev'
-Requires-Dist: pytest-dotenv ; extra == 'dev'
-Requires-Dist: pytest-mock ; extra == 'dev'
-Requires-Dist: pytest-xdist ; extra == 'dev'
-Requires-Dist: pytest ; extra == 'dev'
-Requires-Dist: requests-mock ; extra == 'dev'
-Requires-Dist: sphinx ; extra == 'dev'
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pip-tools; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: requests-mock; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: testcontainers[mysql]; extra == "dev"
+Requires-Dist: alembic; extra == "dev"
+Dynamic: license-file
 
 # ISAR
 
@@ -228,12 +239,21 @@ ISAR_ROBOT_PACKAGE = isar_turtlebot
 ISAR_DEFAULT_MAP = turtleworld
 ```
 
+### Run with make
+Common commands for the project are in [Makefile](./Makefile).
+This requires the CLI program `make`.
+
+Usage:
+```bash
+make <command-in-makefile> # for example: make run
+```
+
 ### Run ISAR server
 
 To run ISAR:
 
 ```bash
-python main.py
+isar-start
 ```
 
 Note, running the full system requires that an implementation of a robot has been installed. See
@@ -253,21 +273,6 @@ In [this](./src/isar/config/predefined_missions) folder there are predefined def
 corresponding to `mission_id=1`. A new mission may be added by adding a new json-file with a mission description. Note,
 the mission IDs must be unique.
 
-### Running with docker-compose
-
-ISAR may be started with an instance of the [isar-robot](https://github.com/equinor/isar-robot) package by
-
-```shell
-docker-compose up --build
-```
-
-Provided that the simulator from [isar-turtlebot](https://github.com/equinor/isar-turtlebot) is running ISAR may be
-started with the turtlebot by
-
-```shell
-docker-compose -f docker-compose-turtlebot.yml up --build
-```
-
 ### Configuration
 
 The system consists of many configuration variables which may alter the functionality. As an example, it is possible to
@@ -293,6 +298,20 @@ There are two methods of specifying configuration.
    By adding environment variables with the prefix `ISAR_` to the [settings.env](./src/isar/config/settings.env) file
    the configuration variables will be overwritten by the values in this file.
 
+### Setup for testing
+To be able to execute the tests you need to set the `ISAR_ENV` environment variable beforehand. Depending on your operating system and the command line you are using you can use one of the following commands:
+
+**Bash/Zsh**
+```bash
+export ISAR_ENV=test
+```
+**Windows Command prompt**
+```cmd
+set ISAR_ENV=test
+```
+
+Remember to set `ISAR_ENV` back to `None` when you want to run `isar-start` afterwards.
+
 ### Running tests
 
 After following the steps in [Development](#install), you can run the tests:
@@ -343,24 +362,29 @@ The system consists of two main components.
 The state machine handles interaction with the robots API and monitors the execution of missions. It also enables
 interacting with the robot before, during and after missions.
 
-The state machine is based on the [transitions](https://github.com/pytransitions/transitions) package for Python. An visualization of the state machine can be seen below:
-![State Machine](./docs/state_machine_diagram.png)
+The state machine is based on the [transitions](https://github.com/pytransitions/transitions) package for Python. The following are some visualizations of the state machine:
+
+Mission behavior without the robot status changed transition that enable the resting states to transition between each other if the robot status changes:
+![State Machine extended](./docs/extended_state_machine_diagram.png)
+
+Robot status changed transition:
+![State Machine robot status changed](./docs/robot_status_state_machine_diagram.png)
+
+Full state machine:
+![State Machine full](./docs/full_state_machine_diagram.png)
 
 In general the states
 
 ```
-States.Off,
-States.Initialize,
-States.Initiate,
-States.Stop,
+States.Stopping,
 States.Monitor,
 States.Paused,
 ```
 
-indicates that the state machine is already running. For running a mission the state machine need to be in the state
+indicates that the state machine is already running. For running a mission the state machine need to be in the states
 
 ```
-States.Idle
+States.Home, States.AwaitNextMission or States.ReturningHome
 ```
 
 ### FastAPI
@@ -382,10 +406,10 @@ overriding the configuration through an environment variable. It accepts a json
 in the list to retrieve the corresponding handler. The current options are
 
 ```
-ISAR_STORAGE = '["local", "blob", "slimm"]'
+ISAR_STORAGE = '["local", "blob"]'
 ```
 
-Note that the `blob` and `slimm` options require special configuration to authenticate to these endpoints.
+Note that the `blob` option requires special configuration to authenticate to these endpoints.
 
 ### Implement your own storage module
 
@@ -393,68 +417,6 @@ You can create your own storage module by implementing the [storage interface](.
 and adding your storage module to the selection [here](./src/isar/modules.py). Note that you must add your module as an
 option in the dictionary.
 
-## Task selection
-
-The tasks of a mission are selected based on a task selector module, defined by the `TASK_SELECTOR` configuration variable. The default task selector is `sequential`. When using the default module, tasks are executed in sequential order defined by the current input mission.
-
-### Implement you own task selector module
-
-Custom task selector modules may be added by implementing additional versions of the [task selector interface](./src/isar/mission_planner/task_selector_interface.py).
-
-For every custom module, the interface function `next_task()` must be implemented. All interface implementations by default have access to the list of tasks in the current mission through the member `self.tasks`, however additional variables may be supplied by adding arguments to `next_task()`. To comply with the interface definition, the function should return the next task upon every call, and raise the `TaskSelectorStop` exception when all tasks in the current mission have been completed:
-
-```python
-class CustomTaskSelector(TaskSelectorInterface):
-    ...
-    def next_task(...) -> Task:
-
-        # Add code here
-        ...
-
-        # Raise `TaskSelectorStop` when all tasks have been completed
-        ...
-```
-
-Optionally, the `initialize()` function may be extended by supplementing the parameter list or function body:
-
-```python
-class CustomTaskSelector(TaskSelectorInterface):
-    ...
-    def initialize(self, tasks: List[Task], ...) -> None:
-        super.initialize(tasks=tasks)
-
-        # Add supplementary code here
-        ...
-```
-
-A custom task selector may be made available during [module selection](./src/isar/modules.py) by adding it to the series of options in the dictionary of injector modules. It can then be activated by overriding the task selector configuration variable:
-
-```python
-# Add custom task selector module to `modules.py`
-
-class CustomTaskSelectorModule(Module):
-    @provider
-    @singleton
-    def provide_task_selector(self) -> TaskSelectorInterface:
-        return CustomTaskSelector()
-
-...
-
-# Make it available to select during injector instantiation
-
-modules: dict[str, tuple[Module, Union[str, bool]]] = {
-    ...
-    "task_selector": (
-        {
-            "sequential": SequentialTaskSelectorModule,
-            "custom": CustomTaskSelectorModule
-        }
-        ...
-    )
-    ...
-}
-```
-
 ## API authentication
 
 The API has an option to include user authentication. This can be enabled by setting the environment variable
@@ -471,6 +433,7 @@ Enabling API authentication also requires the same environment variables. The re
 AZURE_CLIENT_ID
 AZURE_TENANT_ID
 AZURE_CLIENT_SECRET
+ISAR_BLOB_STORAGE_ACCOUNT
 ```
 
 ## MQTT communication

isar-1.34.9.dist-info/RECORD

@@ -0,0 +1,135 @@
+isar/__init__.py,sha256=cH8p8bVveu3FUL6kBhldcSlLaoHgD82Kd0-SwSNfGXw,87
+isar/modules.py,sha256=2bo4Z4H2n4vl9BVwV5V5twOUevsLIuXsPiRPICjCB3k,4404
+isar/script.py,sha256=mkwdRMEYW2HI9eFLyFy23Ks1_vvrsp17b8VlvkhrNao,5913
+isar/apis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/apis/api.py,sha256=0s0C1l5qGhko8rzm4D3y27mwibk_S2s2o95eAl7bH3k,16126
+isar/apis/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/apis/models/models.py,sha256=UqIzHiqrvI-ICi6H_xlBFH2HHgYHnMWAKlnqrdqM380,2099
+isar/apis/models/start_mission_definition.py,sha256=v-wt1XDd53Sw7DCdFAkxBBut-xd_uGJa7qMJnE3VI9k,6364
+isar/apis/robot_control/robot_controller.py,sha256=RSVlxbw9D668tHWItVLtyjvAnsJkCs2yUSkU3iqeAcY,1393
+isar/apis/schedule/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/apis/schedule/scheduling_controller.py,sha256=oyUSo0MdKB24cB796GcfdSzw6-pendz9Thtrh9yAlvc,10890
+isar/apis/security/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/apis/security/authentication.py,sha256=Se2puhe2TUBmfio2RLma52-VSLRhqvWgu0Cd1bhdwMo,2000
+isar/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/config/configuration_error.py,sha256=rO6WOhafX6xvVib8WxV-eY483Z0PpN-9PxGsq5ATfKc,46
+isar/config/log.py,sha256=16qEMVKWrAc5I9xgE0xZQBpuYpy7wMz9NT19JVBZlf4,2218
+isar/config/logging.conf,sha256=skjTp6AsXQGW6L6DeMxGszD-XvWu1BAVWjDipQ4QHvU,854
+isar/config/open_telemetry.py,sha256=Lgu0lbRQA-zz6ZDoBKKk0whQex5w18jl1wjqWzHUGdg,3634
+isar/config/settings.py,sha256=BmcLwk4_MODG1NVuFsbu2W__t68rlmMozzJFWbI4zkQ,12289
+isar/config/certs/ca-cert.pem,sha256=qoNljfad_qcMxhXJIUMLd7nT-Qwf_d4dYSdoOFEOE8I,2179
+isar/config/keyvault/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/config/keyvault/keyvault_error.py,sha256=zvPCsZLjboxsxthYkxpRERCTFxYV8R5WmACewAUQLwk,41
+isar/config/keyvault/keyvault_service.py,sha256=TEAJv5RlWnYvy-n9keivdATDafdTQDj4QY8Aw3SEKoU,3124
+isar/config/maps/JSP1_intermediate_deck.json,sha256=fdotzN6MVotyLbqpIjRSrbBYM84vogLkdS585NjBnL8,826
+isar/config/maps/JSP1_weather_deck.json,sha256=_dG3cSBI8q4_uHqHMOO5kSYqMXn85JL3_9PaH4uk1yQ,832
+isar/config/maps/default_map.json,sha256=3CdGMr0Qn3PrL4TfUK8I5a-hotMrS_n5DKfaEORJPT4,776
+isar/config/maps/klab_b.json,sha256=qXgWVUYPaTdVuomf6lQL-uRbV3Tsa6CftnzcbT3dY78,842
+isar/config/maps/klab_compressor.json,sha256=1Vrk5u_l4WXjrTtG4YfXlrCPbOoRs4TtYHOm0430u2A,803
+isar/config/maps/klab_turtlebot.json,sha256=HcB79XFEdY0Wm96EssIFO4TMyAWzc2KENoqN7TbTT0k,823
+isar/config/maps/turtleworld.json,sha256=EKLMpSK9Gu2lAN-E9l41XOaO3f9Su5n_I97mA6z7sWY,764
+isar/config/predefined_mission_definition/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/config/predefined_mission_definition/default_exr.json,sha256=diSi4KMnGQY01ZumYUBZDvrekgl4bgiTk-9YPXVeBCY,1550
+isar/config/predefined_mission_definition/default_mission.json,sha256=NAspX-kTaHh9VygJGrytJGNjebEIPbiTnWHhj7qt9rk,2722
+isar/config/predefined_mission_definition/default_turtlebot.json,sha256=20ee7q1EIx7bIIojMucSwdBafuCG5sewbMQn9gJuPEo,3704
+isar/config/predefined_missions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/config/predefined_missions/default.json,sha256=eBVuHXRoXELpzN0IbSOHdTVjZnhxFqJQf6h67Ez4Iqk,1243
+isar/config/predefined_missions/default_extra_capabilities.json,sha256=ddYx54xvz1w5hSS5i6YrHOj8-4YMmtuolLXVha4kLvE,2157
+isar/eventhandlers/eventhandler.py,sha256=xM5wmrYO3nQtxxsGt-s98ajKhfl3bCMajqtJ29CoGyo,3816
+isar/mission_planner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/mission_planner/local_planner.py,sha256=Mkg3vvUBF1jImfQnaFvXLNpKVadR21X4mwDd_wHqJ2w,2520
+isar/mission_planner/mission_planner_interface.py,sha256=UgpPIM4FbrWOD7fGY3Ul64k3uYb8wo0FwSWGewYoVbc,485
+isar/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/models/events.py,sha256=zE2YQoWzfuVTDLX99YdXb4wu6lmc_KZlwWYQAxiNfvA,6262
+isar/models/status.py,sha256=ed_CZH08IFwIKwX0t1U6MQpq5tax2LwWrTe_TjII5mg,506
+isar/robot/robot.py,sha256=gw8MI_mLLY1uEFn7xMEFGcz1uBJO6MWH4JXGxbELm2k,15138
+isar/robot/robot_battery.py,sha256=goLdgmn61QCgE2Ja3YuiwE_sqJzIhCkS3u90sz1kdug,2089
+isar/robot/robot_monitor_mission.py,sha256=Pb0dhnVncNt6VuiidlJDyniEXiqoO1ZArSCdWCqX6IY,13831
+isar/robot/robot_pause_mission.py,sha256=2zVQLh1Qoo-PIgpYUd6IBA39EJ1azIGh_lV1b9BeXqk,2631
+isar/robot/robot_resume_mission.py,sha256=naseBgY3mX1p4lsfW2lW_bocuHO59VHx3fhprxi3Nf0,2417
+isar/robot/robot_start_mission.py,sha256=UFwhSTBbCo-R4FO-BnrCB7bnvOkL1p_0CMDuxnSWi5E,2435
+isar/robot/robot_status.py,sha256=dfAls3s8_Vha7ZMLSYngELqsdpaEpcweAWRHanQj8u8,2361
+isar/robot/robot_stop_mission.py,sha256=CaXLsZjjazHmydU9iR7uOWUHtJ2zvKh4ItUbkWY5sIk,2321
+isar/robot/robot_upload_inspection.py,sha256=uCc9nuH1Am5uxD2Tgnm4ZTOm0tQnud0F6eHs0rSUfvY,2539
+isar/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/services/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/services/auth/azure_credentials.py,sha256=9PlwGe5FrPRbW2dp0go7LMp8_l_FRvL8xOXotXwzRDo,364
+isar/services/service_connections/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/services/service_connections/persistent_memory.py,sha256=duNj5vX4VtL5XCu6oiZ0VPmNMlFbNJMzcLcQL8nNfN8,2188
+isar/services/service_connections/request_handler.py,sha256=0LxC0lu_HXeEf_xmJWjfEsh14oAUI97cpG1IWtBlcs4,4278
+isar/services/service_connections/mqtt/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/services/service_connections/mqtt/mqtt_client.py,sha256=8Dr65JNwPx5-kRY8UsRtZ_nrQ2gXXSUH6LWFOYlnluo,4482
+isar/services/service_connections/mqtt/robot_heartbeat_publisher.py,sha256=SKPvY2QwBxqnhL9aGuZQDGQ8F_NDqPtQI5bzRBIUxkQ,1203
+isar/services/service_connections/mqtt/robot_info_publisher.py,sha256=AxokGk51hRPTxxD2r0P9braPJCMrf1InaCxrUBKkF4g,1402
+isar/services/utilities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/services/utilities/mqtt_utilities.py,sha256=_e-UzWcoXvsBUrvb89rNXQaDN4G3rTsYlZRIhmC9fQc,3101
+isar/services/utilities/robot_utilities.py,sha256=4zCigsLXfqDC8POHchktSq81zr1_pTaRve_LQsVr6Mk,514
+isar/services/utilities/scheduling_utilities.py,sha256=wxLBc7l6Pc6y0aLRP-gOzBMfKUs-xg8BA9QiNdBG7bU,23814
+isar/services/utilities/threaded_request.py,sha256=py4G-_RjnIdHljmKFAcQ6ddqMmp-ZYV39Ece-dqRqjs,1874
+isar/state_machine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/state_machine/state_machine.py,sha256=Kmys0yIpsBuBxPrcqHo3FYDfAfx34haHfczihHYLmEU,13669
+isar/state_machine/states_enum.py,sha256=1jiON-PJCDWIA0VHtI0AUFlWeVtbWbGijShVJyViqwI,1012
+isar/state_machine/states/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/state_machine/states/await_next_mission.py,sha256=IJ79RuPveK6xBnHHkMldZ8LJybLfhMcS812t7-I6-iU,4381
+isar/state_machine/states/blocked_protective_stop.py,sha256=Ya5GIZS81olGoTXqKVjDaUXfl3zR6FxdsUXktPJIU80,2578
+isar/state_machine/states/going_to_lockdown.py,sha256=dmOhTkg3zNLIIdxfC9b5ss0rWu-pHm-yol2ASoOIUqo,3879
+isar/state_machine/states/going_to_recharging.py,sha256=CMtA9hmiW8XmH7Skj3B0_IAtdZcJCNt_qAvUL0Rmqgg,3562
+isar/state_machine/states/home.py,sha256=IfAFi9bDvoqNaJRahAw8tQwRQ2Wg84kI-nAmtzXp75U,4856
+isar/state_machine/states/intervention_needed.py,sha256=DmRm5bQYxUzTRCwYiFN9L4bRXWSdGgDKCBwh-hV6ySo,3156
+isar/state_machine/states/lockdown.py,sha256=ZFw9XMDENECuH3lh89RKeU_3CTzW0ZBvqCKptFJG5xo,1364
+isar/state_machine/states/maintenance.py,sha256=PIlPLtS7zn5uTJZ9kTrpOQGUuJww4j5vD-qaNcoj7aI,1267
+isar/state_machine/states/monitor.py,sha256=WYhCkZAfsGoqO092jvnuSJEspY5gBje__-pf4nuGEDY,6267
+isar/state_machine/states/offline.py,sha256=FbchMo1q2d0aZUiDj9VWuD1IAha7sD1d8e5MqyR_JBc,2564
+isar/state_machine/states/paused.py,sha256=-XRjjMpzKgKQZ7oYmI1bAZXNbtti1KHlH0tt59Cv0eg,4149
+isar/state_machine/states/pausing.py,sha256=Q0yH9iTWA-2yGGsD_atb_bqFJG8cApPfmd_TdcGvRbY,1693
+isar/state_machine/states/pausing_return_home.py,sha256=yEMojzOwn6z2u80S1BF2gVVgs3SOLk90LscO3DIj1R8,1740
+isar/state_machine/states/recharging.py,sha256=9VszfV5zAPOaAcI_k_if6uapu7lO3XDWj6GbvnldnEI,3143
+isar/state_machine/states/resuming.py,sha256=Evh9gxxntKwY8MKM4gn0Sq-H9DpMx6RRJrID57LIv4Y,2071
+isar/state_machine/states/resuming_return_home.py,sha256=YZhHno_WdtR5DkoeKmsN4jALmTXcOdWgOGZ0d8Tz2HQ,2414
+isar/state_machine/states/return_home_paused.py,sha256=598K-hKMxjZZf3iVWDaOOauAETSwJxxDbU1wlHnt9UM,4485
+isar/state_machine/states/returning_home.py,sha256=oXc7Ou7lhzLSm4oZocoiB_4I2vUyxzt2CvJP6wAJhRs,9196
+isar/state_machine/states/stopping.py,sha256=B2tcd4jaSOXEkTrd5BnNfMVrzM9wRkJm5hnmM7gxUc0,2484
+isar/state_machine/states/stopping_due_to_maintenance.py,sha256=Mjbwf6bQIB0ihBKrsTxnCCUzkIe0LNybVHiLGzcXSNA,2561
+isar/state_machine/states/stopping_go_to_lockdown.py,sha256=_w9yL8Uq2E6W97-ccp9NJvbfjV2hv87LEK_skS5Jhqg,2327
+isar/state_machine/states/stopping_go_to_recharge.py,sha256=02i37QI_551o-i_Ejc3Z9_xuI9o0g8e6WKCXcwkW2ac,1923
+isar/state_machine/states/stopping_return_home.py,sha256=sKA0tZASme_XVHEj0mwotfiKjFtCZ-FB-y1IoPaj9q4,3089
+isar/state_machine/states/unknown_status.py,sha256=oL92_66TDBwsIELdfqWvFvZ8NkY4oOLaGYKdZHsxAB4,3171
+isar/state_machine/transitions/mission.py,sha256=coHW4Mo3HdEzjolNg6FIppTcU_g_GCvAkr3gU0ERwXc,7317
+isar/state_machine/transitions/return_home.py,sha256=G9mxFpM7IR5NNq7JC-Cbign7XAMC_d7vOkVxCBFVNGE,3701
+isar/state_machine/transitions/robot_status.py,sha256=60EAb1LwuOfk1TPDCgh8S5FBgcZAPHdC2KtCGDrsQrM,2763
+isar/state_machine/utils/common_event_handlers.py,sha256=lBoreI1EuXrqmMkkPIZiy3yCLBDTShW_EFUxMGrCQVE,2492
+isar/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+isar/storage/blob_storage.py,sha256=d44z3XpZDUbiKwN8Av2gytTJxnefMXrp5VhiGm4PWxU,3703
+isar/storage/local_storage.py,sha256=Rn-iiiz9DI7PzIhevOMshPIaqzJaqBXeVJMQRhVSl2M,2191
+isar/storage/storage_interface.py,sha256=x-imVeQTdL6dCaTaPTHpXwCR6N4e27WxK_Vpumg0x-Y,1230
+isar/storage/uploader.py,sha256=0BBrxyZGGRkNxGeZeoREucegs4yKUow2523oLEie07o,10841
+isar/storage/utilities.py,sha256=oLH0Rp7UtrQQdilfITnmXO1Z0ExdeDhBImYHid55vBA,3449
+isar-1.34.9.dist-info/licenses/LICENSE,sha256=3fc2-ebLwHWwzfQbulGNRdcNob3SBQeCfEVUDYxsuqw,14058
+robot_interface/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/robot_interface.py,sha256=s04zOYDpnUu3GxUyDo3DlX1cFf94DmSt-GrwsFPgnYw,9357
+robot_interface/test_robot_interface.py,sha256=FV1urn7SbsMyWBIcTKjsBwAG4IsXeZ6pLHE0mA9EGGs,692
+robot_interface/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/models/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/models/exceptions/robot_exceptions.py,sha256=7extsX9NuJsJ00xeTQ0aI7yeVGW-dzjbH-LH8Mc-uEQ,10821
+robot_interface/models/initialize/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/models/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/models/inspection/inspection.py,sha256=cjAvekL8r82s7bgukWeXpYylHvJG_oRSCJNISPVCvZg,2238
+robot_interface/models/mission/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/models/mission/mission.py,sha256=MQ9p5cuclLXexaZu9bkDh5-aN99eunvYC0vP-Z_kUwI,960
+robot_interface/models/mission/status.py,sha256=3KHA02Jer-HSOwFmUhRkE6cr81H1zPgbwB3p4IjchEY,702
+robot_interface/models/mission/task.py,sha256=SEsdR82CIcqTymecMqYjuY3Nijj_LS90YJdxiConJag,4207
+robot_interface/models/robots/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/models/robots/battery_state.py,sha256=ktOtJ8ltdK0k_i7BoqYfhc5dbOzIG6Oo-uWC67fCWio,98
+robot_interface/models/robots/media.py,sha256=8A-CuuubfngzPprs6zWB9hSaqe3jzgsE8rcCzRX2Uto,227
+robot_interface/models/robots/robot_model.py,sha256=-0jNKWPcEgtF_2klb1It3u0SCoAR0hSW9nce58Zq0Co,417
+robot_interface/telemetry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/telemetry/mqtt_client.py,sha256=0P1S9mWdJcByGoSOwwn2NPQr9I-OX4b1VPbrIYOU-Zo,4334
+robot_interface/telemetry/payloads.py,sha256=A0SWiG609k6o6-Y3vhDWE6an2-_m7D_ND85ohfW4qWs,3236
+robot_interface/utilities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robot_interface/utilities/json_service.py,sha256=9N1zijW7K4d3WFR2autpaS8U9o1ibymiOX-6stTKCyk,1243
+robot_interface/utilities/uuid_string_factory.py,sha256=_NQIbBQ56w0qqO0MUDP6aPpHbxW7ATRhK8HnQiBSLkc,76
+isar-1.34.9.dist-info/METADATA,sha256=LmXJhW-UywCqnF6C2sLVOJ_Lr6JVJfa9yq7ESgZL7L4,29271
+isar-1.34.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+isar-1.34.9.dist-info/entry_points.txt,sha256=RdnGYFhaBdMGEsOVJAAZxHCflEptjSisHqZ-Rgc4t7Q,98
+isar-1.34.9.dist-info/top_level.txt,sha256=UwIML2RtuQKCyJJkatcSnyp6-ldDjboB9k9JgKipO-U,21
+isar-1.34.9.dist-info/RECORD,,

{isar-1.20.2.dist-info → isar-1.34.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{isar-1.20.2.dist-info → isar-1.34.9.dist-info}/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
 isar-start = isar.script:start
+isar-test-print = isar.script:print_startup_info

robot_interface/models/exceptions/robot_exceptions.py

@@ -4,23 +4,27 @@ from typing import Optional
 
 
 class ErrorReason(str, Enum):
-    RobotCommunicationException: str = "robot_communication_exception"
-    RobotCommunicationTimeoutException: str = "robot_communication_timeout_exception"
-    RobotInfeasibleStepException: str = "robot_infeasible_step_exception"
-    RobotInfeasibleMissionException: str = "robot_infeasible_mission_exception"
-    RobotMissionStatusException: str = "robot_mission_status_exception"
-    RobotStepStatusException: str = "robot_step_status_exception"
-    RobotAPIException: str = "robot_api_exception"
-    RobotActionException: str = "robot_action_exception"
-    RobotInitializeException: str = "robot_initialize_exception"
-    RobotRetrieveDataException: str = "robot_retrieve_data_exception"
-    RobotRetrieveInspectionException: str = "robot_retrieve_inspection_exception"
-    RobotTelemetryException: str = "robot_telemetry_exception"
-    RobotMapException: str = "robot_map_exception"
-    RobotTransformException: str = "robot_transform_exception"
-    RobotUnknownErrorException: str = "robot_unknown_error_exception"
-    RobotDisconnectedException: str = "robot_disconnected_exception"
-    RobotMissionNotSupportedException: str = "robot_mission_not_supported_exception"
+    RobotCommunicationException = "robot_communication_exception"
+    RobotCommunicationTimeoutException = "robot_communication_timeout_exception"
+    RobotInfeasibleTaskException = "robot_infeasible_task_exception"
+    RobotInfeasibleMissionException = "robot_infeasible_mission_exception"
+    RobotUnreliableDockingStatusException = "robot_unreliable_docking_status_exception"
+    RobotMissionStatusException = "robot_mission_status_exception"
+    RobotTaskStatusException = "robot_task_status_exception"
+    RobotAPIException = "robot_api_exception"
+    RobotActionException = "robot_action_exception"
+    RobotRetrieveDataException = "robot_retrieve_data_exception"
+    RobotRetrieveInspectionException = "robot_retrieve_inspection_exception"
+    RobotStillStartingMissionException = "robot_still_starting_mission_exception"
+    RobotTelemetryException = "robot_telemetry_exception"
+    RobotTelemetryNoUpdateException = "robot_telemetry_no_update_exception"
+    RobotTelemetryPoseException = "robot_telemetry_pose_exception"
+    RobotMapException = "robot_map_exception"
+    RobotTransformException = "robot_transform_exception"
+    RobotUnknownErrorException = "robot_unknown_error_exception"
+    RobotDisconnectedException = "robot_disconnected_exception"
+    RobotNoMissionRunningException = "robot_no_mission_running_exception"
+    RobotAlreadyHomeException = "robot_already_home_exception"
 
 
 @dataclass
@@ -39,7 +43,7 @@ class RobotException(Exception):
 
 
 # An exception which should be thrown by the robot package if it is unable to
-# communicate with the robot API.
+# communicate with the robot API. ISAR will retry the request.
 class RobotCommunicationException(RobotException):
     def __init__(self, error_description: str) -> None:
         super().__init__(
@@ -50,6 +54,18 @@ class RobotCommunicationException(RobotException):
     pass
 
 
+# An exception which should be thrown by the robot package if it is unable to
+# complete a request as there is no ongoing mission.
+class RobotNoMissionRunningException(RobotException):
+    def __init__(self, error_description: str) -> None:
+        super().__init__(
+            error_reason=ErrorReason.RobotNoMissionRunningException,
+            error_description=error_description,
+        )
+
+    pass
+
+
 # An exception which should be thrown by the robot package if the communication has timed
 # out and ISAR should retry the request.
 class RobotCommunicationTimeoutException(RobotException):
@@ -63,11 +79,11 @@ class RobotCommunicationTimeoutException(RobotException):
 
 
 # An exception which should be thrown by the robot package if it is unable to start the
-# current step.
-class RobotInfeasibleStepException(RobotException):
+# current task.
+class RobotInfeasibleTaskException(RobotException):
     def __init__(self, error_description: str) -> None:
         super().__init__(
-            error_reason=ErrorReason.RobotInfeasibleStepException,
+            error_reason=ErrorReason.RobotInfeasibleTaskException,
             error_description=error_description,
         )
 
@@ -86,6 +102,16 @@ class RobotInfeasibleMissionException(RobotException):
     pass
 
 
+class RobotUnreliableDockingStatusException(RobotException):
+    def __init__(self, error_description: str) -> None:
+        super().__init__(
+            error_reason=ErrorReason.RobotUnreliableDockingStatusException,
+            error_description=error_description,
+        )
+
+    pass
+
+
 # An exception which should be thrown by the robot package if it is unable to collect
 # the status of the current mission.
 class RobotMissionStatusException(RobotException):
@@ -99,11 +125,11 @@ class RobotMissionStatusException(RobotException):
 
 
 # An exception which should be thrown by the robot package if it is unable to collect
-# the status of the current step.
-class RobotStepStatusException(RobotException):
+# the status of the current task.
+class RobotTaskStatusException(RobotException):
     def __init__(self, error_description: str) -> None:
         super().__init__(
-            error_reason=ErrorReason.RobotStepStatusException,
+            error_reason=ErrorReason.RobotTaskStatusException,
             error_description=error_description,
         )
 
@@ -135,19 +161,6 @@ class RobotActionException(RobotException):
     pass
 
 
-# An exception which should be thrown by the robot package if something is wrong during
-# the initialization of the robot. This exception will cause the mission to fail as
-# initialization is performed prior to starting the mission.
-class RobotInitializeException(RobotException):
-    def __init__(self, error_description: str) -> None:
-        super().__init__(
-            error_reason=ErrorReason.RobotInitializeException,
-            error_description=error_description,
-        )
-
-    pass
-
-
 # An exception which should be thrown by the robot package if it is unable to retrieve
 # data from the API like currently executing missions, status of the current mission
 # and similar.
@@ -162,7 +175,7 @@ class RobotRetrieveDataException(RobotException):
 
 
 # An exception which should be thrown by the robot package if it is unable to collect
-# the inspections that were generated for the currently executing step or mission.
+# the inspections that were generated for the currently executing task or mission.
 class RobotRetrieveInspectionException(RobotException):
     def __init__(self, error_description: str) -> None:
         super().__init__(
@@ -173,6 +186,19 @@ class RobotRetrieveInspectionException(RobotException):
     pass
 
 
+# An exception which should be thrown by the robot package if it is still starting the
+# mission when another action is requested. An example of this can be trying to stop
+# the robot while it is still starting the mission.
+class RobotStillStartingMissionException(RobotException):
+    def __init__(self, error_description: str) -> None:
+        super().__init__(
+            error_reason=ErrorReason.RobotStillStartingMissionException,
+            error_description=error_description,
+        )
+
+    pass
+
+
 # An exception which should be thrown by the robot package if it is unable to retrieve
 # telemetry data. It should be used exclusively by the telemetry publishers and their
 # functions.
@@ -186,6 +212,29 @@ class RobotTelemetryException(RobotException):
     pass
 
 
+# An exception which should be thrown by the robot package if it is unable to retrieve
+# telemetry pose data. It should be used exclusively by the telemetry pose publisher.
+class RobotTelemetryPoseException(RobotException):
+    def __init__(self, error_description: str) -> None:
+        super().__init__(
+            error_reason=ErrorReason.RobotTelemetryPoseException,
+            error_description=error_description,
+        )
+
+    pass
+
+
+# An exception which should be thrown by the robot package if there is no new telemetry update.
+class RobotTelemetryNoUpdateException(RobotException):
+    def __init__(self, error_description: str) -> None:
+        super().__init__(
+            error_reason=ErrorReason.RobotTelemetryNoUpdateException,
+            error_description=error_description,
+        )
+
+    pass
+
+
 # An exception which should be thrown by the robot package if it is unable to load the
 # configuration for maps and transformations. This could be caused by faulty
 # configuration and this exception will cause ISAR to crash as further execution is not
@@ -235,11 +284,12 @@ class RobotDisconnectedException(RobotException):
     pass
 
 
-# An exception which should be thrown by the robot package if the robot is given a mission type it cannot run, such as a localisation mission
-class RobotMissionNotSupportedException(RobotException):
+# An exception which should be thrown by the robot package if the robot receives a command
+# to go home and decide to ignore this request as it is already at home.
+class RobotAlreadyHomeException(RobotException):
     def __init__(self, error_description: str) -> None:
         super().__init__(
-            error_reason=ErrorReason.RobotMissionNotSupportedException,
+            error_reason=ErrorReason.RobotAlreadyHomeException,
             error_description=error_description,
         )
 

robot_interface/models/initialize/__init__.py

@@ -1 +0,0 @@
-from .initialize_params import InitializeParams

robot_interface/models/inspection/__init__.py

@@ -1,13 +0,0 @@
-from .inspection import (
-    Audio,
-    Image,
-    ImageMetadata,
-    Inspection,
-    InspectionMetadata,
-    ThermalImage,
-    ThermalImageMetadata,
-    ThermalVideo,
-    ThermalVideoMetadata,
-    Video,
-    VideoMetadata,
-)