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 :

Poinformuje nas, że zawartość to, co jest skrótem od string. Mamy również inne podstawowe typy danych, takie jak liczby całkowite i zmiennoprzecinkowe:

Python wie, że 10 i 20 są liczbami całkowitymi, więc są one przechowywane jako, a Python może zrobić z nimi wszystko, co może zrobić z liczbami całkowitymi. Spójrz na wyniki tego działania:

Tutaj zmusiliśmy Pythona do wzięcia pod uwagę, że nasze dwie zmienne nie są liczbami, ale fragmentami tekstu. Python może dodać do siebie dwa fragmenty tekstu, choć w takim przypadku oczywiście nie wykona żadnych działań arytmetycznych. Ale mówiliśmy o liczbach całkowitych. Istnieją również liczby zmiennoprzecinkowe. Różnica polega na tym, że liczby zmiennoprzecinkowe mogą mieć część dziesiętną, a liczby całkowite nie:

Liczby całkowite i zmiennoprzecinkowe mogą być mieszane bez problemów:

Ponieważ jest liczbą zmiennoprzecinkową, interpreter automatycznie decyduje, że wynik również musi być liczbą zmiennoprzecinkową. Istnieją jednak przypadki, w których interpreter nie wie, jakiego typu użyć. Na przykład:

Powoduje to błąd, jest łańcuchem znaków, a  jest liczbą całkowitą i interpreter nie wie, co zrobić. Możemy jednak wymusić konwersję między typami:

Teraz, gdy obie zmienne są łańcuchami, operacja działa. Zwróć uwagę, że "stringowaliśmy" w czasie drukowania, ale nie zmieniliśmy samego. Gdybyśmy chcieli zmienić na stałe w ciąg znaków, musielibyśmy wykonać tę operację:

Możemy również użyć i  do konwersji na liczbę całkowitą i zmiennoprzecinkową, jeśli chcemy:

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:

daje ten sam wynik. Dzieje się tak, ponieważ jesteśmy w interpreterze i wszystko jest automatycznie drukowane. Kiedy piszemy bardziej złożone programy, które działają poza interpreterem, nie będą one drukowane automatycznie, więc będziemy musieli użyć polecenia. Mając to na uwadze, przestańmy go tutaj używać. Od teraz będziemy po prostu pisać:

Listy
Innym przydatnym typem danych jest lista. Lista jest zbiorem innych danych. Aby zdefiniować listę używamy :

Jak widać, lista może zawierać dowolny typ danych. Z listą można robić wiele rzeczy. Na przykład policzyć jej elementy:

Lub pobrać jeden element:

Podczas gdy komenda zwraca całkowitą liczbę elementów na liście, pierwszy element na liście jest zawsze na pozycji, więc w naszym   będzie na pozycji. Możemy zrobić znacznie więcej z listami, takimi jak sortowanie elementów i usuwanie lub dodawanie elementów.

Co ciekawe, ciąg tekstowy jest bardzo podobny do listy znaków w języku Python. Spróbuj zrobić to:

Zazwyczaj to, co można zrobić z listami, można również zrobić z ciągami. W rzeczywistości zarówno listy, jak i ciągi znaków są sekwencjami.

Oprócz ciągów znaków, liczb całkowitych, zmiennoprzecinkowych i list, istnieje więcej wbudowanych typów danych, takich jak słowniki, a nawet można tworzyć własne typy danych za pomocą klas.

Wcięcia
Jednym z ważnych zastosowań list jest możliwość "przeglądania" ich i robienia czegoś z każdym elementem. Na przykład spójrz na to:

Wykonaliśmy iterację (w żargonie programistycznym) po naszej liście za pomocą polecenia i zrobiliśmy coś z każdym z elementów. Zwróć uwagę na specjalną składnię: polecenie kończy się, wskazując, że następne polecenie będzie blokiem jednego lub więcej poleceń. W interpreterze, natychmiast po wprowadzeniu wiersza poleceń kończącego się, znak zachęty wiersza poleceń zmieni się na , co oznacza, że Python wie, że jest jeszcze coś do zrobienia.

