pinboard.in的python包装器

pinboard的Python项目详细描述


| image0 image1

ci status version versions


pinboard.py是一个易于使用且功能齐全的python包装器和
`命令行实用程序<;https://github.com/lionheart/pinboard.py命令行>;`_对于api中的pinboard.in.


安装
----


(pypi)下载。您可以立即使用pip或easy_install安装它。

如果您使用的是python 3或更高版本:

…代码::bash

pip install"pinboard>;=2.0"


对于python 2.7:

……代码::bash

pip install"pinboard>;=1.0,<;2.0"

usage
----


一旦你明白了,你就可以出发了。代码::pycon

>;>import pinboard
>;>pb=pinboard.pinboard(api_令牌)

以下是一些示例:

update
~~~~~~


>返回添加、更新或删除书签的最新时间。

……代码::pycon

>;>pb.posts.update()
datetime.datetime(2014、7、27、18、11、29)

posts
~代码::pycon

>;>pb.posts.add(url="http://google.com/",description="一个很棒的搜索引擎",\
extended="这是一个描述!",tags=["search","tools"],shared=true,\
toread=false)
true


更新书签:

……代码::pycon



现在您可以直接使用bookmark对象更改描述、扩展、共享、存储、标记或时间。
>;>;bookmark.description="谷歌非常棒"
>;>;bookmark.tags=["搜索","搜索"]
>;>;bookmark.save()
true

如果还想更新书签创建日期,则需要将"update_time=true"传递到save方法
>;>;import datetime
>;>;bookmark.time=datetime.datetime.now()-datetime.timedelta(days=5)
>;>;bookmark.save(update_time=true)


删除书签:

…代码::pycon

