forked from exercism/python
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Updated help and tooling docs per issues exercism#2953 and exercism#2745
* added the pytest invokation pytest -o markers=task to the "running tests" sections of exercises/shared/test.md and docs/TESTS.md * updated and clarified INSTALLATION.md * updated and added new resources to LEARNING.md * updated and added new resources to RESOURCES.md * overhauled TOOLS.md and added new editors and links
- Loading branch information
Showing
7 changed files
with
710 additions
and
221 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,9 +1,35 @@ | ||
| # Installing Python | ||
|
|
||
| If Python isn't already available on your system, detailed instructions by platform can be found in the [Python Setup and Usage][using python] section of the official documentation. | ||
| Real Python also offers a [very helpful guide][helpful guide] to installation on various platforms, including iOS and Android. | ||
| If Python isn't already available on your system, detailed instructions by platform can be found in the [Python Setup and Usage][using python] section of the official documentation. | ||
| Real Python also offers a [nice guide][helpful guide] to installation on various platforms, including iOS and Android. | ||
|
|
||
| Exercism tests and tooling currently supports `Python 3.8` (tests) and `Python 3.9` (tooling). | ||
| Finally, these posts by Brett Cannon [A quick-and-dirty guide][quick-and-dirty] and [Why you should use `python -m pip`][python-m-pip], give very helpful advice on how to manage Python installations and packages. | ||
|
|
||
| **Note for MacOS users:** prior to MacOS Monterey (12.3), `Python 2.7` came pre-installed with the operating system. | ||
| Using `Python 2.7` with exercsim or most other programs is not recommended. | ||
| You should instead install Python 3 via one of the methods detailed below. | ||
| As of MacOS Monterey (12.3), no version of Python will be pre-installed via MacOS. | ||
|
|
||
| Some quick links into the documentation by operating system: | ||
|
|
||
| - [Windows][windows] Additionally, this Microsoft article on [installing Python on windows][python-on-windows] is helpful. | ||
| - [Unix & Linux Systems][unix-and-linux] (_these largely work for MacOS as well_) | ||
| - [MacOS][macos] : **This is outdated.** | ||
| We recommend reviewing some of the methods outlined in the Real Python article [Installing Python][installing-python] or the articles by Brett Cannon linked above. | ||
|
|
||
|
|
||
| Exercism tests and tooling currently support `Python 3.8` (_tests_) and `Python 3.9` (_tooling_). | ||
| This means that the [newest features of Python `3.10`][310-new-features] are **not** currently supported. | ||
| Please refer to the [Python 3.9.x documentation][3.9 docs] for what is currently supported. | ||
|
|
||
| [3.9 docs]: https://docs.python.org/3.9/ | ||
| [310-new-features]: https://docs.python.org/3/whatsnew/3.10.html | ||
| [helpful guide]: https://realpython.com/installing-python/ | ||
| [installing-python]: https://realpython.com/installing-python/#what-your-options-are_1 | ||
| [macos]: https://docs.python.org/3/using/mac.html | ||
| [python-m-pip]: https://snarky.ca/why-you-should-use-python-m-pip/ | ||
| [unix-and-linux]: https://docs.python.org/3/using/unix.html | ||
| [using python]: https://docs.python.org/3/using/index.html | ||
| [windows]: https://docs.python.org/3/using/windows.html | ||
| [python-on-windows]: https://docs.microsoft.com/en-us/windows/python/beginners | ||
| [quick-and-dirty]: https://snarky.ca/a-quick-and-dirty-guide-on-how-to-install-packages-for-python/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,22 +1,28 @@ | ||
| # Recommended learning resources | ||
| # Additional Resources for Python | ||
|
|
||
| * [The Python Tutorial][The Python Tutorial] | ||
| * [The Python Library Reference][The Python Library Reference] | ||
| * [The Python Docs][python docs] | ||
| * [Practical Python][practical python] | ||
| * [Think Python][think python] | ||
| * [PyMOTW-3][pymotw-3] | ||
| * [automate the boring stuff][automate the boring stuff] | ||
| * [Googles Python Class][Googles Python Class] | ||
| * [pycharm edu][pycharm edu] | ||
| - [Official Python 3 Documentation and Reference][python docs] | ||
| - [The Python Library Reference][The Python Library Reference] | ||
| - [The Docs on pip][pip] | ||
| - [Tall, Snarky Canadian (_The Blog of Core Python Developer Brett Cannon_)][Tall, Snarky Canadian] | ||
| - [Practical Python][practical python] | ||
| - [Python 3 Module of the Week (PyMOTW-3)][pymotw-3] | ||
| - [Beyond the Basic Stuff with Python][Beyond the Basic Stuff with Python] | ||
| - [The Big Book of Small Python Projects][The Big Book of Small Python Projects] | ||
| - [Data Structures and Information Retrieval in Python][Data Structures and Information Retrieval in Python] | ||
| - [python practice projects][python practice projects] | ||
| - [Python Courses eu][python-course.eu main] | ||
| - [Fluent Python Notebooks][fluent-notebooks] | ||
|
|
||
|
|
||
| [Beyond the Basic Stuff with Python]: https://inventwithpython.com/beyond/ | ||
| [Data Structures and Information Retrieval in Python]: https://allendowney.github.io/DSIRP/ | ||
| [Practical Python]: https://dabeaz-course.github.io/practical-python/ | ||
| [The Python Tutorial]: https://docs.python.org/3/tutorial/index.html | ||
| [Tall, Snarky Canadian]: https://snarky.ca/ | ||
| [The Big Book of Small Python Projects]: http://inventwithpython.com/bigbookpython/ | ||
| [The Python Library Reference]: https://docs.python.org/3/library/index.html | ||
| [Googles Python Class]: https://developers.google.com/edu/python | ||
| [Think Python]: http://www.greenteapress.com/thinkpython/html/index.html | ||
| [automate the boring stuff]: https://automatetheboringstuff.com/ | ||
| [pycharm edu]: https://www.jetbrains.com/pycharm-edu/ | ||
| [python docs]: https://docs.python.org/3/ | ||
| [fluent-notebooks]: https://github.com/AllenDowney/fluent-python-notebooks | ||
| [pip]: https://pip.pypa.io/en/stable/user_guide/ | ||
| [pymotw-3]: https://pymotw.com/3/ | ||
| [python docs]: https://docs.python.org/3/ | ||
| [python practice projects]: http://pythonpracticeprojects.com/ | ||
| [python-course.eu main]: https://python-course.eu/ |
Oops, something went wrong.