Basic python SDK

[michael-groundlight]

See the README.md and Examples for details. I list several known TODOs at the bottom.

Everything under generated/ is autogenerated using openapi-generator, which uses spec/public-api.yaml.

[romerocesar]

normally I consider README like a dev guide and some other doc as a user guide. right now usage instructions are split between examples and readme

also, I prefer not to push lockfiles to libraries since they quickly result in the dev environment being different than the consuming env with minor updates to any dependency which we actually want to be able to test against and catch issues sooner than later

for the near future: it would be great to add notebooks with examples that can actually run out of the box

[romerocesar]

we may want to push a placeholder to pypi.org to sit on this since there are no namespaces in pypi and packages are identified only by name and number (not URL) so names have to basically be globally unique

[michael-groundlight]

yeah, that's a good idea https://positronixcorp.atlassian.net/jira/software/projects/PK/boards/6?selectedIssue=PK-280

[robotrapta]

Very exciting!

[michael-groundlight]

normally I consider README like a dev guide and some other doc as a user guide. right now usage instructions are split between examples and readme

I moved a few things around to make the distinction clearer. Not perfect, but better.

also, I prefer not to push lockfiles to libraries since they quickly result in the dev environment being different than the consuming env with minor updates to any dependency which we actually want to be able to test against and catch issues sooner than later

Agreed, I've removed poetry.lock and added an entry in gitignore.

for the near future: it would be great to add notebooks with examples that can actually run out of the box

Added it to the TODO list.