rocksky 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa6c83fa81b7bb244115d6b179b278f592dbbade9efdbcb5ec1d4b0f7e2d4b9c
-  data.tar.gz: 410f0dda9e50cdc5b60f39d84d3184cc740db1937672fa3f63417b77665e46a6
+  metadata.gz: 04a23ddf1b0b2c3207cb576fa5809509520ffe2caa5af6edd45c8e8d56f6a873
+  data.tar.gz: e3477fabe8cded03dadb16353781143f9c70722c7e38196154a4c01e47a54583
 SHA512:
-  metadata.gz: 0b0f47853567386514a64edd0beca2ea4c1ab0561f5834371c1756566e026681d0456876c7adacc3d6c1d957be83e3735e0ed5b1e9c9c940c1495851362075d8
-  data.tar.gz: 190f6cbdba923e62b13332f6a04f897c07dec5a5b8098ee7cfc4947b15088dd721deae25778ed9a3ea26b1a4bf3f1926c9891b6c81e5ddce367cc7761324f7a6
+  metadata.gz: 14b72030dbe0dd39f5b277af0729913f71739c89e62d57c89b46abb8bc23300f991bcb6e8b5ee485197886058d372c57e31a27d92b5fd53d3b2e2d644e50d859
+  data.tar.gz: 83c8ce3c29d4b90f2baa3f9111fe1207099bb89435aa142edbbbd3bef2a13af9ba19ec2d997b4544b72e2e972958ebe98f78083aff6a0d167d8756d76294c1b4

data/README.md

@@ -14,7 +14,7 @@ gem install rocksky
 Or in a Gemfile:
 
 ```ruby
-gem "rocksky", "~> 0.6"
+gem "rocksky", "~> 0.7"
 ```
 
 The gem is pure-Ruby; the native library is fetched from the GitHub release on

