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

Having launched PyCharm Edu, you see the Welcome screen first. Here, choose the very first option Introduction to Python. 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 Course Progress tool window, (3) is the Python console, (4) is the editor that now shows the Python script hello_world.py, and (5) is the Task Description tool window.

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

As you see, the Project tool window contains the following major entities:

• Lessons, marked . When a lesson is completed, its icon changes to .
• Tasks, marked . When a task is completed, its icon changes to
• 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.

This procedure is described in the corresponding section of this documentation.

As an exercise, let‘s explore the first lesson and fulfil its tasks.

Lesson 1. First Program and Comments

Expand the Introduction lesson . To do that, click right arrow next to 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. However, if you press F4, this file will open in the editor.

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 , 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 the Task 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:

Refer to the section Interactive Console to learn more about the available controls.

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:

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

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

3. 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.

That completes the tutorial. You got a head start and now can further explore the PyCharm Edu and learn Python along the way. We wish you best of luck!

http://www.jetbrains.com/pycharm/docs/PyCharm_ReferenceCard.pdf