diff --git a/README.md b/README.md new file mode 100644 index 0000000..4b7ccbc --- /dev/null +++ b/README.md @@ -0,0 +1,90 @@ +Weibo +===== + +[![](http://img.shields.io/pypi/v/weibo.svg?style=flat"mylib")](https://pypi.python.org/pypi/weibo) + +[![](http://img.shields.io/pypi/dm/weibo.svg?style=flat)](https://pypi.python.org/pypi/weibo) + + +新浪微博 python SDK. + +使用 `requests` 进行相关网络操作,因而相对于官方的 sdk,极大的简化了代码,并提高了可读性。 + + +安装 +---- + +推荐使用 `pip` 安装。 + +``` bash +pip install weibo +``` + +使用说明 +-------- + +###准备工作 + + +- 首先,注册一个新浪开发者帐号,并在 `新浪开发平台 `_ 新建一个 app. + +- 创建好应用之后在 '应用信息 -> '基本信息' 里面获取 `App Key` 和 `App Secret`. + +- 在 '应用信息 -> '高级信息' 里面设置好 '授权回调页'. + +###示例 + + +下面分别用 `API_KEY`, `API_SECRET`, `REDIRECT_URI` 代表准备工作里面的三个参数。 + + +###Token 认证 + + +```python + +>>> from weibo import Client +>>> c = Client(API_KEY, API_SECRET, REDIRECT_URI) +>>> c.authorize_url +'https://api.weibo.com/oauth2/authorize?redirect_uri=http%3A%2F%2F127.0.0.1%2Fcallback&client_id=123456' +``` +复制链接到浏览器打开,获取 code. + +``` python +>>> c.set_code('abcdefghijklmn') +``` + +client 初始化完成。token 可以被保存下来供下次调用时直接使用。 + +```python +>>> token = c.token +>>> c2 = Client(API_KEY, API_SECRET, REDIRECT_URI, token) +>>> c2.get('users/show', uid=2703275934) +``` + +###帐号认证 + + +除了使用 token 认证,还可以使用 username / password 进行认证。 + +```python + + >>> from weibo import Client + >>> c = Client(API_KEY, API_SECRET, REDIRECT_URI, username='admin', password='secret') + >>> c.get('users/show', uid=1282440983) +``` +###接口调用 + + +参考 [微博开发文档](http://open.weibo.com/wiki/API%E6%96%87%E6%A1%A3_V2) 进行接口调用。 + +```python +>>> c.get('users/show', uid=1282440983) +>>> c.post('statuses/update', status='python sdk test, check out http://lxyu.github.io/weibo/') +``` +client 兼容上传图片接口。 + +````python +>>> f = open('avatar.png', 'rb') +>>> c.post('statuses/upload', status='new avatar!', pic=f) +```` \ No newline at end of file diff --git a/README.rst b/README.rst deleted file mode 100644 index 40c3c2f..0000000 --- a/README.rst +++ /dev/null @@ -1,95 +0,0 @@ -Weibo -===== - -.. image:: http://img.shields.io/pypi/v/weibo.svg?style=flat - :target: https://pypi.python.org/pypi/weibo - -.. image:: http://img.shields.io/pypi/dm/weibo.svg?style=flat - :target: https://pypi.python.org/pypi/weibo - - -新浪微博 python SDK. - -使用 `requests` 进行相关网络操作,因而相对于官方的 sdk,极大的简化了代码,并提高了可读性。 - - -安装 ----- - -推荐使用 `pip` 安装。 - -.. code:: bash - - $ pip install weibo - - -使用说明 --------- - -准备工作 -~~~~~~~~ - -- 首先,注册一个新浪开发者帐号,并在 `新浪开发平台 `_ 新建一个 app. - -- 创建好应用之后在 '应用信息 -> '基本信息' 里面获取 `App Key` 和 `App Secret`. - -- 在 '应用信息 -> '高级信息' 里面设置好 '授权回调页'. - -示例 -~~~~ - -下面分别用 `API_KEY`, `API_SECRET`, `REDIRECT_URI` 代表准备工作里面的三个参数。 - - -Token 认证 -"""""""""" - -.. code:: python - - >>> from weibo import Client - >>> c = Client(API_KEY, API_SECRET, REDIRECT_URI) - >>> c.authorize_url - 'https://api.weibo.com/oauth2/authorize?redirect_uri=http%3A%2F%2F127.0.0.1%2Fcallback&client_id=123456' - -复制链接到浏览器打开,获取 code. - -.. code:: python - - >>> c.set_code('abcdefghijklmn') - - -client 初始化完成。token 可以被保存下来供下次调用时直接使用。 - -.. code:: python - - >>> token = c.token - >>> c2 = Client(API_KEY, API_SECRET, REDIRECT_URI, token) - >>> c2.get('users/show', uid=2703275934) - -帐号认证 -"""""""" - -除了使用 token 认证,还可以使用 username / password 进行认证。 - -.. code:: python - - >>> from weibo import Client - >>> c = Client(API_KEY, API_SECRET, REDIRECT_URI, username='admin', password='secret') - >>> c.get('users/show', uid=1282440983) - -接口调用 -"""""""" - -参考 `微博开发文档 `_ 进行接口调用。 - -.. code:: python - - >>> c.get('users/show', uid=1282440983) - >>> c.post('statuses/update', status='python sdk test, check out http://lxyu.github.io/weibo/') - -client 兼容上传图片接口。 - -.. code:: python - - >>> f = open('avatar.png', 'rb') - >>> c.post('statuses/upload', status='new avatar!', pic=f)