Jikanrb

gem "jikanrb"

require "jikanrb"

# Get anime info using fluent API
anime = Jikanrb.anime(1).info
puts anime[:data][:title]  # => "Cowboy Bebop"

# Get full anime info (includes relations, theme songs, etc.)
anime = Jikanrb.anime(1).info(full: true)

# Search anime
results = Jikanrb.search_anime("Naruto")
results[:data].each do |anime|
  puts "#{anime[:title]} - Score: #{anime[:score]}"
end

client = Jikanrb::Client.new do |config|
  config.read_timeout = 15
  config.max_retries = 5
end

# Fluent API for resources
client.anime(1).info
client.manga(1).info
client.character(1).info
client.person(1).info

# Search and listings
client.search_anime("One Piece", type: "tv", status: "airing")
client.top_anime(type: "tv", filter: "bypopularity")
client.season(2024, "winter")
client.season_now
client.schedules(day: "monday")

client = Jikanrb::Client.new

# Basic and full info
client.anime(1).info                # GET /anime/1
client.anime(1).info(full: true)    # GET /anime/1/full

# Sub-resources
client.anime(1).characters          # Characters and voice actors
client.anime(1).staff               # Staff members
client.anime(1).episodes            # Episodes (first page)
client.anime(1).episodes(page: 2)   # Episodes (page 2)
client.anime(1).news                # News articles
client.anime(1).forum               # Forum topics
client.anime(1).videos              # PVs, episodes, music videos
client.anime(1).pictures            # Pictures
client.anime(1).statistics          # User statistics
client.anime(1).recommendations     # User recommendations
client.anime(1).relations           # Related anime/manga
client.anime(1).themes              # Opening/ending themes
client.anime(1).external            # External links
client.anime(1).streaming           # Streaming platform links

client.manga(1).info                # GET /manga/1
client.manga(1).info(full: true)    # GET /manga/1/full
client.manga(1).characters          # Characters
client.manga(1).news                # News articles
client.manga(1).forum               # Forum topics
client.manga(1).pictures            # Pictures
client.manga(1).statistics          # User statistics
client.manga(1).recommendations     # User recommendations
client.manga(1).relations           # Related anime/manga
client.manga(1).external            # External links

client.character(1).info            # GET /characters/1
client.character(1).info(full: true)# GET /characters/1/full
client.character(1).animes          # Anime appearances
client.character(1).mangas          # Manga appearances
client.character(1).voices          # Voice actors
client.character(1).pictures        # Pictures

client.person(1).info               # GET /people/1
client.person(1).info(full: true)   # GET /people/1/full
client.person(1).animes             # Anime staff positions
client.person(1).mangas             # Manga work
client.person(1).voices             # Voice acting roles
client.person(1).pictures           # Pictures

Jikanrb.configure do |config|
  config.base_url = "https://api.jikan.moe/v4"   # Default
  config.open_timeout = 5                        # Connection timeout (seconds)
  config.read_timeout = 10                       # Read timeout (seconds)
  config.max_retries = 3                         # Retry on rate limit/server errors
  config.retry_interval = 1                      # Initial retry delay (seconds)
  config.logger = Logger.new($stdout)            # Optional logging
end

Jikanrb.configure do |config|
  config.read_timeout = 20
  config.max_retries = 3
  config.logger = Rails.logger
end

begin
  anime = Jikanrb.anime(999999999).info
rescue Jikanrb::NotFoundError => e
  puts "Anime not found: #{e.message}"
rescue Jikanrb::RateLimitError => e
  puts "Rate limited! Retry after #{e.retry_after} seconds"
rescue Jikanrb::ConnectionError => e
  puts "Connection failed: #{e.message}"
rescue Jikanrb::Error => e
  puts "Something went wrong: #{e.message}"
end

client = Jikanrb::Client.new

# Automatic pagination - iterates through all pages
paginator = client.paginate(:top_anime, type: "tv")

# Get all items (will fetch all pages)
all_anime = paginator.all

# Iterate through all pages lazily
paginator.each do |anime|
  puts "#{anime["title"]} - Score: #{anime["score"]}"
end

# Get items from first 3 pages only
first_three_pages = paginator.take_pages(3)

# Manual pagination with pagination info
response = client.top_anime(page: 1)
pagination = client.pagination_info(response)

puts "Current page: #{pagination.current_page}"
puts "Total pages: #{pagination.total_pages}"
puts "Has next page: #{pagination.has_next_page?}"