PythonとSubprocessで学ぶWi-Fi情報取得プロジェクト

python -m venv myenv

myenv\Scripts\activate

python3 -m venv myenv

source myenv/bin/activate

# 今回のプロジェクトでは標準ライブラリのみを使用
# 外部ライブラリは使用しません

# Windows用とmacOS用のコマンド設定をここで管理します
# 実際の内容は次のステップで追加予定

python --version

python3 --version

# 必要なライブラリをインポート
import subprocess  # システムコマンドを実行するためのライブラリ
import os  # ファイルやフォルダの操作に使用
import platform  # 実行中のOSを判定するためのライブラリ


class NetworkInfoManager:
    """Wi-Fiネットワーク情報を取得・管理するクラス"""
    
    def __init__(self):
        """クラスが作成されたときに最初に実行される関数"""
        # 現在動作しているOSの名前を取得して保存
        self.operating_system = platform.system()
        # 検出されたOSをユーザーに表示
        print(f"検出されたOS: {self.operating_system}")

    def check_platform(self):
        """実行中のOSを判定して、使用するコマンドの種類を決める関数"""
        # WindowsかMacかLinuxかを判定
        if self.operating_system == "Windows":
            # Windowsの場合は"windows"を返す
            return "windows"
        elif self.operating_system == "Darwin":  # macOSは内部的にDarwinという名前
            # macOSの場合は"macos"を返す
            return "macos"
        else:
            # それ以外のOSの場合はエラーメッセージを表示
            print(f"サポートされていないOS: {self.operating_system}")
            return "unsupported"

    def execute_command(self, command_list):
        """コマンドを実行して結果を取得する関数
        
        Args:
            command_list: 実行したいコマンドをリスト形式で指定
            
        Returns:
            str: コマンドの実行結果（文字列）、失敗した場合はNone
        """
        try:
            # subprocessを使ってコマンドを実行
            result = subprocess.check_output(
                command_list,  # 実行するコマンドのリスト
                stderr=subprocess.STDOUT,  # エラーメッセージも結果に含める
                timeout=10  # 10秒でタイムアウトする設定
            )
            # コマンドの結果はバイト形式なので、文字列に変換して返す
            return result.decode('utf-8', errors='ignore')
        except subprocess.CalledProcessError as e:
            # コマンドの実行が失敗した場合
            print(f"コマンド実行エラー: {e}")
            return None
        except subprocess.TimeoutExpired:
            # コマンドが指定時間内に終わらなかった場合
            print("コマンドがタイムアウトしました")
            return None
        except Exception as e:
            # その他の予想外のエラーが発生した場合
            print(f"予期しないエラー: {e}")
            return None

    def get_current_wifi_name(self):
        """現在接続中のWi-Fiネットワークの名前を取得する関数
        
        Returns:
            str: Wi-Fi名、取得に失敗した場合はNone
        """
        # まず現在のOSを判定
        platform_type = self.check_platform()
        
        if platform_type == "windows":
            # Windows環境の場合
            # netshコマンドでWi-Fiのインターフェース情報を取得
            command = ["netsh", "wlan", "show", "interfaces"]
            # 上で定義したexecute_command関数でコマンドを実行
            output = self.execute_command(command)
            
            if output:
                # コマンドの結果からWi-Fi名を抽出
                return self._parse_windows_wifi_name(output)
                
        elif platform_type == "macos":
            # macOS環境の場合
            # networksetupコマンドで現在のWi-Fiネットワークを取得
            command = ["networksetup", "-getairportnetwork", "en0"]
            # コマンドを実行
            output = self.execute_command(command)
            
            if output:
                # コマンドの結果からWi-Fi名を抽出
                return self._parse_macos_wifi_name(output)
        
        # どちらでもない場合やエラーの場合はNoneを返す
        return None

    def _parse_windows_wifi_name(self, command_output):
        """Windowsのnetshコマンドの結果からWi-Fi名を取り出す関数
        
        Args:
            command_output: netshコマンドの実行結果（文字列）
            
        Returns:
            str: Wi-Fi名、見つからない場合はNone
        """
        # コマンドの結果を改行文字で分割して、1行ずつ処理
        lines = command_output.split('\n')
        
        # 各行を順番にチェック
        for line in lines:
            # 行の前後にある余分な空白を削除
            cleaned_line = line.strip()
            
            # この行に"ssid"という文字が含まれているかチェック（大文字小文字区別なし）
            # 同時に":"（コロン）も含まれているかチェック
            if "ssid" in cleaned_line.lower() and ":" in cleaned_line:
                # コロンで文字列を分割（最初のコロンのみで分割）
                parts = cleaned_line.split(":", 1)
                # 分割が正常にできた場合
                if len(parts) >= 2:
                    # コロンの右側がWi-Fi名なので取得
                    wifi_name = parts[1].strip()  # 前後の空白も削除
                    # Wi-Fi名が空でない場合は返す
                    if wifi_name and wifi_name != "":
                        return wifi_name
        
        # どの行からもWi-Fi名が見つからなかった場合
        return None

    def _parse_macos_wifi_name(self, command_output):
        """macOSのnetworksetupコマンドの結果からWi-Fi名を取り出す関数
        
        Args:
            command_output: networksetupコマンドの実行結果（文字列）
            
        Returns:
            str: Wi-Fi名、見つからない場合はNone
        """
        # コマンドの結果を改行で分割
        lines = command_output.split('\n')
        
        # 各行をチェック
        for line in lines:
            # 前後の空白を削除
            cleaned_line = line.strip()
            
            # "Current Wi-Fi Network:"という文字列が含まれる行を探す
            if "current wi-fi network:" in cleaned_line.lower():
                # コロンで分割してWi-Fi名の部分を取得
                parts = cleaned_line.split(":", 1)
                if len(parts) >= 2:
                    # コロンの右側がWi-Fi名
                    wifi_name = parts[1].strip()
                    return wifi_name
        
        # 見つからなかった場合
        return None

    def display_network_info(self):
        """取得したネットワーク情報をわかりやすく表示する関数"""
        # 見やすくするために区切り線を表示
        print("=" * 50)
        print("ネットワーク情報取得ツール")
        print("=" * 50)
        
        # 上で作った関数を使って現在のWi-Fi名を取得
        current_wifi = self.get_current_wifi_name()
        
        # Wi-Fi名が取得できた場合
        if current_wifi:
            print(f"接続中のWi-Fi: {current_wifi}")
        else:
            # 取得できなかった場合
            print("Wi-Fi接続が見つかりません")
        
        # 終了の区切り線
        print("=" * 50)

