README_ja.md

ScratchTrend: Scratchから人気作品を取得。

ScratchTrendは、https://scratch.mit.edu/explore から、人気の作品を取得します。
(このライブラリはScratch財団とは無関係です。)

使い方

インストール

ターミナル

$ pip install scratchtrend

インポート

import scratchtrend as sct
from scratchtrend.select import Lang, Sort

必須ライブラリ・アプリ

• Selenium
• BeautifulSoup
• GoogleChrome

推奨ライブラリ

• chromedriver_binary
• webdriver_manager

上記のどれか一つがインストールされていると、ChromeDriverのパスを自動で通してくれます。

準備

sct.CHROMEDRIVER_PATH = "chromedriverのパス"

もし推奨ライブラリのいずれかが入っていない場合はここで指定することができます。 (インストールされていればこれは無視されます。)

# example
data = sct.connect(Lang.JAPANESE, Sort.POPULAR)

指定できる言語の一覧はLanguages.mdに書いてあります。 connect()メソッドで、言語、並び替えを指定してください。
並び替えは以下の通りです:

指定内容	並び替え
Sort.TRENDING	傾向
Sort.POPULAR	人気
Sort.RECENT	最近

メソッド

(まだ開発途中のため、ショボいです)

data.get_by_page()  # ページを指定して取得
data.get_by_num()  # 順位を指定して取得

get_by_page()メソッドはstart引数からend引数のページの作品を取得します。必ず start<endとなるようにしてください。
get_by_num()メソッドはstart引数からend引数の順位の作品を取得します。こちらもstart<endとなるようにしてください。

"順位"という言い方には少し語弊があります。良い言い方があったらIssuesまでお願いします。

返り値

# 見やすくするため整形しています。
[
    {
        'title': '作品のタイトル',
        'id': "作品のID"
    },
    {
        'title': 'タイトル',
        'id': "ID"
    }
]

このようにリスト内辞書で返されます。

デモ

その他

ライセンス

ScratchTrendはMITライセンスです。

クレジット

• ロゴはDesignEvo を使用しました。
• Selenium
• BeautifulSoup
• GoogleChrome

連絡

もしバグを発見した場合は、IssueまたはScratchまで。