nhentai-api 0.1.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34fc4c8aba56d86dec53095de372746d7b168a4997cf7cd47d135aa6de0f4098
-  data.tar.gz: d90796862bddb36ffe361a467d5727e3ae08c0d916075be304e9be13c62aa69c
+  metadata.gz: 32a8382ebb1c8c5d33c1ea5baa94070fc31c788e31c628c7708fa6b29d839d94
+  data.tar.gz: 1481e553fa7663d4898b07f60814413be9efb5ccd8c233bf84d0c08281edf934
 SHA512:
-  metadata.gz: 2b72edd65733a0b407414c272a481a319801c944afea09379975df1a1ba5e03d57d3147864f8f564fff125f6e21595aa451867072e13bb0184a03af98d9cb46f
-  data.tar.gz: 560fcbe879cccef3a63160077981c46659a3fb2fcae65579251c62f6661d03d28583e300a20acb8e3001173065c40557863a4548f7ad717708a936537bb33812
+  metadata.gz: 585e38f3cb7d7397158535f4bca3dd10fde1fb70bcf4ecddff39eaee1178a6f1cb50ad668897e838087265ab1d61e1617bddbdcede672d1f8de46fd6a5945a7c
+  data.tar.gz: a5246ab1e9eec631fed5a883822e9190bf004e88840b6cc9d3a13cb516371019a61c77a7808d04eaebd325ba5a23e823c930351f16f5063164cc8b963fd5c2e5

data/lib/nhentai-api.rb

@@ -1,6 +1,7 @@
 require 'net/http'
+require 'time'
 
-class Tag
+class Info
   attr_reader :id, :name, :count, :url
 
   def initialize(id, name, count, url)
@@ -17,172 +18,535 @@ class Doujinshi
   def initialize(id)
     @id           = id
     @client       = Net::HTTP.get_response(URI("https://nhentai.net/g/#{@id}/"))
-    @media_id     = @client.body.match(%r{\/([0-9]+)\/cover.jpg})[1]
-    @count_pages  = @client.body.match(/([0-9]+) pages/)[1].to_i
+    if self.exists?
+      @media_id     = @client.body.match(%r{\/([0-9]+)\/cover})[1]
+      @count_pages  = @client.body.match(/Pages:\s*.*>([0-9]+)</)[1].to_i
+    end
   end
 
+  #
+  # Check if a doujinshi with the given id exist
+  #
+  # @return [Bool] true if the doujinshi exist, otherwise false
+  # @since 0.1.0
+  # @example
+  #   doujinshi.exists?   #=> true
+  #
   def exists?
-    @client.code == 200
+    @client.code == '200'
   end
 
+  #
+  # Give the title of a doujinshi
+  #
+  # @return [String] the title of a given doujinshi
+  # @since 0.1.0
+  # @example
+  #   doujinshi.title   #=> '[Illumination. (Ogadenmon)] Android no Ecchi na Yatsu | Horny Androids (NieR:Automata) [English] =TLL + mrwayne= [Digital]'
+  #
   def title
-    @client.body.match(%r{<div id="info">\s+<h1>(.+)<\/h1>})[1]
+    @client.body.match(/"pretty">(.*?)</)[1]
   end
 
+  #
+  # Give the cover's URL of a doujinshi
+  #
+  # @return [String] the cover's URL of a given doujinshi
+  # @since 0.1.0
+  # @example
+  #   doujinshi.cover   #=> 'https://t.nhentai.net/galleries/1170172/cover.jpg'
+  #
   def cover
