nebulino / scrobblenaut

A deadly simple LastFM API Wrapper for Dart. So deadly simple that it's gonna hit the mark.

Scrobblenaut

Just a Last.FM API Wrapper for Dart. A package to interact with the official

Last.FM API.

Disclaimer

I'm doing it just for fun, so... use at your own risk.

I hope it will become something great.

^-^

Usage

First build the .g files for Serializable (if you clone the repo):

pub run build_runner build

A simple usage example:

import 'package:scrobblenaut/scrobblenaut.dart';

// A simple example...
// For more, check the example folder.
void main() async {
  final lastFMAuth = await LastFM.noAuth(apiKey: APIValues.API);
  final scrobblenaut = Scrobblenaut(lastFM: lastFMAuth);
  
  // Start using the Wrapper...
}

Get Scrobblenaut

Add Scrobblenaut dependency on pubspec.yaml:

From GitHub (for example: branch-name >> dev-build):

dependencies:
  scrobblenaut:
    git: https://github.com/Nebulino/Scrobblenaut.git
      ref: branch-name

From pub.dev:

dependencies:
  scrobblenaut: ^version-number

Features and bugs

Status

All the methods are available. Needs more time to check for problems caused by a bad information management from the API side. For example:

• Tracks duration information taken from an album like method is different from a Track duration taken from a track info query.

• Some variables can have strange content such as FIXME on some Track duration.

• Many more. For now with my tests, this is the best I can handle. I just need more track and usage of my package to track different type of errors that can occurs.

Future of the package after all methods implemented

It's still a long way. I have some ideas, and I'm going to continue to support it, just stay tuned.

For the documentation

For now, You have to download the repo and run dartdoc on the console, on the root of the package. When I upload this package on pub.dev you can use the documentation from there directly.

There's 2 type of usage:

• with authentication;
• without authentication.

Please file feature requests and bugs at the issue tracker.

Copyright © 2020 Nebulino

scrobblenaut's Issues

Change XML dependency?

For avoiding conflicts.

Scrobblenaut uses ^4.1.0

Main Conflicts:

• Flutter Stable: (xml ^2.6.1)

For now use Flutter Master.

Manage empty response.

When all input are filled but still LastFM wants to whine... and a {} is returned.
For example:

scrobblenaut.track.getTags(track: 'Tomoyo', artist: 'RADWIMPS', user: 'nebulino');

RADWIMPS hasn't created any songs with that name.

Managing Wiki with HTML tags.

Remove escaping on HTML entities on Wiki content and/or summary?

Publish the null-safety vesion.

is it possible to play a track?

Creating finally a tests file?

Some documentation needs to be checked.

Problem with Artist in user.recentTracks().

The name in Artist inside each tracks in user.recentTracks() is null.

Some dartdoc link are broken.

Check those methods:

• Album
• Artist
• Chart
• Geo
• Library
• Tag
• User