Awesome
<p align="center"> <a href="https://github.com/alexmojaki/futurecoder/blob/master/LICENSE.txt"><img src="https://img.shields.io/github/license/alexmojaki/futurecoder?style=flat" alt="MIT license" align="left"></a> <a href="https://github.com/alexmojaki/futurecoder/actions"><img src="https://github.com/alexmojaki/futurecoder/workflows/CI/badge.svg" alt="Tests status" align="left"></a> <img src="homepage/static/logo/bordered2.png" width="300px" height="300px" alt="logo"> <a href="https://saucelabs.com"><img src="https://opensource.saucelabs.com/images/opensauce/powered-by-saucelabs-badge-gray.png?sanitize=true" alt="Testing Powered By SauceLabs" align="right"></a> </p> <h1 align="center"><code>futurecoder</code></h1>This is a 100% free and interactive course for people to teach themselves programming in Python, especially complete beginners at programming. It is carefully designed to reduce frustration and guide the user while still ensuring that they learn how to solve problems. The goal is for as many people as possible to learn programming.
You can try it out here: https://futurecoder.io/
Please consider contributing or donating!
Alternatively, come have a chat on slack.
Features
For a fuller demonstration and explanation, watch this video.
<table> <tr> <td colspan="2"> The course is a fully interactive 'book' which requires the user to run code in the provided editor or shell to advance: </td> </tr> <tr> <td colspan="2">
</td>
</td>
<td>
</td>
Or in some cases solve a Parsons problem instead, where they have to put a shuffled solution in the correct order:
</td> </tr> <tr> <td>- Highlighting the exact operation that failed, not just the line, using executing
- Tables of local variables and simple expressions evaluated by pure_eval
- Suggestions for fixes provided by DidYouMean
- Beginner friendly explanations provided by friendly-traceback (shown when hovering over the little
i
icon) - Showing multiline statements in full thanks to stack_data without showing unnecessary extra lines
Several debuggers are provided, including snoop... </td> <td>
...birdseye... </td>
</tr> <tr> <td>
</td>
<td>
</td>
...and Python Tutor </td>
</tr> <tr> <td colspan="2">
</td>
Running locally
- Fork this repo,
git clone
it, and enter the top-levelfuturecoder
folder. - Install Python 3.11.2 and poetry.
- Run
poetry install
to install Python dependencies. - Run
./scripts/generate.sh
. This will generate various static files from Python used by the frontend and run some tests. Repeat this step whenever you change Python files. - In the
frontend
folder:-
Install
node
. We recommend using version 16.17.1 (lts/gallium) but there are no known issues with other versions. -
Run
npm ci
to download dependencies. -
Run
npm run build
and then copyservice-worker.js
from thecourse
folder to thepublic
folder. The service worker is used by sync-message to handletime.sleep
and reading from stdin (e.g.input()
) in Python. If you want to enable caching (not a good idea when developing), set the environment variableREACT_APP_PRECACHE=1
when building. -
Run
npm start
to start the frontend development server.
-
- Go to http://localhost:3000/course/
To learn more about the system, see the contributing guide.
Controls
To explore the course more freely:
- Click the hamburger menu icon in the top left.
- Click Settings.
- Turn Developer mode on.
- This should give you two red buttons floating at the bottom of the screen. They change the currently active step, so you can move forward without having to complete exercises or backwards to test a step again.