BillboardSwiftLibrary 0.1.4

BillboardSwiftLibrary 0.1.4

Fitzgerald Afful 维护。



BillboardSwiftLibrary

CI Status Version License Platform

基本用法

要下载 Billboard 排行榜首,我们使用 BillboardManager 构造函数。

让我们获取当前的热门 100 排行榜和特定日期的数据。

别忘了在您的 info.plist 中 App Transport Security Settings 下将 Allow Arbitrary Loads 设置为 YES

import BillboardSwiftLibrary

let manager = BillboardManager()
manager.getChart(chartType: ChartType.hot100) { (entries, error) in
	if error != nil{
		print(error!.localizedDescription)
		return
	}

	print(entries!) //Array of ChartEntry
}



//FOR A PARTICULAR DATE (always remember date is in the form YYYY-MM-DD)
manager.getChart(chartType: ChartType.hot100, date: "2018-11-18") { (entries, error) in
	if error != nil{
		print(error!.localizedDescription)
		return
	}

	print(entries!) //Array of ChartEntry
}



//FOR A PARTICULAR DATE (with individual date components)
manager.getChart(chartType: ChartType.hot100, day: 18, month: 11, year: 2018) { (entries, error) in
	if error != nil{
		print(error!.localizedDescription)
		return
	}

	print(entries!) //Array of ChartEntry
}

示例

要运行示例项目,请克隆仓库,然后首先从 Example 目录运行 pod install

系统要求

  • iOS 9.0+ / OSX 10.10+
  • Swift 4.0+

安装

Cocoa Pods

安装方法,只需将以下行添加到您的 Podfile

pod 'BillboardSwiftLibrary'

Swift Package Manager

在您的 Package.swift 中添加 BillboardSwiftLibrary

import PackageDescription

let package = Package(
dependencies: [
	package(url: "https://github.com/FitzAfful/BillboardSwiftLibrary.git", "0.1.2")
])

图表条目属性

图表条目(通常是单个轨迹)的类型为 ChartEntry。一个 ChartEntry 实例具有以下属性

  • title – 轨迹的标题。
  • artist – 艺术家的名字,如 Billboard.com 格式化。
  • peakPos – 轨迹在任何时间点的最高排名,包括未来日期,作为整数(如果没有包含此信息,则为 None)。
  • lastPos – 轨迹在上周排行榜上的位置,作为整数(如果没有包含此信息,则为 None)。如果轨迹在上周的排行榜上没有出现,则此值为 0。
  • weeks – 轨迹在排行榜上出现或曾出现的周数,包括未来日期(直到当前时间)。
  • rank – 轨迹在排行榜中的当前位置。
  • isNew – 轨迹是否为图表中新加入的。

贡献

欢迎提出拉取请求!

认为找到了一个错误吗?在这里创建一个问题 这里

基于 Allen Guo 开发的 Billboard.py

作者

Fitzafful, [email protected]

许可证

BillboardSwiftLibrary遵守MIT许可证。更多详情请参阅LICENSE文件。