Introduction to Python/pl

Wprowadzenie
To jest krótki poradnik dla osób, dla których Python jest całkowicie nowy. Python to wieloplatformowy język programowania o otwartym kodzie źródłowym. Ma kilka cech, które odróżniają go od innych języków programowania i jest bardzo przystępny dla nowych użytkowników:


 * Został zaprojektowany tak, aby był czytelny dla ludzi, dzięki czemu jest stosunkowo łatwy do nauczenia i zrozumienia.
 * Jest interpretowany, co oznacza, że programy nie muszą być kompilowane przed ich wykonaniem. Kod Pythona może być wykonywany natychmiast, nawet linijka po linijce, jeśli chcesz.
 * Może być osadzony w innych programach jako język skryptowy. FreeCAD posiada wbudowany interpreter Python. Możesz pisać kod Python, aby manipulować częściami FreeCAD. Jest to bardzo potężne, oznacza to, że można budować własne narzędzia.
 * Jest rozszerzalny, można łatwo podłączyć nowe moduły do instalacji Python i rozszerzyć jego funkcjonalność. Na przykład istnieją moduły, które pozwalają środowisku Pyton odczytywać i zapisywać obrazy, komunikować się z Twitterem, planować zadania do wykonania przez system operacyjny itp.

Poniższa instrukcja jest bardzo podstawowym wprowadzeniem i w żadnym wypadku nie jest kompletnym poradnikiem. Mamy jednak nadzieję, że będzie to dobry punkt wyjścia do dalszej eksploracji FreeCAD i jego mechanizmów. Zdecydowanie zachęcamy do wprowadzenia poniższych fragmentów kodu do interpretera Python.



Interpreter
Zwykle, gdy piszesz programy komputerowe, po prostu otwierasz edytor tekstu i lub środowisko programistyczne (które w większości przypadków zawiera edytor tekstu z kilkoma dodatkowymi narzędziami), wpisujesz swój program, następnie kompilujesz go i wykonujesz. Przez większość czasu robisz błędy podczas pisania, więc twój program nie działa. Otrzymujesz komunikat błędu mówiący co poszło źle. Potem wracasz do edytora tekstu, poprawiasz błędy, uruchamiasz ponownie, aż program zacznie działać prawidłowo.

W środowisku Python cały ten proces można wykonać w sposób przezroczysty wewnątrz interpretera Python. Interpreter to okno z wierszem poleceń, w którym można po prostu wpisać kod. Jeśli zainstalowałeś Python na swoim komputerze (pobierz go ze strony Python, jeśli korzystasz z systemu Windows lub Mac, zainstaluj go z repozytorium pakietów jeśli korzystasz z systemu GNU/Linux), będziesz miał interpreter Python w menu startowym. Ale, jak już wspomniano, FreeCAD ma również wbudowany interpreter: konsola Python.



Jeśli jej nie widzisz, kliknij. Rozmiar konsoli Python można zmienić, a także ją odblokować.

Interpreter pokazuje wersję Python, a następnie symbol, który jest znakiem zachęty. Pisanie kodu w interpreterze jest proste: jedna linia to jedna instrukcja. Po naciśnięciu, linia kodu zostanie wykonana (po natychmiastowej i niewidocznej kompilacji). Na przykład, spróbuj napisać to:

to polecenie Python, które oczywiście wypisuje coś na ekranie. Po naciśnięciu, operacja jest wykonywana, a wiadomość jest drukowana. Jeśli popełnimy błąd, na przykład napiszemy:

Python natychmiast ci to powie. W tym przypadku Python nie wie, czym jest. Znaki określają, że zawartość jest ciągiem znaków, programistycznym żargonem dla fragmentu tekstu. Bez nich polecenie nie rozpoznaje. Naciskając strzałkę w górę można wrócić do ostatniej linii kodu i poprawić ją.

Interpreter Python posiada również wbudowany system pomocy. Powiedzmy, że nie rozumiemy, co poszło nie tak z i chcemy uzyskać szczegółowe informacje o poleceniu:

Otrzymasz długi i kompletny opis wszystkiego, co może zrobić polecenie.

Teraz, gdy rozumiesz już interpreter Python, możemy przejść do poważniejszych rzeczy.

Zmienne
W programowaniu bardzo często zachodzi potrzeba przechowywania wartości pod nazwą. W tym miejscu pojawiają się zmienne. Na przykład, wpisz to:

Prawdopodobnie rozumiesz co się tutaj stało, zapisaliśmy ciąg pod nazwą. Teraz, gdy jest znany, możemy go użyć gdziekolwiek, na przykład w poleceniu. Możemy użyć dowolnej nazwy, musimy tylko przestrzegać kilku prostych zasad, takich jak nieużywanie spacji lub znaków interpunkcyjnych i nieużywanie słów kluczowych Python. Na przykład, możemy napisać:

