使用Python和維基百科API構(gòu)建維基百科命令行工具

創(chuàng)建一個維基百科命令行界面 (CLI) 工具是一個很有成就感項目，它結(jié)合了Python的簡潔性和維基百科龐大的知識庫。本教程將逐步指導(dǎo)您如何構(gòu)建一個使用其API從維基百科獲取信息的CLI工具。

先決條件

開始之前，請確保您擁有以下內(nèi)容：

• 系統(tǒng)上安裝了Python 3.7或更高版本。
• Python的基礎(chǔ)知識和API的使用經(jīng)驗。
• 用于訪問維基百科API的互聯(lián)網(wǎng)連接。

第一步：了解維基百科API

維基百科在 http://www.miracleart.cn/link/27bf6226213cf288dfbf62ffc02bad4f 提供了一個RESTful API。此API允許開發(fā)人員查詢維基百科的內(nèi)容、元數(shù)據(jù)等等。我們將使用的關(guān)鍵端點包括：

• action=query：從維基百科獲取一般內(nèi)容。
• list=search：按關(guān)鍵字搜索文章。
• prop=extracts：檢索文章摘要。

所有API請求的基本URL為：

<code>http://www.miracleart.cn/link/27bf6226213cf288dfbf62ffc02bad4f</code>

第二步：設(shè)置Python環(huán)境

首先創(chuàng)建一個Python虛擬環(huán)境并安裝所需的庫。我們將使用requests進行HTTP請求，使用argparse處理CLI參數(shù)。

<code># 創(chuàng)建虛擬環(huán)境
python -m venv wikipedia-cli-env

# 激活環(huán)境
# 在Windows上：
wikipedia-cli-env\Scripts\activate
# 在Mac/Linux上：
source wikipedia-cli-env/bin/activate

# 安裝依賴項
pip install requests argparse</code>

第三步：規(guī)劃CLI功能

我們的CLI工具將包括以下功能：

1. 搜索維基百科文章：允許用戶按關(guān)鍵字搜索文章。
2. 獲取文章摘要：檢索特定文章的簡短摘要。
3. 查看CLI幫助：顯示使用說明。

第四步：實現(xiàn)CLI工具

以下是CLI工具的Python代碼：

import argparse
import requests

# 定義維基百科API的基本URL
WIKIPEDIA_API_URL = "http://www.miracleart.cn/link/27bf6226213cf288dfbf62ffc02bad4f"

def search_articles(query):
    """搜索與查詢匹配的維基百科文章。"""
    params = {
        'action': 'query',
        'list': 'search',
        'srsearch': query,
        'format': 'json',
    }
    response = requests.get(WIKIPEDIA_API_URL, params=params)
    response.raise_for_status()  # 對錯誤的響應(yīng)引發(fā)錯誤
    data = response.json()

    if 'query' in data:
        return data['query']['search']
    else:
        return []

def get_article_summary(title):
    """獲取維基百科文章的摘要。"""
    params = {
        'action': 'query',
        'prop': 'extracts',
        'exintro': True,
        'titles': title,
        'format': 'json',
    }
    response = requests.get(WIKIPEDIA_API_URL, params=params)
    response.raise_for_status()
    data = response.json()

    pages = data.get('query', {}).get('pages', {})
    for page_id, page in pages.items():
        if 'extract' in page:
            return page['extract']
    return "No summary available."

def main():
    parser = argparse.ArgumentParser(description="一個與維基百科交互的CLI工具。")
    subparsers = parser.add_subparsers(dest="command")

    # 子命令：search
    search_parser = subparsers.add_parser("search", help="在維基百科上搜索文章。")
    search_parser.add_argument("query", help="搜索查詢。")

    # 子命令：summary
    summary_parser = subparsers.add_parser("summary", help="獲取特定維基百科文章的摘要。")
    summary_parser.add_argument("title", help="維基百科文章的標題。")

    args = parser.parse_args()

    if args.command == "search":
        results = search_articles(args.query)
        if results:
            print("搜索結(jié)果：")
            for result in results:
                print(f"- {result['title']}: {result['snippet']}")
        else:
            print("未找到結(jié)果。")

    elif args.command == "summary":
        summary = get_article_summary(args.title)
        print(summary)

    else:
        parser.print_help()

if __name__ == "__main__":
    main()

第五步：測試CLI工具

將腳本保存為wikipedia_cli.py。您現(xiàn)在可以從終端運行該工具：

1. 搜索文章：

<code>python wikipedia_cli.py search "Python programming"</code>

2. 獲取文章摘要：

<code>python wikipedia_cli.py summary "Python (programming language)"</code>

第六步：增強工具

為了使工具更強大和用戶友好，請考慮添加以下內(nèi)容：

1. 錯誤處理：為失敗的API請求提供詳細的錯誤消息。
2. 格式化：使用諸如rich之類的庫來獲得更漂亮的輸出。
3. 緩存：實現(xiàn)緩存以避免對相同查詢的重復(fù)API調(diào)用。
4. 附加功能：添加對獲取相關(guān)文章、類別或圖像的支持。

結(jié)論

您已成功使用Python及其API構(gòu)建了一個維基百科CLI工具！此工具可以作為更高級項目的良好起點，例如將其集成到其他應(yīng)用程序中或創(chuàng)建GUI版本。祝您編碼愉快！

以上是如何創(chuàng)建Wikipedia CLI的詳細內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！