def main():
    """プログラムが実行されたときに呼び出されるメイン関数"""
    try:
        # NetworkInfoManagerクラスのインスタンスを作成
        network_manager = NetworkInfoManager()
        
        # ネットワーク情報を表示する関数を呼び出し
        network_manager.display_network_info()
        
    except KeyboardInterrupt:
        # ユーザーがCtrl+Cでプログラムを中断した場合
        print("\nプログラムが中断されました")
    except Exception as e:
        # その他のエラーが発生した場合
        print(f"プログラム実行エラー: {e}")


# このファイルが直接実行された場合のみmain関数を呼び出す
# 他のファイルからimportされた場合は実行されない
if __name__ == "__main__":
    main()

python wifi_manager.py

python3 wifi_manager.py

    def get_wifi_password(self, wifi_name):
        """指定されたWi-Fiネットワークのパスワードを取得する関数
        
        Args:
            wifi_name: パスワードを調べたいWi-Fi名
            
        Returns:
            str: Wi-Fiパスワード、取得に失敗した場合はNone
        """
        # Wi-Fi名が指定されていない場合は処理を中止
        if not wifi_name:
            return None
            
        # 現在のOSを判定
        platform_type = self.check_platform()
        
        if platform_type == "windows":
            # Windows環境の場合
            # netshコマンドでWi-Fiプロファイルの詳細情報を取得
            # "key=clear"オプションでパスワードを平文で取得
            command = ["netsh", "wlan", "show", "profile", wifi_name, "key=clear"]
            # コマンドを実行
            output = self.execute_command(command)
            
            if output:
                # コマンドの結果からパスワードを抽出
                return self._parse_windows_wifi_password(output)
                
        elif platform_type == "macos":
            # macOS環境の場合
            # securityコマンドでキーチェーンからパスワードを取得
            command = ["security", "find-generic-password", "-wa", wifi_name]
            # コマンドを実行
            output = self.execute_command(command)
            
            if output:
                # コマンドの結果からパスワードを抽出
                return self._parse_macos_wifi_password(output)
        
        # どのOSでもない場合やエラーの場合
        return None

    def _parse_windows_wifi_password(self, command_output):
        """Windowsのnetshコマンドの結果からパスワードを取り出す関数
        
        Args:
            command_output: netsh show profileコマンドの実行結果
            
        Returns:
            str: Wi-Fiパスワード、見つからない場合は"パスワードなし"
        """
        # コマンドの結果を改行で分割して1行ずつ処理
        lines = command_output.split('\n')
        
        # 各行をチェック
        for line in lines:
            # 行の前後の余分な空白を削除
            cleaned_line = line.strip()
            
            # "Key Content"という文字列が含まれる行を探す
            # この行にパスワード情報が記載されている
            if "key content" in cleaned_line.lower() and ":" in cleaned_line:
                # コロンで分割してパスワード部分を取得
                parts = cleaned_line.split(":", 1)  # 最初のコロンのみで分割
                if len(parts) >= 2:
                    # コロンの右側がパスワード
                    password = parts[1].strip()  # 前後の空白を削除
                    # パスワードが空でない場合は返す
                    if password and password != "":
                        return password
        
        # パスワードが見つからなかった場合
        return "パスワードなし"

    def _parse_macos_wifi_password(self, command_output):
        """macOSのsecurityコマンドの結果からパスワードを取り出す関数
        
        Args:
            command_output: security find-generic-passwordコマンドの実行結果
            
        Returns:
            str: Wi-Fiパスワード、見つからない場合は"パスワードなし"
        """
        # コマンドの結果を改行で分割
        lines = command_output.split('\n')
        
        # 各行をチェック
        for line in lines:
            # 前後の空白を削除
            cleaned_line = line.strip()
            
            # securityコマンドは成功時にパスワードのみを出力する
            # エラーメッセージ以外の行がパスワード
            if cleaned_line and not cleaned_line.startswith("security:"):
                return cleaned_line
        
        # パスワードが見つからなかった場合
        return "パスワードなし"

    def display_network_info(self):
        """ネットワーク情報を詳細表示する関数（パスワード情報も含む）"""
        # 見やすくするための区切り線
        print("=" * 50)
        print("ネットワーク詳細情報取得ツール")
        print("=" * 50)
        
        # 現在接続中のWi-Fi名を取得
        current_wifi = self.get_current_wifi_name()
        
        # Wi-Fi名が取得できた場合
        if current_wifi:
            # Wi-Fi名を表示
            print(f"接続中のWi-Fi名: {current_wifi}")
            
            # 上で作成した関数を使ってWi-Fiパスワードを取得
            wifi_password = self.get_wifi_password(current_wifi)
            
            # パスワードが取得できた場合とできなかった場合で分岐
            if wifi_password and wifi_password != "パスワードなし":
                # パスワードが取得できた場合
                print(f"Wi-Fiパスワード: {wifi_password}")
            else:
                # パスワードが取得できなかった場合
                print("Wi-Fiパスワード: 取得できませんでした")
                
        else:
            # Wi-Fi名自体が取得できなかった場合
            print("Wi-Fi接続が見つかりません")
        
        # 終了の区切り線
        print("=" * 50)

    def execute_command(self, command_list):
        """コマンドを実行して結果を取得する関数（エラー処理強化版）
        
        Args:
            command_list: 実行したいコマンドをリスト形式で指定
            
        Returns:
            str: コマンドの実行結果、失敗した場合はNone
        """
        try:
            # subprocessを使ってコマンドを実行
            result = subprocess.check_output(
                command_list,  # 実行するコマンドのリスト
                stderr=subprocess.STDOUT,  # エラーメッセージも結果に含める
                timeout=15  # パスワード取得は時間がかかることがあるので15秒に設定
            )
            # コマンドの結果をバイト形式から文字列に変換
            return result.decode('utf-8', errors='ignore')
        except subprocess.CalledProcessError as e:
            # コマンドの実行が失敗した場合
            # 特に管理者権限が必要な場合のエラーをチェック
            if "access" in str(e).lower() or "permission" in str(e).lower():
                print("注意: 管理者権限が必要な場合があります")
            else:
                print(f"コマンド実行エラー: {e}")
            return None
        except subprocess.TimeoutExpired:
            # コマンドが指定時間内に終わらなかった場合
            print("コマンドがタイムアウトしました")
            return None
        except Exception as e:
            # その他の予想外のエラーが発生した場合
            print(f"予期しないエラー: {e}")
            return None

