A PyCharm könnyen használható eszközöket biztosít a gyors és kényelmes szoftverfejlesztéshez. Az alább felsorolt főbb funkciók gyakorlati használatát a KfGyak_01_01_elso_teszt_py.mp4 videó részletesen bemutatja.

Új Python program létrehozása

• Egy már létező forráskód elmentése más néven: File / Save as...
• Új üres forráskód létrehozása: File / New... / Python File

Csomag definíciók gyors elérése

• A csomag neve után tett pont . hatására megjelennek a csomag definíciói. Továbbgépeléssel szűkíthetjük a találati listát. A találti lista elemei között fel-le lépkedve a kurzor nyilakkal választhatunk.
• Az Enter lenyomásával a PyCharm beilleszti a kiválasztott definíciót, és megtartja a sorban utána következő részeket.
• A Tab lenyomásakor a következő definíciós határig terjedő részt lecseréli a listában kiválasztottra.

Undo

• A CTRL + Z lenyomásával visszavonhatjuk a legutóbbi szerkesztési lépéseinket.

Definíciós segítség, dokumentáció elérése (angol nyelven!)

• Függvény fejlécben gépelve a sor felett megjelenik a paraméterlista, kiemelve az éppen aktuális paramétert.
• Ha ez eltűnik, akkor a CTRL + P segítségével újra előhozható.
• Az egér kurzort mozgatva információt kaphatunk az alatta elhelyezkedő elemről. Változók esetén a definiálásukat mutatja, függvény neve esetén pedig a függvény dokumentációját. Ha ez az információ eltűnik, a CTRL + Q lenyomására újra előhozható.
• A CTRL + Q újbóli lenyomásával ez a dokumentáció egy új panelen jelenik meg, amit a jobb felső sarokban lévő vízszintes vonal alakú ikonnal minimalizálhatunk, ha már nincs rá szükségünk.

Figyelmeztetések, hibák, gépelési hibák

• A PyCharm a szerkesztőablak alsó részén füleken választható információs ablakokat jelenít meg.
  • Run: program futása közbeni konzol
  • Python Console: Python parancssorban gépelhetünk
  • Terminal: parancssori környezetben gépelhetünk
  • Problems: hibák, figyelmeztetések, gépelési hibák
• A szerkesztőfelület jobb felső sarkában ikonokkal jelzi a hibákat, a figyelmeztetéseket és a gépelési hibákat
• A jobb oldalsó részen, a görgőn színes csíkokkal jelzi a problémás helyeket. Az egérmutatót ráhúzva leírást kapunk. Kattintva az adott sorra ugrik.
• A hibákat javítani kell, a figyelmeztetéseket érdemes. A gépelési hibákat az angol nyelv szerint kezeli. Megjegyzésekeben és forráskódban is. Ha zavar, de nem akarjuk átírni, akkor felvehetjük a szótárba.

Refaktorálás

• Refactor menü elemei: Refactor This..., Rename..., ...
• Változókat, függvényeket, fájlokat tetszőlegesen át tudunk nevezni.
• Alapértelmezetten a teljes projekten belül, annak minden forrásfájljában elvégzi a módosítást! Ezt szűkíthetjük például az aktuális fájlra.

Az OpenCV Python csomagjának 4.10 verziója kompatibilis a PyCharm csomagfeltérképező funkciójával, vagyis a PyCharm a kezdeti feltérképezés után ismerni fogja az OpenCV függvényeket és eléri a dokumentációkat. További teendőnk ekkor nincs!

Néhány korábbi OpenCV Python csomag nem kompatibilis a PyCharm csomagfeltérképező funkciójával, illetve elképzelhető, hogy a jövőben ilyen eset újra előfordulhat. Amennyiben ez a helyzet, akkor nem kapunk meg fontos segítségeket a fejlesztéshez, a szerkesztő pedig figyelmeztetéseket jelez az OpenCV függvényeknél. A főbb tünetek az alábbiak:

• A cv2. begépelése után nem jelennek meg az OpenCV definíciók.
• Az OpenCV függvények fejlécében nem kapunk információt a paraméterekről (pl. Ctrl + P lenyomásakor).

Ebben az esetben javításra az alábbi javaslatok érhetők el egy angol nyelvű fórum bejegyzésben:

• OpenCV code completion is (still!) not working

A tapasztalataim szerint a Workaround 2 rendben működik Windows környezetben. A lépések röviden az alábbiak.

• Állítsuk üzembe a példatárat az előzőleg leírt módon. Feltételezzük, hogy a hibajelenség fennáll. Győződjünk meg róla, hogy az indexelő háttérfolyamat véget ért.
• Lépjünk be a Python értelmező beállításokba.
  • File / Settings... / Project... / Python Interpreter
  • Nyissuk le a Python Interpreter listát, és válasszuk ki a Show all... opciót.
  • A megjelenő új ablak bal felső részében keressük meg a Show Interpreter Paths ikont és kattintsunk rá.
  • Az újabb ablak bal felső sarkában kattintsunk a + jelre.
  • Tallózzuk be a Python telepítési mappánk Lib/site-packages/cv2 mappát.
  • Lépjünk ki a beállítási ablakokból az OK gombok megnyomásával.
  • Elkezdődik a cv2 csomag feltérképezése.
  • Ha véget ér, használhatók az előzőleg hiányzó funkciók. Teszteljük a Ctrl + P lenyomásával egy OpenCV függvény hívási fejlécében.
  • Ha később hibát kapnánk program futtatáskor, akkor a kézzel hozzáadott site-packages/cv2 mappát törölhetjük a listáról. A feltérképezési információ nem vész el. Ilyen hiba inkább Linux környezetben fordul elő.