Overview

This guide aims to help the students get a grip of PyCharm Edu and pass through the initial course of Python programming.

The first start

When you first launch PyCharm Edu, you see the following image:

Select the student's role, and then click the button Start using PyCharm Edu.

Having launched PyCharm Edu, you see the Welcome screen first. Here, choose the very first option Browse Courses. In the Select Course dialog box, choose Introduction to Python, and click the Join button. PyCharm Edu silently creates a project, and opens it.

Now look at the new project:

where (1) is the Project Tool Window, (2) is the editor, (3) is the Task Description tool window with the course progress bar (4), (5) is the Run tool window, and (6) is the Python Console tool button.

To learn what is a tool window and how to handle it, refer to the corresponding sections of the documentation.

Python files, marked , and all other file types, supported by PyCharm Edu.

Sandbox, where you can create files and folders of your choice.

Creating an educational project

By the way, when you feel yourself better with Python, you can create an educational project yourself. To do this, just choose File | New Project... on the main menu, and follow the steps of the wizard.

Lesson 1. First program and comments

Expand the Introduction lesson . To do that, click right arrow next to the lesson name. You see the nested tasks :

Click next to the first task name, and see the Python file hello_world.py. This file is opened in the editor by default.

To the right of the editor, there is the Task Description tool window with the task text.

Above the task description, there is the toolbar with the following icons:

- click this button to make sure your answer was correct.

/ - click these buttons to open the previous or next task in the editor.

- click this button to drop changes to a task and start it anew.

- click this button to show prompt for the current task.

Executing a task

The editor tab is occupied by a task itself. A task consists of one or more frames that serve as placeholders for your code - you need to type your answer inside the placeholder.

In our case, you have to introduce yourself to the world, that is, type your name in the frame:

Before checking the task, you might want to run it - just to see for yourself how it works. For that, there is a special icon in the left gutter of the editor:

If you click this icon, the current Python script will run and show you its output in the Run tool window:

When ready, click in the Task Description tool window, to check whether the task within a placeholder has been executed correctly:

Yes, you are right! Congrats are well deserved.

By the way, if you click in the Run tool window, the output will disappear. If your attempt was not correct, PyCharm Edu also informs you about it:

As you see in the Project Tool Window, the correctly executed task is marked green, while the incorrect task is marked red. Let’s get rid of red and repeat the task!

Note that if a task contains more than one placeholder, each placeholder with correct code becomes green, while a placeholder with incorrect code becomes red. The entire task will be considered correct and marked green only when all the placeholders are filled in with correct code!

Navigating between tasks

As the current task has been successfully executed, let’s pass to the next one. To do that, click the right arrow button , or press Ctrl+Right. PyCharm Edu opens the next task in the editor. Note that the newly opened file that contains a yet untouched code, is underlined with the red curvy line, since there are syntax errors.

When you enter syntactically valid solution, this red curvy line will disappear.

Clicking the left arrow or pressing Ctrl+Left lets you jump to the previous task.

Starting a task all over again

Suppose now that you’ve made several attempts to execute a task, and now there are lots of changes, and you want to start everything from scratch.

In this case, click on the toolbar of the Task Description tool window, and see how PyCharm Edu returns to the original state of a task:

Getting task hints

If you are not sure what are you supposed to do to fulfil a task, you can always see the task description. It is always available in theTask Description Tool Window.

You can also view hints for each placeholder. To do that, place the caret in the answer placeholder and click .

Navigating between answer placeholders

Suppose now that your task contains several placeholders, and you have to type something meaningful in each one. You know well enough the answer to the second question, but you are not sure about the first one, which now holds the highlight.

No problem - you can start with any question you like better. To do that, press Ctrl+Enter, and the placeholders of the next question now gets the focus:

Now type your answer here, and then press Ctrl+Enter again to jump to the first frame.

You can also switch between answer placeholders back and forth using Ctrl+Shift+Right/Ctrl+Shift+Right.

Using Python console

Finally, let’s try working in the console. Click the tool window button Python Console. The console starts, allowing you to enter commands:

Pressing Enter () executes the current command. You can use the history of commands already entered in the console: press up or down arrow keys to navigate through the history.

Note that code completion is available in the Python console. For example, start typing the keyword ‘type’ and press Ctrl+Space after the first letters. PyCharm Edu suggests matches:

Code completions after dot and after the opening parenthesis are also available:

Pressing the toolbar button shows you variables used in the current session:

How to reset the entire course?

At some point you may want to reset the entire course. There is no special button or menu entry for that in PyCharm Edu, so you have to do this manually.

To reset the entire course, follow these steps:

On the main menu, choose File | New project...

In the dialog box that opens, choose project type Educational.

Specify the new directory for your project.

If you are going to reset Introduction to Python, you have to delete the PythonIntroduction folder (this folder by default resides under your home folder in PycharmProjects/PythonIntroduction) - and the next time you’ll click the Introduction to Python option, PyCharm Edu will create a new educational project for you.

Adaptive courses

Do you feel yourself strong enough to skip the tasks too simple for you? Or you are not sure of yourself and would like to repeat the tasks more than once? If this is the case, you can choose the so-called adaptive course.

This is how it's done… In the New Project dialog (opened from the Welcome screen, or by choosing File | New Project... on the main menu) select Educational project type, and then, in the Courses drop-down list, choose Adaptive Python:

Click Create. At last your educational project is ready. You see, that it slightly differs from the ordinary project:

Here (1) is the Project tool window with just one task and the Sandbox, (2) is the editor where you will type your code, and (3) is the Task Description tool window which features two buttons on top, Too Hard and Too Boring.