data/lib/rocksky/library.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: true
+
+module Rocksky
+  # Authenticated client for the app.rocksky.library.* API — the Subsonic /
+  # navidrome-compatible surface over a user's uploaded music. Every method
+  # requires auth, so a token is mandatory at construction (see Rocksky.library).
+  # Optional params are Ruby keyword args (nil = omitted); wire keys stay
+  # camelCase. Returns the parsed JSON payload.
+  class Library
+    def initialize(token, base: nil)
+      raise Error, "app.rocksky.library.* requires an access token" if token.nil? || token.to_s.empty?
+
+      @token = token.to_s
+      @base = base.to_s
+    end
+
+    # app.rocksky.library.ping
+    def ping()
+      query("app.rocksky.library.ping", {})
+    end
+
+    # app.rocksky.library.getLicense
+    def get_license()
+      query("app.rocksky.library.getLicense", {})
+    end
+
+    # app.rocksky.library.getMusicFolders
+    def get_music_folders()
+      query("app.rocksky.library.getMusicFolders", {})
+    end
+
+    # app.rocksky.library.getScanStatus
+    def get_scan_status()
+      query("app.rocksky.library.getScanStatus", {})
+    end
+
+    # app.rocksky.library.startScan
+    def start_scan()
+      query("app.rocksky.library.startScan", {})
+    end
+
+    # app.rocksky.library.getUser
+    def get_user()
+      query("app.rocksky.library.getUser", {})
+    end
+
+    # app.rocksky.library.getArtists
+    def get_artists()
+      query("app.rocksky.library.getArtists", {})
+    end
+
+    # app.rocksky.library.getIndexes
+    def get_indexes()
+      query("app.rocksky.library.getIndexes", {})
+    end
+
+    # app.rocksky.library.getArtist
+    def get_artist(id)
+      query("app.rocksky.library.getArtist", { id: id })
+    end
+
+    # app.rocksky.library.getArtistInfo
+    def get_artist_info(id)
+      query("app.rocksky.library.getArtistInfo", { id: id })
+    end
+
+    # app.rocksky.library.getAlbum
+    def get_album(id)
+      query("app.rocksky.library.getAlbum", { id: id })
+    end
+
+    # app.rocksky.library.getAlbumList
+    def get_album_list(type, size: nil, offset: nil, from_year: nil, to_year: nil, genre: nil)
+      query("app.rocksky.library.getAlbumList", { type: type, size: size, offset: offset, fromYear: from_year, toYear: to_year, genre: genre })
+    end
+
+    # app.rocksky.library.getAlbumInfo
+    def get_album_info(id)
+      query("app.rocksky.library.getAlbumInfo", { id: id })
+    end
+
+    # app.rocksky.library.getSong
+    def get_song(id)
+      query("app.rocksky.library.getSong", { id: id })
+    end
+
+    # app.rocksky.library.getRandomSongs
+    def get_random_songs(size: nil, genre: nil, from_year: nil, to_year: nil)
+      query("app.rocksky.library.getRandomSongs", { size: size, genre: genre, fromYear: from_year, toYear: to_year })
+    end
+
+    # app.rocksky.library.getSongsByGenre
+    def get_songs_by_genre(genre, count: nil, offset: nil)
+      query("app.rocksky.library.getSongsByGenre", { genre: genre, count: count, offset: offset })
+    end
+
+    # app.rocksky.library.getSimilarSongs
+    def get_similar_songs(id, count: nil)
+      query("app.rocksky.library.getSimilarSongs", { id: id, count: count })
+    end
+
+    # app.rocksky.library.getTopSongs
+    def get_top_songs(artist, count: nil)
+      query("app.rocksky.library.getTopSongs", { artist: artist, count: count })
+    end
+
+    # app.rocksky.library.getLyrics
+    def get_lyrics(artist: nil, title: nil)
+      query("app.rocksky.library.getLyrics", { artist: artist, title: title })
+    end
+
+    # app.rocksky.library.getMusicDirectory
+    def get_music_directory(id)
+      query("app.rocksky.library.getMusicDirectory", { id: id })
+    end
+
+    # app.rocksky.library.getGenres
+    def get_genres()
+      query("app.rocksky.library.getGenres", {})
+    end
+
+    # app.rocksky.library.search
+    def search(query, artist_count: nil, artist_offset: nil, album_count: nil, album_offset: nil, song_count: nil, song_offset: nil)
+      query("app.rocksky.library.search", { query: query, artistCount: artist_count, artistOffset: artist_offset, albumCount: album_count, albumOffset: album_offset, songCount: song_count, songOffset: song_offset })
+    end
+
+    # app.rocksky.library.getStarred
+    def get_starred()
+      query("app.rocksky.library.getStarred", {})
+    end
+
+    # app.rocksky.library.star
+    def star(id, album_id: nil, artist_id: nil)
+      procedure("app.rocksky.library.star", { id: id, albumId: album_id, artistId: artist_id })
+    end
+
+    # app.rocksky.library.unstar
+    def unstar(id, album_id: nil, artist_id: nil)
+      procedure("app.rocksky.library.unstar", { id: id, albumId: album_id, artistId: artist_id })
+    end
+
+    # app.rocksky.library.getPlaylists
+    def get_playlists()
+      query("app.rocksky.library.getPlaylists", {})
+    end
+
+    # app.rocksky.library.getPlaylist
+    def get_playlist(id)
+      query("app.rocksky.library.getPlaylist", { id: id })
+    end
+
+    # app.rocksky.library.createPlaylist
+    def create_playlist(name)
+      procedure("app.rocksky.library.createPlaylist", { name: name })
+    end
+
+    # app.rocksky.library.updatePlaylist
+    def update_playlist(playlist_id, name: nil, comment: nil, song_id_to_add: nil, song_index_to_remove: nil)
+      procedure("app.rocksky.library.updatePlaylist", { playlistId: playlist_id, name: name, comment: comment, songIdToAdd: song_id_to_add, songIndexToRemove: song_index_to_remove })
+    end
+
+    # app.rocksky.library.deletePlaylist
+    def delete_playlist(id)
+      procedure("app.rocksky.library.deletePlaylist", { id: id })
+    end
+
+    # app.rocksky.library.deleteSong
+    def delete_song(id)
+      procedure("app.rocksky.library.deleteSong", { id: id })
+    end
+
+    # app.rocksky.library.deleteAlbum
+    def delete_album(id)
+      procedure("app.rocksky.library.deleteAlbum", { id: id })
+    end
+
+    # app.rocksky.library.scrobble
+    def scrobble(id, time: nil, submission: nil)
+      procedure("app.rocksky.library.scrobble", { id: id, time: time, submission: submission })
+    end
+
+    # app.rocksky.library.updateNowPlaying
+    def update_now_playing(id)
+      procedure("app.rocksky.library.updateNowPlaying", { id: id })
+    end
+
+    # app.rocksky.library.getNowPlaying
+    def get_now_playing()
+      query("app.rocksky.library.getNowPlaying", {})
+    end
+
+    # app.rocksky.library.getPlayQueue
+    def get_play_queue()
+      query("app.rocksky.library.getPlayQueue", {})
+    end
+
+    # app.rocksky.library.savePlayQueue
+    def save_play_queue(id: nil, current: nil, position: nil)
+      procedure("app.rocksky.library.savePlayQueue", { id: id, current: current, position: position })
+    end
+
+    # app.rocksky.library.getStreamUrl
+    def get_stream_url(id, max_bit_rate: nil, format: nil)
+      query("app.rocksky.library.getStreamUrl", { id: id, maxBitRate: max_bit_rate, format: format })
+    end
+
+    # app.rocksky.library.getDownloadUrl
+    def get_download_url(id)
+      query("app.rocksky.library.getDownloadUrl", { id: id })
+    end
+
+    # app.rocksky.library.getCoverArtUrl
+    def get_cover_art_url(id, size: nil)
+      query("app.rocksky.library.getCoverArtUrl", { id: id, size: size })
+    end
+
+    # app.rocksky.library.getInternetRadioStations
+    def get_internet_radio_stations()
+      query("app.rocksky.library.getInternetRadioStations", {})
+    end
+
+    private
+
+    def query(nsid, params = {})
+      Rocksky.unwrap(C.rocksky_library_get(@base, @token, nsid, JSON.generate(params.compact)))
+    end
+
+    def procedure(nsid, body = {})
+      Rocksky.unwrap(C.rocksky_library_post(@base, @token, nsid, JSON.generate(body.compact)))
+    end
+  end
+end

