Add GraphQL transport

[marcelldls]

An additional "backend" for FastCS which provides a GraphQL api.
The API is fully discoverable and demoable from the autogenerated "GraphiQL gui" at "{domain}/graphql".
I choose to use the FastAPI "Strawberry" integration as it is the recommended library by FastAPI.

The following considersations have been taken to conform with best practices:

• Attributes to be read using a query (also demonstates how subcontrollers are nested)

Example:

Query request:
query{
    DesiredPosition
    subcontroller {
        DesiredPosition
    }
}

Query response:
{
  "data": {
    "subcontroller": {
      "DesiredPosition": 1.0,
    }
    "DesiredPosition": 1.0,
  }
}

• Attributes to be written using a mutation

Example:

Mutation request:
mutation{
  DesiredPosition(value: 2.0)
}

Mutation response:
{
  "data": {
    "DesiredPosition": 2.0
  }
}

• Commands can cause server side effects so they are triggered using a mutation as per convention
  • A boolean response is returned to confirm the command was executed successfully

Example:

Mutation request:
mutation{
  BlinkLED
}

Mutation response:
{
  "data": {
    "BlinkLED": true
  }
}

Further:

• I follow a similar pattern to the Tango "backend" to create the server and testing, so any feedback from the exisiting PRs should feed into this
• I have added nested subcontrollers to test arbitrary subcontroller nesting as this is a harder problem for the graphql request structure - the tests of other backends should also apply this and need to be updated accordingly

[GDYendell]

I have a had a quick look, but I am going to ignore this until we iterate on and merge some of the other recent PRs first, as you suggest.

[marcelldls]

I have a had a quick look, but I am going to ignore this until we iterate on and merge some of the other recent PRs first, as you suggest.

Lets do that. When we are done iterating, we can enjoy some of the graph recursion xD

[codecov]

Codecov Report

Attention: Patch coverage is 91.30435% with 10 lines in your changes missing coverage. Please review.

Project coverage is 88.06%. Comparing base (e2dfc01) to head (ef5c8e3).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/fastcs/transport/graphQL/graphQL.py	94.11%	5 Missing ⚠️
src/fastcs/transport/graphQL/adapter.py	78.57%	3 Missing ⚠️
src/fastcs/launch.py	60.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #71      +/-   ##
==========================================
+ Coverage   87.76%   88.06%   +0.30%     
==========================================
  Files          28       31       +3     
  Lines        1193     1307     +114     
==========================================
+ Hits         1047     1151     +104     
- Misses        146      156      +10     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[marcelldls]

Apparently camelCase is the convention for field names https://www.apollographql.com/docs/graphos/schema-design/guides/naming-conventions#casing so i have adjusted accordingly

[GDYendell]

First pass comments

[marcelldls]

I will rebase this on monday

[marcelldls]

@GDYendell Rebased. Also did the rename of create_type as discussed this morning

[marcelldls]

Hmm - the tests passed now that its in my branch... LGTM I guess

[marcelldls]

Ah I guess the rebase might have solved it

[GDYendell]

Note that puts still do not work here because of the problem where the tasks are added to the wrong event loop. So we either need to add something like

def _create_sender_callback(self, attribute, controller):
    async def callback(value):
        future = asyncio.run_coroutine_threadsafe(
            attribute.sender.put(controller, attribute, value), self._loop
        )
        await asyncio.wrap_future(future)

    return callback

or we need to figure out #98.

I think we should just merge this for now, though.

[marcelldls]

The puts issue is across transports so I agree we should merge this and look towards #98 which I believe solves the problem

[GDYendell]

Questionable self approval...