BoardGameGeek.com API和Board Game实用程序的Python接口。
libBGG的Python项目详细描述
libbgg
==
boardgamegeek.com的python接口。从bgg中提取信息，并为数据创建适当的python对象。
支持python 3
*boardgame对象：boardgame、guild等。
*a caching用于将检索到的XML查询写入本地文件系统的API。
python用法示例：
---------------------------
>；来自libbgg.bg g api import bggapi
>；api=bggapi（）
>；bg=api。fetch_boardgame（'yinsh'）
>；print'yinsh由%s在%s中创建（bg.year，"，".join（bg.designers））
yinsh是由kris burm于2003年创建的
>；guild=api.fetch戋guild（'1920'）\bgg仅支持按id获取guild。
>；打印"bgg guild%s有%d个成员。"%（guild.name，len（guild.members））
bgg guild"paradox"有2个成员。
>；collection=api.fetch_collection（'philsstein'）
>；print'philsstein rated yinsh:s of 10'%collection.rating['yinsh'].userrating
philsstein rated yinsh:8 of 10
--------
ch查询bgg
并转储它找到的信息和"最高等级"，这需要一个公会id
，并转储公会成员的最高等级游戏和等级。
用法：
--------
$./bin/top-rated--help
用法：top-rated[-h][-g guild][-n number][-c cache][-f][-h htmlout]
[-w wikiout]
[-l{none，all，debug，info，warning，error，critical}]
Iven guild.
可选参数：
-h，--帮助显示此帮助消息并退出
-g guild，--guild guild
guild的ID。（bgg不支持按名称分类的guild
搜索。
-n number，--number
显示多少游戏。（默认值=100）
-c缓存，--cache缓存
缓存路径。如果先在缓存中给定查找，则从bgg获取。否则，始终从bgg.
集合中获取。如果给定--force fetch，则强制将
提取到缓存中。
-f，--forcefetch如果给定，则强制对任何数据进行重新提取。如果未给定缓存，则此参数不起任何作用。
-h htmlout，--htmlout htmlout
如果给定，则将数据的HTML表写入给定的
文件。
-w wikiout，--wikiout wikiout
if给定，将wiki格式的数据版本
写入给定文件。
-l{none，all，debug，info，warning，error，critical}，-log level{none，all，debug，info，warning，error，critical}
要记录的级别。必须是none、debug、
info、warning、error或critical之一。默认为无。
（这主要用于调试。）
$./bin/bgg_query--help
用法：bgg_query[-h][-g game][-g guild][-u user][-c collection]
[-c cache][-f]
[-l{none，all，debug，info，warning，error，critical}
向BGG查询棋盘游戏和相关信息。所有参数都可以指定
并多次指定。
（bgg不支持按名称分类的guild
搜索。
-u用户，--bgg用户的用户名。
-c集合，--collection集合
user的集合
-c缓存，--cache缓存
path缓存。如果先在缓存中给定查找，则从bgg获取。否则，始终从bgg.
集合中获取。如果给定--force fetch，则强制将
提取到缓存中。
-f，--forcefetch如果给定，则强制对任何数据进行重新提取。如果未给定缓存，则此参数
不起任何作用。
-l{none，all，debug，info，warning，error，critical}，--log level{none，all，debug，info，warning，error，critical}
要记录的级别。必须是none、debug、
info、warning、error或critical之一。默认值为"无"。
（这主要用于调试。）
脚本示例运行：
----
是的，BGG有一个"yinsh"用户。
$./bin/bgg_query——用户yinsh——收藏yinsh——游戏yinsh
yinsh的收藏有2款游戏：专卖版：豪华版（1995年）评分：5，拼字游戏（1948年）评分：6，
yinsh:
bggid:83873
国家：马来西亚
名字：yin
hot10:
姓氏：swee heng
名称：yinsh
前10名：
交易评级：0
注册年份：2006
yinsh:
艺术家：lu'cifer
bgid:7854
类别：抽象策略
设计师：kris burm
系列：mensa select，项目gipf
maxplayers:2
力学：网格运动，模式构建
minplayers:2
名称：yinsh
播放时间：30
发行商：don&co.，rio grande games，smart toys and games，inc.
年份：2003
aitlinsquared，distinctlybenign，jdclewis，magdalencox，schnubby，zetaceti名称：r/棋盘游戏
$./bin/b g g戋u query-g qwirkle-g notexists-g"pr戋t-porter"
qwirkle:
艺术家：b'
bgid:b'25669'
类别：b"抽象策略"
设计师：b'susan麦金利·罗斯家族：b'mensa select，qwirkle'
maxplayers:b'4'
mechanics:b'hand management，pattern building，tile placement'
minplayers:b'2'
名字：b'qwirkle，qwirkle\xc3\xa9附加航程，qwirkle travel，xed\x81\x90\xec\x9c\x84\xed\x81\xb4'
播放时间：B'45'
发行商：B'Mindware，999游戏，ADC Blackfire Entertainment，Compaya.hu-Gamer Caf\xc3\xa9 Kft.，Competo/Marektoy，Corfix，Cutia.ro.，xc3\x89面纱&Jeux，G3，绿板游戏公司，IELLO，Begint Media，Productief BV，Schmidt Spile'
年份：B'2006'
注xists:未找到。如果给定，则缓存中没有连接或不存在连接。
pr_t-porter:
艺术家：b'mariusz gandzel、tomasz jedruszek、micha\xc5\x82 oracz、darek zabrocki'
bgid:b'87890'
类别：b'economic、industry/manufacturing'
设计师：b'piotr haraszzak、ignacy trzewiczek'
系列：B'
maxplayers:B'4'
mechanics:B'card drafting，set collection，worker placement'
minplayers:B'2'
names:B'PR\xC3\xaat-\xC3\xa0 porter'
playingtime:B'90'
publishers:B'portal games'
year:B'2010'
G_cache-G 1291-N 15
获取公会"R/棋盘游戏"的成员信息
获取6个成员集合…….获取6个集合，总计1083个游戏和1062个等级。
计算等级…
公会R/棋盘游戏的等级：
==ted stddev名称
--------
1。10.00 1 0.00克梅特
2.10.00 1 0.00沙丘
3。10.00 10.00生存：逃离亚特兰蒂斯！
4。10.00 1 0.00银河卡车司机：周年纪念版
5.10.00 1 0.00雷克斯：帝国的最后日子
6。10.00 1 0.00磁盘世界：ankh morpork
7.10.00 10.00大津巴布韦
8.10.00 1 0.00忒修斯：暗轨道
10。9.50 1 0.00芝加哥快车
11.9.00 1 0.00荣耀罗马
12。9.00 1 0.00神秘地
13。9.00 1 0.00色卡
14.9.00 1 0.00汉莎·特顿尼卡
15.9.00 1 0.00 london
计算时间：2014年4月28日星期一17:45:22
使用来自6个公会成员的1062个评分。
version history
----
0.1.5-由于新服务器端更新而更新集合。服务器现在缓存信息。
0.1.4-减少内存占用。
0.1.2-垃圾箱/最高工程。添加了本地文件系统缓存。
0.1.1-添加了数据缓存
0.1.0-初始签入
==
boardgamegeek.com的python接口。从bgg中提取信息，并为数据创建适当的python对象。
支持python 3
*boardgame对象：boardgame、guild等。
*a caching用于将检索到的XML查询写入本地文件系统的API。
python用法示例：
---------------------------
>；来自libbgg.bg g api import bggapi
>；api=bggapi（）
>；bg=api。fetch_boardgame（'yinsh'）
>；print'yinsh由%s在%s中创建（bg.year，"，".join（bg.designers））
yinsh是由kris burm于2003年创建的
>；guild=api.fetch戋guild（'1920'）\bgg仅支持按id获取guild。
>；打印"bgg guild%s有%d个成员。"%（guild.name，len（guild.members））
bgg guild"paradox"有2个成员。
>；collection=api.fetch_collection（'philsstein'）
>；print'philsstein rated yinsh:s of 10'%collection.rating['yinsh'].userrating
philsstein rated yinsh:8 of 10
--------
ch查询bgg
并转储它找到的信息和"最高等级"，这需要一个公会id
，并转储公会成员的最高等级游戏和等级。
用法：
--------
$./bin/top-rated--help
用法：top-rated[-h][-g guild][-n number][-c cache][-f][-h htmlout]
[-w wikiout]
[-l{none，all，debug，info，warning，error，critical}]
Iven guild.
可选参数：
-h，--帮助显示此帮助消息并退出
-g guild，--guild guild
guild的ID。（bgg不支持按名称分类的guild
搜索。
-n number，--number
显示多少游戏。（默认值=100）
-c缓存，--cache缓存
缓存路径。如果先在缓存中给定查找，则从bgg获取。否则，始终从bgg.
集合中获取。如果给定--force fetch，则强制将
提取到缓存中。
-f，--forcefetch如果给定，则强制对任何数据进行重新提取。如果未给定缓存，则此参数不起任何作用。
-h htmlout，--htmlout htmlout
如果给定，则将数据的HTML表写入给定的
文件。
-w wikiout，--wikiout wikiout
if给定，将wiki格式的数据版本
写入给定文件。
-l{none，all，debug，info，warning，error，critical}，-log level{none，all，debug，info，warning，error，critical}
要记录的级别。必须是none、debug、
info、warning、error或critical之一。默认为无。
（这主要用于调试。）
$./bin/bgg_query--help
用法：bgg_query[-h][-g game][-g guild][-u user][-c collection]
[-c cache][-f]
[-l{none，all，debug，info，warning，error，critical}
向BGG查询棋盘游戏和相关信息。所有参数都可以指定
并多次指定。
（bgg不支持按名称分类的guild
搜索。
-u用户，--bgg用户的用户名。
-c集合，--collection集合
user的集合
-c缓存，--cache缓存
path缓存。如果先在缓存中给定查找，则从bgg获取。否则，始终从bgg.
集合中获取。如果给定--force fetch，则强制将
提取到缓存中。
-f，--forcefetch如果给定，则强制对任何数据进行重新提取。如果未给定缓存，则此参数
不起任何作用。
-l{none，all，debug，info，warning，error，critical}，--log level{none，all，debug，info，warning，error，critical}
要记录的级别。必须是none、debug、
info、warning、error或critical之一。默认值为"无"。
（这主要用于调试。）
脚本示例运行：
----
是的，BGG有一个"yinsh"用户。
$./bin/bgg_query——用户yinsh——收藏yinsh——游戏yinsh
yinsh的收藏有2款游戏：专卖版：豪华版（1995年）评分：5，拼字游戏（1948年）评分：6，
yinsh:
bggid:83873
国家：马来西亚
名字：yin
hot10:
姓氏：swee heng
名称：yinsh
前10名：
交易评级：0
注册年份：2006
yinsh:
艺术家：lu'cifer
bgid:7854
类别：抽象策略
设计师：kris burm
系列：mensa select，项目gipf
maxplayers:2
力学：网格运动，模式构建
minplayers:2
名称：yinsh
播放时间：30
发行商：don&co.，rio grande games，smart toys and games，inc.
年份：2003
aitlinsquared，distinctlybenign，jdclewis，magdalencox，schnubby，zetaceti名称：r/棋盘游戏
$./bin/b g g戋u query-g qwirkle-g notexists-g"pr戋t-porter"
qwirkle:
艺术家：b'
bgid:b'25669'
类别：b"抽象策略"
设计师：b'susan麦金利·罗斯家族：b'mensa select，qwirkle'
maxplayers:b'4'
mechanics:b'hand management，pattern building，tile placement'
minplayers:b'2'
名字：b'qwirkle，qwirkle\xc3\xa9附加航程，qwirkle travel，xed\x81\x90\xec\x9c\x84\xed\x81\xb4'
播放时间：B'45'
发行商：B'Mindware，999游戏，ADC Blackfire Entertainment，Compaya.hu-Gamer Caf\xc3\xa9 Kft.，Competo/Marektoy，Corfix，Cutia.ro.，xc3\x89面纱&Jeux，G3，绿板游戏公司，IELLO，Begint Media，Productief BV，Schmidt Spile'
年份：B'2006'
注xists:未找到。如果给定，则缓存中没有连接或不存在连接。
pr_t-porter:
艺术家：b'mariusz gandzel、tomasz jedruszek、micha\xc5\x82 oracz、darek zabrocki'
bgid:b'87890'
类别：b'economic、industry/manufacturing'
设计师：b'piotr haraszzak、ignacy trzewiczek'
系列：B'
maxplayers:B'4'
mechanics:B'card drafting，set collection，worker placement'
minplayers:B'2'
names:B'PR\xC3\xaat-\xC3\xa0 porter'
playingtime:B'90'
publishers:B'portal games'
year:B'2010'
G_cache-G 1291-N 15
获取公会"R/棋盘游戏"的成员信息
获取6个成员集合…….获取6个集合，总计1083个游戏和1062个等级。
计算等级…
公会R/棋盘游戏的等级：
==ted stddev名称
--------
1。10.00 1 0.00克梅特
2.10.00 1 0.00沙丘
3。10.00 10.00生存：逃离亚特兰蒂斯！
4。10.00 1 0.00银河卡车司机：周年纪念版
5.10.00 1 0.00雷克斯：帝国的最后日子
6。10.00 1 0.00磁盘世界：ankh morpork
7.10.00 10.00大津巴布韦
8.10.00 1 0.00忒修斯：暗轨道
10。9.50 1 0.00芝加哥快车
11.9.00 1 0.00荣耀罗马
12。9.00 1 0.00神秘地
13。9.00 1 0.00色卡
14.9.00 1 0.00汉莎·特顿尼卡
15.9.00 1 0.00 london
计算时间：2014年4月28日星期一17:45:22
使用来自6个公会成员的1062个评分。
version history
----
0.1.5-由于新服务器端更新而更新集合。服务器现在缓存信息。
0.1.4-减少内存占用。
0.1.2-垃圾箱/最高工程。添加了本地文件系统缓存。
0.1.1-添加了数据缓存
0.1.0-初始签入
欢迎加入QQ群-->： 979659372
