ウェブ自動化のための軽量なSeleniumラッパー。

ausrine

ウェブ自動化のための軽量なSeleniumラッパー。

ausrineは、Seleniumの機能を直感的で使いやすいAPIにラッピングすることで、ウェブ自動化タスクを簡素化するように設計されています。データのスクレイピング、ウェブアプリケーションのテスト、または繰り返しのブラウザタスクの自動化など、ausrineは最小限の設定で効率的な体験を提供します。

インストール

ausrineをpipを使用してインストールします：

pip install ausrine

ausrineはselenium>=4.0.0とSelenium Managerを使用しており、WebDriverの依存関係を自動的に管理します。インストール以外の追加設定は不要です。

使用方法

ausrineは、直感的なWebAutomationDriverクラスを提供することで、Seleniumを使ったウェブ自動化を簡素化します。以下はBingで検索を行う例です：

from ausrine import WebAutomationDriver
from ausrine.chrome import setup_webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys

# Chrome WebDriverを初期化
driver = setup_webdriver()

# WebAutomationDriverインスタンスを作成
ausrine = WebAutomationDriver(driver)

# Bingに移動
ausrine.get("https://www.bing.com/?cc=jp")

# 検索ボックスを見つけ、"iphone"と入力し、Enterキーを押す
ausrine.send_keys(by=By.NAME, value="q", text="iphone")
ausrine.send_keys(by=By.NAME, value="q", text=Keys.ENTER)

# ドライバーを終了
ausrine.quit()

executeを使用して一連のコマンドを実行することもできます：

sequences = [
    {"get": {"url": "https://www.bing.com/?cc=jp"}},
    {"send_keys": {"by": By.NAME, "value": "q", "text": "iphone"}},
    {"send_keys": {"by": By.NAME, "value": "q", "text": Keys.ENTER}},
]
ausrine = WebAutomationDriver(setup_webdriver())
ausrine.execute(sequences)
ausrine.quit()

エラー処理にはtry_executeを使用します：

sequences = [
    {"get": {"url": "https://www.bing.com/?cc=jp"}},
    {"send_keys": {"by": By.NAME, "value": "q", "text": "iphone"}},
    {"send_keys": {"by": By.NAME, "value": "q", "text": Keys.ENTER}},
]
ausrine = WebAutomationDriver(setup_webdriver())
error = ausrine.try_execute(sequences)
if error:
    print(f"エラーが発生しました: {error}")
else:
    print("実行が正常に完了しました")
ausrine.quit()

フォーム送信の例

以下はログイン表单を送信する例です：

from ausrine import WebAutomationDriver
from ausrine.chrome import setup_webdriver
from selenium.webdriver.common.by import By

# Chrome WebDriverを初期化
driver = setup_webdriver()

# WebAutomationDriverインスタンスを作成
ausrine = WebAutomationDriver(driver)

# ログインページに移動
ausrine.get("https://example.com/login")

# ユーザー名とパスワードを入力し、送信
ausrine.send_keys(by=By.ID, value="username", text="user")
ausrine.send_keys(by=By.ID, value="password", text="pass", password=True)
ausrine.submit(by=By.ID, value="login-btn")

# ドライバーを終了
ausrine.quit()

機能

• シンプルなAPI: get、click、send_keys、submitなどの一般的なウェブタスクのための直感的なメソッド。
• シーケンス実行: executeまたはtry_executeを使用して複数のコマンドを連結し、堅牢な自動化を実現。
• カスタマイズ可能なWebDriver: setup_webdriverを介してヘッドレスモードやカスタムダウンロードディレクトリなどのChromeオプションを設定可能。
• 軽量: 最小限の依存関係（Seleniumのみ）と焦点を絞った機能セット。

要件

• Python >= 3.10
• Selenium >= 4.0.0, < 5.0.0

ライセンス

このプロジェクトはMITライセンスの条件の下でライセンスされています。詳細はLICENSEファイルを参照してください。

貢献

貢献を歓迎します！詳細はCONTRIBUTING.mdファイルを参照し、問題やプルリクエストをGitHubリポジトリに提出してください。