map-visualization

DB(SQLite)内の住所データをGeocodingして地図にプロットする。

利用サービス

• Geocoding API - 住所から緯度経度を検索
  • APIコールは、10秒に1回に抑える必要がある

利用ライブラリ

• 地図データ可視化に使用
  • folium
    • foliumの基本的な使い方とオープンデータ活用 - Qiita
  • pandas
• Geocoding APIコール、解析に使用
  • requests
  • beautifulsoup4
  • lxml
• プログレスバー表示に使用
  • tqdm

開発環境

ツール種類	ツール名
依存関係管理	Poetry
テストフレームワーク	pytest
リンター	flake8
フォーマッター	black
型チェック	mypy

実行方法

python ./app.py
# もしくは
make start

• プロジェクトディレクトリのplaces_test.dbを読み込む
• 地図をmap.htmlとして出力

開発方法

Poetry導入

開発環境に無ければ入れる。使い方まとめはこちら。

Mac / Linux

> curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python

Windows (※Powershellで導入)

> (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -UseBasicParsing).Content | python

依存パッケージの一括インストール

poetry install

仮想環境に入る

lintやunit testは仮想環境に入って実行する。出るのはexit。

poetry shell

とりあえず一通り動確したい時

make lint
make ut
make start

Unit Test

全部実行

pytest
pytest -v # verbose
pytest -s # 標準出力を出す (--capture=noと同じ)
pytest -ra # サマリーを表示 (テストをpassしたもの以外)
pytest -rA # サマリーを表示 (テストをpassしたものも含む)

指定して実行
(テストファイル名, パッケージ名, テストクラス名, メソッド名, 割と何でも拾ってくれる。部分一致でも。)

pytest -k app
pytest -k test_app.py
pytest -k my

マーカーを指定して実行

pytest -m 'slow'
pytest -m 'not slow'

カバレッジレポートも作成

pytest -v --capture=no --cov-config .coveragerc --cov=main --cov-report=xml --cov-report=term-missing .

もしくは

make ut

VSCodeでコードカバレッジを見るには、Coverage Gutters (プラグイン) を入れる。表示されない場合は、コマンドパレットでCoverage Gutters: Display Coverageする。

• VSCodeでカバレッジを表示する（pytest-cov）

Lint

flake8 --max-line-length=100 --ignore=E203,W503 ./main

もしくは

make lint

参考

• 基本的な使い方 - Poetry documentation (ver. 1.1.6 日本語訳)
• Configuration — pytest documentation
• Usage and Invocations — pytest documentation