Adapterプログラミングスタイル規則

AdapterはPython言語で記述されているため、Adapter開発者は Pythonプログラミング規則 を厳守する必要があります。

また、Adapterプログラミングのメンテナンス性と読みやすさを向上させるために、Adapterは本節で記述される規則も厳守する必要があります。

命名規則

1. クラス名にはキャメルケースを使用します。次に例を示します。

   class AdapterWidget
   

2. クラスのメンバー変数とメンバー関数は、アンダースコアで結合された小文字の単語を使用します。次に例を示します。

   self.pick_count # Note that variables are generally nouns
   def start_viz(self): # Note that the function name is generally a verb + object
       pass
   

3. クラスのメンバー変数とメンバー関数がクラス内でのみ使用される場合は、名前の前にアンダースコアを追加して、その名前をクラス外で使用することは推奨されていませんが、クラス外で使用できます。次に例を示します。

   self._socket = socket() # Indicates that the _socket variable is only used inside the class
   def _init_widget(self): # Indicates that the _init_widget function is only used inside the class
       pass
   

4. 定数はアンダースコアで結合されたア大文字の単語を使用します。次に例を示します。

   ADAPTER_DIR = "D:/adapter_for_communication"
   

コメントの規則

コメントを適切に使用する必要があります。表現が複雑な場合、または表現された意味が重要な場合にのみ追加する必要があります。

• 一行コメント

  一行コメントは#で始めます。

• 複数行コメント

  複数行コメントは"""と"""の間に記述します。

• 関数、クラス、またはパッケージ紹介のコメント

  コメントは、関数の下、クラスの下、またはパッケージの先頭に配置されます。次に例を示します。

  def viz_is_running(self):
  
      """
      Will be called when find viz is running during starting viz.
      """
  
  class Adapter(QObject):
  
      """
      Base class which encapsulates Viz/Vision/Hub/Robserver inter faces.
      """
  
  """
  Service base classes.
  """
  
  import logging
  

ログ規則

ログは、エラーが発生したときに問題を分析するのに役立ちます。主要関数を呼び出す場合、関数が参照可能なデータを返す場合など、適切な場合にログ情報を出力するのが最適です。

Adapterは、次の2つのログ出力方法をサポートしています。

• print：この方法は、ログをコンソールに出力するだけです。実行時のリアルタイム監視には便利ですが、プログラムはエラーが発生するとメッセージが失われます。したがって、実際の生産で使用することはお勧めしません。

• logging：この方法は、ログ表示形式をフォーマットすることをサポートし、ログをログファイルに保存することもサポートします（選択可能な機能）。したがって、この方法を使用することをお勧めします。