A library for consuming the last.fm API. This library covers all services listed in last.fm API page.
The Swift Package Manager is a tool for managing the distribution of Swift code.
- Add the following to your
Package.swiftfile:
dependencies: [
.package(url: "https://github.com/duhnnie/LastFM.swift", from: "1.0.0")
]- Build your project:
$ swift buildCarthage is a simple, decentralized dependency manager for Cocoa. To install LastFM.swift with Carthage:
-
Make sure Carthage is installed.
-
Update your Cartfile to include the following:
github "duhnnie/LastFM.swift" ~> 1.0.0
-
Run
carthage updateand add the appropriate framework.
CocoaPods is a dependency manager for Cocoa projects. To install LastFM.swift with CocoaPods:
-
Make sure CocoaPods is installed.
# Using the default Ruby install will require you to use sudo when # installing and updating gems. [sudo] gem install cocoapods
-
Update your Podfile to include the following:
use_frameworks! target 'YourAppTargetName' do pod 'LastFM.swift', '~> 1.0.0' end
-
Run
pod install --repo-update.
You will need a last.fm API account, you can get one here. Once you have an API account, you will need to create a LastFM.swift instance providing the api key and api secret:
import LastFM
let lastFM = LastFM(apiKey: "your_api_key", apiSecret: "your_api_secret")After that, you'll be able to start consuming services (check here for info/docs about all available services):
let recentTrackParams = RecentTracksParams(user: "someUser", limit: 10, page: 1)
lastFM.User.getRecentTracks(params: recentTrackParams) { result in
switch (result) {
case .failure(let error):
print("error message: \(error.localizedDescription)")
switch(error) {
case .LastFMServiceError(let lastfmErrorType, let message):
print(lastfmErrorType, message)
case .NoData:
print("No data was returned.")
case .OtherError(let error):
print("An error ocurred: \(error)")
}
case .success(let obj):
for track in obj.items {
print("\(track.artist.name) - \(track.name) - \(track.nowPlaying ? "🔈" : track.date!.debugDescription)")
}
}
}Some services require authentication and this library provides all necessary methods for it (you can read about all authentication paths provided by last.fm here).
For example, for scrobbling a track to your last.fm profile, you need to provide the session key you get from any of the last.fm authentication paths, so last.fm knows which account the track should go to.
var scrobbleParams = ScrobbleParams()
scrobbleParams.addItem(
item: ScrobbleParamItem(
artist: "The Strokes",
track: "The Adults Are Talking",
date: Date(),
album: "The New Abnormal"
)
)
try lastFM.Track.scrobble(
params: scrobbleParams,
sessionKey: "your_session_key",
onCompletion: { result in
switch (result) {
case .success(let scrobble):
print(scrobble)
case .failure(let error):
print(error)
}
}
)LastFM.swift is supported by Linux. However running the tests results in a fatal error:
Fatal error: Constant strings cannot be deallocated
So that's why some test running in GitHub Actions. Anyway, you can run the tests in a local Docker container (it has a different Swift version) by running:
./runLinuxTests.sh
- Found a bug or have a feature request? Open an issue.
- Want to contribute? Submit a pull request.
LastFM.swift is available under the MIT license. See the LICENSE file for more information.