Skąd interpreter będzie wiedział, ile kolejnych linii będzie musiało zostać wykonanych wewnątrz operacji ? W tej kwestii Python polega na wcięciach. Następne linie muszą zaczynać się od pustej spacji, lub kilku pustych spacji, lub tabulatora, lub kilku tabulatorów. Dopóki wcięcie pozostaje takie samo, linie będą uważane za część bloku. Jeśli zaczniesz jedną linię od 2 spacji, a następną od 4, pojawi się błąd. Kiedy skończysz, po prostu napisz kolejną linię bez wcięć lub naciśnij, aby powrócić z bloku

Wcięcia pomagają również w czytelności programu. Jeśli użyjesz dużych wcięć (na przykład użyjesz tabulatorów zamiast spacji) podczas pisania dużego programu, będziesz mieć wyraźny widok na to, co jest wykonywane wewnątrz czego. Zobaczymy, że inne polecenia również używają wciętych bloków kodu.

Komenda może być używana do wielu rzeczy, które muszą być wykonane więcej niż jeden raz. Można ją na przykład połączyć z poleceniem :

Jeśli uruchamiałeś przykłady kodu w interpreterze poprzez kopiuj-wklej, poprzedni blok tekstu spowoduje wyświetlenie błędu. Zamiast tego skopiuj do końca wciętego bloku, tj. do końca linii, a następnie wklej w interpreterze. W interpreterze naciskaj, aż zniknie trzykropkowy znak zachęty i kod zostanie uruchomiony. Następnie skopiuj dwie ostatnie linie, po czym naciśnij. Powinna pojawić się ostateczna odpowiedź.

Jeśli wpiszesz do interpretera zobaczysz:

Tutaj nawiasy kwadratowe oznaczają opcjonalny parametr. Oczekuje się jednak, że wszystkie będą liczbami całkowitymi. Poniżej wymusimy, aby parametr step był liczbą całkowitą przy użyciu :

Kolejny przykład :

Komenda ma również tę dziwną cechę, że zaczyna się od  (jeśli nie podasz liczby początkowej), a jego ostatnia liczba będzie o jeden mniejsza niż podana liczba końcowa. Dzieje się tak oczywiście dlatego, że działa dobrze z innymi poleceniami Python. Na przykład:

Innym interesującym zastosowaniem wciętych bloków jest polecenie. Polecenie to wykonuje blok kodu tylko wtedy, gdy spełniony jest określony warunek, na przykład:

Oczywiście zawsze spowoduje to wydrukowanie zdania, ale spróbuj zastąpić drugą linię:

Wtedy nic nie zostanie wydrukowane. Możemy również określić instrukcję :

Funkcje
Istnieje bardzo niewiele standardowych poleceń Python i znamy już kilka z nich. Można jednak tworzyć własne polecenia. W rzeczywistości większość dodatkowych modułów, które można podłączyć do instalacji Pythona, robi właśnie to - dodaje polecenia, których można używać. Niestandardowa komenda w Pythonie nazywana jest funkcją i jest tworzona w następujący sposób:

Polecenie definiuje nową funkcję, nadaje jej nazwę, a wewnątrz nawiasów definiuje argumenty, których funkcja będzie używać. Argumenty to dane, które zostaną przekazane do funkcji. Na przykład, spójrz na polecenie. Jeśli po prostu napiszesz, Python powie ci, że potrzebuje argumentu. Co jest oczywiste: chcesz poznać długość czegoś. Jeśli napiszesz to  jest argumentem, który przekazujesz do funkcji. Funkcja jest zdefiniowana w taki sposób, że wie, co zrobić z tym argumentem. To samo zrobiliśmy z naszą funkcją.

Nazwa może być dowolna i będzie używana tylko wewnątrz funkcji. Jest to po prostu nazwa, którą nadajesz argumentowi, abyś mógł coś z nim zrobić. Definiując argumenty, informujesz również funkcję, ilu argumentów może oczekiwać. Na przykład, jeśli zrobisz tak:

