jikanrb 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb528e6db6413f8aa74e076189001f63fd5bb1180e20a6b65341ea36dbb0f6e6
-  data.tar.gz: 03dc1aa0638e29902313138e0598df2e310b29c6814672fa490eb7bcde0269b3
+  metadata.gz: cf12793ef80ef81581dbad79ebe5d15266029db927c4e4ab5f741323b84f7d6f
+  data.tar.gz: 4c28905ede783f3047996a6c1bb0a74f88a8529b0d76d0658d546c9d89af6164
 SHA512:
-  metadata.gz: 531160fb13899e4a6499f7209a8371352e5473e24879ae7dae4d6643452af72b11725e9fdd33d18e65dc568569afe1f4f5d303b10df9abe6b9a7a74ccdef52d7
-  data.tar.gz: 40f0284cb2b8d2a1508f09ee30d28587219a9c7cfe2484a0a4d9e0c7b7f7ad21aed92140e9396a7d0875fc3ac5339aa23172534b3464976bb321ae0996d6cf24
+  metadata.gz: 1beb1a905b77c37a189dc6dfed33bd42923b412a9eef9aeeb81be74f484df4ed06626ad1209de68a5f92b2a150550c4cc2d234832ad372d616aed56faa8c08c5
+  data.tar.gz: e578ca35e574134812424ddb696ac2166e6ea216e7be343bcc5663ccbf10858b56c8d8255f2fab830a250b34c2c57d61133ee14ab45b3231b520e657c07c71c4

data/CHANGELOG.md

@@ -1,5 +1,72 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-01-31
+
+### Added
+- **Fluent API** for accessing sub-resources with chainable methods
+- `BaseResource` class providing common functionality for all resources
+- `AnimeResource` with 14 sub-resource methods:
+  - `info(full: false)` - Basic/full anime details
+  - `characters` - Characters and voice actors
+  - `staff` - Staff members
+  - `episodes(page: nil)` - Episodes with pagination
+  - `news` - Related news articles
+  - `forum` - Forum topics
+  - `videos` - PVs, episodes, music videos
+  - `pictures` - Anime pictures
+  - `statistics` - User statistics
+  - `recommendations` - User recommendations
+  - `relations` - Related anime/manga
+  - `themes` - Opening/ending themes
+  - `external` - External links
+  - `streaming` - Streaming platform links
+- `MangaResource` with 9 sub-resource methods:
+  - `info(full: false)` - Basic/full manga details
+  - `characters` - Characters
+  - `news` - Related news articles
+  - `forum` - Forum topics
+  - `pictures` - Manga pictures
+  - `statistics` - User statistics
+  - `recommendations` - User recommendations
+  - `relations` - Related anime/manga
+  - `external` - External links
+- `CharacterResource` with 5 sub-resource methods:
+  - `info(full: false)` - Basic/full character details
+  - `animes` - Anime appearances
+  - `mangas` - Manga appearances
+  - `voices` - Voice actors
+  - `pictures` - Character pictures
+- `PersonResource` with 5 sub-resource methods:
+  - `info(full: false)` - Basic/full person details
+  - `animes` - Anime staff positions
+  - `mangas` - Manga work
+  - `voices` - Voice acting roles
+  - `pictures` - Person pictures
+
+### Changed
+- `Client#anime(id)` now returns `AnimeResource` instead of `Hash`
+- `Client#manga(id)` now returns `MangaResource` instead of `Hash`
+- `Client#character(id)` now returns `CharacterResource` instead of `Hash`
+- `Client#person(id)` now returns `PersonResource` instead of `Hash`
+
+### Breaking Changes
+- Removed `full:` parameter from `anime`, `manga`, `character`, and `person` methods
+- Use `.info` or `.info(full: true)` for the previous behavior:
+  ```ruby
+  # Before (v0.2.x)
+  client.anime(1)
+  client.anime(1, full: true)
+
+  # After (v0.3.0+)
+  client.anime(1).info
+  client.anime(1).info(full: true)
+  ```
+
+### Documentation
+- Complete YARD documentation for all resource classes
+- Updated README with fluent API examples
+- Added migration guide for breaking changes
+
 ## [0.2.1] - 2026-01-10
 
 ### Changed

data/README.md

