Add Python language guide #376

JesterOrNot · 2020-01-03T06:44:55Z

No description provided.

JesterOrNot · 2020-01-04T16:20:18Z

@jankeromnes @svenefftinge can you take a look at this

jankeromnes

Hi @JesterOrNot, many many thanks for improving our "Languages & Frameworks" section! You're so fast that it's not easy to keep up. 😅

For this Pull Request, I think you didn't mean to propose all these changes to:

src/components/*
src/pages/*
src/resources/*
src/utils/link.tsx

To remove the noise, I will now squash all your commits into one, and only keep the changes to:

src/docs/*

I hope that's ok with you. 🙂

jankeromnes · 2020-01-07T13:37:56Z

Also, please always try to avoid "Merge" commits here. They make the commit history messy (it becomes a mashed-up tree instead of a straightforward linear progression) for no clear benefits.

Note:

Using the "Update Pull Request" button on GitHub creates a "Merge" commit (because the developers of GitHub really like them for some reason)
Using git rebase upstream/master can clean up any "Merge" commits for you by cleanly "re-basing" your changes on top of the latest upstream commits

jankeromnes

Thanks a lot for your great work here!

The improvements to the Java page are excellent, many thanks. I'd like to merge them as is.

For the Julia page, it still seems pretty small. If I'm a Julia developer who is new to Gitpod, I'm not sure if this page will really help me configure my own Julia project so that it works well in Gitpod.

I mean sure, looking at the example repositories may give me a clue about what I need to configure, but if I've never seen a Gitpod configuration in my life, or even written a Dockerfile, this may all be too much to deal with (and maybe I'll give up trying to set up Gitpod).

For the Python page, it's pretty cool to have .gitpod.yml and .gitpod.Dockerfile examples, but maybe we don't want to put very long & complicated configurations in front of our new users. So maybe it's better to just cover the basics, e.g. say what exactly you need to do if you want to use wxPython in Gitpod, and then have external links to the full configurations if users want them.

src/docs/julia_in_gitpod.md

src/docs/python_in_gitpod.md

jankeromnes · 2020-01-08T16:37:29Z

I took the liberty to split out the Java and Julia guide improvements, which are now merged separately into master.

This PR is actually about the Python guide. Let's update it to reflect that.

JesterOrNot · 2020-01-09T18:36:29Z

@jankeromnes can you take another look?

jankeromnes

Cool post! The wxPython section is starting to look good. However, I feel like there should some content before that section (not all Python developers want to work with wxPython).

Specifically, I think we should mention cool Python example repositories, and any VS Code extensions that could be interesting to install (if there are some that are worth it?)

Here are a few Python example repos from the top of my head:

https://github.com/gitpod-io/django-locallibrary-tutorial MDN's local library Django application example (our default Python example for Gitpod)
https://github.com/techwithtim/Hangman A graphical Hangman game based on pygame and Gitpod's VNC image (pretty fun to play! however you'll need to increase the preview pane width in order to even see the pygame window)
https://github.com/techwithtim/NEAT-Flappy-Bird A graphical AI playground that teaches generational AI agents to win the game Flappy Bird (same thing with the preview width)
https://github.com/openai/gym An AI framework from OpenAI (the config lives in the external definitely-gp repository though)
https://github.com/TheAlgorithms/Python is a cool example for running Python algorithms in Gitpod, but it doesn't have any special setup/configuration (could be a good example that Python "just works" in Gitpod without needing any config)

I don't know about VS Code extensions though.

src/docs/python_in_gitpod.md

JesterOrNot · 2020-01-10T15:24:56Z

Don't worry on the examples front I have a lot of examples ready to be added!

JesterOrNot · 2020-01-10T16:03:34Z

see #383

jankeromnes · 2020-01-10T17:30:54Z

The Examples section looks cool! Many thanks.

I feel like it should come before the wxPython section though. Also, very brief descriptions of each example would be cool, e.g.:

gitpod-io/django-locallibrary-tutorial: An example website written in Django by MDN
JesterOrNot/Gitpod-PyQt: A PyQt example for Gitpod
gitpod-io/wxPython-example: A wxPython example for Gitpod
techwithtim/Hangman: A simple hangman game made with Python and PyGame

JesterOrNot · 2020-01-10T17:31:49Z

I'll move it Jan
Done!

jankeromnes

Many thanks for the recent fixes! I've added a few more comments / suggestions.

Also, do you know any VS Code extensions that would be useful for Python? (If you don't need any, that's cool too though.)

src/docs/python_in_gitpod.md

Co-Authored-By: Jan Keromnes <[email protected]>

jankeromnes

Super cool! Thanks a lot for the great work on this guide.

This seems ready to go, except for a minor problem in the Dockerfile. Please fix it, and then we'll be able to "Squash & Merge" all these commits. 👍

src/docs/python_in_gitpod.md

JesterOrNot · 2020-01-20T16:50:28Z

Fixed!

jankeromnes · 2020-01-20T17:08:00Z

As mentioned on Slack, please open a follow-up PR to mention which Python versions are supported in Gitpod, and how to switch from one to the other (e.g. with a brief pyenv explanation & examples)

JesterOrNot · 2020-01-20T17:09:27Z

So merge this and then open a separate PR?

JesterOrNot · 2020-01-20T17:09:43Z

ok

jankeromnes · 2020-01-20T17:09:52Z

Many thanks @JesterOrNot! And yes please :)

JesterOrNot changed the title ~~Add Julia to languages_and_frameworks.md~~ Add Julia to languages_and_frameworks.md and extend python_in_gitpod Jan 5, 2020

JesterOrNot requested review from nisarhassan12, svenefftinge and jankeromnes January 6, 2020 21:19

jankeromnes suggested changes Jan 7, 2020

View reviewed changes

jankeromnes force-pushed the master branch from b284a16 to 4427d5d Compare January 7, 2020 13:47

jankeromnes reviewed Jan 7, 2020

View reviewed changes

jankeromnes mentioned this pull request Jan 8, 2020

[docs] Add Julia section #261

Closed

jankeromnes self-requested a review January 8, 2020 16:36

jankeromnes changed the title ~~Add Julia to languages_and_frameworks.md and extend python_in_gitpod~~ Add Python language guide Jan 8, 2020

jankeromnes force-pushed the master branch 2 times, most recently from 1e5346e to 5299d6b Compare January 8, 2020 16:38

jankeromnes changed the title ~~Add Python language guide~~ [docs] Add Python language guide Jan 8, 2020

jankeromnes reviewed Jan 10, 2020

View reviewed changes

[docs] Add Python language guide

1be9341

jankeromnes force-pushed the master branch from 8e27117 to 1be9341 Compare January 10, 2020 17:15

Update python_in_gitpod.md

c46e2bf

Sean Hellum added 2 commits January 10, 2020 19:15

move examples

b765747

add descriptions

6525158

JesterOrNot requested a review from jankeromnes January 10, 2020 19:19

JesterOrNot changed the title ~~[docs] Add Python language guide~~ [WIP] Add Python language guide Jan 11, 2020

jankeromnes reviewed Jan 13, 2020

View reviewed changes

src/docs/python_in_gitpod.md Outdated Show resolved Hide resolved

src/docs/python_in_gitpod.md Outdated Show resolved Hide resolved

Sean Hellum and others added 10 commits January 15, 2020 07:51

Update src/docs/python_in_gitpod.md

057be28

Co-Authored-By: Jan Keromnes <[email protected]>

Update src/docs/python_in_gitpod.md

b3240cc

Co-Authored-By: Jan Keromnes <[email protected]>

eUpdate src/docs/python_in_gitpod.md

9420e6c

Co-Authored-By: Jan Keromnes <[email protected]>

Update python_in_gitpod.md

cf728ce

Update src/docs/python_in_gitpod.md

1b9e02d

Co-Authored-By: Jan Keromnes <[email protected]>

Update src/docs/python_in_gitpod.md

6c7b38a

Co-Authored-By: Jan Keromnes <[email protected]>

Update src/docs/python_in_gitpod.md

e4db076

Co-Authored-By: Jan Keromnes <[email protected]>

Update src/docs/python_in_gitpod.md

be3a1dc

Co-Authored-By: Jan Keromnes <[email protected]>

be more specific

c3d7e2d

remove displaced sentence

2d9c00e

JesterOrNot requested a review from jankeromnes January 15, 2020 14:32

Sean Hellum and others added 9 commits January 15, 2020 08:34

Update src/docs/python_in_gitpod.md

1beed9f

Co-Authored-By: Jan Keromnes <[email protected]>

Update src/docs/python_in_gitpod.md

d0401af

Co-Authored-By: Jan Keromnes <[email protected]>

Update src/docs/python_in_gitpod.md

02c9f9b

Co-Authored-By: Jan Keromnes <[email protected]>

Update src/docs/python_in_gitpod.md

557ca6d

Co-Authored-By: Jan Keromnes <[email protected]>

specify

386cfc1

Merge branch 'master' of https://github.com/JesterOrNot/website

26286d8

fix

143b360

fix link

55cf668

linkify

c21f709

jankeromnes approved these changes Jan 20, 2020

View reviewed changes

src/docs/python_in_gitpod.md Outdated Show resolved Hide resolved

Update python_in_gitpod.md

57e0eba

JesterOrNot requested a review from jankeromnes January 20, 2020 16:50

jankeromnes merged commit 79748b7 into gitpod-io:master Jan 20, 2020

JesterOrNot changed the title ~~[WIP] Add Python language guide~~ Add Python language guide Jan 21, 2020

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add Python language guide #376

Add Python language guide #376

JesterOrNot commented Jan 3, 2020

JesterOrNot commented Jan 4, 2020 •

edited

Loading

jankeromnes left a comment

jankeromnes commented Jan 7, 2020

jankeromnes left a comment

jankeromnes commented Jan 8, 2020

JesterOrNot commented Jan 9, 2020

jankeromnes left a comment •

edited

Loading

JesterOrNot commented Jan 10, 2020

JesterOrNot commented Jan 10, 2020

jankeromnes commented Jan 10, 2020 •

edited

Loading

JesterOrNot commented Jan 10, 2020 •

edited

Loading

jankeromnes left a comment

jankeromnes left a comment

JesterOrNot commented Jan 20, 2020

jankeromnes commented Jan 20, 2020

JesterOrNot commented Jan 20, 2020

JesterOrNot commented Jan 20, 2020

jankeromnes commented Jan 20, 2020

Add Python language guide #376

Add Python language guide #376

Conversation

JesterOrNot commented Jan 3, 2020

JesterOrNot commented Jan 4, 2020 • edited Loading

jankeromnes left a comment

Choose a reason for hiding this comment

jankeromnes commented Jan 7, 2020

jankeromnes left a comment

Choose a reason for hiding this comment

jankeromnes commented Jan 8, 2020

JesterOrNot commented Jan 9, 2020

jankeromnes left a comment • edited Loading

Choose a reason for hiding this comment

JesterOrNot commented Jan 10, 2020

JesterOrNot commented Jan 10, 2020

jankeromnes commented Jan 10, 2020 • edited Loading

JesterOrNot commented Jan 10, 2020 • edited Loading

jankeromnes left a comment

Choose a reason for hiding this comment

jankeromnes left a comment

Choose a reason for hiding this comment

JesterOrNot commented Jan 20, 2020

jankeromnes commented Jan 20, 2020

JesterOrNot commented Jan 20, 2020

JesterOrNot commented Jan 20, 2020

jankeromnes commented Jan 20, 2020

JesterOrNot commented Jan 4, 2020 •

edited

Loading

jankeromnes left a comment •

edited

Loading

jankeromnes commented Jan 10, 2020 •

edited

Loading

JesterOrNot commented Jan 10, 2020 •

edited

Loading