一个python api，可以访问英国排名前40的专辑和单张图表（打算在英国学校用作教学辅助）
pythontop40的Python项目详细描述
pythontop40
==
**pythontop40**图书馆设计用于英国学校，为学生提供访问英国前40名单曲和专辑的数据。
希望通过提供与学生相关信息的简单接口，他们将能够与数据联系起来，并想象出更多的方式，在他们的代码中消费和使用数据，希望**代码更进一步**。
**pythontop40**访问的数据是由
`@ben major<；https://twitter.com/benmajor88>；``和他的
《英国40强排行榜》api<；http://ben major.co.uk/2013/12/uk-top-40-charts-api/>；` ` `.
**python top 40**正在积极开发访问
《这篇博文》<；http://www.onebloke.com/2014/12/pythontop40-get-the-uk-top-40-albums-and-singles-from-python/>；`
了解更多信息。并根据"apache2许可证"lt；http://www.apache.org/licenses/license-2.0.html>；` `，
获得许可，请随意"贡献"<；https://bitbucket.org/dannygoodall/pythontop40/pull requests>；` ` ` `和
"报告错误和建议"<；https://bitbucket.org/dannygoodall/pythontop40/issues>；`.
…注：：
pythontop40**库设计用于英国学校，提供对
描述英国前40名单曲和专辑的数据的编程访问。希望通过提供简单的接口来访问学生可能感兴趣的
信息，可以激励他们**进一步编写代码**。
因此，本文档很可能针对教师和教育专业人员，可能对python没有深入的知识。警告：
**pythontop40**当前设计用于python版本3。我最近进行了一些工作，使它在python 2上运行，但这需要比我当前的nose测试允许的更彻底的测试。如果您
`遇到任何问题<；https://bitbucket.org/dannygoodall/pythontop40/issues>；``或者您希望'submit a pull
请求<；https://bitbucket.org/dannygoodall/pythontop40/pull requests>；``请在bitbucket上与我联系。
用法
----
**pythontop40**向开发人员公开一个非常简单的api。它是通过将：类：`~top40.top40`
类导入模块并创建此类的实例来访问的，例如：
from pythontop40 import top40
top40=top40（）
其中包括：
*：py:attr:`top40.albums<；top40.top40.albums>；`
*：py:attr:`top40.singles<；top40.top40.singles>；`
*：py:attr:`top40.albums&u chart<；top40.top40.albums>；`
*：py:attr:`top40.singles<；top40.top40.singles>；`
下面的示例代码显示如何使用这些属性之一获取当前前40个相册的列表。：
from pythontop40 import top40
albums=top40。相册中的相册：
print（
album.position，
album.title，
"by"，
album.artist
这个短程序使用：class:`~top40.top40.albums`类的：py:attr:`~top40.top40.albums`属性获取当前英国前40张专辑的python:class:`list'。然后循环遍历这个列表，在循环的每次迭代中，变量album都被设置为列表中的下一个album条目。
：py:class:`entry<；top40.entry>；`结果是这样的：：：
3四乘一方向
4在《孤独的一小时》中由萨姆·史密斯
5在《永无止境的河流》中由平克·弗洛伊德
。
。
。
。
40在伦敦的会议上由玛丽·布利格
我希望事情很清楚，但是，我们可以找到一个更详细的关于该程序在上做什么的讨论
:doc:`here<；moredetail>；`。
features
==
**pythontop40**提供了：
*使用
属性的：py:attr:`singles<；top40.top40.singles>；`：py:class:`~top40.top40`类。
*使用
:py:class:`~top40.top40.singles>；`属性的：py:attr:`albums<；top40.top40.singles>；`当前英国前40个唱片集的列表。
*a:py:class:`chart<；top40.chart>；`与单曲或唱片集相关的对象。
:py:class:`chart<；top40.chart>；`对象包含发布图表的：
*：py:attr:`~top40.chart.date`
*发布图表的日期：py:attr:`~top40.chart.retrieved`来自服务器的每个排名前40位的单曲或专辑
**pythontop40**也将缓存结果，这样一旦从
远程服务器检索到结果类型（单曲或专辑），它将在来自缓存的后续请求中返回，而不会从远程服务器刷新。
***默认情况下，pythontop40**将使用持久缓存。这应确保在数据不太可能频繁更改时，远程服务器不会受到请求的影响。缓存的默认持续时间为3600秒（1小时）。与内存缓存不同，持久缓存将在python解释器运行
会话结束后继续存在。可以通过向：py:class:`top40`
构造函数传递"cache\u duration"值来更改持续时间。对"cache-duration"使用"none"值将禁用持久缓存，并仅依赖于
内存缓存。
*可以使用：py:func:`~top40.top40.reset-cache`方法重置缓存，以便下一次请求
相册或单曲信息时通过连接到远程服务器来获取它。
installation
====
**pythontop40**可以在python包索引"pypi"中找到。<；https://pypi.python.org/pypi/pythontop40>；`\u
可以使用``pip``安装。用法：
pip install pythontop40
documentation
==
**pythontop40**的文档可以在
`readthedocs站点<；http://pythontop40.readthedocs.org/en/latest/index.html>上找到；`.
api-应用程序编程接口
======br/>===pythontop40**的类和函数的完整文档可以找到：doc:`here<；top40>；`，
错误和异常可以找到：doc:`here<；errors>；`.
测试
----
要运行**pythontop40**测试套件，您应该安装测试和开发需求，然后运行notests。
代码块：：bash
$pip install-r dev requirements.txt
$nosetests tests
更改
----
>请参阅：doc:`changes<；changes>；`。
==
**pythontop40**图书馆设计用于英国学校，为学生提供访问英国前40名单曲和专辑的数据。
希望通过提供与学生相关信息的简单接口，他们将能够与数据联系起来，并想象出更多的方式，在他们的代码中消费和使用数据，希望**代码更进一步**。
**pythontop40**访问的数据是由
`@ben major<；https://twitter.com/benmajor88>；``和他的
《英国40强排行榜》api<；http://ben major.co.uk/2013/12/uk-top-40-charts-api/>；` ` `.
**python top 40**正在积极开发访问
《这篇博文》<；http://www.onebloke.com/2014/12/pythontop40-get-the-uk-top-40-albums-and-singles-from-python/>；`
了解更多信息。并根据"apache2许可证"lt；http://www.apache.org/licenses/license-2.0.html>；` `，
获得许可，请随意"贡献"<；https://bitbucket.org/dannygoodall/pythontop40/pull requests>；` ` ` `和
"报告错误和建议"<；https://bitbucket.org/dannygoodall/pythontop40/issues>；`.
…注：：
pythontop40**库设计用于英国学校，提供对
描述英国前40名单曲和专辑的数据的编程访问。希望通过提供简单的接口来访问学生可能感兴趣的
信息，可以激励他们**进一步编写代码**。
因此，本文档很可能针对教师和教育专业人员，可能对python没有深入的知识。警告：
**pythontop40**当前设计用于python版本3。我最近进行了一些工作，使它在python 2上运行，但这需要比我当前的nose测试允许的更彻底的测试。如果您
`遇到任何问题<；https://bitbucket.org/dannygoodall/pythontop40/issues>；``或者您希望'submit a pull
请求<；https://bitbucket.org/dannygoodall/pythontop40/pull requests>；``请在bitbucket上与我联系。
用法
----
**pythontop40**向开发人员公开一个非常简单的api。它是通过将：类：`~top40.top40`
类导入模块并创建此类的实例来访问的，例如：
from pythontop40 import top40
top40=top40（）
其中包括：
*：py:attr:`top40.albums<；top40.top40.albums>；`
*：py:attr:`top40.singles<；top40.top40.singles>；`
*：py:attr:`top40.albums&u chart<；top40.top40.albums>；`
*：py:attr:`top40.singles<；top40.top40.singles>；`
下面的示例代码显示如何使用这些属性之一获取当前前40个相册的列表。：
from pythontop40 import top40
albums=top40。相册中的相册：
print（
album.position，
album.title，
"by"，
album.artist
这个短程序使用：class:`~top40.top40.albums`类的：py:attr:`~top40.top40.albums`属性获取当前英国前40张专辑的python:class:`list'。然后循环遍历这个列表，在循环的每次迭代中，变量album都被设置为列表中的下一个album条目。
：py:class:`entry<；top40.entry>；`结果是这样的：：：
3四乘一方向
4在《孤独的一小时》中由萨姆·史密斯
5在《永无止境的河流》中由平克·弗洛伊德
。
。
。
。
40在伦敦的会议上由玛丽·布利格
我希望事情很清楚，但是，我们可以找到一个更详细的关于该程序在上做什么的讨论
:doc:`here<；moredetail>；`。
features
==
**pythontop40**提供了：
*使用
属性的：py:attr:`singles<；top40.top40.singles>；`：py:class:`~top40.top40`类。
*使用
:py:class:`~top40.top40.singles>；`属性的：py:attr:`albums<；top40.top40.singles>；`当前英国前40个唱片集的列表。
*a:py:class:`chart<；top40.chart>；`与单曲或唱片集相关的对象。
:py:class:`chart<；top40.chart>；`对象包含发布图表的：
*：py:attr:`~top40.chart.date`
*发布图表的日期：py:attr:`~top40.chart.retrieved`来自服务器的每个排名前40位的单曲或专辑
**pythontop40**也将缓存结果，这样一旦从
远程服务器检索到结果类型（单曲或专辑），它将在来自缓存的后续请求中返回，而不会从远程服务器刷新。
***默认情况下，pythontop40**将使用持久缓存。这应确保在数据不太可能频繁更改时，远程服务器不会受到请求的影响。缓存的默认持续时间为3600秒（1小时）。与内存缓存不同，持久缓存将在python解释器运行
会话结束后继续存在。可以通过向：py:class:`top40`
构造函数传递"cache\u duration"值来更改持续时间。对"cache-duration"使用"none"值将禁用持久缓存，并仅依赖于
内存缓存。
*可以使用：py:func:`~top40.top40.reset-cache`方法重置缓存，以便下一次请求
相册或单曲信息时通过连接到远程服务器来获取它。
installation
====
**pythontop40**可以在python包索引"pypi"中找到。<；https://pypi.python.org/pypi/pythontop40>；`\u
可以使用``pip``安装。用法：
pip install pythontop40
documentation
==
**pythontop40**的文档可以在
`readthedocs站点<；http://pythontop40.readthedocs.org/en/latest/index.html>上找到；`.
api-应用程序编程接口
======br/>===pythontop40**的类和函数的完整文档可以找到：doc:`here<；top40>；`，
错误和异常可以找到：doc:`here<；errors>；`.
测试
----
要运行**pythontop40**测试套件，您应该安装测试和开发需求，然后运行notests。
代码块：：bash
$pip install-r dev requirements.txt
$nosetests tests
更改
----
>请参阅：doc:`changes<；changes>；`。
欢迎加入QQ群-->： 979659372