wystąpi błąd. Nasza funkcja została zaprogramowana do przyjmowania tylko jednego argumentu, ale otrzymała dwa, i. Wypróbujmy inny przykład:

Tutaj stworzyliśmy funkcję, która otrzymuje dwa argumenty, sumuje je i zwraca tę wartość. Zwracanie czegoś jest bardzo przydatne, ponieważ możemy zrobić coś z wynikiem, na przykład zapisać go w zmiennej.

Moduły
Teraz, gdy masz już dobre pojęcie o tym, jak działa Python, musisz wiedzieć jeszcze jedną rzecz: jak pracować z plikami i modułami.

Do tej pory pisaliśmy instrukcje Python linia po linii w interpreterze. Ta metoda nie jest oczywiście odpowiednia dla większych programów. Zwykle kod programów Python jest przechowywany w plikach z rozszerzeniem. Są to zwykłe pliki tekstowe, a do ich tworzenia i edycji można użyć dowolnego edytora tekstu (Linux Gedit, Emacs, vi, Kate lub nawet notatnika Windows).

Istnieje kilka sposobów na wykonanie programu w języku Python. W systemie Windows wystarczy kliknąć plik prawym przyciskiem myszy, otworzyć go w środowisku Python i wykonać. Ale można również wykonać go z poziomu samego interpretera Python. W tym celu interpreter musi wiedzieć, gdzie znajduje się program. We FreeCAD najprostszym sposobem jest umieszczenie programu w folderze, który interpreter Python dla FreeCAD zna domyślnie, takim jak folder użytkownika FreeCAD : Dodajmy tam podfolder o nazwie, a następnie napiszmy taki plik:
 * W systemie Linux jest to zazwyczaj  lub.
 * Na macOS jest to zazwyczaj.
 * W systemie Windows jest to, którym zwykle jest.

Zapisz plik jako w folderze  i w oknie interpretera wpisz:

bez rozszerzenia. Spowoduje to wykonanie zawartości pliku, linia po linii, tak jakbyśmy napisali go w interpreterze. Funkcja sumy zostanie utworzona, a wiadomość zostanie wydrukowana. Pliki zawierające funkcje, takie jak nasza, nazywane są modułami.

Kiedy piszemy funkcję w interpreterze, wykonujemy ją w ten sposób:

Kiedy jednak importujemy moduł zawierający funkcję, składnia jest nieco inna:

Oznacza to, że moduł jest importowany jako "kontener", a wszystkie jego funkcje znajdują się wewnątrz tego kontenera. Jest to bardzo przydatne, ponieważ możemy importować wiele modułów i utrzymywać wszystko dobrze zorganizowane. Zasadniczo, gdy widzisz, z kropką pomiędzy, oznacza to, że znajduje się wewnątrz.

Możemy również zaimportować naszą funkcję sum bezpośrednio do głównej przestrzeni interpretera:

Prawie wszystkie moduły to robią: definiują funkcje, nowe typy danych i klasy, których można używać w interpreterze lub we własnych modułach Pythona, ponieważ nic nie stoi na przeszkodzie, aby importować inne moduły wewnątrz swojego modułu!

Skąd mamy wiedzieć, jakie moduły posiadamy, jakie funkcje się w nich znajdują i jak ich używać (czyli jakich argumentów potrzebują)? Widzieliśmy już, że Python posiada funkcję. Wykonanie:

da nam listę wszystkich dostępnych modułów. Możemy zaimportować dowolny z nich i przeglądać jego zawartość za pomocą polecenia :

Zobaczymy wszystkie funkcje zawarte w module, a także dziwne rzeczy o nazwach , ,. Każda funkcja w dobrze stworzonym module ma, który wyjaśnia, jak z niej korzystać. Na przykład widzimy, że w module matematycznym znajduje się funkcja. Chcesz wiedzieć, jak z niej korzystać?

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.