PyCharm 2019.2ヘルプ

PyCharmリファクタリングチュートリアル

このチュートリアルの内容

このチュートリアルでは、有理数を利用する単純なクラスの例を使用して、PyCharmで利用可能ないくつかのリファクタリングを示します。

前提条件

次の前提条件が満たされていることを確認してください。

  • PyCharmバージョン2016.2以降で作業しています。

  • プロジェクトはすでに作成されています。

例の準備

プロジェクトにPythonファイル rational.py を作成し、次のコードを追加します。

from collections import namedtuple class Rational(namedtuple('Rational', ['num', 'denom'])): def __new__(cls, num, denom): if denom == 0: raise ValueError('Denominator cannot be null') if denom < 0: num, denom = -num, -denom return super().__new__(cls, num, denom) def __str__(self): return '{}/{}'.format(self.num, self.denom)

有理数を単純化する

分子と分母を最大公約数で除算して有理数を単純化しましょう:

from collections import namedtuple class Rational(namedtuple('Rational', ['num', 'denom'])): def __new__(cls, num, denom): if denom == 0: raise ValueError('Denominator cannot be null') if denom < 0: num, denom = -num, -denom x = abs(num) y = abs(denom) while x: x, y = y % x, x factor = y return super().__new__(cls, num // factor, denom // factor) def __str__(self): return '{}/{}'.format(self.num, self.denom)

メソッドの抽出

ここでは、最も大きな共通の除数の検索を別の方法に抽出しましょう: これを行うには、ステートメントを選択する

x = abs(num) y = abs(denom) while x: x, y = y % x, x factor = y

Ctrl+Alt+Mを押します。開いたダイアログボックスでメソッド名 gcd を入力し、OKをクリックします。

@staticmethod def gcd(denom, num): x = abs(num) y = abs(denom) while x: x, y = y % x, x factor = y return factor

ローカル変数のインライン化とメソッドシグネチャーの変更

インライン変数リファクタリングを使って、変数 factorを取り除きましょう。そのためには、変数にキャレットを置いて Ctrl+Alt+Nを押します。検出された factor 変数はすべてインライン化されています。

次に、シグネチャーの変更を使ってパラメータ名を変更します。そのためには、メソッド宣言行にキャレットを置き、Ctrl+F6を押します。開いたダイアログで、パラメータ denomnum をそれぞれ xy に名前変更し、icons nodes upLevel svg をクリックしてパラメータの順序を変更します。

次のコードで終わります:

@staticmethod def gcd(x, y): x = abs(x) y = abs(y) while x: x, y = y % x, x return y

クイック・フィックスの使用

既存の静的メソッドを関数に変換しましょう: これを行うには、Alt+Enterを押し、候補リストからstatic メソッドを関数に変換するを選択し、Enterを押します:

from collections import namedtuple class Rational(namedtuple('Rational', ['num', 'denom'])): def __new__(cls, num, denom): if denom == 0: raise ValueError('Denominator cannot be null') if denom < 0: num, denom = -num, -denom factor = gcd(num, denom) return super().__new__(cls, num // factor, denom // factor) def __str__(self): return '{}/{}'.format(self.num, self.denom) def gcd(x, y): x = abs(x) y = abs(y) while x: x, y = y % x, x return y

関数を別のファイルに移動する

それでは、関数を別のファイルに移動してimportステートメントを追加します。そのためには、関数 gcd 宣言にキャレットを置き、F6を押します。開いたダイアログで、宛先ファイル util.pyの完全修飾パスを指定します。このファイルは存在しませんが、自動的に作成されます。

def gcd(x, y): x = abs(x) y = abs(y) while x: x, y = y % x, x return y

インポート文も自動的に追加されます。ファイル rational.py は次のようになります。

from collections import namedtuple from util import gcd class Rational(namedtuple('Rational', ['num', 'denom'])): def __new__(cls, num, denom): if denom == 0: raise ValueError('Denominator cannot be null') if denom < 0: num, denom = -num, -denom factor = gcd(num, denom) return super().__new__(cls, num // factor, denom // factor) def __str__(self): return '{}/{}'.format(self.num, self.denom)

クラスRationalのさらなる変更

マジックメソッドの追加

次に、クラス Rationalのオブジェクトに対する加減演算のためのマジックメソッドの宣言を追加しましょう。

from collections import namedtuple from util import gcd class Rational(namedtuple('Rational', ['num', 'denom'])): def __new__(cls, num, denom): if denom == 0: raise ValueError('Denominator cannot be null') factor = gcd(num, denom) if denom < 0: num, denom = -num, -denom return super().__new__(cls, num // factor, denom // factor) def __str__(self): return '{}/{}'.format(self.num, self.denom) def __add__(self, other): if isinstance(other, int): other = Rational(other, 1) if isinstance(other, Rational): new_num = self.num * other.denom + other.num * self.denom new_denom = self.denom * other.denom return Rational(new_num, new_denom) return NotImplemented def __neg__(self): return Rational(-self.num, self.denom) def __radd__(self, other): return self + other def __sub__(self, other): return self + (-other) def __rsub__(self, other): return -self + other

メソッドの抽出とクイックフィックスの使用

次に、式 Rational(other, 1) を別のメソッドに抽出します。これを行うには、前述の式にキャレットを置き、Ctrl+Alt+M を押し、開いているダイアログボックスに新しいメソッド名 from_intを入力します。

最後に、メソッド from_int 宣言にキャレットを置き、Alt+Enterを押し、候補リストからメソッドを static にするを選択し、Enterを押します。

@staticmethod def from_int(other): return Rational(other, 1)

最後に、パラメータ other の名前を numberに変更しましょう。これを行うには、パラメータにキャレットを置き、Shift+F6を押します。

スーパークラスの抽出

次に、メソッド __radd__ , __sub____rsub__ の実装をスーパークラスに移動します。また、メソッド __neg____add__ を抽象化します。

これは完了です...クラス Rational 宣言にキャレットを置き、コンテキストメニューでリファクタリング | 抽出を指し、スーパークラスの抽出...を選択します。次に、表示されるダイアログボックスで、スーパークラスの名前(ここでは AdditiveMixin)を指定し、スーパークラスに追加するメソッドを選択します。メソッド __neg__ および __add__に対しては、列abstract にするチェックボックスを選択します。

次のコードで終了します。

from abc import abstractmethod, ABCMeta from collections import namedtuple from util import gcd class AdditiveMixin(metaclass=ABCMeta): @abstractmethod def __add__(self, other): pass @abstractmethod def __neg__(self): pass def __radd__(self, other): return self + other def __sub__(self, other): return self + (-other) def __rsub__(self, other): return -self + other class Rational(namedtuple('Rational', ['num', 'denom']), AdditiveMixin): def __new__(cls, num, denom): if denom == 0: raise ValueError('Denominator cannot be null') factor = gcd(num, denom) if denom < 0: num, denom = -num, -denom return super().__new__(cls, num // factor, denom // factor) def __str__(self): return '{}/{}'.format(self.num, self.denom) def __add__(self, other): if isinstance(other, int): other = self.from_int(other) if isinstance(other, Rational): new_num = self.num * other.denom + other.num * self.denom new_denom = self.denom * other.denom return Rational(new_num, new_denom) return NotImplemented def from_int(self, number): return Rational(number, 1) def __neg__(self): return Rational(-self.num, self.denom)
最終更新日: 2019年8月21日

関連事項

関連ページ:

メソッドの抽出ダイアログ

JavaScriptコンテキストでは、ダイアログボックスのタイトルが関数の抽出に変更されることがあります。名前このテキストボックスに、選択されたソースコードに基づいて生成される関数またはメソッドの名前を指定します。パラメーターこの領域で、新しいメソッド/関数に渡すパラメータを選択します。新しい方法の...

インライン化

インライン化リファクタリングでは、メソッドまたは変数の抽出リファクタリングを元に戻すことができます。インライン化するコードフラグメント内にカーソルを置きます。を押します。または、をクリックします。インライン化ダイアログで、インライン化オプションを指定します。プレビューと変更の適用、インライン変数:変...

スーパークラスの抽出ダイアログ

スーパークラスを抽出この読み取り専用フィールドには、スーパークラスを抽出するクラスの名前が表示されます。スーパークラス名このテキストフィールドに、スーパークラス名を入力します。新しいクラスのディレクトリーこのテキストフィールドに、新しいクラスが格納されるターゲットディレクトリーへのパスを指定します。...

コードリファレンス情報

このセクションでは、シンボルの定義を表示し、ドキュメント参照を表示し、ビューパラメータ情報機能を使用する方法について説明します。定義:PyCharmでは、タグ、クラス、フィールド、メソッド、関数などのシンボルがプロジェクトでどのように定義されているかを確認することができます。この目的のために、IDE...