-    "https://t.nhentai.net/galleries/#{@media_id}/cover.jpg"
+    res = @client.body.match(%r{https://t.nhentai.net/galleries/#{@media_id}/cover\.(.{3})"})
+
+    "https://t.nhentai.net/galleries/#{@media_id}/cover.#{res[1]}"
   end
 
+  #
+  # Give the URL of a given page of a doujinshi
+  #
+  # @param [Integer] page a particular page of a doujinshi
+  # @return [String] the URL of a given page of a doujinshi
+  # @since 0.1.0
+  # @example
+  #   doujinshi.get_page        #=> 'https://i.nhentai.net/galleries/1170172/1.jpg'
+  #   doujinshi.get_page(10)    #=> 'https://i.nhentai.net/galleries/1170172/10.jpg'
+  #
   def page(page = 1)
     res = @client.body.match(%r{https://t.nhentai.net/galleries/#{@media_id}/#{page}t\.(.{3})"})
 
     "https://i.nhentai.net/galleries/#{@media_id}/#{page}.#{res[1]}"
   end
 
+  #
+  # Give the URL of a all pages of a doujinshi
+  #
+  # @return [Array] array pages' URL
+  # @since 0.1.0
+  # @example
+  #   doujinshi.pages   #=> ['https://i.nhentai.net/galleries/1170172/1.jpg', ..., 'https://i.nhentai.net/galleries/1170172/31.jpg']
+  #
   def pages
     (1..@count_pages).map { |page| page(page) }
   end
 
+  #
+  # Give the thumbnail's URL of a given page of a doujinshi
+  #
+  # @param [Integer] page a particular page of a doujinshi
+  # @return [String] the thumbnail's URL of a given page of a doujinshi
+  # @since 0.1.0
+  # @example
+  #   doujinshi.get_thumbnail       #=> 'https://t.nhentai.net/galleries/1170172/1t.jpg'
+  #   doujinshi.get_thumbnail(10)   #=> 'https://t.nhentai.net/galleries/1170172/10t.jpg'
+  #
   def thumbnail(page = 1)
     res = @client.body.match(%r{https://t.nhentai.net/galleries/#{@media_id}/(#{page}t\..{3})"})
 
     "https://t.nhentai.net/galleries/#{@media_id}/#{res[1]}"
   end
 
+  #
+  # Give the URL of a all thumbnails of a doujinshi
+  #
+  # @return [Array] an array thumbnails' URL
+  # @since 0.1.0
+  # @example
+  #   doujinshi.thumbnails    #=> ['https://t.nhentai.net/galleries/1170172/1t.jpg',..., 'https://t.nhentai.net/galleries/1170172/31t.jpg']
+  #
   def thumbnails
     (1..@count_pages).map { |page| thumbnail(page) }
   end
 
-  def num_favorites
+  #
+  # Give the number of favorites on a doujinshi
+  #
+  # @return [Integer] a counter of favorites on a given doujinshi
+  # @since 0.1.0
+  # @example
+  #   doujinshi.num_favorites   #=> 13326
+  #
+  def count_favorites
     regex = %r{<span>Favorite <span class="nobold">.(\d+).<\/span><\/span>}
 
     @client.body.match(regex)[1].to_i
   end
 
+  #
+  # Give the upload date of a doujinshi
+  #
+  # @return [Integer] the upload date of a given doujinshi
+  # @since 0.1.0
+  # @example
+  #   doujinshi.upload_date   #=> 2018-01-17 15:56:16 +0000
+  #
   def upload_date
-    Time.parse(@client.body.match(/datetime="(.+)"/)[1])
-  end
-
-  def parse_tags(res)
-    res.split(%r{<a(.+?)<\/a>}).reject(&:empty?).map do |line|
-      id    = line.match(/tag-(\d+)/)[1]
-      name  = line.match(/">(.+?)</)[1].strip
-      count = line.match(/\((.+?)\)</)[1].tr(',', '').to_i
-      url   = line.match(/href=\"(.+?)\"/)[1]
-
-      Tag.new(id, name, count, url)
-    end
+    Time.iso8601(@client.body.match(/<time .+ datetime="(.*?)"/)[1])
   end
 
+  #
+  # Give all tags of a doujinshi
+  #
+  # @return [Array] of Tag class of a given doujinshi
+  # @since 0.1.0
+  # @example
+  #   doujinshi.tags
+  #
   def tags
     res = @client.body.match(%r{Tags:\s*<span class="tags">(.+)<\/span>})
+    return [] if res.nil?
 
     parse_tags(res[1])
   end
 
+  #
+  # Give a counter of tags
+  #
+  # @return [Integer] of tags
+  # @since 0.1.0
+  # @example
+  #   doujinshi.count_tags    #=> 9
+  #
   def count_tags
     res = @client.body.match(%r{Tags:\s*<span class="tags">(.+)<\/span>})
 
-    res.nil? ? 0 : parse_tags(res[1]).count
+    res.nil? ? 0 : parse_tags(res[1]).length
   end
 
+  #
+  # Check if a particular doujinshi have some tags
+  #
+  # @return [Bool] true if the doujinshi have tags, otherwise false
+  # @since 0.1.0
+  # @example
+  #   doujinshi.tags?   #=> true
+  #
   def tags?
     !@client.body.match(%r{Tags:\s*<span class="tags">(.+)<\/span>}).nil?
   end
 
+  #
+  # Give all parodies of a doujinshi
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags
+  #
   def parodies
     res = @client.body.match(%r{Parodies:\s+<span class="tags">(.+)<\/span>})
+    return [] if res.nil?
 
     parse_tags(res[1])
   end
 
+  #
+  # Give a counter of parodies
+  #
+  # @since 0.1.0
+  # @see Doujinshi#count_tags
+  #
   def count_parodies
     res = @client.body.match(%r{Parodies:\s+<span class="tags">(.+)<\/span>})
 
-    res.nil? ? 0 : parse_tags(res[1]).count
+    res.nil? ? 0 : parse_tags(res[1]).length
   end
 
+  #
+  # Check if a particular doujinshi have some parodies
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags?
+  #
   def parodies?
     !@client.body.match(%r{Parodies:\s+<span class="tags">(.+)<\/span>}).nil?
   end
 
+  #
+  # Give all characters of a doujinshi
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags
+  #
   def characters
     res = @client.body.match(%r{Characters:\s+<span class="tags">(.+)<\/span>})
+    return [] if res.nil?
 
     parse_tags(res[1])
   end
 
+  #
+  # Give a counter of characters
+  #
+  # @since 0.1.0
+  # @see Doujinshi#count_tags
+  #
   def count_characters
     res = @client.body.match(%r{Characters:\s+<span class="tags">(.+)<\/span>})
 
-    res.nil? ? 0 : parse_tags(res[1]).count
+    res.nil? ? 0 : parse_tags(res[1]).length
   end
 
+  #
+  # Check if a particular doujinshi have some characters
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags?
+  #
   def characters?
     !@client.body.match(%r{Characters:\s+<span class="tags">(.+)<\/span>}).nil?
   end
 
+  #
+  # Give all artists of a doujinshi
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags
+  #
   def artists
     res = @client.body.match(%r{Artists:\s+<span class="tags">(.+)<\/span>})
+    return [] if res.nil?
 
     parse_tags(res[1])
   end
 
+  #
+  # Give a counter of artists
+  #
+  # @since 0.1.0
+  # @see Doujinshi#count_tags
+  #
   def count_artists
     res = @client.body.match(%r{Artists:\s+<span class="tags">(.+)<\/span>})
 
-    res.nil? ? 0 : parse_tags(res[1]).count
+    res.nil? ? 0 : parse_tags(res[1]).length
   end
 
+  #
+  # Check if a particular doujinshi have some artists
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags?
+  #
   def artists?
     !@client.body.match(%r{Artists:\s+<span class="tags">(.+)<\/span>}).nil?
   end
 
+  #
+  # Give all groups of a doujinshi
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags
+  #
   def groups
     res = @client.body.match(%r{Groups:\s+<span class="tags">(.+)<\/span>})
+    return [] if res.nil?
 
     parse_tags(res[1])
   end
 
+  #
+  # Give a counter of groups
+  #
+  # @since 0.1.0
+  # @see Doujinshi#count_tags
+  #
   def count_groups
     res = @client.body.match(%r{Groups:\s+<span class="tags">(.+)<\/span>})
 
-    res.nil? ? 0 : parse_tags(res[1]).count
+    res.nil? ? 0 : parse_tags(res[1]).length
   end
 
+  #
+  # Check if a particular doujinshi have some groups
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags?
+  #
   def groups?
     !@client.body.match(%r{Groups:\s+<span class="tags">(.+)<\/span>}).nil?
   end
 
+  #
+  # Give all languages of a doujinshi
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags
+  #
   def languages
     res = @client.body.match(%r{Languages:\s+<span class="tags">(.+)<\/span>})
+    return [] if res.nil?
 
     parse_tags(res[1])
   end
 
+  #
+  # Give a counter of languages
+  #
+  # @since 0.1.0
+  # @see Doujinshi#count_tags
+  #
   def count_languages
     res = @client.body.match(%r{Languages:\s+<span class="tags">(.+)<\/span>})
 
-    res.nil? ? 0 : parse_tags(res[1]).count
+    res.nil? ? 0 : parse_tags(res[1]).length
   end
 
+  #
+  # Check if a particular doujinshi have some languages
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags?
+  #
   def languages?
     !@client.body.match(%r{Languages:\s+<span class="tags">(.+)<\/span>}).nil?
   end
 
+  #
+  # Give all categories of a doujinshi
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags
+  #
   def categories
     res = @client.body.match(%r{Categories:\s+<span class="tags">(.+)<\/span>})
+    return [] if res.nil?
 
     parse_tags(res[1])
   end
 
+  #
+  # Give a counter of categories
+  #
+  # @since 0.1.0
+  # @see Doujinshi#count_tags
+  #
   def count_categories
     res = @client.body.match(%r{Categories:\s+<span class="tags">(.+)<\/span>})
 
-    res.nil? ? 0 : parse_tags(res[1]).count
+    res.nil? ? 0 : parse_tags(res[1]).length
   end
 
+  #
+  # Check if a particular doujinshi have some categories
+  #
+  # @since 0.1.0
+  # @see Doujinshi#tags?
+  #
   def categories?
     !@client.body.match(%r{Categories:\s+<span class="tags">(.+)<\/span>}).nil?
   end
+
+  #
+  # @private
+  #
+
+  private
+
+  def parse_tags(res)
+    res.split(%r{<a(.+?)<\/a>}).reject(&:empty?).map do |line|
+      id    = line.match(/tag-(\d+)/)[1]
+      name  = line.match(/">(.+?)</)[1].strip
+      count = line.match(/class="count">(\d+.)</)[1]
+      url   = line.match(/href=\"(.+?)\"/)[1]
+
+      count = count[-1] == 'K' ? count.to_i * 1000 : count.to_i
+
+      Info.new(id, name, count, url)
+    end
+  end
+end
+
+class Tag
+  #
+  # List all doujinshi of the page of a given tag
+  #
+  # @param [String] keyword of the research
+  # @param [Integer] sort optional, 1 is sorting by time, 2 is by popularity
+  # @param [Integer] page each page can return 25 doujinshi
+  # @return [Array] array of Info
+  # @since 0.2.0
+  #
+  def self.listing(keyword, sort = 1, page = 1)
+    keyword.tr!(' ', '-')
+    sort = sort == 1 ? '' : 'popular'
+    client = Net::HTTP.get_response(URI("https://nhentai.net/tag/#{keyword}/#{sort}?page=#{page}"))
+    res = client.body.split(%r{<div class="gallery".+?>(.+)</div>}).select { |line| line.include?('<a href="/g/') }
+
+    parse_tags(res)
+  end
+
+  #
+  # @private
+  #
+  def self.parse_tags(res)
+    res.map do |line|
+      id    = line.match(%r{/g/(\d+)/})[1]
+      name  = line.match(%r{<div class="caption">(.+)</div>})[1].strip
+      count = 1
+      url   = "/g/#{id}"
+
+      Info.new(id, name, count, url)
+    end
+  end
+end
+
+class Parody < Tag
+  #
+  # List all doujinshi of the page of a given parody
+  #
+  # @since 0.2.0
+  # @see Tag#listing
+  #
+  def self.listing(keyword, sort = 1, page = 1)
+    keyword.tr!(' ', '-')
+    sort = sort == 1 ? '' : 'popular'
+    client = Net::HTTP.get_response(URI("https://nhentai.net/parody/#{keyword}/#{sort}?page=#{page}"))
+    res = client.body.split(%r{<div class="gallery".+?>(.+)</div>}).select { |line| line.include?('<a href="/g/') }
+
+    parse_tags(res)
+  end
+end
+
+class Character < Tag
+  #
+  # List all doujinshi of the page of a given character
+  #
+  # @since 0.2.0
+  # @see Tag#listing
+  #
+  def self.listing(keyword, sort = 1, page = 1)
+    keyword.tr!(' ', '-')
+    sort = sort == 1 ? '' : 'popular'
+    client = Net::HTTP.get_response(URI("https://nhentai.net/character/#{keyword}/#{sort}?page=#{page}"))
+    res = client.body.split(%r{<div class="gallery".+?>(.+)</div>}).select { |line| line.include?('<a href="/g/') }
+
+    parse_tags(res)
+  end
+end
+
+class Artist < Tag
+  #
+  # List all doujinshi of the page of a given artists
+  #
+  # @since 0.2.0
+  # @see Tag#listing
+  #
+  def self.listing(keyword, sort = 1, page = 1)
+    keyword.tr!(' ', '-')
+    sort = sort == 1 ? '' : 'popular'
+    client = Net::HTTP.get_response(URI("https://nhentai.net/artist/#{keyword}/#{sort}?page=#{page}"))
+    res = client.body.split(%r{<div class="gallery".+?>(.+)</div>}).select { |line| line.include?('<a href="/g/') }
+
+    parse_tags(res)
+  end
+end
+
+class Group < Tag
+  #
+  # List all doujinshi of the page of a given group
+  #
+  # @since 0.2.0
+  # @see Tag#listing
+  #
+  def self.listing(keyword, sort = 1, page = 1)
+    keyword.tr!(' ', '-')
+    sort = sort == 1 ? '' : 'popular'
+    client = Net::HTTP.get_response(URI("https://nhentai.net/group/#{keyword}/#{sort}?page=#{page}"))
+    res = client.body.split(%r{<div class="gallery".+?>(.+)</div>}).select { |line| line.include?('<a href="/g/') }
+
+    parse_tags(res)
+  end
+end
+
+class Language < Tag
+  #
+  # List all doujinshi of the page of a given language
+  #
+  # @since 0.2.0
+  # @see Tag#listing
+  #
+  def self.listing(keyword, sort = 1, page = 1)
+    keyword.tr!(' ', '-')
+    sort = sort == 1 ? '' : 'popular'
+    client = Net::HTTP.get_response(URI("https://nhentai.net/language/#{keyword}/#{sort}?page=#{page}"))
+    res = client.body.split(%r{<div class="gallery".+?>(.+)</div>}).select { |line| line.include?('<a href="/g/') }
+
+    parse_tags(res)
+  end
+end
+
+class Category < Tag
+  #
+  # List all doujinshi of the page of a given category
+  #
+  # @since 0.2.0
+  # @see Tag#listing
+  #
+  def self.listing(keyword, sort = 1, page = 1)
+    keyword.tr!(' ', '-')
+    sort = sort == 1 ? '' : 'popular'
+    client = Net::HTTP.get_response(URI("https://nhentai.net/category/#{keyword}/#{sort}?page=#{page}"))
+    res = client.body.split(%r{<div class="gallery".+?>(.+)</div>}).select { |line| line.include?('<a href="/g/') }
+
+    parse_tags(res)
+  end
 end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: nhentai-api
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Gael Roussel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-06-06 00:00:00.000000000 Z
+date: 2020-07-17 00:00:00.000000000 Z
 dependencies: []
 description: nhentai-api is a basic and easy to use API for nhentai.net
-email: groussel42@gmail.com
+email: gaelroussel@protonmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -21,7 +21,8 @@ homepage: https://rubygems.org/gems/nhentai-api
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/groussel42/nhentai-api
+  documentation_uri: https://www.rubydoc.info/github/groussel42/nhentai-api
+  source_code_uri: https://github.com/Mraiih/nhentai-api
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -37,7 +38,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubyforge_project: 
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: nhentai-api is a basic and easy to use API for nhentai.net