Stduy_language_Python

Sample Python List

説明

• プログラミング言語 Python の学習用

免責事項

このソフトウェアの使用または使用不可によって、いかなる問題が生じた場合も、著作者はその責任を負いません。バージョンアップや不具合に対する対応の責任も負わないものとします。

開発環境構築

Pytnon のインストール

• win 版
  1. vscode を開く
  2. ctrl + `でターミナルを開いて移動する
  3. 以下のコマンドを実行

     python

  4. python が入っていないと MicrosoftStore が開いて python のダウンロード画面を出すのでダウンロードする
• 参考サイト
  • Python+VSCode におすすめの拡張機能

venv などの仮想環境を動かすための準備

• win 版

  • 仮想環境を動かすため PowerShell の ps ファイルを実行するものがある

  • しかし PowerShell の環境によっては ps ファイルを実行不可能な設定なのもある

    • .\venv\Scripts\activete を実行すると以下のエラーが出た ..\venv\Scripts\Activate.ps1 を読み込むことができません。

    • 原因 1: PowerShell の安全装置の一つであるスクリプト不許可の設定がされている

      • どういう事か

        • PowerShell の安全装置の一つであるスクリプト不許可の設定がされている

      • 原因なのかどうかの確認方法

        1. PowerShell を実行
        2. Get-ExecutionPolicy コマンドを実行
        3. Restricted が表示されたら原因１に該当

      • 原因対策

        1. PowerShell を管理者として実行

        2. 以下のコマンドを実行して Y を入力 set-executionpolicy remotesigned

        3. Get-ExecutionPolicy コマンドを実行

        4. RemoteSigned が表示されたら OK

      • 参考サイト

        • 「このシステムではスクリプトの実行が無効になっているため、ファイル XXX を読み込みことができません」エラー（PowerShell）が出る原因と対処方法

仮想環境作成

• win 版
  • 以下のコマンドで作成
    • python -m venv venv

仮想環境有効

• win 版
  • 仮想環境を作成したディレクトリに移動して以下のコマンドを実行
    • .\venv\Scripts\activate

仮想環境無効

• win 版
  • 以下のコマンド実行
    • deactivate

デバッグツールの環境作成

• win 版

  • 以下のプロジェクトのディレクトリ構成を元に説明

    • Project
      • .vscode/
      • venv/
      • main.py

    1. .vscode/に settings.json ファイルを追加

    2. setting.json ファイルに以下の内容を記述して保存 { "python.venvPath": "../venv", "python.pythonPath": "../venv" }

       python の path に python.exe があるパスを指定 venv ディレクトリは setting.json がおいているディレクトリの一つ上においているので 相対パス設定の"../venv"でうまくいく

    3. launch.json に環境変数 PYTHONPATH を設定する

       • これを設定しないと自作したモジュールをインポートしてもパスが通っていないからデバッグした時にインポートでエラーとなる

       1. launch.json を作成

       2. "configurations"項目に"env"項目を追加

       3. 環境変数"PYTHONPAT"を通す

          • こんな感じ

            launch.json ↓ { // IntelliSense を使用して利用可能な属性を学べます。 // 既存の属性の説明をホバーして表示します。 // 詳細情報は次を確認してください: https://go.microsoft.com/fwlink/?linkid=830387 "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "justMyCode": true, // 自作モジュールをアクティブにしているファイルからでも実行できるようにするためパスを通している "env": { "PYTHONPATH": "${workspaceFolder}" } } ] }

          • 参考サイト Visual Studio Code で Python デバッグ実行

    4. デバッグ実行してブレークポイントで動くかチェック

       • ちなみに F5 キーでデバッグ実行！
       • launch.json がなければ生成する

  • 参考サイト

    • Python の仮想環境を VSCODE でデバッグできるようにする

コードチェックのツール mypy の環境作成

• win 版

  • 以下のコマンドで mypy をインストール pip install mypy

  • 設定画面の mypy の利用を有効化する

    • グローバル設定ファイル settgins.json に以下の記述を追加 "python.linting.mypyEnabled": true

  • 関数を作成した動作確認

    • 以下のコードを添付して hello(123)の箇所でエラーが表示しているなら成功 def hello(name: str) -> str: return "Hello " + name

    result: str = hello(123)

  • メモ

    • pyfields のパッケージを使うと正しいコードを記述しているのにその箇所がエラーとなっていた
      • つまり不十分！
    • クラスのメソッドで戻り値の型ヒントを付けているメソッドをエラーとしていた。
    • これは利用しない方がいいと判断した
    • 導入が簡単だから入れたが、失敗だった

  • 参考サイト mypy を VS code で使うための手順

フォーマットに合わせてコード整形する環境作成

• win 版

  • 以下のコマンドで black をインストール pip install black

  • VSCode で Black を使うように設定

    • グローバル設定ファイル settgins.json に以下の記述を追加 "python.formatting.provider": "black"

  • alt + shift + f のショートカットキーでコード整形を実行

    • Black で整形するための拡張機能がなけらばインストールを要求するのでその場合はインストール

  • コードが整形されていたら成功

  • 参考サイト

    • Black できれいに自動整形！flake8 と Black 導入と実行

コード補間の環境作成

• これを見てやってくれ！

単体テストの環境構築

1. pytest を利用
   • pip でインストール
     • pip install pytest
2. tests ディレクトリを作成
   1. 作成したディレクトリにinit.py を作成
      • これを作成しないと自作パッケージのインポートでうまくいかずテストが実行できない
3. py ファイルを作成
   • test_xxx の関数を作成する
     • 関数名に test と頭につけないとテスト対象として認識されない
4. テストするコードを記述したり、テストする自作モジュールをインポートする
5. テスト用の py ファイルを開くとアクティブバーにテストアイコンが出るのでクリック
6. テスト用の環境作りますかというボタンがあるのでボタンを押す
7. settings.js に tests ディレクトリのパスを指定 こんな感じ(cli_simple ディレクトリ中にあるテストコードが入っている tests ディレクトリを指定) "${workspaceFolder}/cli_simple/tests",

• 参考サイト
  • pytest でのインストールについて分かった

pytest の collect-only コマンドからテストするように足りないパッケージを教えてくれる

1. 以下のコマンドを実行

   • pytest collect-only
     • テストできるパッケージについての情報など一覧が出る

• 参考サイト
  • 【VSCode】Pytest Discovery Error : Error discovering

pytest を使ったコードデバッグ方法

• 参考サイト
  • pytest のコードでのデバッグ方法

pip でインストールしたパッケージ一覧をエクスポートとインポート方法

• エクスポート方法

  • 以下のコマンドでインストールしたパッケージ一覧を記載したファイルをエクスポートできる pip freeze > requirements.txt

• インポート方法

  • 以下のコマンドでrequirements.txtに記載したパッケージ一覧をインポートできる pip install -r requirements.txt

ローカライズ対応

• 以下のサイトをまず参考にした
  • https://blog.narito.ninja/detail/86/
  • 項目[翻訳ファイルの作成]の前まではそのまま使えた
    • django-admin makemessages -l ja
    • 上記のコマンドを実行したら以下のエラーが出た
      • Django makemessages command generates error: "xgettext: Non-ASCII string"
    • これのサイト以外のを参考にした
• 次はこのサイトが参考になった
  • https://sinyblog.com/django/translation-001/
  • 項目[メッセージファイルの作成]の以下のコマンドでメッセージを作成してみた
    • python manage.py makemessages -l ja
    • しかしエラーになった
      • ImportError: cannot import name ‘ugettext_lazy’ from ‘django.utils.translation’
    • インポートがないというエラーで調査した
      • 以下のサイトで解決した
        • https://forum.djangoproject.com/t/importerror-cannot-import-name-ugettext-lazy-from-django-utils-translation/10943
      • 参考にしたサイトは django3 系のようだ
        • 試した環境が django4 系だと 3 系のインポートファイルがなくなったみたい
      • 利用できるインポートに変えてうまくいった
    • もう一度以下のコマンドを実行
      • python manage.py makemessages -l ja
    • しかしエラーになった
      • Django makemessages command generates error: "xgettext: Non-ASCII string"
      • 最初に参考にしたサイトで試したエラーが起きた
    • 調査したら以下のサイトを参考にして解決出来た
      • https://stackoverflow.com/questions/45078011/django-makemessages-command-generates-error-xgettext-non-ascii-string
      • venv の仮想環境での実行が原因のようだ
      • 以下のコマンドで成功した
        • python manage.py makemessages -l ja -i venv
  • 使える状態になった
• ローカライズテキストの追加やコンパイルなど残り対応について
  • 以下のサイトの翻訳設定や言語コンパイルの項目で対応できる
    • https://sinyblog.com/django/translation-001/

実行で参考にしたサイト

• コマンドツールのエラーコード出力方法
• Json の制御
• LF(ラインフィールド)という改行コードについて
• Ctrl + /で範囲選択したコードを一括コメントアウト出来る！
• config.ini で%%で囲ったテキストの取得方法
  • %%と二重にすると良い
• config.ini にリストや辞書の要素を対応する方法
• クラスの変数の検証が出来るパッケージについて