nexus_mods 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6490bd894c40f7806bb126cb70ade888ab5121499b86ff2cc959ee663dd223d
-  data.tar.gz: d9fdeb53c88c27ce9503e328a261ddb31a0facbbe0b6c35c304628c6e9580790
+  metadata.gz: 9fd9e01b4661eaa68f2a7fea3c52907b55f9bb7379f1e8f5423742f164784b95
+  data.tar.gz: 8a87ea1ba913a9f41303918a338649065eef99d5c3b8ec75b4fb4bbdbd782bcc
 SHA512:
-  metadata.gz: 7c8f9576edd38dab0076f24ad1d396973c9d1ab8542ff4eef548d9b49758f85b6da465465b10b1e53dbb2db6d8312f31e9b88649916f654e7b8c1a12092aaadb
-  data.tar.gz: 1b2d1e915594af39c9bd793a8f216fc2796024e2729a2b5596c35b546e04c8e2bb96dce77aa35e11f5d7a98fba1652c79f77f01648a363cfdf9b93ec40ee7602
+  metadata.gz: 382f42ee4d79d68ac34c6715fa3ad3f154a9376ff0b0b41b651804adaef512c681fa53a0d9112d1897757a8e77d3f8902bff468099fc78e48a97fc050f7d9bac
+  data.tar.gz: 6dd0631ddc2575c33da22390eeef859b3d01a1b805b566337add1eba2bb2fcd23925d250edde5b15d54a92cad5596125330645cff7f4a9eb13e3a2ef1be06f57

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [v1.1.1](https://github.com/Muriel-Salvan/nexus_mods/compare/v1.1.0...v1.1.1) (2023-04-10 19:39:28)
+
+### Patches
+
+* [Improved documentation and added examples](https://github.com/Muriel-Salvan/nexus_mods/commit/0eb3fd00e0d1ad34db04a30ab2043a49371dc64f)
+
 # [v1.1.0](https://github.com/Muriel-Salvan/nexus_mods/compare/v1.0.0...v1.1.0) (2023-04-10 19:19:16)
 
 ### Features

data/README.md

@@ -2,6 +2,17 @@
 
 Simple Ruby API letting you handle [NexusMods](https://www.nexusmods.com/) REST API.
 
+## Main features
+
+* Get the API **limits**.
+* Get the **games** information.
+* Get individual **mods** and **mod files** information.
+* Configurable **caching** with expiry times to save API calls to nexusmods.com.
+* All served in an object-oriented **API in full Ruby**.
+
+See the [examples](examples) for more details on how to use it.
+Those examples expect that you set a valid NexusMods API key in the `NEXUS_MODS_API_KEY` environment variable.
+
 ## Install
 
 Via gem
@@ -54,7 +65,7 @@ Any contribution is welcome:
 
 ## Credits
 
-- [Muriel Salvan][link-author]
+- [Muriel Salvan](https://x-aeon.com/muriel)
 
 ## License
 

data/examples/api_caching.rb

@@ -0,0 +1,41 @@
+require 'nexus_mods'
+require 'fileutils'
+
+# Make sure a previous file for caching was not here before
+test_api_cache_file = 'nexus_mods_test_api_cache.json'
+FileUtils.rm_f test_api_cache_file
+
+nexus_mods = NexusMods.new(
+  api_key: ENV.fetch('NEXUS_MODS_API_KEY'),
+  api_cache_file: test_api_cache_file
+)
+
+initial_remaining = nexus_mods.api_limits.daily_remaining
+puts "Before fetching anything, daily API remaining is #{initial_remaining}"
+
+puts 'Fetch the list of games (without using cache)...'
+puts "Fetched #{nexus_mods.games.size} games."
+
+puts "After fetching those games, daily API remaining is #{nexus_mods.api_limits.daily_remaining}"
+
+puts 'Now we fetch again the list of games (this should use the cache)...'
+puts "Fetched #{nexus_mods.games.size} games."
+
+puts "After fetching those games a second time, daily API remaining is #{nexus_mods.api_limits.daily_remaining}"
+
+puts 'Now we close the current NexusMods instance ad re-instantiate a new one from scratch using the same API cache file'
+
+new_nexus_mods = NexusMods.new(
+  api_key: ENV.fetch('NEXUS_MODS_API_KEY'),
+  api_cache_file: test_api_cache_file
+)
+
+puts "Before fetching anything from the new instance, daily API remaining is #{new_nexus_mods.api_limits.daily_remaining}"
+
+puts 'Now we fetch the list of games from the new instance (this should use the cache that was stored in the file)...'
+puts "Fetched #{new_nexus_mods.games.size} games."
+
+puts "After fetching those games from the new instance, daily API remaining is #{new_nexus_mods.api_limits.daily_remaining}"
+
+puts
+puts "As a conclusion, we used 2 instances of NexusMods that have fetched games 3 times, and it consumed #{initial_remaining - new_nexus_mods.api_limits.daily_remaining} real API call."

data/examples/api_limits.rb

@@ -0,0 +1,12 @@
+require 'nexus_mods'
+
+api_limits = NexusMods.new(api_key: ENV.fetch('NEXUS_MODS_API_KEY')).api_limits
+puts <<~EO_OUTPUT
+  API limits:
+    daily_limit: #{api_limits.daily_limit}
+    daily_remaining: #{api_limits.daily_remaining}
+    daily_reset: #{api_limits.daily_reset}
+    hourly_limit: #{api_limits.hourly_limit}
+    hourly_remaining: #{api_limits.hourly_remaining}
+    hourly_reset: #{api_limits.hourly_reset}
+EO_OUTPUT

data/examples/games.rb

@@ -0,0 +1,8 @@
+require 'nexus_mods'
+
+games = NexusMods.new(api_key: ENV.fetch('NEXUS_MODS_API_KEY')).games
+puts "Found a total of #{games.size} games."
+puts 'Here is the top 10 by number of downloads:'
+games.sort_by { |game| -game.downloads_count }[0..9].each do |game|
+  puts "* #{game.name} (#{game.mods_count} mods, #{game.downloads_count} downloads)"
+end

data/examples/log_debug.rb

@@ -0,0 +1,10 @@
+require 'nexus_mods'
+
+puts 'Example of fetching a mod with log debug activated, and without using the cache (so that we always see the query):'
+puts
+NexusMods.new(
+  api_key: ENV.fetch('NEXUS_MODS_API_KEY'),
+  log_level: :debug,
+  game_domain_name: 'skyrimspecialedition',
+  mod_id: 42_521
+).mod(clear_cache: true)

data/examples/mods.rb

@@ -0,0 +1,24 @@
+require 'nexus_mods'
+
+nexus_mods = NexusMods.new(
+  api_key: ENV.fetch('NEXUS_MODS_API_KEY'),
+  game_domain_name: 'skyrimspecialedition'
+)
+some_mod_ids = [
+  266,
+  2_347,
+  17_230,
+  42_521
+]
+puts 'Here are some details about a few mods for Skyrim Special Edition:'
+puts
+some_mod_ids.each do |mod_id|
+  mod = nexus_mods.mod(mod_id:)
+  mod_files = nexus_mods.mod_files(mod_id:)
+  puts <<~EO_OUTPUT
+    ===== #{mod.name} (v#{mod.version}) by #{mod.uploader.name} (#{mod.downloads_count} downloads)
+    #{mod.summary}
+    * Last 5 files: #{mod_files.reverse[0..4].map(&:file_name).join(', ')}
+
+  EO_OUTPUT
+end

data/lib/nexus_mods/version.rb

@@ -1,5 +1,5 @@
 class NexusMods
 
-  VERSION = '1.1.0'
+  VERSION = '1.1.1'
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nexus_mods
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Muriel Salvan
@@ -131,10 +131,20 @@ extra_rdoc_files:
 - CHANGELOG.md
 - LICENSE.md
 - README.md
+- examples/api_caching.rb
+- examples/api_limits.rb
+- examples/games.rb
+- examples/log_debug.rb
+- examples/mods.rb
 files:
 - CHANGELOG.md
 - LICENSE.md
 - README.md
+- examples/api_caching.rb
+- examples/api_limits.rb
+- examples/games.rb
+- examples/log_debug.rb
+- examples/mods.rb
 - lib/nexus_mods.rb
 - lib/nexus_mods/api/api_limits.rb
 - lib/nexus_mods/api/category.rb