GitHubじゃ!Pythonじゃ!

GitHubからPython関係の優良リポジトリを探したかったのじゃー、でも英語は出来ないから日本語で読むのじゃー、英語社会世知辛いのじゃー

bear

python-twitter – Twitter APIの周りのPythonラッパー

投稿日:

Twitter APIの周りのPythonラッパー。

Python Twitter

Twitter APIの周りのPythonラッパー。

Python-Twitterデベロッパーによる

前書き

このライブラリは、 Twitter API用の純粋なPythonインターフェイスを提供します 2.7以上のPythonバージョンとPython 3で動作します。

Twitterは、人々がWeb、IM、およびSMS経由で接続できるようにするサービスを提供します。 TwitterはWebサービスAPIを公​​開しています。このライブラリは、Pythonプログラマーが使いやすくするためのものです。

インストール

あなたはpython-twitterを以下を使ってインストールすることができます:

$ pip install python-twitter

Google App Engineでpython-twitterを使用している場合は、App Engineプロジェクトにサードパーティのベンダーライブラリの依存関係を含める方法についての詳細を参照してください。

コードの取得

コードはhttps://github.com/bear/python-twitterでホストされています

匿名で最新の開発版をチェックしてください:

$ git clone git://github.com/bear/python-twitter.git
$ cd python-twitter

依存関係をインストールするには、次のいずれかを実行します。

$ make dev

または:

$ pip install -Ur requirements.testing.txt
$ pip install -Ur requirements.txt

`make dev`は、 `pyenv`を使ってテストを実行するために必要なすべてのバージョンをあなたのローカル`pyenv`インストールする`make dev`注意してください。

プロダクション用に最小の依存関係をインストールするには( pip install python-twitterされているもの)、次のコマンドを実行します。

$ make env

または:

$ pip install -Ur requirements.txt

テストの実行

テストスイートは、選択したMakefileターゲットに応じて、単一のPythonバージョンまたはその範囲に対して実行できます。

テストに`pip install pytest`とオプションで`pip install pytest-cov` (これらは`requirements.testing.txt`から依存関係をインストールした場合に含まれてい`requirements.testing.txt` )が`requirements.testing.txt`

単一のPythonバージョンで単体テストを実行するには:

$ make test

コードカバレッジを実行する:

$ make coverage

Pythonバージョンのセットに対して単体テストを実行するには:

$ make tox

ドキュメンテーション

最新のpython-twitterのドキュメントはhttps://python-twitter.readthedocs.ioご覧ください TwitterのAPIドキュメントはhttps://dev.twitter.com/overview/documentationで閲覧できます

使用

このライブラリは、Twitter APIとTwitterデータモデルの周りにPythonラッパーを提供します。 始めるには、examples /フォルダー内のサンプルをチェックするか、 https://python-twitter.readthedocs.ioの文書を読んでください。ここには、Twitterからの認証キーの取得とライブラリーの使用に関する情報が含まれています。

Djangoで使う

ツイートのURLを展開してツイートのテキストを追加する追加のテンプレートタグ。 python-twitterで使用できるdjangoテンプレートタグを参照してください: https : //github.com/radzhome/python-twitter-django-tags

モデル

ライブラリはモデルを利用して、Twitterによって返されるさまざまなデータ構造を表します。 これらのモデルは次のとおりです。
  • twitter.Category
  • twitter.DirectMessage
  • twitter.Hashtag
  • twitter.List
  • twitter.Media
  • twitter.Status
  • twitter.Trend
  • twitter.Url
  • twitter.User
  • twitter.UserStatus

これらのモデルのマニュアルを読むには、次のコマンドを実行します。

$ pydoc twitter.[model]

API

APIはtwitter.Apiクラスを介して公開されています。

python-twitterはほぼすべての操作にOAuthキーを使用する必要があります。 TwitterのAPI v1.1では、すべてではないにしてもほとんどのエンドポイントで認証が必要です。 したがって、このライブラリを使用するには、Twitterにアプリを登録する必要があります。 詳細はhttps://python-twitter.readthedocs.ioの「Getting Started」ガイドを参照してください。

アクセストークンを生成するには、アプリケーションに必要なアクセスの種類を選択してから、次のいずれかを実行する必要があります。

詳細はTwitterのOAuthの概要をご覧ください

ログイン資格情報を持つtwitter.Apiインスタンスを作成するには(TwitterはすべてのAPI呼び出しに対してOAuthアクセストークンが必要です):

>>> import twitter
>>> api = twitter.Api(consumer_key='consumer_key',
                      consumer_secret='consumer_secret',
                      access_token_key='access_token',
                      access_token_secret='access_token_secret')

信任状が成功したかどうかを確認するには:

>>> print(api.VerifyCredentials())
{"id": 16133, "location": "Philadelphia", "name": "bear"}

:ここに示した小さなサンプルよりもはるかに多くが印刷されます

単一のユーザーのパブリック・ステータス・メッセージを取得するには、 userがTwitterユーザーの画面名であるuserがありuser

>>> statuses = api.GetUserTimeline(screen_name=user)
>>> print([s.text for s in statuses])

ユーザーの友だちリストを取得するには:

>>> users = api.GetFriends()
>>> print([u.name for u in users])

Twitterのステータスメッセージを投稿するには:

>>> status = api.PostUpdate('I love python-twitter!')
>>> print(status.text)
I love python-twitter!

より多くのAPIメソッドがあります。詳細なAPIドキュメントを読むには、 readthedocsのドキュメントをチェックするか、ドキュメントをローカルでビルドしてください:

$ make docs

インライン文書をチェックアウトするには:

$ pydoc twitter.Api

Todo

パッチ、プルリクエスト、バグレポートを歓迎します。オリジナルのソースとスタイルを一致させてください。

特に、より多くのサンプルスクリプトを用意することは大きな助けになります。 python-twitterを使用し、ドキュメントのリンクを希望するプログラムをお持ちの場合は、 twitter/doc/getting_started.rstに対してプルリクエストを送信し、最下位にプログラムを追加してください。

twitter.Statusとtwitter.Userクラスは、APIが変更された場合、APIとの同期を保つのが難しくなります。 コードの多くは、おそらくイントロスペクションで記述することができます。

twitter.Statustwitter.Userクラスは、プロパティ設定ツールでより多くの検証を実行できます。

詳しくは

詳細はGoogleグループをご覧ください。

貢献者

もともと、DeWitt ClintonとMike Taylorの2つの図書館がpython-twitterに統合されました。

今は時間の経過とともに多くの貢献者を抱えるフルオープンソースプロジェクトです。 完全なリストについては、AUTHORS.rstを参照してください。

ライセンス

Copyright 2007-2016 Python-Twitter開発者
Apache License、Version 2.0(以下「ライセンス」)の下でライセンスされています。
ライセンスに従わない限り、このファイルを使用することはできません。
あなたはライセンスのコピーを
適用される法律または書面による同意が必要な場合を除き、ソフトウェア
ライセンスの下で配布されているものは、現状のままで配布され、
明示的にも黙示的にも、いかなる種類の保証も条件もありません。
権限を管理する特定の言語については、ライセンスを参照してください。
ライセンスに基づく制限。







-bear

執筆者: