Python console/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Caption|Przykładowy kod Pythona, który generuje obiekty w oknie widoku 3D.}}")
(Updating to match new version of source page)
(10 intermediate revisions by 2 users not shown)
Line 20: Line 20:
Konsola Pythona potrafi wykonać uzupełnienie podstawowego kodu. Gdy po obiekcie zostanie zapisana kropka, pokaże na przykład publiczne metody i atrybuty ''(zmienne)'' bieżącego obiektu ''(klasy)'', {{incode|obj.}}
Konsola Pythona potrafi wykonać uzupełnienie podstawowego kodu. Gdy po obiekcie zostanie zapisana kropka, pokaże na przykład publiczne metody i atrybuty ''(zmienne)'' bieżącego obiektu ''(klasy)'', {{incode|obj.}}


Konsola jest również w stanie wyświetlić łańcuch dokumentacji konkretnej funkcji, gdy zapisywany jest otwierający nawias, na przykład {{kod|funkcja(}}
Konsola jest również w stanie wyświetlić łańcuch dokumentacji konkretnej funkcji, gdy zapisywany jest otwierający nawias, na przykład {{incode|function(}}


[[File:FreeCAD_Python_console_example.png|800px]]
[[File:FreeCAD_Python_console_example.png|800px]]
Line 26: Line 26:
{{Caption|Przykładowy kod Pythona, który generuje obiekty w oknie widoku 3D.}}
{{Caption|Przykładowy kod Pythona, który generuje obiekty w oknie widoku 3D.}}


Skrypty inicjujące FreeCAD automatycznie ładują niektóre moduły i definiują niektóre aliasy. Dlatego też, są one dostępne w konsoli Pythona
The FreeCAD initialization scripts automatically load some modules, and define some aliases. Therefore, in the Python console these are available
{{Code|code=
{{Code|code=
App = FreeCAD
App = FreeCAD
Line 32: Line 32:
}}
}}


W związku z tym są one równe
Therefore these are equal


{{Code|code=
{{Code|code=
Line 39: Line 39:
}}
}}


{{Emphasis|Note:}} these pre-loaded modules and aliases are only available from the Python console embedded inside the FreeCAD program. If you use FreeCAD as a library in an external program, you must remember to load the {{incode|FreeCAD}} and {{incode|FreeCADGui}} modules and define the necessary aliases if you wish.
{{Emphasis|Note:}} Te wstępnie załadowane moduły i aliasy dostępne tylko z konsoli Pythona wbudowanej w program FreeCAD. Jeśli używasz FreeCAD jako biblioteki w zewnętrznym programie, musisz pamiętać o załadowaniu modułów {{incode|FreeCAD}} i {{incode|FreeCADGui}} i zdefiniowaniu niezbędnych aliasów, jeżeli zachodzi taka potrzeba.


== Actions ==
==Działania==


Kliknij prawym przyciskiem myszy na konsoli Pythona, aby wyświetlić kilka poleceń:
Right click on the Python console shows some commands:
* {{MenuCommand|Copy}}: stores the selected text in the clipboard for later pasting; it is disabled if nothing is selected.
*{{MenuCommand|Copy}}: Przechowuje zaznaczony tekst w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.
* {{MenuCommand|Copy command}}: stores the selected command in the clipboard for later pasting; it is disabled if nothing is selected.
*{{MenuCommand|Copy command}}: Przechowuje wybrane polecenie w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.
* {{MenuCommand|Copy history}}: copy the entire history of Python commands entered in this session.
* {{MenuCommand|Save history as}}: save the entire history of Python commands entered in this session to a text file.
* {{MenuCommand|Paste}}: paste previously copied text in the clipboard to the Python console.
* {{MenuCommand|Select all}}: selects all text in the Python console.
* {{MenuCommand|Clear console}}: erases all commands entered into the Python console. This is useful if the Python console is full of messages and previously entered commands that may be distracting when testing a new function. This is merely aesthetic, as this command doesn't delete existing variables nor clears the imported modules in the session.
* {{MenuCommand|Insert file name}}: opens a dialog to search for a file in the system, then it inserts the full path of the file. This is useful to test functions that process an input file, without having to write the entire name in the console, which is error prone. This command does not run the file, and does not import it as a Python module, it just returns the full path of that file.
* {{MenuCommand|Word wrap}}: wrap very long lines that exceed the horizontal dimension of the Python console.



{{Interface}}
*{{MenuCommand|Historia kopiowania}}: Skopiuj całą historię poleceń Pythona wprowadzonych w tej sesji.
{{Userdocnavi}}
*{{MenuCommand|Zapisz historię jako}}: Zapisuje całą historię poleceń Pythona wprowadzonych w tej sesji do pliku tekstowego.
*{{MenuCommand|Wklej}}: Wklej uprzednio skopiowany tekst ze schowka do konsoli Pythona.
* {{MenuCommand|Zaznacz wszystko}}: Zaznacza cały tekst w konsoli Pythona.
* {{MenuCommand|Wyczyść konsolę}}: Usuwa wszystkie polecenia wprowadzone do konsoli Pythona. Jest to przydatne, gdy konsola Pythona jest pełna komunikatów i wcześniej wprowadzonych poleceń, które mogą rozpraszać podczas testowania nowej funkcji. Jest to tylko estetyczne, ponieważ polecenie to nie usuwa istniejących zmiennych ani nie usuwa zaimportowanych modułów w sesji.
*{{MenuCommand|Wstaw nazwę pliku}}: Otwiera okno dialogowe do wyszukiwania pliku w systemie, a następnie wstawia pełną ścieżkę do pliku. Jest to przydatne do testowania funkcji, które przetwarzają plik wejściowy, bez konieczności zapisywania całej nazwy w konsoli, co jest podatne na błędy. To polecenie nie uruchamia pliku i nie importuje go jako modułu Pythona, tylko zwraca pełną ścieżkę do tego pliku.
* {{MenuCommand|Zawijanie linii}}: zawijaj bardzo długie linie, które przekraczają poziomy wymiar konsoli Pythona.


{{Interface{{#translation:}}}}

{{Std Base navi{{#translation:}}}}

{{Userdocnavi{{#translation:}}}}

Revision as of 05:48, 19 February 2020

(styczeń 2020) FreeCAD został pierwotnie zaprojektowany do współpracy z Pythonem 2. Ponieważ Python 2 osiągnął koniec życia w 2020 roku, dalszy rozwój FreeCAD będzie się odbywał wyłącznie z Pythonem 3, a kompatybilność wsteczna nie będzie utrzymywana.

Wprowadzenie

Konsola Pythona to panel, który uruchamia instancję interpretera Python, który może być używany do sterowania procesami FreeCAD oraz tworzenia i modyfikowania obiektów i ich właściwości.

Konsola Pythona w FreeCAD obsługuje podstawowe kolorowanie składni, potrafi rozróżnić różne style i kolory, komentarze, łańcuchy, wartości liczbowe, wbudowane funkcje, wydrukowany tekst wyjściowy i separatory, takie jak nawiasy i przecinki. Te właściwości konsoli można skonfigurować w Edytor preferencji.

Konsola Pythona pokazująca komunikaty, gdy FreeCAD właśnie się uruchamia.

Tworzenie skryptów

Dla absolutnie początkujących, zobacz: Wprowadzenie do Pythona, oraz Samouczek tworzenia skryptów Python.

Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.

Konsola Pythona potrafi wykonać uzupełnienie podstawowego kodu. Gdy po obiekcie zostanie zapisana kropka, pokaże na przykład publiczne metody i atrybuty (zmienne) bieżącego obiektu (klasy), obj.

Konsola jest również w stanie wyświetlić łańcuch dokumentacji konkretnej funkcji, gdy zapisywany jest otwierający nawias, na przykład function(

Przykładowy kod Pythona, który generuje obiekty w oknie widoku 3D.

Skrypty inicjujące FreeCAD automatycznie ładują niektóre moduły i definiują niektóre aliasy. Dlatego też, są one dostępne w konsoli Pythona

App = FreeCAD
Gui = FreeCADGui

W związku z tym są one równe

App.newDocument()
FreeCAD.newDocument()

Note: Te wstępnie załadowane moduły i aliasy są dostępne tylko z konsoli Pythona wbudowanej w program FreeCAD. Jeśli używasz FreeCAD jako biblioteki w zewnętrznym programie, musisz pamiętać o załadowaniu modułów FreeCAD i FreeCADGui i zdefiniowaniu niezbędnych aliasów, jeżeli zachodzi taka potrzeba.

Działania

Kliknij prawym przyciskiem myszy na konsoli Pythona, aby wyświetlić kilka poleceń:

  • Copy: Przechowuje zaznaczony tekst w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.
  • Copy command: Przechowuje wybrane polecenie w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.


  • Historia kopiowania: Skopiuj całą historię poleceń Pythona wprowadzonych w tej sesji.
  • Zapisz historię jako: Zapisuje całą historię poleceń Pythona wprowadzonych w tej sesji do pliku tekstowego.
  • Wklej: Wklej uprzednio skopiowany tekst ze schowka do konsoli Pythona.
  • Zaznacz wszystko: Zaznacza cały tekst w konsoli Pythona.
  • Wyczyść konsolę: Usuwa wszystkie polecenia wprowadzone do konsoli Pythona. Jest to przydatne, gdy konsola Pythona jest pełna komunikatów i wcześniej wprowadzonych poleceń, które mogą rozpraszać podczas testowania nowej funkcji. Jest to tylko estetyczne, ponieważ polecenie to nie usuwa istniejących zmiennych ani nie usuwa zaimportowanych modułów w sesji.
  • Wstaw nazwę pliku: Otwiera okno dialogowe do wyszukiwania pliku w systemie, a następnie wstawia pełną ścieżkę do pliku. Jest to przydatne do testowania funkcji, które przetwarzają plik wejściowy, bez konieczności zapisywania całej nazwy w konsoli, co jest podatne na błędy. To polecenie nie uruchamia pliku i nie importuje go jako modułu Pythona, tylko zwraca pełną ścieżkę do tego pliku.
  • Zawijanie linii: zawijaj bardzo długie linie, które przekraczają poziomy wymiar konsoli Pythona.


Template:Interface/pl