EDU-3624: Python Project Tutorial Geocoding

[GSmithApps]

What was changed

This adds a python project-based tutorial to the docs/tutorials.

Note that the accompanying code is currently in my personal repository. It would ideally be migrated to the Temporal organization along with the other project-based-tutorial code such as https://github.com/temporalio/data-pipeline-project-python and https://github.com/temporalio/email-subscription-project-python.

Why?

I asked Tom Wheeler if there was anything I could contribute, and he suggested to make a Python tutorial.

Checklist

1. How was this tested:
   I ran yarn start in my local. There's a screenshot below showing the tutorial.

2. Any docs updates needed?
   The only changes are to docs 👍

3. ⚠️ Small warning: I did not clear the snippets from my code. ⚠️ I was having trouble getting the snippets after clearing them, so I figured I'd leave them in. I'm not sure if the get snips functionality is down at the moment, or if it's because the code repository is not in the Temporal organization. In any case, I saw other tutorials with the snippets still there, so I figure it's okay.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
temporal-learning	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 29, 2024 11:04am

[CLAassistant]

All committers have signed the CLA.

[axfelix]

Thanks for this contribution! I have only a few comments/questions:

1. Why the different make_worker and run_worker scripts? We don't tend to use this pattern anywhere, especially not in our beginner projects.
2. Would you mind showing some example input/output at the end of the tutorial? I like to conclude these by showing the project running end-to-end.
3. I agree it would be best to host the code repository within the Temporal org when we publish this to the learn site; do you have permissions to create a new repo yourself, so you can migrate it out of your own Github?
4. I don't believe there's any reason you should have to use the https://python.temporal.io/temporalio.workflow.unsafe.html#imports_passed_through context manager to import your own helper functions from your Activity definition to your Workflow code... head check from @MasonEgger ?

If we get these resolved, I'd love to merge this.

[GSmithApps]

Hi Alex,

Thanks so much for your kindness!

To be honest on this one, I wrote this tutorial as I was applying for this job, and I'm not sure how useful this tutorial is. I respectfully leave it up to you and your team, and if you think we don't need it, it won't hurt my feelings 😆

But if you do like it, then yeah I certainly can look into these notes in more detail and clean up the PR 👍🏼

[axfelix]

Hey Grant!

From my point of view, it's very close to being publishable, and we could always use more tutorials! Not a high priority of course, but if you get a chance, I think it needs less than an hour of work.

[GSmithApps]

Excellent - thanks Alex! Yeah I'll put it on my queue for whenever it's handy 👍