"""
ネットワーク情報取得ツール用の設定ファイル
各OS用のコマンドとメッセージをまとめて管理
"""

# Windows環境で使用するコマンドの設定
WINDOWS_COMMANDS = {
    "wifi_interfaces": ["netsh", "wlan", "show", "interfaces"],
    "wifi_profile": ["netsh", "wlan", "show", "profile"],  # Wi-Fi名は後から追加
}

# macOS環境で使用するコマンドの設定
MACOS_COMMANDS = {
    "wifi_network": ["networksetup", "-getairportnetwork", "en0"],
    "wifi_password": ["security", "find-generic-password", "-wa"],  # Wi-Fi名は後から追加
}

# 表示メッセージの設定
MESSAGES = {
    "success": "ネットワーク情報の取得が完了しました",
    "no_wifi": "Wi-Fi接続が見つかりません",
    "no_password": "パスワードを取得できませんでした",
    "permission_error": "管理者権限が必要です",
}

def main():
    """プログラムのメイン処理（パスワード取得機能を含む）"""
    try:
        # NetworkInfoManagerクラスのインスタンスを作成
        network_manager = NetworkInfoManager()
        
        # OS検出メッセージは詳細情報表示で十分なのでコメントアウト
        # print(f"検出されたOS: {network_manager.operating_system}")
        
        # ネットワーク詳細情報を表示（Wi-Fi名とパスワードの両方）
        network_manager.display_network_info()
        
    except KeyboardInterrupt:
        # ユーザーがCtrl+Cで中断した場合
        print("\nプログラムが中断されました")
    except Exception as e:
        # その他のエラーが発生した場合
        print(f"プログラム実行エラー: {e}")