Teraz nie jest już niezdefiniowane. Zmienne mogą być modyfikowane w dowolnym momencie, dlatego są nazywane zmiennymi, ich zawartość może się zmieniać. Na przykład:

Zmieniliśmy wartość. Możemy również kopiować zmienne:

Zaleca się nadawanie zmiennym znaczących nazw. Po pewnym czasie nie będziesz pamiętać, co reprezentuje zmienna o nazwie. Ale jeśli nazwiesz ją na przykład, łatwo zapamiętasz jej przeznaczenie. Dodatkowo, twój kod jest o krok bliżej do bycia samodokumentującym się.

Wielkość liter jest bardzo ważna, nie jest tym samym co. Gdybyś wpisał, zwróciłoby to błąd jako niezdefiniowany.

Liczby
Oczywiście programy w Python mogą obsługiwać wszystkie rodzaje danych, nie tylko ciągi tekstowe. Jedna rzecz jest ważna, Python musi wiedzieć z jakim rodzajem danych ma do czynienia. W naszym przykładzie print hello widzieliśmy, że polecenie rozpoznało nasz ciąg. Używając znaków, określiliśmy, że to, co następuje, jest ciągiem tekstowym.

Zawsze możemy sprawdzić typ danych zmiennej za pomocą polecenia :

It will tell us the content of is a, which is short for string. We also have other basic data types such as integer and float numbers:

Python knows that 10 and 20 are integer numbers, so they are stored as, and Python can do with them everything it can do with integers. Look at the results of this:

Here we forced Python to consider that our two variables are not numbers but pieces of text. Python can add two pieces of text together, although in that case, of course, it won't perform any arithmetic. But we were talking about integer numbers. There are also float numbers. The difference is float numbers can have a decimal part and integer numbers do not:

Integers and floats can be mixed together without problems:

Because is a float Python automatically decides that the result must also be a float. But there are cases where Python does not knows what type to use. For example:

This results in an error, is a string and  is an integer, and Python doesn't know what to do. However, we can force Python to convert between types:

Now that both variables are strings the operation works. Note that we "stringified" at the time of printing, but we didn't change  itself. If we wanted to turn permanently into a string, we would need to do this:

We can also use and  to convert to integer and float if we want:

Pewnie zauważyłeś, że użyliśmy polecenia na kilka sposobów. Drukowaliśmy zmienne, sumy, kilka rzeczy oddzielonych przecinkami, a nawet wynik innego polecenia z języka Python. Być może zauważyłeś również, że te dwa polecenia:

have the same result. This is because we are in the interpreter, and everything is automatically printed. When we write more complex programs that run outside the interpreter, they won't print automatically, so we'll need to use the command. With that in mind let's stop using it here. From now on we will simply write:

Lists
Another useful data type is a list. A list is a collection of other data. To define a list we use :

As you can see a list can contain any type of data. You can do many things with a list. For example, count its items:

Or retrieve one item:

While the command returns the total number of items in a list, the first item in a list is always at position, so in our   will be at position. We can do much more with lists such as sorting items and removing or adding items.

Interestingly a text string is very similar to a list of characters in Python. Try doing this:

Usually what you can do with lists can also be done with strings. In fact both lists and strings are sequences.

Apart from strings, integers, floats and lists, there are more built-in data types, such as dictionaries, and you can even create your own data types with classes.

Indentation
One important use of lists is the ability to "browse" through them and do something with each item. For example look at this:

We iterated (programming jargon) through our list with the command and did something with each of the items. Note the special syntax: the command terminates with  indicating the following will be a block of one of more commands. In the interpreter, immediately after you enter the command line ending with, the command prompt will change to which means Python knows that there is more to come.

How will Python know how many of the next lines will need to be executed inside the operation? For that, Python relies on indentation. The next lines must begin with a blank space, or several blank spaces, or a tab, or several tabs. And as long as the indentation stays the same the lines will be considered part of the block. If you begin one line with 2 spaces and the next one with 4, there will be an error. When you have finished, just write another line without indentation, or press to come back from the  block

Indentation also aids in program readability. If you use large indentations (for example use tabs instead of spaces) when you write a big program, you'll have a clear view of what is executed inside what. We'll see that other commands use indented blocks of code as well.

The command can be used for many things that must be done more than once. It can, for example, be combined with the command:

If you have been running the code examples in an interpreter by copy-pasting, you will find the previous block of text will throw an error. Instead, copy to the end of the indented block, i.e. the end of the line and then paste in the interpreter. In the interpreter press until the three dot prompt disappears and the code runs. Then copy the final two lines followed by another. The final answer should appear.

