Python SDKDocs updates for v1.2 client

[paulyuk]

Description

Updated Python SDK docs for the client:

• changed all example links to point to the main branch, versus old setup branch 1+ years old
• updated all sample code to reflect current 1.2 SDK for Python
• added complementary Subscribe example to Publish & subscribe to messages section

Issue reference

Fixes #1551

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

• Code compiles correctly
• [] Created/updated tests
• Extended the documentation

[paulyuk]

@wcs1only @berndverst could you please help review how I branched here? The docs were sparse on branching technique for a submodule like PythonSDK. I did work in my own branch and pushed to that branch, since obviously I cannot and should not to the main. Please advise. I wonder if that's why the build check broke too?

[berndverst]

LGTM

[wcs1only]

@wcs1only @berndverst could you please help review how I branched here? The docs were sparse on branching technique for a submodule like PythonSDK. I did work in my own branch and pushed to that branch, since obviously I cannot and should not to the main. Please advise. I wonder if that's why the build check broke too?

@paulyuk You did things right, the build failure looks unrelated, as another PR is failing in the same place. I suspect there may have been a change in one of our dependencies that might be tripping things up. Will take a look today.

[berndverst]

@wcs1only @berndverst could you please help review how I branched here? The docs were sparse on branching technique for a submodule like PythonSDK. I did work in my own branch and pushed to that branch, since obviously I cannot and should not to the main. Please advise. I wonder if that's why the build check broke too?

@paulyuk You did things right, the build failure looks unrelated, as another PR is failing in the same place. I suspect there may have been a change in one of our dependencies that might be tripping things up. Will take a look today.

Looks related to protobuff library stubs missing for type checking. Either mypy --install-types or adding the types-protobuf requirement should resolve it. Agree this should be done in another PR. @wcs1only

[wcs1only]

Nice work! Thanks for cleaning this up!

[paulyuk]

Thank you @wcs1only and @berndverst !

[codecov]

Codecov Report

Merging #224 (8b03147) into master (4522b8c) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #224   +/-   ##
=======================================
  Coverage   88.68%   88.68%           
=======================================
  Files          49       49           
  Lines        1954     1954           
=======================================
  Hits         1733     1733           
  Misses        221      221           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4522b8c...8b03147. Read the comment docs.