data/lib/rocksky/manifest.json

@@ -1,12 +1,12 @@
 {
   "repo": "tsirysndr/rocksky",
-  "tag": "bindings-v0.3.0",
+  "tag": "bindings-v0.4.0",
   "checksums": {
-    "aarch64-apple-darwin": "645f343ba39bbcaa62ed38a56b8b9d88010d20e8e1f7488b691eab751f05d52d",
-    "aarch64-linux-gnu": "d8939244fa7fac3b56e83012fc30c87dc50b8531e21f860ab324159d38d5e78d",
-    "x86_64-apple-darwin": "9702077e8793c2a3c07c345e684c0918da04a44c71668c862fb516a75af61763",
-    "x86_64-linux-gnu": "964afa99734213465343daf3c5e5681be7c1a5a5d656a7030b5f2cc2b3bcea23",
-    "x86_64-unknown-freebsd": "e827e572d9d18eb9996607a9107bed4e28aaea0878f744b152bd3e6afec05bf4",
-    "x86_64-unknown-netbsd": "78744d465bbcbbe2f7fc61e36e554153d9a8334ac471e52f65c997c1beaeb455"
+    "aarch64-apple-darwin": "cd828960ba30880c121eca655a890625360c8b6f3d7d1e15ecbfeda9934c1496",
+    "aarch64-linux-gnu": "43d52700719ca325a7cc4bf24ae6e8eef8e71bdf532968bcc029f067e09e660f",
+    "x86_64-apple-darwin": "54749d2c37bd2f4f487a24b91ab935a6806f359e2bf8b52ec192d4421524aed0",
+    "x86_64-linux-gnu": "6750513f2a592637c436e28113aaa4e2cc2890829b337a3dcf999b40bbd7d924",
+    "x86_64-unknown-freebsd": "f1fa22d790c30dee2d4418e5a781338d4aeffbd334db48bc5d70bc94b88f23db",
+    "x86_64-unknown-netbsd": "4bb233727e965c45187cfa254206a25756c2c2fdc25e64df39f84f5d5eeb01d5"
   }
 }

data/lib/rocksky/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rocksky
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

data/lib/rocksky.rb

@@ -27,6 +27,8 @@ module Rocksky
       "char* rocksky_top_tracks(const char*, unsigned int, unsigned int)",
       "char* rocksky_global_stats(const char*)",
       "char* rocksky_get(const char*, const char*, const char*, const char*)",
+      "char* rocksky_library_get(const char*, const char*, const char*, const char*)",
+      "char* rocksky_library_post(const char*, const char*, const char*, const char*)",
       "char* rocksky_match_song(const char*, const char*, const char*, const char*, const char*)",
       "char* rocksky_top_tracks_interval(const char*, unsigned int, unsigned int, const char*, unsigned int, const char*, const char*)",
       "char* rocksky_top_artists_interval(const char*, unsigned int, unsigned int, const char*, unsigned int, const char*, const char*)",
@@ -210,4 +212,15 @@ module Rocksky
       @ptr = Fiddle::Pointer.new(0)
     end
   end
+
+  # Build an authenticated app.rocksky.library.* (uploaded-music) client. The
+  # token is required — every library method is auth-gated.
+  #
+  #   lib = Rocksky.library(token)
+  #   lib.get_song(song_id)
+  def self.library(token, base: nil)
+    Library.new(token, base: base)
+  end
 end
+
+require_relative "rocksky/library"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rocksky
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Rocksky
@@ -80,6 +80,7 @@ files:
 - README.md
 - exe/rocksky-console
 - lib/rocksky.rb
+- lib/rocksky/library.rb
 - lib/rocksky/manifest.json
 - lib/rocksky/native.rb
 - lib/rocksky/version.rb