@@ -1,7 +1,7 @@
 # Jikanrb
 
 [![Gem Version](https://badge.fury.io/rb/jikanrb.svg)](https://badge.fury.io/rb/jikanrb)
-[![CI](https://github.com/tuusuario/jikanrb/actions/workflows/main.yml/badge.svg)](https://github.com/tuusuario/jikanrb/actions)
+[![CI](https://github.com/sbrocos/jikanrb/actions/workflows/main.yml/badge.svg)](https://github.com/sbrocos/jikanrb/actions)
 
 A modern Ruby client for the [Jikan API v4](https://jikan.moe/) - the unofficial MyAnimeList API.
 
@@ -10,7 +10,7 @@ A modern Ruby client for the [Jikan API v4](https://jikan.moe/) - the unofficial
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'jikanrb'
+gem "jikanrb"
 ```
 
 And then execute:
@@ -30,17 +30,14 @@ gem install jikanrb
 ### Quick Start
 
 ```ruby
-require 'jikanrb'
+require "jikanrb"
 
-# Get anime by ID
-anime = Jikanrb.anime(1)
-
-# Access data using strings or symbols (Indifferent Access)
-puts anime["data"]["title"] # => "Cowboy Bebop"
-puts anime[:data][:title]   # => "Cowboy Bebop"
+# 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, full: true)
+anime = Jikanrb.anime(1).info(full: true)
 
 # Search anime
 results = Jikanrb.search_anime("Naruto")
@@ -57,11 +54,13 @@ client = Jikanrb::Client.new do |config|
   config.max_retries = 5
 end
 
-# All methods available
-client.anime(1)
-client.manga(1)
-client.character(1)
-client.person(1)
+# 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")
@@ -69,19 +68,75 @@ client.season_now
 client.schedules(day: "monday")
 ```
 
-### Configuration in Rails
+## Fluent API (v1.1.0+)
+
+Access sub-resources using the fluent interface for cleaner, chainable code.
 
-You can configure the gem globally in an initializer (e.g., `config/initializers/jikanrb.rb`):
+### Anime
 
 ```ruby
-# config/initializers/jikanrb.rb
-Jikanrb.configure do |config|
-  config.read_timeout = 20
-  config.max_retries = 3
-  # config.logger = Rails.logger # Use Rails logger
-end
+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
 ```
 
+### Manga
+
+```ruby
+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
+```
+
+### Characters
+
+```ruby
+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
+```
+
+### People
+
+```ruby
+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
+```
+
+## Configuration
+
 ### Global Configuration
 
 ```ruby
@@ -95,14 +150,33 @@ Jikanrb.configure do |config|
 end
 ```
 
-### Available Methods
+### Rails Configuration
+
+Create an initializer (e.g., `config/initializers/jikanrb.rb`):
+
+```ruby
+Jikanrb.configure do |config|
+  config.read_timeout = 20
+  config.max_retries = 3
+  config.logger = Rails.logger
+end
+```
+
+## Available Methods
+
+### Resource Methods (Fluent API)
+
+| Method | Returns | Description |
+| :--- | :--- | :--- |
+| `anime(id)` | `AnimeResource` | Anime resource for sub-resource access |
+| `manga(id)` | `MangaResource` | Manga resource for sub-resource access |
+| `character(id)` | `CharacterResource` | Character resource for sub-resource access |
+| `person(id)` | `PersonResource` | Person resource for sub-resource access |
+
+### Direct Methods
 
 | Method | Description |
 | :--- | :--- |
-| `anime(id, full: false)` | Get anime by MAL ID |
-| `manga(id, full: false)` | Get manga by MAL ID |
-| `character(id, full: false)` | Get character by MAL ID |
-| `person(id, full: false)` | Get person by MAL ID |
 | `search_anime(query, **params)` | Search anime |
 | `search_manga(query, **params)` | Search manga |
 | `top_anime(type:, filter:, page:)` | Top anime list |
@@ -111,11 +185,11 @@ end
 | `season_now(page:)` | Current season anime |
 | `schedules(day:)` | Weekly schedule |
 
-### Error Handling
+## Error Handling
 
 ```ruby
 begin
-  anime = Jikanrb.anime(999999999)
+  anime = Jikanrb.anime(999999999).info
 rescue Jikanrb::NotFoundError => e
   puts "Anime not found: #{e.message}"
 rescue Jikanrb::RateLimitError => e
@@ -127,21 +201,22 @@ rescue Jikanrb::Error => e
 end
 ```
 
-### Pagination
+## Pagination
 
 The gem provides convenient pagination helpers for working with paginated endpoints:
 
 ```ruby
-# Automatic pagination - iterates through all pages
 client = Jikanrb::Client.new
-paginator = client.paginate(:top_anime, type: 'tv')
+
+# 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']}"
+  puts "#{anime["title"]} - Score: #{anime["score"]}"
 end
 
 # Get items from first 3 pages only
@@ -153,24 +228,15 @@ pagination = client.pagination_info(response)
 
 puts "Current page: #{pagination.current_page}"
 puts "Total pages: #{pagination.total_pages}"
-puts "Items per page: #{pagination.per_page}"
 puts "Has next page: #{pagination.has_next_page?}"
-puts "Has previous page: #{pagination.has_previous_page?}"
-puts "Next page number: #{pagination.next_page}" if pagination.has_next_page?
 ```
 
-### Rate Limiting
+## Rate Limiting
 
 Jikan API allows **60 requests per minute**. This gem includes automatic retry with exponential backoff for rate limit errors (429).
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-### Useful Commands
-
 ```bash
 # Install dependencies
 bin/setup
@@ -178,11 +244,14 @@ bin/setup
 # Run tests
 bundle exec rspec
 
+# Run linter
+bundle exec rubocop
+
 # Interactive console
 bin/console
 
-# Linting
-bundle exec rubocop
+# Generate documentation
+bundle exec yard doc
 ```
 
 ## Acknowledgments
@@ -191,12 +260,8 @@ This gem is inspired by [jikan.rb](https://github.com/Zerocchi/jikan.rb) by Zero
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at <https://github.com/[USERNAME]/jikanrb>. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/jikanrb/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/sbrocos/jikanrb.
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the Jikanrb project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/jikanrb/blob/main/CODE_OF_CONDUCT.md).

data/lib/jikanrb/client.rb

@@ -47,44 +47,88 @@ module Jikanrb
       request(:get, path, params)
     end
 
-    # Anime information by ID
+    # Returns an AnimeResource for fluent API access to anime sub-resources
     #
     # @param id [Integer] Anime ID on MyAnimeList
-    # @param full [Boolean] If true, returns extended information
-    # @return [Hash] Anime data
-    def anime(id, full: false)
-      path = full ? "/anime/#{id}/full" : "/anime/#{id}"
-      get(path)
+    # @return [Resources::AnimeResource] Anime resource for chaining
+    #
+    # @example Get anime info
+    #   client.anime(1).info
+    #   # => { data: { mal_id: 1, title: "Cowboy Bebop", ... } }
+    #
+    # @example Get full anime info
+    #   client.anime(1).info(full: true)
+    #
+    # @example Get anime characters
+    #   client.anime(1).characters
+    #
+    # @example Get anime episodes
+    #   client.anime(1).episodes
+    def anime(id)
+      Resources::AnimeResource.new(self, id)
     end
 
-    # Manga information by ID
+    # Returns a MangaResource for fluent API access to manga sub-resources
     #
     # @param id [Integer] Manga ID on MyAnimeList
-    # @param full [Boolean] If true, returns extended information
-    # @return [Hash] Manga data
-    def manga(id, full: false)
-      path = full ? "/manga/#{id}/full" : "/manga/#{id}"
-      get(path)
+    # @return [Resources::MangaResource] Manga resource for chaining
+    #
+    # @example Get manga info
+    #   client.manga(1).info
+    #   # => { data: { mal_id: 1, title: "Monster", ... } }
+    #
+    # @example Get full manga info
+    #   client.manga(1).info(full: true)
+    #
+    # @example Get manga characters
+    #   client.manga(1).characters
+    #
+    # @example Get manga statistics
+    #   client.manga(1).statistics
+    def manga(id)
+      Resources::MangaResource.new(self, id)
     end
 
-    # Character information by ID
+    # Returns a CharacterResource for fluent API access to character sub-resources
     #
     # @param id [Integer] Character ID on MyAnimeList
-    # @param full [Boolean] If true, returns extended information
-    # @return [Hash] Character data
-    def character(id, full: false)
-      path = full ? "/characters/#{id}/full" : "/characters/#{id}"
-      get(path)
+    # @return [Resources::CharacterResource] Character resource for chaining
+    #
+    # @example Get character info
+    #   client.character(1).info
+    #   # => { data: { mal_id: 1, name: "Spike Spiegel", ... } }
+    #
+    # @example Get full character info
+    #   client.character(1).info(full: true)
+    #
+    # @example Get character's anime appearances
+    #   client.character(1).animes
+    #
+    # @example Get character's voice actors
+    #   client.character(1).voices
+    def character(id)
+      Resources::CharacterResource.new(self, id)
     end
 
-    # Person information by ID
+    # Returns a PersonResource for fluent API access to person sub-resources
     #
     # @param id [Integer] Person ID on MyAnimeList
-    # @param full [Boolean] If true, returns extended information
-    # @return [Hash] Person data
-    def person(id, full: false)
-      path = full ? "/people/#{id}/full" : "/people/#{id}"
-      get(path)
+    # @return [Resources::PersonResource] Person resource for chaining
+    #
+    # @example Get person info
+    #   client.person(1).info
+    #   # => { data: { mal_id: 1, name: "Tomokazu Seki", ... } }
+    #
+    # @example Get full person info
+    #   client.person(1).info(full: true)
+    #
+    # @example Get person's anime staff positions
+    #   client.person(1).animes
+    #
+    # @example Get person's voice acting roles
+    #   client.person(1).voices
+    def person(id)
+      Resources::PersonResource.new(self, id)
     end
 
     # Search anime
@@ -93,7 +137,7 @@ module Jikanrb
     # @param params [Hash] Additional filters (type, score, status, etc.)
     # @return [Hash] Search results
     def search_anime(query, **params)
-      get('/anime', params.merge(q: query))
+      get('anime', params.merge(q: query))
     end
 
     # Search manga
@@ -102,7 +146,7 @@ module Jikanrb
     # @param params [Hash] Additional filters
     # @return [Hash] Search results
     def search_manga(query, **params)
-      get('/manga', params.merge(q: query))
+      get('manga', params.merge(q: query))
     end
 
     # Top anime
@@ -115,7 +159,7 @@ module Jikanrb
       params = { page: page }
       params[:type] = type if type
       params[:filter] = filter if filter
-      get('/top/anime', params)
+      get('top/anime', params)
     end
 
     # Top manga
@@ -128,7 +172,7 @@ module Jikanrb
       params = { page: page }
       params[:type] = type if type
       params[:filter] = filter if filter
-      get('/top/manga', params)
+      get('top/manga', params)
     end
 
     # Seasonal anime
@@ -138,7 +182,7 @@ module Jikanrb
     # @param page [Integer] Page number
     # @return [Hash] Seasonal anime
     def season(year, season, page: 1)
-      get("/seasons/#{year}/#{season}", page: page)
+      get("seasons/#{year}/#{season}", page: page)
     end
 
     # Current season
@@ -146,7 +190,7 @@ module Jikanrb
     # @param page [Integer] Page number
     # @return [Hash] Current season anime
     def season_now(page: 1)
-      get('/seasons/now', page: page)
+      get('seasons/now', page: page)
     end
 
     # Weekly schedule
@@ -154,7 +198,7 @@ module Jikanrb
     # @param day [String, nil] Day: "monday", "tuesday", etc.
     # @return [Hash] Anime schedule
     def schedules(day: nil)
-      path = day ? "/schedules/#{day}" : '/schedules'
+      path = day ? "schedules/#{day}" : 'schedules'
       get(path)
     end
 

data/lib/jikanrb/resources/anime_resource.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+module Jikanrb
+  module Resources
+    # Resource class for accessing Anime sub-resources from the Jikan API.
+    # Provides fluent API access to anime details, characters, staff, episodes,
+    # news, forum topics, videos, pictures, statistics, and more.
+    #
+    # @example Basic usage
+    #   client = Jikanrb::Client.new
+    #   anime = client.anime(1)
+    #   anime.info                   # GET /anime/1
+    #   anime.info(full: true)       # GET /anime/1/full
+    #   anime.characters             # GET /anime/1/characters
+    #   anime.episodes               # GET /anime/1/episodes
+    #
+    # @see https://docs.api.jikan.moe/#tag/anime
+    class AnimeResource < BaseResource
+      # Returns anime details
+      #
+      # @param full [Boolean] If true, returns extended information including
+      #   relations, themes, external links, and streaming links
+      # @return [Hash] Anime data as IndifferentHash
+      #
+      # @example Get basic info
+      #   client.anime(1).info
+      #   # => { data: { mal_id: 1, title: "Cowboy Bebop", ... } }
+      #
+      # @example Get full info
+      #   client.anime(1).info(full: true)
+      #   # => { data: { mal_id: 1, title: "...", relations: [...], themes: {...} } }
+      def info(full: false)
+        path = full ? "anime/#{@id}/full" : "anime/#{@id}"
+        get(path)
+      end
+
+      # Returns characters and their voice actors for this anime
+      #
+      # @return [Hash] List of characters as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).characters
+      #   # => { data: [{ character: { mal_id: 1, name: "Spike Spiegel" }, role: "Main", voice_actors: [...] }, ...] }
+      def characters
+        get("anime/#{@id}/characters")
+      end
+
+      # Returns staff members for this anime
+      #
+      # @return [Hash] List of staff as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).staff
+      #   # => { data: [{ person: { mal_id: 1, name: "..." }, positions: ["Director"] }, ...] }
+      def staff
+        get("anime/#{@id}/staff")
+      end
+
+      # Returns episodes for this anime
+      #
+      # @param page [Integer, nil] Page number for pagination
+      # @return [Hash] List of episodes as IndifferentHash
+      #
+      # @example Get first page of episodes
+      #   client.anime(1).episodes
+      #   # => { data: [{ mal_id: 1, title: "Asteroid Blues", ... }, ...], pagination: { ... } }
+      #
+      # @example Get specific page
+      #   client.anime(1).episodes(page: 2)
+      def episodes(page: nil)
+        get("anime/#{@id}/episodes", { page: page }.compact)
+      end
+
+      # Returns news articles related to this anime
+      #
+      # @return [Hash] List of news articles as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).news
+      #   # => { data: [{ mal_id: 1, title: "...", date: "...", author_username: "..." }, ...] }
+      def news
+        get("anime/#{@id}/news")
+      end
+
+      # Returns forum topics related to this anime
+      #
+      # @return [Hash] List of forum topics as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).forum
+      #   # => { data: [{ mal_id: 1, title: "...", date: "...", author_username: "..." }, ...] }
+      def forum
+        get("anime/#{@id}/forum")
+      end
+
+      # Returns videos (PVs, episodes, music videos) for this anime
+      #
+      # @return [Hash] Video data as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).videos
+      #   # => { data: { promo: [...], episodes: [...], music_videos: [...] } }
+      def videos
+        get("anime/#{@id}/videos")
+      end
+
+      # Returns pictures of this anime
+      #
+      # @return [Hash] List of pictures as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).pictures
+      #   # => { data: [{ jpg: { image_url: "https://..." }, webp: { ... } }, ...] }
+      def pictures
+        get("anime/#{@id}/pictures")
+      end
+
+      # Returns statistics for this anime
+      #
+      # @return [Hash] Statistics data as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).statistics
+      #   # => { data: { watching: 12345, completed: 67890, on_hold: 1234, ... } }
+      def statistics
+        get("anime/#{@id}/statistics")
+      end
+
+      # Returns user recommendations for this anime
+      #
+      # @return [Hash] List of recommendations as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).recommendations
+      #   # => { data: [{ entry: { mal_id: 5, title: "..." }, votes: 123 }, ...] }
+      def recommendations
+        get("anime/#{@id}/recommendations")
+      end
+
+      # Returns related anime/manga entries
+      #
+      # @return [Hash] List of relations as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).relations
+      #   # => { data: [{ relation: "Adaptation", entry: [{ mal_id: 173, type: "manga", name: "..." }] }, ...] }
+      def relations
+        get("anime/#{@id}/relations")
+      end
+
+      # Returns opening and ending themes for this anime
+      #
+      # @return [Hash] Theme songs as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).themes
+      #   # => { data: { openings: ["Tank! by The Seatbelts"], endings: ["The Real Folk Blues by ..."] } }
+      def themes
+        get("anime/#{@id}/themes")
+      end
+
+      # Returns external links for this anime
+      #
+      # @return [Hash] List of external links as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).external
+      #   # => { data: [{ name: "Official Site", url: "https://..." }, ...] }
+      def external
+        get("anime/#{@id}/external")
+      end
+
+      # Returns streaming links for this anime
+      #
+      # @return [Hash] List of streaming platforms as IndifferentHash
+      #
+      # @example
+      #   client.anime(1).streaming
+      #   # => { data: [{ name: "Crunchyroll", url: "https://..." }, ...] }
+      def streaming
+        get("anime/#{@id}/streaming")
+      end
+    end
+  end
+end

data/lib/jikanrb/resources/base_resource.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Jikanrb
+  module Resources
+    # Base class for all resource classes.
+    # Provides common functionality for accessing sub-resources from the Jikan API.
+    #
+    # @abstract Subclass and implement specific resource methods
+    #
+    # @example Creating a custom resource
+    #   class AnimeResource < BaseResource
+    #     def characters
+    #       get("anime/#{@id}/characters")
+    #     end
+    #   end
+    class BaseResource
+      # @return [Integer] The resource ID
+      attr_reader :id
+
+      # Creates a new resource instance
+      #
+      # @param client [Jikanrb::Client] The client instance to use for requests
+      # @param id [Integer] The resource ID on MyAnimeList
+      def initialize(client, id)
+        @client = client
+        @id = id
+      end
+
+      private
+
+      # Performs a GET request through the client
+      #
+      # @param path [String] The API endpoint path
+      # @param params [Hash] Optional query parameters
+      # @return [Hash] The API response as an IndifferentHash
+      def get(path, params = {})
+        @client.send(:request, :get, path, params)
+      end
+    end
+  end
+end

data/lib/jikanrb/resources/character_resource.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Jikanrb
+  module Resources
+    # Resource class for accessing Character sub-resources from the Jikan API.
+    # Provides fluent API access to character details, anime appearances,
+    # manga appearances, voice actors, and pictures.
+    #
+    # @example Basic usage
+    #   client = Jikanrb::Client.new
+    #   character = client.character(1)
+    #   character.info                  # GET /characters/1
+    #   character.info(full: true)      # GET /characters/1/full
+    #   character.anime                 # GET /characters/1/anime
+    #   character.voices                # GET /characters/1/voices
+    #
+    # @see https://docs.api.jikan.moe/#tag/characters
+    class CharacterResource < BaseResource
+      # Returns character details
+      #
+      # @param full [Boolean] If true, returns extended information including
+      #   anime appearances, manga appearances, and voice actors
+      # @return [Hash] Character data as IndifferentHash
+      #
+      # @example Get basic info
+      #   client.character(1).info
+      #   # => { data: { mal_id: 1, name: "Spike Spiegel", ... } }
+      #
+      # @example Get full info
+      #   client.character(1).info(full: true)
+      #   # => { data: { mal_id: 1, name: "...", anime: [...], voices: [...] } }
+      def info(full: false)
+        path = full ? "characters/#{@id}/full" : "characters/#{@id}"
+        get(path)
+      end
+
+      # Returns anime appearances for this character
+      #
+      # @return [Hash] List of anime appearances as IndifferentHash
+      #
+      # @example
+      #   client.character(1).anime
+      #   # => { data: [{ role: "Main", anime: { mal_id: 1, title: "..." } }, ...] }
+      def animes
+        get("characters/#{@id}/anime")
+      end
+
+      # Returns manga appearances for this character
+      #
+      # @return [Hash] List of manga appearances as IndifferentHash
+      #
+      # @example
+      #   client.character(1).manga
+      #   # => { data: [{ role: "Main", manga: { mal_id: 1, title: "..." } }, ...] }
+      def mangas
+        get("characters/#{@id}/manga")
+      end
+
+      # Returns voice actors for this character
+      #
+      # @return [Hash] List of voice actors as IndifferentHash
+      #
+      # @example
+      #   client.character(1).voices
+      #   # => { data: [{ language: "Japanese", person: { mal_id: 11, name: "..." } }, ...] }
+      def voices
+        get("characters/#{@id}/voices")
+      end
+
+      # Returns pictures of this character
+      #
+      # @return [Hash] List of pictures as IndifferentHash
+      #
+      # @example
+      #   client.character(1).pictures
+      #   # => { data: [{ jpg: { image_url: "https://..." } }, ...] }
+      def pictures
+        get("characters/#{@id}/pictures")
+      end
+    end
+  end
+end

data/lib/jikanrb/resources/manga_resource.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module Jikanrb
+  module Resources
+    # Resource class for accessing Manga sub-resources from the Jikan API.
+    # Provides fluent API access to manga details, characters, news,
+    # forum topics, pictures, statistics, and more.
+    #
+    # @example Basic usage
+    #   client = Jikanrb::Client.new
+    #   manga = client.manga(1)
+    #   manga.info                   # GET /manga/1
+    #   manga.info(full: true)       # GET /manga/1/full
+    #   manga.characters             # GET /manga/1/characters
+    #
+    # @see https://docs.api.jikan.moe/#tag/manga
+    class MangaResource < BaseResource
+      # Returns manga details
+      #
+      # @param full [Boolean] If true, returns extended information including
+      #   relations, external links, etc.
+      # @return [Hash] Manga data as IndifferentHash
+      #
+      # @example Get basic info
+      #   client.manga(1).info
+      #   # => { data: { mal_id: 1, title: "Monster", ... } }
+      #
+      # @example Get full info
+      #   client.manga(1).info(full: true)
+      #   # => { data: { mal_id: 1, title: "...", relations: [...], external: [...] } }
+      def info(full: false)
+        path = full ? "manga/#{@id}/full" : "manga/#{@id}"
+        get(path)
+      end
+
+      # Returns characters for this manga
+      #
+      # @return [Hash] List of characters as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).characters
+      #   # => { data: [{ character: { mal_id: 1, name: "Kenzou Tenma" }, role: "Main" }, ...] }
+      def characters
+        get("manga/#{@id}/characters")
+      end
+
+      # Returns news articles related to this manga
+      #
+      # @return [Hash] List of news articles as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).news
+      #   # => { data: [{ mal_id: 1, title: "...", date: "...", author_username: "..." }, ...] }
+      def news
+        get("manga/#{@id}/news")
+      end
+
+      # Returns forum topics related to this manga
+      #
+      # @return [Hash] List of forum topics as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).forum
+      #   # => { data: [{ mal_id: 1, title: "...", date: "...", author_username: "..." }, ...] }
+      def forum
+        get("manga/#{@id}/forum")
+      end
+
+      # Returns pictures of this manga
+      #
+      # @return [Hash] List of pictures as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).pictures
+      #   # => { data: [{ jpg: { image_url: "https://..." }, webp: { ... } }, ...] }
+      def pictures
+        get("manga/#{@id}/pictures")
+      end
+
+      # Returns statistics for this manga
+      #
+      # @return [Hash] Statistics data as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).statistics
+      #   # => { data: { reading: 12345, completed: 67890, on_hold: 1234, ... } }
+      def statistics
+        get("manga/#{@id}/statistics")
+      end
+
+      # Returns user recommendations for this manga
+      #
+      # @return [Hash] List of recommendations as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).recommendations
+      #   # => { data: [{ entry: { mal_id: 5, title: "..." }, votes: 123 }, ...] }
+      def recommendations
+        get("manga/#{@id}/recommendations")
+      end
+
+      # Returns related anime/manga entries
+      #
+      # @return [Hash] List of relations as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).relations
+      #   # => { data: [{ relation: "Adaptation", entry: [{ mal_id: 19, type: "anime", name: "..." }] }, ...] }
+      def relations
+        get("manga/#{@id}/relations")
+      end
+
+      # Returns external links for this manga
+      #
+      # @return [Hash] List of external links as IndifferentHash
+      #
+      # @example
+      #   client.manga(1).external
+      #   # => { data: [{ name: "Official Site", url: "https://..." }, ...] }
+      def external
+        get("manga/#{@id}/external")
+      end
+    end
+  end
+end

data/lib/jikanrb/resources/person_resource.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Jikanrb
+  module Resources
+    # Resource class for accessing Person sub-resources from the Jikan API.
+    # Provides fluent API access to person details, anime staff positions,
+    # manga work, voice acting roles, and pictures.
+    #
+    # @example Basic usage
+    #   client = Jikanrb::Client.new
+    #   person = client.person(1)
+    #   person.info                  # GET /people/1
+    #   person.info(full: true)      # GET /people/1/full
+    #   person.animes                # GET /people/1/anime
+    #   person.voices                # GET /people/1/voices
+    #
+    # @see https://docs.api.jikan.moe/#tag/people
+    class PersonResource < BaseResource
+      # Returns person details
+      #
+      # @param full [Boolean] If true, returns extended information including
+      #   anime, manga, and voice acting roles
+      # @return [Hash] Person data as IndifferentHash
+      #
+      # @example Get basic info
+      #   client.person(1).info
+      #   # => { data: { mal_id: 1, name: "Tomokazu Seki", ... } }
+      #
+      # @example Get full info
+      #   client.person(1).info(full: true)
+      #   # => { data: { mal_id: 1, name: "...", anime: [...], voices: [...] } }
+      def info(full: false)
+        path = full ? "people/#{@id}/full" : "people/#{@id}"
+        get(path)
+      end
+
+      # Returns anime staff positions for this person
+      #
+      # @return [Hash] List of anime staff positions as IndifferentHash
+      #
+      # @example
+      #   client.person(1).animes
+      #   # => { data: [{ position: "Director", anime: { mal_id: 1, title: "..." } }, ...] }
+      def animes
+        get("people/#{@id}/anime")
+      end
+
+      # Returns manga work positions for this person
+      #
+      # @return [Hash] List of manga work positions as IndifferentHash
+      #
+      # @example
+      #   client.person(1).mangas
+      #   # => { data: [{ position: "Story & Art", manga: { mal_id: 1, title: "..." } }, ...] }
+      def mangas
+        get("people/#{@id}/manga")
+      end
+
+      # Returns voice acting roles for this person
+      #
+      # @return [Hash] List of voice acting roles as IndifferentHash
+      #
+      # @example
+      #   client.person(1).voices
+      #   # => { data: [{ role: "Main", character: { ... }, anime: { ... } }, ...] }
+      def voices
+        get("people/#{@id}/voices")
+      end
+
+      # Returns pictures of this person
+      #
+      # @return [Hash] List of pictures as IndifferentHash
+      #
+      # @example
+      #   client.person(1).pictures
+      #   # => { data: [{ jpg: { image_url: "https://..." } }, ...] }
+      def pictures
+        get("people/#{@id}/pictures")
+      end
+    end
+  end
+end

data/lib/jikanrb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jikanrb
-  VERSION = '0.2.1'
+  VERSION = '0.3.0'
 end

data/lib/jikanrb.rb

@@ -7,6 +7,13 @@ require_relative 'jikanrb/pagination'
 require_relative 'jikanrb/client'
 require_relative 'jikanrb/utils'
 
+# Resources module - Fluent API for accessing sub-resources
+require_relative 'jikanrb/resources/base_resource'
+require_relative 'jikanrb/resources/anime_resource'
+require_relative 'jikanrb/resources/manga_resource'
+require_relative 'jikanrb/resources/character_resource'
+require_relative 'jikanrb/resources/person_resource'
+
 # Jikanrb is a modern Ruby wrapper for the Jikan REST API v4.
 # Provides easy access to anime, manga, characters, and more from MyAnimeList.
 #
@@ -69,23 +76,23 @@ module Jikanrb
     # Allows using Jikanrb.anime(1) directly
 
     # @see Client#anime
-    def anime(id, full: false)
-      client.anime(id, full: full)
+    def anime(id)
+      client.anime(id)
     end
 
     # @see Client#manga
-    def manga(id, full: false)
-      client.manga(id, full: full)
+    def manga(id)
+      client.manga(id)
     end
 
     # @see Client#character
-    def character(id, full: false)
-      client.character(id, full: full)
+    def character(id)
+      client.character(id)
     end
 
     # @see Client#person
-    def person(id, full: false)
-      client.person(id, full: full)
+    def person(id)
+      client.person(id)
     end
 
     # @see Client#search_anime

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jikanrb
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Sergio Brocos
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-10 00:00:00.000000000 Z
+date: 2026-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -58,7 +58,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".claude/settings.local.json"
 - ".ruby-version"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -70,6 +69,11 @@ files:
 - lib/jikanrb/configuration.rb
 - lib/jikanrb/errors.rb
 - lib/jikanrb/pagination.rb
+- lib/jikanrb/resources/anime_resource.rb
+- lib/jikanrb/resources/base_resource.rb
+- lib/jikanrb/resources/character_resource.rb
+- lib/jikanrb/resources/manga_resource.rb
+- lib/jikanrb/resources/person_resource.rb
 - lib/jikanrb/utils.rb
 - lib/jikanrb/version.rb
 - sig/jikanrb.rbs

data/.claude/settings.local.json

@@ -1,8 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(rubocop:*)",
-      "Bash(bundle exec rubocop:*)"
-    ]
-  }
-}