>;>pb.posts.delete(url="http://google.com/"
true

代码::pycon

>;>pb.posts.get(url="http://google.com/"
{u'date':datetime.datetime(2014、7、25、16、35、25),
u'posts':[<;bookmark description="a great search engine"url="google.com">;],
u'user':u'dlo'}

>;>导入datetime
>;>pb.posts.get(dt=datetime.date.today())
{u'date':datetime.datetime(2014、7、25、16、35、25),
u'posts':[<;bookmark description="a great search engine"url="google.com">;,
<;bookmark description="平滑滚动css tricks"url="css tricks.com">;,
<;bookmark description="apple"沮丧地说,"人们不想支付任何东西"在移动设备上,"横幅传奇"开发者touch arcade"url="toucharcade.com">;",
u'user':u'dlo'}


返回所有最近的书签(可选择按标记筛选):

…代码::pycon

>>pb.posts.recent(tag=["programming","python"])
{u'date':datetime.datetime(2014,4,28,2,7,58),
u'posts':[<;bookmark description="itunesfs 1.0.0.7:python包索引"url="pypi.python"。org">;",
<;bookmark description="mincss"清除css中的垃圾邮件"-peterbe.com"url="www.peterbe.com">;,
<;bookmark description="braintree测试信用卡账号"url="www.braintreepayments.com">;,
<;bookmark description="有价值的课程:python中的monad(语法很好!)"url="www.valuedlessons.com">;,
<;bookmark description="在spacepaste粘贴egy1xpqxq2uput91sh83"url="bpaste.net">;,
<;bookmark description="40个随机字母和数字"url="gist.github.com">;,
<;bookmark description="pep 3156--异步IO支持重新启动"url="www.python.org">;,
<;bookmark description="brython"url="www.brython.info">;,
<;bookmark description="django rest framework"url="django rest framework.org">;,
<;bookmark description="mypy-具有动态和静态类型的新python变体"url="www.mypy-lang.org">;,
<;bookmark description="julython 2012"url="www.julython.org">;,
<;bookmark description="stripe blog:使用gdb探索python"url="stripe.com">;,
<;bookmark description="python常见问题解答:描述符-模糊记事本"url="me.veekun.com">;,
<;bookmark description="python神奇方法指南"rafeketler.com"url="www.rafeketler.com">;,
<;bookmark description="melopy"url="prezjordan.github.com">;,
<;bookmark description="litl/rauth"url="github.com">;],
u'user':u'dlo}

代码::pycon

>>pb.posts.dates(tag=["programming","python"])
{u'dates':{datetime.date(2008,12,5):1,
datetime.date(2008,12,6):1,

datetime.date(2014,7,24):6,
datetime.date(2014,7,25):4},
u'tag':u'programming+python',
u'user':u'dlo'}


获取帐户中的所有书签:

……代码::pycon

>;>pb.posts.all()
[<;bookmark description="of Princesses and Dragons"url="medium.com">;
<;bookmark description="a Great Search Engine"url="google.com">;,

<;
<;bookmark description="runner econ 101-stimha"url="stimhack.com">;,
<;bookmark descrip攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀攀br/>您还可以按标记、开始、结果、fromdt或todt进行筛选。

…代码::pycon

>;>;导入日期时间
>;>;五天前=datetime.datetime.now()-datetime.timedelta(天=5)
>;>;pb.posts.all(tag=["programming"],start=10,results=100,fromdt=五天前)
[<;bookmark description="of Princesses and Dragons"url="medium.com">;
<;bookmark description="a Great Search Engine"url="google.com">;,

<;bookmark description="Runner Econ 101-Stimha"url="Stimhack.com">;,
<;bookmark description="_64;_",__+___…___:_"url="news.naver.com">;]

tags
~~~~~


代码::pycon

>;>pb.posts.suggest(url="https://pinboard.in")
[{u'popular':[u'pinboard']},
{u'recommended':[u'bookmark',
u'bookmarks',
u'\uc815\ubcf4\ud1b5\uc2e0',
u'pinboard',
u'unread,
u'webservice']


返回您帐户中的所有标记以及使用这些标记的次数:


……代码::pycon

>;>pb.tags.get()
[<;tag name="荒谬"count=1>;,
<;tag name="accessibility"count=2>;,
<;tag name="accounting"count=3>;,
<;tag name="zen"count=1>;,
<;tag name="zsh"count=1>;,
<;tag name="zynga"count=1>;]


删除标记:

…代码::pycon

>>pb.tags.delete(tag="zynga"
true


重命名标记:

…代码::pycon

>;>;pb.tags.rename(old='ppython',new='python')
true


杂项
~~~~~~~~~~~~~~~~~

默认情况下,pinboard.py将返回解析的json对象。如果您想
请求的原始响应对象,只需传入
`` parse_response=false`.

代码::pycon

>;>;response=pb.tags.get(parse_response=false)
>;>;response
<;addinfourl at 4396047680,其fp=<;socket.&u fileobject at 0x105f79850>;
>;>;response.read()
…您的标签…

pinboard.py将1-1映射到pinboard api(例如,pb.one.two.three()将
向"https://api.pinboard.in/v1/one/two/three"发送请求)。有关其他方法和用法的更多信息,请阅读"pinboard api
文档<;https://pinboard.in/api/>;` ` ` ` ` ` ` `.

另一个注意事项–您可能已经注意到书签没有"title"属性。自从Pinboard API调用titles
"descriptions"和descriptions"extended"以来,就一直在这样做(这样做是为了让
与美味的API保持一致,回到过去)。为了尽量减少混淆,这个库坚持pinboard如何命名这些字段。请记住-"description"表示"title",而"extended"表示"description"。


pinboard.py还附带了一个方便的命令行实用程序,名为
"pinboard"。只需键入"pinboard-h"即可获得支持的
命令的完整列表。您的api令牌需要对pinboard.py可用,并且可以通过多种方式输入
。首先pinboard.py将尝试读取
~/.pinboardrc配置文件。如果不存在,则它将尝试
读取名为"pinboard_token"的环境变量。最后,它将显示一个shell提示,让用户输入他们的令牌(您可以通过键入"pinboard login"立即强制后一行为)。

如果您想将原始响应数据发送到stdout,只需在子命令(例如,"pinboard–raw bookmarks")之前传递"–raw"。

代码::sh

$pinboard login
输入您的pinboard api令牌:用户名:xxxxx
已将pinboard凭据保存到~/.pinboard rc
$pinboard suggest tags--url http://pymotw.com/2/argparse/
[
{
"popular":[
"python"
]
},
{
"推荐":[
"python",
"参数",
"解析"
]
}
]
$pinboard get——日期7-13-2014
{
"日期":"2014-07-13t03:03:58z",
"posts":[
{
"扩展":",
"hash":"e2311835eb0de6bff2595a9b1525bb98",
"description":"python 2.7.x和python 3.x key difference",
"tags":"python",
"ref":"http://sebastianraschka.com/articles/2014\u python 2.u key diff.html",
"meta":"561D1F53791A8C501093411F0301FC",
"time":"2014-07-13t03:03:58Z",
"shared":"yes",
"toread":"no"
},
{
"extended":",
"hash":"4abe28f70154bd35f84be73cec0c53ef",
"description":"迈阿密,伟大的世界城市,正在被淹没,而那些被忽视的力量世界新闻观察家",
"tags":",
"ref":"http://www.theguardian.com/world/2014/jul/11/miami溺水气候变化否认者海平面上升",
"meta":"2ca54779553ba9d3202A5CD3D67685",
"时间":"2014-07-13t02:53:54z",
"共享":"是",
"存储":"是"
}}
],
"用户":"dlo"
}
}$pinboard--raw get--date 7/13/2014
"日期":"2014-07-13t03:03:58z","user":"dlo","posts":[{"ref":"http:\/\/sebastianraschka.com\/articles\/2014_python_2_3_key_diff.html","description":"python 2.7.x和python 3.x key differences","extended":,"meta":"561D1F53791A8C501093411F0301FC","hash":"E2311835EB0DE6FF2595A9B1525BB98","time":"2014-07-13T03:03:58Z","shared":"yes","toread":"no","tags":"python"},{"ref":"http:\/\/www.theguardian.com\/world\/2014\/jul\/11\/miami-swoding-climate-change-deniers海平面上升","description":"迈阿密,这个伟大的世界城市,正在被淹没,而那些被忽视的力量世界新闻观察家","extended":","meta":"2ca54779553ba9d302a5cd3d367685","hash":"4abe28f70154bd35f84be73cec0c53ef","time":"2014-07-13t02:53:54z","shared":"yes","toread":"yes","tags":"}]

您可以通过传递"-h"标志打印钉板命令的完整列表。

代码::sh

$pinboard-h
用法:pinboard[-h][--raw]

{登录、上次更新、添加、删除、获取、最近、日期、书签、建议标记、标记、删除标记、重命名标记、注释、注释、注释、rss密钥、api标记}


{登录,上次更新,添加,删除,获取,最近,日期,书签,建议标记,标记,删除标记,重命名标记,注释,注释,rss密钥,api token}
添加帖子/add
删除帖子/delete
获取帖子/get
最近的帖子/recent
日期帖子/dates
书签帖子/all
建议标签发布/建议
标记标记/get
删除标记标记/delete
重命名标记标记/rename
注释注释/list
注释注释/id
rss密钥用户/secret
api标记用户/api_令牌


可选参数:
-h,--帮助显示此帮助消息并退出
--raw不使用任何
格式从pinboard api打印原始数据。

代码::sh

$pinboard bookmarks-h
用法:pinboard bookmarks[-h][--from_date from_date][--to_date to_date]
[--tags tags[tags…][--count count count]
[--offset offset]

-H,--帮助显示此帮助消息并退出
--from_date from_date
--to_date to_date
--tags tags[标记…]
--count count
--offset offset


码头工人:

…代码::sh

$cd<;https://github.com/lionheart/pinboard.py/blob/master/path_to_pinboard>;/bin
$docker build-t pinboard。

代码::sh

$export pinboard_token=<;https://github.com/lionheart/pinboard.py/blob/master/your_pinboard_token>;
$docker run-ti-e pinboard_token pinboard书签--count 10

支持
----


您可能想查看"pushpin for
pinboard<;https://itunes.apple.com/us/app/pushpin-for-pinboard/id548052590?"mt=8&uo=4&at=1l3vbec>;` `.

…_ license-licenselecense-imagelicense-url:

license license
----


<;!--https://circleci.com/gh/lionheart/pinboard.py/tree/master.png?圆圈标记=D50700E1C75836063A7951F80AB1913CF6447ACF-->;

…| image0 image::meta/repo banner.png
…| image1 image::meta/repo banner bottom.png
:目标:https://github.com/lionheart/pinboard.py/blob/master/https://lionheartsw.com/
。| CI状态图像::http://img.shields.io/travis/lionheart/pinboard.py.svg?style=flat
:目标:https://github.com/lionheart/pinboard.py/blob/master/https://travis ci.org/lionheart/pinboard.py
。|图片版本:http://img.shields.io/pypi/v/pinboard.svg?style=flat
:目标:https://github.com/lionheart/pinboard.py/blob/master/https://pypi.python.org/pypi/pinboard
…|版本图像::https://img.shields.io/pypi/pyversions/pinboard.svg?style=flat
:目标:https://github.com/lionheart/pinboard.py/blob/master/https://pypi.python.org/pypi/pinboard
…|许可证图像::http://img.shields.io/pypi/l/pinboard.py.svg?style=flat
:目标:https://github.com/lionheart/pinboard.py/blob/master/license



欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java HikariCP连接池Tomcat调试启用   java如何在javascript中访问JSON数组的元素?   jasper使用HttpServlet报告Java空白PDF   用于存储海量数据的java最佳集合   JBPM&springboot组织。流口水。坚持不懈jta。JtaTransactionManager在JNDI位置[java:comp/UserTransaction]未找到任何UserTransaction   java Grails maven插件需要Groovy 2.4.2   获取列表中访问最少的元素(Java 8)   java在IntelliJ中下载cn1lib不起作用   java Akka构造函数通过spring进行布线   swing在Java中创建JList时,如何更改条目的背景颜色?   为什么Java8Lambda允许访问非最终类变量?   javajavax。邮政MessaginException:无法连接到SMTP主机   java Android Webview高度在滚动后增加