If you type into the interpreter you will see:

Here the square brackets denote an optional parameter. However all are expected to be integers. Below we will force the step parameter to be an integer using :

Another example:

The command also has that strange particularity that it begins with  (if you don't specify the starting number) and that its last number will be one less than the ending number you specify. That is, of course, so it works well with other Python commands. For example:

Another interesting use of indented blocks is with the command. This command executes a code block only if a certain condition is met, for example:

Of course this will always print the sentence, but try replacing the second line with:

Then nothing is printed. We can also specify an statement:

Functions
There are very few standard Python commands and we already know several of them. But you can create your own commands. In fact, most of the additional modules that you can plug into your Python installation do just that, they add commands that you can use. A custom command in Python is called a function and is made like this:

The command defines a new function, you give it a name, and inside the parenthesis you define the arguments that the function will use. Arguments are data that will be passed to the function. For example, look at the command. If you just write, Python will tell you it needs an argument. Which is obvious: you want to know the length of something. If you write then  is the argument that you pass to the  function. And the function is defined in such a way that it knows what to do with this argument. We have done the same thing with our function.

The name can be anything, and it will only be used inside the function. It is just a name you give to the argument so you can do something with it. By defining arguments you also to tell the function how many to expect. For example, if you do this:

there will be an error. Our function was programmed to receive just one argument, but it received two, and. Let's try another example:

Here we made a function that receives two arguments, sums them, and returns that value. Returning something is very useful, because we can do something with the result, such as store it in the variable.

Modules
Now that you have a good idea of how Python works, you will need to know one more thing: How to work with files and modules.

Until now, we have written Python instructions line by line in the interpreter. This method is obviously not suitable for larger programs. Normally the code for Python programs is stored in files with the extension. Which are just plain text files and any text editor (Linux gedit, emacs, vi or even Windows Notepad) can be used to create and edit them.

There are several of ways to execute a Python program. In Windows, simply right-click your file, open it with Python, and execute it. But you can also execute it from the Python interpreter itself. For this, the interpreter must know where your program is. In FreeCAD the easiest way is to place your program in a folder that FreeCAD's Python interpreter knows by default, such as FreeCAD's user folder: Let's add a subfolder there called and then write a file like this:
 * On Linux it is usually  or.
 * On Windows it is, which is usually.
 * On macOS it is usually.

Save the file as in the  folder, and in the interpreter window write:

without the extension. This will execute the contents of the file, line by line, just as if we had written it in the interpreter. The sum function will be created, and the message will be printed. Files containing functions, like ours, are called modules.

When we write a function in the interpreter, we execute it like this:

But when we import a module containing a function the syntax is a bit different:

That is, the module is imported as a "container", and all its functions are inside that container. This is very useful, because we can import a lot of modules, and keep everything well organized. Basically when you see, with a dot in between, then this means is inside.

We can also import our sum function directly into the main interpreter space:

Almost all modules do that: they define functions, new data types and classes that you can use in the interpreter or in your own Python modules, because nothing prevents you from importing other modules inside your module!

How do we know what modules we have, what functions are inside and how to use them (that is, what kind of arguments they need)? We have already seen that Python has a function. Doing:

will give us a list of all available modules. We can import any of them and browse their content with the command:

We'll see all the functions contained in the module, as well as strange stuff named, ,. Every function in a well made module has a that explains how to use it. For example, we see that there is a function inside the math module. Want to know how to use it?

It may not be evident, but on either side of are two underscore characters.

And finally one last tip: When working on new or existing code, it is better to not use the FreeCAD macro file extension,, but instead use the standard extension. This is because Python doesn't recognize the extension. If you use your code can be easily loaded with, as we have already seen, and also reloaded with :

Istnieje jednak alternatywa:



Rozpoczęcie pracy z FreeCAD
Mamy nadzieję, że masz teraz wyobrażenie o tym, jak działa Python i możesz zacząć odkrywać, co FreeCAD ma do zaoferowania. Wszystkie funkcje Python FreeCAD są dobrze zorganizowane w różnych modułach. Niektóre z nich są już załadowane (zaimportowane) podczas uruchamiania FreeCAD. Wystarczy spróbować:

Uwagi

 * FreeCAD został pierwotnie zaprojektowany do pracy ze środowiskiem Python 2. Ponieważ Python 2 osiągnął koniec swojego życia w 2020 r., przyszły rozwój FreeCAD będzie odbywał się wyłącznie w Pythonie 3, a kompatybilność wsteczna nie będzie obsługiwana.
 * Znacznie więcej informacji na temat Pythona można znaleźć w oficjalnym przewodniku po Pythonie i oficjalnym dokumencie referencyjnym Python.