# このファイルが直接実行された場合のみmain関数を呼び出す
if __name__ == "__main__":
    main()

python wifi_manager.py

python3 wifi_manager.py

# Virtual environment
myenv/

# OS generated files
.DS_Store
Thumbs.db

# IDE files
.vscode/settings.json
.idea/

# システムコマンドを活用したネットワーク情報取得ツール

## プロジェクト内容

現在接続中のWi-Fiネットワークの名前とパスワードを取得するネットワーク情報管理ツールです。Windows・macOS両対応のクロスプラットフォーム仕様で、各OSのシステムコマンドを活用してセキュアなネットワーク情報を自動取得します。Pythonのsubprocessモジュールとシステムコマンド実行技術を学習することを目的として実装しました。

## プロジェクト構成

```
network_info_tool/
├── wifi_manager.py          # メインプログラム
├── config.py               # 設定管理ファイル
├── requirements.txt        # 依存関係管理
├── README.md              # プロジェクト説明書
└── .gitignore             # Git除外ファイル設定
```

## 必要要件/開発環境

- **Python 3.7以上**
- **VSCode** (開発環境)
- **Git** (バージョン管理)
- **Windows 10以上** または **macOS 10.14以上**

### 使用ライブラリ

- **subprocess** システムコマンドの実行処理
- **platform** OS種別の自動判定
- **os** オペレーティングシステム操作

## 機能

- **OS自動判定** Windows・macOSの自動識別とコマンド選択
- **Wi-Fi名取得** 現在接続中のネットワーク名を自動取得
- **Wi-Fiパスワード取得** 接続中ネットワークのパスワードを安全に取得
- **クロスプラットフォーム対応** Windows・macOS両環境での動作保証
- **システムコマンド実行** netsh・networksetup・securityコマンドの活用
- **データ解析処理** コマンド出力の文字列解析と情報抽出
- **エラーハンドリング** コマンド実行失敗やタイムアウトへの対応
- **権限管理** 管理者権限が必要な処理の適切な案内

## 実行方法

### 1. リポジトリのクローン

```bash
git clone https://github.com/yourusername/network_info_tool.git
cd network_info_tool
```

### 2. 仮想環境の作成・アクティベート

**Windows**
```bash
python -m venv myenv
myenv\Scripts\activate
```

**macOS**
```bash
python3 -m venv myenv
source myenv/bin/activate
```

### 3. 依存関係のインストール

```bash
pip install -r requirements.txt
```

### 4. プログラムの実行

**Windows**
```bash
python wifi_manager.py
```

**macOS**
```bash
python3 wifi_manager.py
```

実行後、現在接続中のWi-Fi名とパスワードが表示されます。

### 注意事項

- パスワード取得には管理者権限が必要な場合があります
- macOSでは初回実行時にキーチェーンアクセスの許可が求められることがあります
- セキュリティソフトによってコマンド実行がブロックされる場合があります

## データ取得について

* **Windows環境** netshコマンドを使用してWLAN情報を取得
* **macOS環境** networksetupとsecurityコマンドを使用してネットワーク情報を取得
* **出力形式** コンソールに接続情報を表示

## 開発者

YuYu