中級者向け No.061
GitHub APIビューア
GitHub APIを使ってユーザーのリポジトリ一覧・スター数・言語統計を取得して表示するツール。requests + JSONパースを実践的に学ぶ。
📋 目次
1. アプリ概要
GitHub APIを使ってユーザーのリポジトリ一覧・スター数・言語統計を取得して表示するツール。requests + JSONパースを実践的に学ぶ。
このアプリはnetworkカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter・requests、難易度は ★★★ 難しい です。
Pythonの豊富なライブラリを活用することで、実用的なアプリを短いコードで実装できます。ソースコードをコピーして実行し、仕組みを理解したうえでカスタマイズに挑戦してみてください。
GUIアプリ開発はプログラミングの楽しさを実感できる最も効果的な学習方法のひとつです。変数・関数・クラス・イベント処理などの重要な概念が自然と身につきます。
2. 機能一覧
- GitHub APIビューアのメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
動作確認環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
インストールが必要なライブラリ
pip install requests4. 完全なソースコード
コードのコピー方法
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
app061.py
import tkinter as tk
from tkinter import ttk, messagebox
import urllib.request
import urllib.parse
import json
import threading
class App061:
"""GitHub APIビューア"""
BASE = "https://api.github.com"
def __init__(self, root):
self.root = root
self.root.title("GitHub APIビューア")
self.root.geometry("1000x660")
self.root.configure(bg="#0d1117")
self._token = ""
self._build_ui()
def _build_ui(self):
header = tk.Frame(self.root, bg="#161b22", pady=6)
header.pack(fill=tk.X)
tk.Label(header, text="🐙 GitHub APIビューア",
font=("Noto Sans JP", 12, "bold"),
bg="#161b22", fg="#f0f6fc").pack(side=tk.LEFT, padx=12)
# トークン設定
tk.Label(header, text="Token:", bg="#161b22", fg="#8b949e",
font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
self.token_var = tk.StringVar()
ttk.Entry(header, textvariable=self.token_var,
width=36, show="*").pack(side=tk.LEFT)
ttk.Button(header, text="適用",
command=self._apply_token).pack(side=tk.LEFT, padx=4)
# 検索バー
search_f = tk.Frame(self.root, bg="#0d1117", pady=4)
search_f.pack(fill=tk.X, padx=8)
self.search_mode = tk.StringVar(value="user")
ttk.Combobox(search_f, textvariable=self.search_mode,
values=["user", "repos", "search"],
state="readonly", width=8).pack(side=tk.LEFT, padx=2)
self.query_var = tk.StringVar(value="torvalds")
ttk.Entry(search_f, textvariable=self.query_var,
width=30).pack(side=tk.LEFT, padx=4)
ttk.Button(search_f, text="🔍 取得",
command=self._fetch).pack(side=tk.LEFT)
self.search_mode.trace_add("write", self._on_mode_change)
# 説明ラベル
self.hint_lbl = tk.Label(search_f, text="ユーザー名を入力",
bg="#0d1117", fg="#8b949e", font=("Arial", 9))
self.hint_lbl.pack(side=tk.LEFT, padx=8)
# メインエリア
paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)
# 左: 結果リスト
left = tk.Frame(paned, bg="#0d1117")
paned.add(left, weight=1)
tk.Label(left, text="結果", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.result_tree = ttk.Treeview(left, columns=("name", "desc"),
show="headings", selectmode="browse")
self.result_tree.heading("name", text="名前")
self.result_tree.heading("desc", text="説明")
self.result_tree.column("name", width=160, anchor="w")
self.result_tree.column("desc", width=200, anchor="w")
rsb = ttk.Scrollbar(left, command=self.result_tree.yview)
self.result_tree.configure(yscrollcommand=rsb.set)
rsb.pack(side=tk.RIGHT, fill=tk.Y)
self.result_tree.pack(fill=tk.BOTH, expand=True)
self.result_tree.bind("<<TreeviewSelect>>", self._on_result_select)
# 右: 詳細
right = tk.Frame(paned, bg="#0d1117")
paned.add(right, weight=2)
tk.Label(right, text="詳細", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.detail_text = tk.Text(right, bg="#161b22", fg="#c9d1d9",
font=("Courier New", 9), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.WORD)
dsb = ttk.Scrollbar(right, command=self.detail_text.yview)
self.detail_text.configure(yscrollcommand=dsb.set)
dsb.pack(side=tk.RIGHT, fill=tk.Y)
self.detail_text.pack(fill=tk.BOTH, expand=True)
# RAWパネル
raw_f = tk.Frame(self.root, bg="#0d1117")
raw_f.pack(fill=tk.X, padx=4, pady=2)
tk.Label(raw_f, text="Raw JSON:", bg="#0d1117", fg="#8b949e",
font=("Arial", 8)).pack(anchor="w")
self.raw_text = tk.Text(raw_f, height=5, bg="#0d1117", fg="#6e7681",
font=("Courier New", 8), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.NONE)
raw_sb = ttk.Scrollbar(raw_f, orient=tk.HORIZONTAL,
command=self.raw_text.xview)
self.raw_text.configure(xscrollcommand=raw_sb.set)
self.raw_text.pack(fill=tk.X)
raw_sb.pack(fill=tk.X)
self.status_var = tk.StringVar(value="ユーザー名を入力して取得してください")
tk.Label(self.root, textvariable=self.status_var,
bg="#21262d", fg="#8b949e", font=("Arial", 9),
anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)
self._data_cache = {}
def _apply_token(self):
self._token = self.token_var.get().strip()
self.status_var.set("トークンを設定しました" if self._token
else "トークンをクリアしました")
def _on_mode_change(self, *args):
hints = {"user": "ユーザー名を入力 (例: torvalds)",
"repos": "ユーザー名を入力 (例: torvalds)",
"search": "キーワードを入力 (例: python tkinter)"}
self.hint_lbl.config(text=hints.get(self.search_mode.get(), ""))
def _make_request(self, url):
req = urllib.request.Request(url)
req.add_header("Accept", "application/vnd.github.v3+json")
req.add_header("User-Agent", "PythonLandApp")
if self._token:
req.add_header("Authorization", f"token {self._token}")
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode("utf-8"))
def _fetch(self):
query = self.query_var.get().strip()
if not query:
messagebox.showwarning("警告", "検索クエリを入力してください")
return
mode = self.search_mode.get()
self.status_var.set("取得中...")
self.result_tree.delete(*self.result_tree.get_children())
threading.Thread(target=self._do_fetch, args=(mode, query),
daemon=True).start()
def _do_fetch(self, mode, query):
try:
if mode == "user":
url = f"{self.BASE}/users/{urllib.parse.quote(query)}"
data = self._make_request(url)
self.root.after(0, self._show_user, data)
elif mode == "repos":
url = (f"{self.BASE}/users/{urllib.parse.quote(query)}"
f"/repos?per_page=50&sort=updated")
data = self._make_request(url)
self.root.after(0, self._show_repos, data)
elif mode == "search":
encoded = urllib.parse.quote(query)
url = f"{self.BASE}/search/repositories?q={encoded}&per_page=30"
data = self._make_request(url)
self.root.after(0, self._show_search_results,
data.get("items", []))
except Exception as e:
self.root.after(0, self.status_var.set, f"エラー: {e}")
def _show_user(self, data):
self.result_tree.delete(*self.result_tree.get_children())
iid = self.result_tree.insert(
"", tk.END,
values=(data.get("login", ""), data.get("bio", "") or ""),
tags=("user",))
self._data_cache[iid] = data
self._show_detail(data)
self.status_var.set(f"ユーザー: {data.get('login', '')}")
def _show_repos(self, data):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in data:
iid = self.result_tree.insert(
"", tk.END,
values=(repo.get("name", ""),
repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(data)} 件のリポジトリ")
def _show_search_results(self, items):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in items:
name = f"{repo.get('full_name', '')}"
iid = self.result_tree.insert(
"", tk.END,
values=(name, repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(items)} 件のリポジトリが見つかりました")
def _on_result_select(self, event=None):
sel = self.result_tree.selection()
if not sel:
return
iid = sel[0]
data = self._data_cache.get(iid, {})
self._show_detail(data)
def _show_detail(self, data):
lines = []
if "login" in data: # ユーザー
for k in ("login", "name", "bio", "location", "email",
"public_repos", "followers", "following",
"created_at", "html_url"):
if data.get(k) is not None:
lines.append(f"{k:20s}: {data[k]}")
else: # リポジトリ
for k in ("full_name", "description", "language", "stargazers_count",
"forks_count", "open_issues_count", "license",
"created_at", "updated_at", "html_url", "clone_url"):
v = data.get(k)
if isinstance(v, dict):
v = v.get("name", "")
if v is not None:
lines.append(f"{k:22s}: {v}")
text = "\n".join(lines)
self.detail_text.configure(state=tk.NORMAL)
self.detail_text.delete("1.0", tk.END)
self.detail_text.insert(tk.END, text)
self.detail_text.configure(state=tk.DISABLED)
raw = json.dumps(data, ensure_ascii=False, indent=2)
self.raw_text.configure(state=tk.NORMAL)
self.raw_text.delete("1.0", tk.END)
self.raw_text.insert(tk.END, raw)
self.raw_text.configure(state=tk.DISABLED)
if __name__ == "__main__":
root = tk.Tk()
app = App061(root)
root.mainloop()
5. コード解説
GitHub APIビューアのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App061クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。
import tkinter as tk
from tkinter import ttk, messagebox
import urllib.request
import urllib.parse
import json
import threading
class App061:
"""GitHub APIビューア"""
BASE = "https://api.github.com"
def __init__(self, root):
self.root = root
self.root.title("GitHub APIビューア")
self.root.geometry("1000x660")
self.root.configure(bg="#0d1117")
self._token = ""
self._build_ui()
def _build_ui(self):
header = tk.Frame(self.root, bg="#161b22", pady=6)
header.pack(fill=tk.X)
tk.Label(header, text="🐙 GitHub APIビューア",
font=("Noto Sans JP", 12, "bold"),
bg="#161b22", fg="#f0f6fc").pack(side=tk.LEFT, padx=12)
# トークン設定
tk.Label(header, text="Token:", bg="#161b22", fg="#8b949e",
font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
self.token_var = tk.StringVar()
ttk.Entry(header, textvariable=self.token_var,
width=36, show="*").pack(side=tk.LEFT)
ttk.Button(header, text="適用",
command=self._apply_token).pack(side=tk.LEFT, padx=4)
# 検索バー
search_f = tk.Frame(self.root, bg="#0d1117", pady=4)
search_f.pack(fill=tk.X, padx=8)
self.search_mode = tk.StringVar(value="user")
ttk.Combobox(search_f, textvariable=self.search_mode,
values=["user", "repos", "search"],
state="readonly", width=8).pack(side=tk.LEFT, padx=2)
self.query_var = tk.StringVar(value="torvalds")
ttk.Entry(search_f, textvariable=self.query_var,
width=30).pack(side=tk.LEFT, padx=4)
ttk.Button(search_f, text="🔍 取得",
command=self._fetch).pack(side=tk.LEFT)
self.search_mode.trace_add("write", self._on_mode_change)
# 説明ラベル
self.hint_lbl = tk.Label(search_f, text="ユーザー名を入力",
bg="#0d1117", fg="#8b949e", font=("Arial", 9))
self.hint_lbl.pack(side=tk.LEFT, padx=8)
# メインエリア
paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)
# 左: 結果リスト
left = tk.Frame(paned, bg="#0d1117")
paned.add(left, weight=1)
tk.Label(left, text="結果", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.result_tree = ttk.Treeview(left, columns=("name", "desc"),
show="headings", selectmode="browse")
self.result_tree.heading("name", text="名前")
self.result_tree.heading("desc", text="説明")
self.result_tree.column("name", width=160, anchor="w")
self.result_tree.column("desc", width=200, anchor="w")
rsb = ttk.Scrollbar(left, command=self.result_tree.yview)
self.result_tree.configure(yscrollcommand=rsb.set)
rsb.pack(side=tk.RIGHT, fill=tk.Y)
self.result_tree.pack(fill=tk.BOTH, expand=True)
self.result_tree.bind("<<TreeviewSelect>>", self._on_result_select)
# 右: 詳細
right = tk.Frame(paned, bg="#0d1117")
paned.add(right, weight=2)
tk.Label(right, text="詳細", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.detail_text = tk.Text(right, bg="#161b22", fg="#c9d1d9",
font=("Courier New", 9), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.WORD)
dsb = ttk.Scrollbar(right, command=self.detail_text.yview)
self.detail_text.configure(yscrollcommand=dsb.set)
dsb.pack(side=tk.RIGHT, fill=tk.Y)
self.detail_text.pack(fill=tk.BOTH, expand=True)
# RAWパネル
raw_f = tk.Frame(self.root, bg="#0d1117")
raw_f.pack(fill=tk.X, padx=4, pady=2)
tk.Label(raw_f, text="Raw JSON:", bg="#0d1117", fg="#8b949e",
font=("Arial", 8)).pack(anchor="w")
self.raw_text = tk.Text(raw_f, height=5, bg="#0d1117", fg="#6e7681",
font=("Courier New", 8), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.NONE)
raw_sb = ttk.Scrollbar(raw_f, orient=tk.HORIZONTAL,
command=self.raw_text.xview)
self.raw_text.configure(xscrollcommand=raw_sb.set)
self.raw_text.pack(fill=tk.X)
raw_sb.pack(fill=tk.X)
self.status_var = tk.StringVar(value="ユーザー名を入力して取得してください")
tk.Label(self.root, textvariable=self.status_var,
bg="#21262d", fg="#8b949e", font=("Arial", 9),
anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)
self._data_cache = {}
def _apply_token(self):
self._token = self.token_var.get().strip()
self.status_var.set("トークンを設定しました" if self._token
else "トークンをクリアしました")
def _on_mode_change(self, *args):
hints = {"user": "ユーザー名を入力 (例: torvalds)",
"repos": "ユーザー名を入力 (例: torvalds)",
"search": "キーワードを入力 (例: python tkinter)"}
self.hint_lbl.config(text=hints.get(self.search_mode.get(), ""))
def _make_request(self, url):
req = urllib.request.Request(url)
req.add_header("Accept", "application/vnd.github.v3+json")
req.add_header("User-Agent", "PythonLandApp")
if self._token:
req.add_header("Authorization", f"token {self._token}")
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode("utf-8"))
def _fetch(self):
query = self.query_var.get().strip()
if not query:
messagebox.showwarning("警告", "検索クエリを入力してください")
return
mode = self.search_mode.get()
self.status_var.set("取得中...")
self.result_tree.delete(*self.result_tree.get_children())
threading.Thread(target=self._do_fetch, args=(mode, query),
daemon=True).start()
def _do_fetch(self, mode, query):
try:
if mode == "user":
url = f"{self.BASE}/users/{urllib.parse.quote(query)}"
data = self._make_request(url)
self.root.after(0, self._show_user, data)
elif mode == "repos":
url = (f"{self.BASE}/users/{urllib.parse.quote(query)}"
f"/repos?per_page=50&sort=updated")
data = self._make_request(url)
self.root.after(0, self._show_repos, data)
elif mode == "search":
encoded = urllib.parse.quote(query)
url = f"{self.BASE}/search/repositories?q={encoded}&per_page=30"
data = self._make_request(url)
self.root.after(0, self._show_search_results,
data.get("items", []))
except Exception as e:
self.root.after(0, self.status_var.set, f"エラー: {e}")
def _show_user(self, data):
self.result_tree.delete(*self.result_tree.get_children())
iid = self.result_tree.insert(
"", tk.END,
values=(data.get("login", ""), data.get("bio", "") or ""),
tags=("user",))
self._data_cache[iid] = data
self._show_detail(data)
self.status_var.set(f"ユーザー: {data.get('login', '')}")
def _show_repos(self, data):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in data:
iid = self.result_tree.insert(
"", tk.END,
values=(repo.get("name", ""),
repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(data)} 件のリポジトリ")
def _show_search_results(self, items):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in items:
name = f"{repo.get('full_name', '')}"
iid = self.result_tree.insert(
"", tk.END,
values=(name, repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(items)} 件のリポジトリが見つかりました")
def _on_result_select(self, event=None):
sel = self.result_tree.selection()
if not sel:
return
iid = sel[0]
data = self._data_cache.get(iid, {})
self._show_detail(data)
def _show_detail(self, data):
lines = []
if "login" in data: # ユーザー
for k in ("login", "name", "bio", "location", "email",
"public_repos", "followers", "following",
"created_at", "html_url"):
if data.get(k) is not None:
lines.append(f"{k:20s}: {data[k]}")
else: # リポジトリ
for k in ("full_name", "description", "language", "stargazers_count",
"forks_count", "open_issues_count", "license",
"created_at", "updated_at", "html_url", "clone_url"):
v = data.get(k)
if isinstance(v, dict):
v = v.get("name", "")
if v is not None:
lines.append(f"{k:22s}: {v}")
text = "\n".join(lines)
self.detail_text.configure(state=tk.NORMAL)
self.detail_text.delete("1.0", tk.END)
self.detail_text.insert(tk.END, text)
self.detail_text.configure(state=tk.DISABLED)
raw = json.dumps(data, ensure_ascii=False, indent=2)
self.raw_text.configure(state=tk.NORMAL)
self.raw_text.delete("1.0", tk.END)
self.raw_text.insert(tk.END, raw)
self.raw_text.configure(state=tk.DISABLED)
if __name__ == "__main__":
root = tk.Tk()
app = App061(root)
root.mainloop()
UIレイアウトの構築
LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。
import tkinter as tk
from tkinter import ttk, messagebox
import urllib.request
import urllib.parse
import json
import threading
class App061:
"""GitHub APIビューア"""
BASE = "https://api.github.com"
def __init__(self, root):
self.root = root
self.root.title("GitHub APIビューア")
self.root.geometry("1000x660")
self.root.configure(bg="#0d1117")
self._token = ""
self._build_ui()
def _build_ui(self):
header = tk.Frame(self.root, bg="#161b22", pady=6)
header.pack(fill=tk.X)
tk.Label(header, text="🐙 GitHub APIビューア",
font=("Noto Sans JP", 12, "bold"),
bg="#161b22", fg="#f0f6fc").pack(side=tk.LEFT, padx=12)
# トークン設定
tk.Label(header, text="Token:", bg="#161b22", fg="#8b949e",
font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
self.token_var = tk.StringVar()
ttk.Entry(header, textvariable=self.token_var,
width=36, show="*").pack(side=tk.LEFT)
ttk.Button(header, text="適用",
command=self._apply_token).pack(side=tk.LEFT, padx=4)
# 検索バー
search_f = tk.Frame(self.root, bg="#0d1117", pady=4)
search_f.pack(fill=tk.X, padx=8)
self.search_mode = tk.StringVar(value="user")
ttk.Combobox(search_f, textvariable=self.search_mode,
values=["user", "repos", "search"],
state="readonly", width=8).pack(side=tk.LEFT, padx=2)
self.query_var = tk.StringVar(value="torvalds")
ttk.Entry(search_f, textvariable=self.query_var,
width=30).pack(side=tk.LEFT, padx=4)
ttk.Button(search_f, text="🔍 取得",
command=self._fetch).pack(side=tk.LEFT)
self.search_mode.trace_add("write", self._on_mode_change)
# 説明ラベル
self.hint_lbl = tk.Label(search_f, text="ユーザー名を入力",
bg="#0d1117", fg="#8b949e", font=("Arial", 9))
self.hint_lbl.pack(side=tk.LEFT, padx=8)
# メインエリア
paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)
# 左: 結果リスト
left = tk.Frame(paned, bg="#0d1117")
paned.add(left, weight=1)
tk.Label(left, text="結果", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.result_tree = ttk.Treeview(left, columns=("name", "desc"),
show="headings", selectmode="browse")
self.result_tree.heading("name", text="名前")
self.result_tree.heading("desc", text="説明")
self.result_tree.column("name", width=160, anchor="w")
self.result_tree.column("desc", width=200, anchor="w")
rsb = ttk.Scrollbar(left, command=self.result_tree.yview)
self.result_tree.configure(yscrollcommand=rsb.set)
rsb.pack(side=tk.RIGHT, fill=tk.Y)
self.result_tree.pack(fill=tk.BOTH, expand=True)
self.result_tree.bind("<<TreeviewSelect>>", self._on_result_select)
# 右: 詳細
right = tk.Frame(paned, bg="#0d1117")
paned.add(right, weight=2)
tk.Label(right, text="詳細", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.detail_text = tk.Text(right, bg="#161b22", fg="#c9d1d9",
font=("Courier New", 9), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.WORD)
dsb = ttk.Scrollbar(right, command=self.detail_text.yview)
self.detail_text.configure(yscrollcommand=dsb.set)
dsb.pack(side=tk.RIGHT, fill=tk.Y)
self.detail_text.pack(fill=tk.BOTH, expand=True)
# RAWパネル
raw_f = tk.Frame(self.root, bg="#0d1117")
raw_f.pack(fill=tk.X, padx=4, pady=2)
tk.Label(raw_f, text="Raw JSON:", bg="#0d1117", fg="#8b949e",
font=("Arial", 8)).pack(anchor="w")
self.raw_text = tk.Text(raw_f, height=5, bg="#0d1117", fg="#6e7681",
font=("Courier New", 8), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.NONE)
raw_sb = ttk.Scrollbar(raw_f, orient=tk.HORIZONTAL,
command=self.raw_text.xview)
self.raw_text.configure(xscrollcommand=raw_sb.set)
self.raw_text.pack(fill=tk.X)
raw_sb.pack(fill=tk.X)
self.status_var = tk.StringVar(value="ユーザー名を入力して取得してください")
tk.Label(self.root, textvariable=self.status_var,
bg="#21262d", fg="#8b949e", font=("Arial", 9),
anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)
self._data_cache = {}
def _apply_token(self):
self._token = self.token_var.get().strip()
self.status_var.set("トークンを設定しました" if self._token
else "トークンをクリアしました")
def _on_mode_change(self, *args):
hints = {"user": "ユーザー名を入力 (例: torvalds)",
"repos": "ユーザー名を入力 (例: torvalds)",
"search": "キーワードを入力 (例: python tkinter)"}
self.hint_lbl.config(text=hints.get(self.search_mode.get(), ""))
def _make_request(self, url):
req = urllib.request.Request(url)
req.add_header("Accept", "application/vnd.github.v3+json")
req.add_header("User-Agent", "PythonLandApp")
if self._token:
req.add_header("Authorization", f"token {self._token}")
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode("utf-8"))
def _fetch(self):
query = self.query_var.get().strip()
if not query:
messagebox.showwarning("警告", "検索クエリを入力してください")
return
mode = self.search_mode.get()
self.status_var.set("取得中...")
self.result_tree.delete(*self.result_tree.get_children())
threading.Thread(target=self._do_fetch, args=(mode, query),
daemon=True).start()
def _do_fetch(self, mode, query):
try:
if mode == "user":
url = f"{self.BASE}/users/{urllib.parse.quote(query)}"
data = self._make_request(url)
self.root.after(0, self._show_user, data)
elif mode == "repos":
url = (f"{self.BASE}/users/{urllib.parse.quote(query)}"
f"/repos?per_page=50&sort=updated")
data = self._make_request(url)
self.root.after(0, self._show_repos, data)
elif mode == "search":
encoded = urllib.parse.quote(query)
url = f"{self.BASE}/search/repositories?q={encoded}&per_page=30"
data = self._make_request(url)
self.root.after(0, self._show_search_results,
data.get("items", []))
except Exception as e:
self.root.after(0, self.status_var.set, f"エラー: {e}")
def _show_user(self, data):
self.result_tree.delete(*self.result_tree.get_children())
iid = self.result_tree.insert(
"", tk.END,
values=(data.get("login", ""), data.get("bio", "") or ""),
tags=("user",))
self._data_cache[iid] = data
self._show_detail(data)
self.status_var.set(f"ユーザー: {data.get('login', '')}")
def _show_repos(self, data):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in data:
iid = self.result_tree.insert(
"", tk.END,
values=(repo.get("name", ""),
repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(data)} 件のリポジトリ")
def _show_search_results(self, items):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in items:
name = f"{repo.get('full_name', '')}"
iid = self.result_tree.insert(
"", tk.END,
values=(name, repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(items)} 件のリポジトリが見つかりました")
def _on_result_select(self, event=None):
sel = self.result_tree.selection()
if not sel:
return
iid = sel[0]
data = self._data_cache.get(iid, {})
self._show_detail(data)
def _show_detail(self, data):
lines = []
if "login" in data: # ユーザー
for k in ("login", "name", "bio", "location", "email",
"public_repos", "followers", "following",
"created_at", "html_url"):
if data.get(k) is not None:
lines.append(f"{k:20s}: {data[k]}")
else: # リポジトリ
for k in ("full_name", "description", "language", "stargazers_count",
"forks_count", "open_issues_count", "license",
"created_at", "updated_at", "html_url", "clone_url"):
v = data.get(k)
if isinstance(v, dict):
v = v.get("name", "")
if v is not None:
lines.append(f"{k:22s}: {v}")
text = "\n".join(lines)
self.detail_text.configure(state=tk.NORMAL)
self.detail_text.delete("1.0", tk.END)
self.detail_text.insert(tk.END, text)
self.detail_text.configure(state=tk.DISABLED)
raw = json.dumps(data, ensure_ascii=False, indent=2)
self.raw_text.configure(state=tk.NORMAL)
self.raw_text.delete("1.0", tk.END)
self.raw_text.insert(tk.END, raw)
self.raw_text.configure(state=tk.DISABLED)
if __name__ == "__main__":
root = tk.Tk()
app = App061(root)
root.mainloop()
イベント処理
ボタンのcommand引数でクリックイベントを、bind('
import tkinter as tk
from tkinter import ttk, messagebox
import urllib.request
import urllib.parse
import json
import threading
class App061:
"""GitHub APIビューア"""
BASE = "https://api.github.com"
def __init__(self, root):
self.root = root
self.root.title("GitHub APIビューア")
self.root.geometry("1000x660")
self.root.configure(bg="#0d1117")
self._token = ""
self._build_ui()
def _build_ui(self):
header = tk.Frame(self.root, bg="#161b22", pady=6)
header.pack(fill=tk.X)
tk.Label(header, text="🐙 GitHub APIビューア",
font=("Noto Sans JP", 12, "bold"),
bg="#161b22", fg="#f0f6fc").pack(side=tk.LEFT, padx=12)
# トークン設定
tk.Label(header, text="Token:", bg="#161b22", fg="#8b949e",
font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
self.token_var = tk.StringVar()
ttk.Entry(header, textvariable=self.token_var,
width=36, show="*").pack(side=tk.LEFT)
ttk.Button(header, text="適用",
command=self._apply_token).pack(side=tk.LEFT, padx=4)
# 検索バー
search_f = tk.Frame(self.root, bg="#0d1117", pady=4)
search_f.pack(fill=tk.X, padx=8)
self.search_mode = tk.StringVar(value="user")
ttk.Combobox(search_f, textvariable=self.search_mode,
values=["user", "repos", "search"],
state="readonly", width=8).pack(side=tk.LEFT, padx=2)
self.query_var = tk.StringVar(value="torvalds")
ttk.Entry(search_f, textvariable=self.query_var,
width=30).pack(side=tk.LEFT, padx=4)
ttk.Button(search_f, text="🔍 取得",
command=self._fetch).pack(side=tk.LEFT)
self.search_mode.trace_add("write", self._on_mode_change)
# 説明ラベル
self.hint_lbl = tk.Label(search_f, text="ユーザー名を入力",
bg="#0d1117", fg="#8b949e", font=("Arial", 9))
self.hint_lbl.pack(side=tk.LEFT, padx=8)
# メインエリア
paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)
# 左: 結果リスト
left = tk.Frame(paned, bg="#0d1117")
paned.add(left, weight=1)
tk.Label(left, text="結果", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.result_tree = ttk.Treeview(left, columns=("name", "desc"),
show="headings", selectmode="browse")
self.result_tree.heading("name", text="名前")
self.result_tree.heading("desc", text="説明")
self.result_tree.column("name", width=160, anchor="w")
self.result_tree.column("desc", width=200, anchor="w")
rsb = ttk.Scrollbar(left, command=self.result_tree.yview)
self.result_tree.configure(yscrollcommand=rsb.set)
rsb.pack(side=tk.RIGHT, fill=tk.Y)
self.result_tree.pack(fill=tk.BOTH, expand=True)
self.result_tree.bind("<<TreeviewSelect>>", self._on_result_select)
# 右: 詳細
right = tk.Frame(paned, bg="#0d1117")
paned.add(right, weight=2)
tk.Label(right, text="詳細", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.detail_text = tk.Text(right, bg="#161b22", fg="#c9d1d9",
font=("Courier New", 9), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.WORD)
dsb = ttk.Scrollbar(right, command=self.detail_text.yview)
self.detail_text.configure(yscrollcommand=dsb.set)
dsb.pack(side=tk.RIGHT, fill=tk.Y)
self.detail_text.pack(fill=tk.BOTH, expand=True)
# RAWパネル
raw_f = tk.Frame(self.root, bg="#0d1117")
raw_f.pack(fill=tk.X, padx=4, pady=2)
tk.Label(raw_f, text="Raw JSON:", bg="#0d1117", fg="#8b949e",
font=("Arial", 8)).pack(anchor="w")
self.raw_text = tk.Text(raw_f, height=5, bg="#0d1117", fg="#6e7681",
font=("Courier New", 8), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.NONE)
raw_sb = ttk.Scrollbar(raw_f, orient=tk.HORIZONTAL,
command=self.raw_text.xview)
self.raw_text.configure(xscrollcommand=raw_sb.set)
self.raw_text.pack(fill=tk.X)
raw_sb.pack(fill=tk.X)
self.status_var = tk.StringVar(value="ユーザー名を入力して取得してください")
tk.Label(self.root, textvariable=self.status_var,
bg="#21262d", fg="#8b949e", font=("Arial", 9),
anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)
self._data_cache = {}
def _apply_token(self):
self._token = self.token_var.get().strip()
self.status_var.set("トークンを設定しました" if self._token
else "トークンをクリアしました")
def _on_mode_change(self, *args):
hints = {"user": "ユーザー名を入力 (例: torvalds)",
"repos": "ユーザー名を入力 (例: torvalds)",
"search": "キーワードを入力 (例: python tkinter)"}
self.hint_lbl.config(text=hints.get(self.search_mode.get(), ""))
def _make_request(self, url):
req = urllib.request.Request(url)
req.add_header("Accept", "application/vnd.github.v3+json")
req.add_header("User-Agent", "PythonLandApp")
if self._token:
req.add_header("Authorization", f"token {self._token}")
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode("utf-8"))
def _fetch(self):
query = self.query_var.get().strip()
if not query:
messagebox.showwarning("警告", "検索クエリを入力してください")
return
mode = self.search_mode.get()
self.status_var.set("取得中...")
self.result_tree.delete(*self.result_tree.get_children())
threading.Thread(target=self._do_fetch, args=(mode, query),
daemon=True).start()
def _do_fetch(self, mode, query):
try:
if mode == "user":
url = f"{self.BASE}/users/{urllib.parse.quote(query)}"
data = self._make_request(url)
self.root.after(0, self._show_user, data)
elif mode == "repos":
url = (f"{self.BASE}/users/{urllib.parse.quote(query)}"
f"/repos?per_page=50&sort=updated")
data = self._make_request(url)
self.root.after(0, self._show_repos, data)
elif mode == "search":
encoded = urllib.parse.quote(query)
url = f"{self.BASE}/search/repositories?q={encoded}&per_page=30"
data = self._make_request(url)
self.root.after(0, self._show_search_results,
data.get("items", []))
except Exception as e:
self.root.after(0, self.status_var.set, f"エラー: {e}")
def _show_user(self, data):
self.result_tree.delete(*self.result_tree.get_children())
iid = self.result_tree.insert(
"", tk.END,
values=(data.get("login", ""), data.get("bio", "") or ""),
tags=("user",))
self._data_cache[iid] = data
self._show_detail(data)
self.status_var.set(f"ユーザー: {data.get('login', '')}")
def _show_repos(self, data):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in data:
iid = self.result_tree.insert(
"", tk.END,
values=(repo.get("name", ""),
repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(data)} 件のリポジトリ")
def _show_search_results(self, items):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in items:
name = f"{repo.get('full_name', '')}"
iid = self.result_tree.insert(
"", tk.END,
values=(name, repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(items)} 件のリポジトリが見つかりました")
def _on_result_select(self, event=None):
sel = self.result_tree.selection()
if not sel:
return
iid = sel[0]
data = self._data_cache.get(iid, {})
self._show_detail(data)
def _show_detail(self, data):
lines = []
if "login" in data: # ユーザー
for k in ("login", "name", "bio", "location", "email",
"public_repos", "followers", "following",
"created_at", "html_url"):
if data.get(k) is not None:
lines.append(f"{k:20s}: {data[k]}")
else: # リポジトリ
for k in ("full_name", "description", "language", "stargazers_count",
"forks_count", "open_issues_count", "license",
"created_at", "updated_at", "html_url", "clone_url"):
v = data.get(k)
if isinstance(v, dict):
v = v.get("name", "")
if v is not None:
lines.append(f"{k:22s}: {v}")
text = "\n".join(lines)
self.detail_text.configure(state=tk.NORMAL)
self.detail_text.delete("1.0", tk.END)
self.detail_text.insert(tk.END, text)
self.detail_text.configure(state=tk.DISABLED)
raw = json.dumps(data, ensure_ascii=False, indent=2)
self.raw_text.configure(state=tk.NORMAL)
self.raw_text.delete("1.0", tk.END)
self.raw_text.insert(tk.END, raw)
self.raw_text.configure(state=tk.DISABLED)
if __name__ == "__main__":
root = tk.Tk()
app = App061(root)
root.mainloop()
Textウィジェットでの結果表示
tk.Textウィジェットをstate=DISABLED（読み取り専用）で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。
import tkinter as tk
from tkinter import ttk, messagebox
import urllib.request
import urllib.parse
import json
import threading
class App061:
"""GitHub APIビューア"""
BASE = "https://api.github.com"
def __init__(self, root):
self.root = root
self.root.title("GitHub APIビューア")
self.root.geometry("1000x660")
self.root.configure(bg="#0d1117")
self._token = ""
self._build_ui()
def _build_ui(self):
header = tk.Frame(self.root, bg="#161b22", pady=6)
header.pack(fill=tk.X)
tk.Label(header, text="🐙 GitHub APIビューア",
font=("Noto Sans JP", 12, "bold"),
bg="#161b22", fg="#f0f6fc").pack(side=tk.LEFT, padx=12)
# トークン設定
tk.Label(header, text="Token:", bg="#161b22", fg="#8b949e",
font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
self.token_var = tk.StringVar()
ttk.Entry(header, textvariable=self.token_var,
width=36, show="*").pack(side=tk.LEFT)
ttk.Button(header, text="適用",
command=self._apply_token).pack(side=tk.LEFT, padx=4)
# 検索バー
search_f = tk.Frame(self.root, bg="#0d1117", pady=4)
search_f.pack(fill=tk.X, padx=8)
self.search_mode = tk.StringVar(value="user")
ttk.Combobox(search_f, textvariable=self.search_mode,
values=["user", "repos", "search"],
state="readonly", width=8).pack(side=tk.LEFT, padx=2)
self.query_var = tk.StringVar(value="torvalds")
ttk.Entry(search_f, textvariable=self.query_var,
width=30).pack(side=tk.LEFT, padx=4)
ttk.Button(search_f, text="🔍 取得",
command=self._fetch).pack(side=tk.LEFT)
self.search_mode.trace_add("write", self._on_mode_change)
# 説明ラベル
self.hint_lbl = tk.Label(search_f, text="ユーザー名を入力",
bg="#0d1117", fg="#8b949e", font=("Arial", 9))
self.hint_lbl.pack(side=tk.LEFT, padx=8)
# メインエリア
paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)
# 左: 結果リスト
left = tk.Frame(paned, bg="#0d1117")
paned.add(left, weight=1)
tk.Label(left, text="結果", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.result_tree = ttk.Treeview(left, columns=("name", "desc"),
show="headings", selectmode="browse")
self.result_tree.heading("name", text="名前")
self.result_tree.heading("desc", text="説明")
self.result_tree.column("name", width=160, anchor="w")
self.result_tree.column("desc", width=200, anchor="w")
rsb = ttk.Scrollbar(left, command=self.result_tree.yview)
self.result_tree.configure(yscrollcommand=rsb.set)
rsb.pack(side=tk.RIGHT, fill=tk.Y)
self.result_tree.pack(fill=tk.BOTH, expand=True)
self.result_tree.bind("<<TreeviewSelect>>", self._on_result_select)
# 右: 詳細
right = tk.Frame(paned, bg="#0d1117")
paned.add(right, weight=2)
tk.Label(right, text="詳細", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.detail_text = tk.Text(right, bg="#161b22", fg="#c9d1d9",
font=("Courier New", 9), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.WORD)
dsb = ttk.Scrollbar(right, command=self.detail_text.yview)
self.detail_text.configure(yscrollcommand=dsb.set)
dsb.pack(side=tk.RIGHT, fill=tk.Y)
self.detail_text.pack(fill=tk.BOTH, expand=True)
# RAWパネル
raw_f = tk.Frame(self.root, bg="#0d1117")
raw_f.pack(fill=tk.X, padx=4, pady=2)
tk.Label(raw_f, text="Raw JSON:", bg="#0d1117", fg="#8b949e",
font=("Arial", 8)).pack(anchor="w")
self.raw_text = tk.Text(raw_f, height=5, bg="#0d1117", fg="#6e7681",
font=("Courier New", 8), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.NONE)
raw_sb = ttk.Scrollbar(raw_f, orient=tk.HORIZONTAL,
command=self.raw_text.xview)
self.raw_text.configure(xscrollcommand=raw_sb.set)
self.raw_text.pack(fill=tk.X)
raw_sb.pack(fill=tk.X)
self.status_var = tk.StringVar(value="ユーザー名を入力して取得してください")
tk.Label(self.root, textvariable=self.status_var,
bg="#21262d", fg="#8b949e", font=("Arial", 9),
anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)
self._data_cache = {}
def _apply_token(self):
self._token = self.token_var.get().strip()
self.status_var.set("トークンを設定しました" if self._token
else "トークンをクリアしました")
def _on_mode_change(self, *args):
hints = {"user": "ユーザー名を入力 (例: torvalds)",
"repos": "ユーザー名を入力 (例: torvalds)",
"search": "キーワードを入力 (例: python tkinter)"}
self.hint_lbl.config(text=hints.get(self.search_mode.get(), ""))
def _make_request(self, url):
req = urllib.request.Request(url)
req.add_header("Accept", "application/vnd.github.v3+json")
req.add_header("User-Agent", "PythonLandApp")
if self._token:
req.add_header("Authorization", f"token {self._token}")
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode("utf-8"))
def _fetch(self):
query = self.query_var.get().strip()
if not query:
messagebox.showwarning("警告", "検索クエリを入力してください")
return
mode = self.search_mode.get()
self.status_var.set("取得中...")
self.result_tree.delete(*self.result_tree.get_children())
threading.Thread(target=self._do_fetch, args=(mode, query),
daemon=True).start()
def _do_fetch(self, mode, query):
try:
if mode == "user":
url = f"{self.BASE}/users/{urllib.parse.quote(query)}"
data = self._make_request(url)
self.root.after(0, self._show_user, data)
elif mode == "repos":
url = (f"{self.BASE}/users/{urllib.parse.quote(query)}"
f"/repos?per_page=50&sort=updated")
data = self._make_request(url)
self.root.after(0, self._show_repos, data)
elif mode == "search":
encoded = urllib.parse.quote(query)
url = f"{self.BASE}/search/repositories?q={encoded}&per_page=30"
data = self._make_request(url)
self.root.after(0, self._show_search_results,
data.get("items", []))
except Exception as e:
self.root.after(0, self.status_var.set, f"エラー: {e}")
def _show_user(self, data):
self.result_tree.delete(*self.result_tree.get_children())
iid = self.result_tree.insert(
"", tk.END,
values=(data.get("login", ""), data.get("bio", "") or ""),
tags=("user",))
self._data_cache[iid] = data
self._show_detail(data)
self.status_var.set(f"ユーザー: {data.get('login', '')}")
def _show_repos(self, data):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in data:
iid = self.result_tree.insert(
"", tk.END,
values=(repo.get("name", ""),
repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(data)} 件のリポジトリ")
def _show_search_results(self, items):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in items:
name = f"{repo.get('full_name', '')}"
iid = self.result_tree.insert(
"", tk.END,
values=(name, repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(items)} 件のリポジトリが見つかりました")
def _on_result_select(self, event=None):
sel = self.result_tree.selection()
if not sel:
return
iid = sel[0]
data = self._data_cache.get(iid, {})
self._show_detail(data)
def _show_detail(self, data):
lines = []
if "login" in data: # ユーザー
for k in ("login", "name", "bio", "location", "email",
"public_repos", "followers", "following",
"created_at", "html_url"):
if data.get(k) is not None:
lines.append(f"{k:20s}: {data[k]}")
else: # リポジトリ
for k in ("full_name", "description", "language", "stargazers_count",
"forks_count", "open_issues_count", "license",
"created_at", "updated_at", "html_url", "clone_url"):
v = data.get(k)
if isinstance(v, dict):
v = v.get("name", "")
if v is not None:
lines.append(f"{k:22s}: {v}")
text = "\n".join(lines)
self.detail_text.configure(state=tk.NORMAL)
self.detail_text.delete("1.0", tk.END)
self.detail_text.insert(tk.END, text)
self.detail_text.configure(state=tk.DISABLED)
raw = json.dumps(data, ensure_ascii=False, indent=2)
self.raw_text.configure(state=tk.NORMAL)
self.raw_text.delete("1.0", tk.END)
self.raw_text.insert(tk.END, raw)
self.raw_text.configure(state=tk.DISABLED)
if __name__ == "__main__":
root = tk.Tk()
app = App061(root)
root.mainloop()
例外処理とエラーハンドリング
try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。
import tkinter as tk
from tkinter import ttk, messagebox
import urllib.request
import urllib.parse
import json
import threading
class App061:
"""GitHub APIビューア"""
BASE = "https://api.github.com"
def __init__(self, root):
self.root = root
self.root.title("GitHub APIビューア")
self.root.geometry("1000x660")
self.root.configure(bg="#0d1117")
self._token = ""
self._build_ui()
def _build_ui(self):
header = tk.Frame(self.root, bg="#161b22", pady=6)
header.pack(fill=tk.X)
tk.Label(header, text="🐙 GitHub APIビューア",
font=("Noto Sans JP", 12, "bold"),
bg="#161b22", fg="#f0f6fc").pack(side=tk.LEFT, padx=12)
# トークン設定
tk.Label(header, text="Token:", bg="#161b22", fg="#8b949e",
font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
self.token_var = tk.StringVar()
ttk.Entry(header, textvariable=self.token_var,
width=36, show="*").pack(side=tk.LEFT)
ttk.Button(header, text="適用",
command=self._apply_token).pack(side=tk.LEFT, padx=4)
# 検索バー
search_f = tk.Frame(self.root, bg="#0d1117", pady=4)
search_f.pack(fill=tk.X, padx=8)
self.search_mode = tk.StringVar(value="user")
ttk.Combobox(search_f, textvariable=self.search_mode,
values=["user", "repos", "search"],
state="readonly", width=8).pack(side=tk.LEFT, padx=2)
self.query_var = tk.StringVar(value="torvalds")
ttk.Entry(search_f, textvariable=self.query_var,
width=30).pack(side=tk.LEFT, padx=4)
ttk.Button(search_f, text="🔍 取得",
command=self._fetch).pack(side=tk.LEFT)
self.search_mode.trace_add("write", self._on_mode_change)
# 説明ラベル
self.hint_lbl = tk.Label(search_f, text="ユーザー名を入力",
bg="#0d1117", fg="#8b949e", font=("Arial", 9))
self.hint_lbl.pack(side=tk.LEFT, padx=8)
# メインエリア
paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)
# 左: 結果リスト
left = tk.Frame(paned, bg="#0d1117")
paned.add(left, weight=1)
tk.Label(left, text="結果", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.result_tree = ttk.Treeview(left, columns=("name", "desc"),
show="headings", selectmode="browse")
self.result_tree.heading("name", text="名前")
self.result_tree.heading("desc", text="説明")
self.result_tree.column("name", width=160, anchor="w")
self.result_tree.column("desc", width=200, anchor="w")
rsb = ttk.Scrollbar(left, command=self.result_tree.yview)
self.result_tree.configure(yscrollcommand=rsb.set)
rsb.pack(side=tk.RIGHT, fill=tk.Y)
self.result_tree.pack(fill=tk.BOTH, expand=True)
self.result_tree.bind("<<TreeviewSelect>>", self._on_result_select)
# 右: 詳細
right = tk.Frame(paned, bg="#0d1117")
paned.add(right, weight=2)
tk.Label(right, text="詳細", bg="#0d1117", fg="#8b949e",
font=("Arial", 9)).pack(anchor="w")
self.detail_text = tk.Text(right, bg="#161b22", fg="#c9d1d9",
font=("Courier New", 9), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.WORD)
dsb = ttk.Scrollbar(right, command=self.detail_text.yview)
self.detail_text.configure(yscrollcommand=dsb.set)
dsb.pack(side=tk.RIGHT, fill=tk.Y)
self.detail_text.pack(fill=tk.BOTH, expand=True)
# RAWパネル
raw_f = tk.Frame(self.root, bg="#0d1117")
raw_f.pack(fill=tk.X, padx=4, pady=2)
tk.Label(raw_f, text="Raw JSON:", bg="#0d1117", fg="#8b949e",
font=("Arial", 8)).pack(anchor="w")
self.raw_text = tk.Text(raw_f, height=5, bg="#0d1117", fg="#6e7681",
font=("Courier New", 8), relief=tk.FLAT,
state=tk.DISABLED, wrap=tk.NONE)
raw_sb = ttk.Scrollbar(raw_f, orient=tk.HORIZONTAL,
command=self.raw_text.xview)
self.raw_text.configure(xscrollcommand=raw_sb.set)
self.raw_text.pack(fill=tk.X)
raw_sb.pack(fill=tk.X)
self.status_var = tk.StringVar(value="ユーザー名を入力して取得してください")
tk.Label(self.root, textvariable=self.status_var,
bg="#21262d", fg="#8b949e", font=("Arial", 9),
anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)
self._data_cache = {}
def _apply_token(self):
self._token = self.token_var.get().strip()
self.status_var.set("トークンを設定しました" if self._token
else "トークンをクリアしました")
def _on_mode_change(self, *args):
hints = {"user": "ユーザー名を入力 (例: torvalds)",
"repos": "ユーザー名を入力 (例: torvalds)",
"search": "キーワードを入力 (例: python tkinter)"}
self.hint_lbl.config(text=hints.get(self.search_mode.get(), ""))
def _make_request(self, url):
req = urllib.request.Request(url)
req.add_header("Accept", "application/vnd.github.v3+json")
req.add_header("User-Agent", "PythonLandApp")
if self._token:
req.add_header("Authorization", f"token {self._token}")
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode("utf-8"))
def _fetch(self):
query = self.query_var.get().strip()
if not query:
messagebox.showwarning("警告", "検索クエリを入力してください")
return
mode = self.search_mode.get()
self.status_var.set("取得中...")
self.result_tree.delete(*self.result_tree.get_children())
threading.Thread(target=self._do_fetch, args=(mode, query),
daemon=True).start()
def _do_fetch(self, mode, query):
try:
if mode == "user":
url = f"{self.BASE}/users/{urllib.parse.quote(query)}"
data = self._make_request(url)
self.root.after(0, self._show_user, data)
elif mode == "repos":
url = (f"{self.BASE}/users/{urllib.parse.quote(query)}"
f"/repos?per_page=50&sort=updated")
data = self._make_request(url)
self.root.after(0, self._show_repos, data)
elif mode == "search":
encoded = urllib.parse.quote(query)
url = f"{self.BASE}/search/repositories?q={encoded}&per_page=30"
data = self._make_request(url)
self.root.after(0, self._show_search_results,
data.get("items", []))
except Exception as e:
self.root.after(0, self.status_var.set, f"エラー: {e}")
def _show_user(self, data):
self.result_tree.delete(*self.result_tree.get_children())
iid = self.result_tree.insert(
"", tk.END,
values=(data.get("login", ""), data.get("bio", "") or ""),
tags=("user",))
self._data_cache[iid] = data
self._show_detail(data)
self.status_var.set(f"ユーザー: {data.get('login', '')}")
def _show_repos(self, data):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in data:
iid = self.result_tree.insert(
"", tk.END,
values=(repo.get("name", ""),
repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(data)} 件のリポジトリ")
def _show_search_results(self, items):
self.result_tree.delete(*self.result_tree.get_children())
self._data_cache.clear()
for repo in items:
name = f"{repo.get('full_name', '')}"
iid = self.result_tree.insert(
"", tk.END,
values=(name, repo.get("description", "") or ""))
self._data_cache[iid] = repo
self.status_var.set(f"{len(items)} 件のリポジトリが見つかりました")
def _on_result_select(self, event=None):
sel = self.result_tree.selection()
if not sel:
return
iid = sel[0]
data = self._data_cache.get(iid, {})
self._show_detail(data)
def _show_detail(self, data):
lines = []
if "login" in data: # ユーザー
for k in ("login", "name", "bio", "location", "email",
"public_repos", "followers", "following",
"created_at", "html_url"):
if data.get(k) is not None:
lines.append(f"{k:20s}: {data[k]}")
else: # リポジトリ
for k in ("full_name", "description", "language", "stargazers_count",
"forks_count", "open_issues_count", "license",
"created_at", "updated_at", "html_url", "clone_url"):
v = data.get(k)
if isinstance(v, dict):
v = v.get("name", "")
if v is not None:
lines.append(f"{k:22s}: {v}")
text = "\n".join(lines)
self.detail_text.configure(state=tk.NORMAL)
self.detail_text.delete("1.0", tk.END)
self.detail_text.insert(tk.END, text)
self.detail_text.configure(state=tk.DISABLED)
raw = json.dumps(data, ensure_ascii=False, indent=2)
self.raw_text.configure(state=tk.NORMAL)
self.raw_text.delete("1.0", tk.END)
self.raw_text.insert(tk.END, raw)
self.raw_text.configure(state=tk.DISABLED)
if __name__ == "__main__":
root = tk.Tk()
app = App061(root)
root.mainloop()
6. ステップバイステップガイド
このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。
-
1ファイルを作成する
新しいファイルを作成して app061.py と保存します。
-
2クラスの骨格を作る
App061クラスを定義し、__init__とmainloop()の最小構成を作ります。
-
3タイトルバーを作る
Frameを使ってカラーバー付きのタイトルエリアを作ります。
-
4入力フォームを実装する
LabelFrameとEntryウィジェットで入力エリアを作ります。
-
5処理ロジックを実装する
_execute()メソッドにメインロジックを実装します。
-
6結果表示を実装する
TextウィジェットかLabelに結果を表示する_show_result()を実装します。
-
7エラー処理を追加する
try-exceptとmessageboxでエラーハンドリングを追加します。
7. カスタマイズアイデア
基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。
💡 ダークモードを追加する
bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。
💡 データの保存機能
処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。
💡 設定ダイアログ
フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。
8. よくある問題と解決法
❌ 日本語フォントが表示されない
原因：システムに日本語フォントが見つからない場合があります。
解決法：font引数を省略するかシステムに合ったフォントを指定してください。
❌ ライブラリのインポートエラー
原因：必要なライブラリがインストールされていません。
解決法：pip install コマンドで必要なライブラリをインストールしてください。 (pip install requests)
❌ ウィンドウサイズが合わない
原因：画面解像度や表示スケールによって異なる場合があります。
解決法：root.geometry()で適切なサイズに調整してください。
9. 練習問題
アプリの理解を深めるための練習問題です。
-
課題1：機能拡張
GitHub APIビューアに新しい機能を1つ追加してみましょう。
-
課題2：UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。
-
課題3：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。