maimai_net 0.0.1

data/lib/maimai_net/region.rb

@@ -0,0 +1,108 @@
+module MaimaiNet
+  # constant group that defines maimai server region
+  #
+  # @note any of modules defined in here can't be included nor modified any further.
+  module Region
+    module Base
+      def self.append_features(cls)
+        super
+        cls.const_set :WEBSITE_BASE, cls.const_get(:BASE_HOST) + '/maimai-mobile'
+      end
+    end
+
+    # maimai DX Japan Server constants
+    module Japan
+      BASE_HOST = URI('https://maimaidx.jp')
+      include Base
+      LOGIN_PAGE_PROC = ->(site){
+        site.host == WEBSITE_BASE.host && (
+          site.path == WEBSITE_BASE.path ||
+          site.path == WEBSITE_BASE.path + '/'
+        )
+      }
+    end
+
+    # maimai DX Asia Server constants
+    module Asia
+      BASE_HOST = URI('https://maimaidx-eng.com')
+      include Base
+      LOGIN_PAGE_PROC = ->(site){
+        site.host.end_with?('.am-all.net') &&
+        site.path.split('/').first(3).join('/') == '/common_auth/login'
+      }
+      LOGIN_ERROR_PROC = ->(site, body) {
+        LOGIN_PAGE_PROC.call(site) &&
+        %r{<([\S]+)(?:\s+[^>]+)?>Error</\1>}i.match?(body)
+      }
+    end
+
+    class << self
+      include ModuleExt::MethodCache
+
+      # @return [Array<Symbol>] list of available regions
+      cache_method :list do
+        regions.keys.freeze
+      end
+
+      # @return [Hash{Symbol => Module}] mapping of region key and its respective module
+      cache_method :regions do
+        constants.map do |k|
+          mod = const_get(k)
+          [k.downcase, mod]
+        end.sort_by(&:object_id).select do |name, mod|
+          mod.is_a?(Module) && mod < Base
+        end.to_h.freeze
+      end
+
+      # @return [Hash{Symbol => Hash{Symbol => Object}}] mapping of region properties in Hash-friendly format.
+      cache_method :infos do
+        regions.map do |k, mod|
+          d = mod.constants.map do |ck| [ck.downcase, mod.const_get(ck)] end.to_h
+          [k, d]
+        end.to_h.freeze
+      end
+
+      # guess server region based on provided URL.
+      #
+      # Conditions for a url considered as the server region are either:
+      # - uri is either exact component or sublevel of provided server's website uri.
+      # - uri should match server's internal login page.
+      #
+      # @param uri [String, URI] URL to check it's region
+      # @return [Symbol] region name for given url.
+      # @return [nil]    none of the region matches.
+      cache_method :guess # do |uri|
+      def guess(uri)
+        return method(__method__).call(URI(uri)) unless URI::Generic === uri
+
+        infos.select do |k, data|
+          (
+            %i(scheme userinfo host port).all? do |k|
+              data[:website_base].public_send(k) == uri.public_send(k)
+            end && (
+              uri.path == data[:website_base].path ||
+              uri.path.start_with?(data[:website_base].path + '/')
+            )
+          ) || (
+            data[:login_page_proc].call(uri)
+          )
+        end.keys.shift
+      end
+
+      private :regions
+    end
+  ensure
+    # Freeze all modules and prevent from inclusion
+    mods = constants.map do |k| const_get(k) end
+    mods << self
+
+    private_constant :Base
+
+    mods.each do |mod|
+      %i(append_features prepend_features).each do |meth|
+        mod.define_singleton_method meth do |cls| end
+      end
+      mod.freeze
+    end
+  end
+end

data/lib/maimai_net/user_option.rb

@@ -0,0 +1,147 @@
+module MaimaiNet
+  module UserOption
+    Option = Struct.new(:name, :choices, :selected) do
+      def select(value)
+        new_selected = choices.find do |choice|
+          choice.match?(value)
+        end
+
+        fail ArgumentError, "invalid value selected" if new_selected.nil?
+        self.selected = new_selected
+      end
+
+      alias pick select
+
+      def selected_id
+        self.selected.value
+      end
+
+      def to_a
+        [self.name, self.selected_id]
+      end
+
+      def to_h
+        Hash[*to_a]
+      end
+
+      alias to_ary  to_a
+      alias to_hash to_h
+    end
+
+    Choice = Struct.new(:group, :value, :description) do
+      @symbol_alias_hooks = {
+        full: [],
+        partial: [],
+      }.freeze
+
+      def initialize(*args)
+        super
+
+        @alias_symbol = symbol_alias_of
+        @alias_value  = value_alias_of
+      end
+
+      attr_reader :alias_symbol, :alias_value
+
+      def matches
+        description_value = !@alias_value.nil? ? description : nil
+        [self.value, description_value, @alias_symbol, @alias_value].compact.uniq
+      end
+
+      def match?(value)
+        matches.include?(value)
+      end
+
+      private
+      def symbol_alias_of
+        return if /^[-]?(?:0|[1-9]+[0-9]*)(?:[.][0-9]+)?$/.match?(description)
+
+        hooks = self.class.instance_variable_get(:@symbol_alias_hooks)
+        fully_replaced = false
+        value = description.dup
+        group_name = (String === self.group ? self.group : self.group.name).dup.freeze
+        value.dup.yield_self do |temp_value|
+          hooks[:full].each do |hook|
+            hook.call(group_name, temp_value)
+            fully_replaced |= temp_value != value
+            break if fully_replaced
+          end
+
+          value.replace temp_value if fully_replaced
+        end
+
+        value.dup.yield_self do |temp_value|
+          hooks[:partial].each do |hook|
+            hook.call(group_name, temp_value)
+          end
+
+          value.replace temp_value if temp_value != value
+        end unless fully_replaced
+
+        if /^[\x20-\x7f]+$/.match?(value) then
+          value.downcase.scan(/[a-z0-9]+/).join('_').to_sym
+        end
+      end
+
+      def value_alias_of
+        case description
+        when /^[-]?(?:0|[1-9]+[0-9]*)$/; Integer($&)
+        when /^[-]?(?:0|[1-9]+[0-9]*)(?:[.][0-9]+)?$/; Float($&)
+        end
+      end
+
+      def self.add_symbol_hook(key, func)
+        @symbol_alias_hooks.fetch(key)
+          .push(func)
+
+        self
+      end
+
+      add_symbol_hook :partial, ->(group, value) {
+        value.gsub! /['×・]/, ''
+      }
+      add_symbol_hook :partial, ->(group, value) {
+        value.gsub! /[＆～]/ do |sym| ((sym.ord & ~0xff00) + 0x20).chr end
+      }
+      add_symbol_hook :partial, ->(group, value) {
+        value.gsub! /[(]([a-z]+)[)]/i, ' \1 '
+      }
+      add_symbol_hook :partial, ->(group, value) {
+        value.gsub! /[(](?:[a-z]*[+\-♦])[)]/i, {
+          '(+)' => ' increase ',
+          '(-)' => ' decrease ',
+          '(MAX-)' => ' decrease ',
+          '(♦)' => ' grade ',
+        }
+      }
+      add_symbol_hook :partial, ->(group, value) {
+        value.gsub! /(\d+)-(\w+)/ do sprintf('-%s%s', $1, $2) end
+      }
+      add_symbol_hook :partial, ->(group, value) {
+        value.gsub! /[\u2460-\u2473]/ do |sym| " #{(sym.ord - 0x2460) + 1}" end
+      }
+      add_symbol_hook :partial, ->(group, value) {
+        value.gsub! 'でらっくスコア', 'DX Score '
+      }
+
+      conversion = {
+        '⇔' => 'Mirror',
+        '⇅' => 'Flip',
+        '↻' => 'Rotate',
+      }
+      translation = {
+        'デフォルト' => 'Default',
+        'シンプル' => 'Simple',
+        'クラシック' => 'Classic',
+        'でらっくす' => 'Deluxe',
+        'スプラッシュ' => 'Splash',
+      }
+      {}.merge(conversion, translation).tap do |convert_map|
+        pattern = Regexp.union(convert_map.keys)
+        add_symbol_hook :full, ->(group, value) {
+          value.gsub! pattern, convert_map
+        }
+      end
+    end
+  end
+end

data/lib/maimai_net/util.rb

@@ -0,0 +1,9 @@
+module MaimaiNet
+  module Util
+    def self.extend_object(cls)
+      super
+    end
+  end
+
+  extend Util
+end

data/lib/maimai_net/version.rb

@@ -0,0 +1,3 @@
+module MaimaiNet
+  VERSION = -'0.0.1'
+end

data/lib/maimai_net.rb

@@ -0,0 +1,14 @@
+module MaimaiNet
+  require 'maimai_net/version'
+  require 'maimai_net/error'
+
+  require 'maimai_net/module_ext'
+  require 'maimai_net/util'
+  require 'maimai_net/constants'
+  require 'maimai_net/core_ext'
+  require 'maimai_net/refines'
+
+  require 'maimai_net/region'
+  require 'maimai_net/client'
+  require 'maimai_net/user_option'
+end

data/maimai-net.gemspec

@@ -0,0 +1,44 @@
+require_relative 'lib/maimai_net/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "maimai_net"
+  spec.version       = MaimaiNet::VERSION
+  spec.authors       = [
+    %(Rei Hakurei),
+  ]
+  spec.email         = %w(contact@bloom-juery.net)
+
+  spec.summary       = %q(Parses maimai-net into readable data.)
+  spec.homepage      = 'https://github.com/ReiFan49/rb.maimai-net'
+  spec.license       = 'BSD-3-Clause-Clear'
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  begin
+    spec.files       = Dir.chdir(File.expand_path('..', __FILE__)) do
+      `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+    end
+  rescue Errno::ENOENT
+    spec.files       = Dir.glob('lib/**/*.rb', base: File.expand_path('..', __FILE__))
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'byebug'
+
+  spec.add_runtime_dependency 'nokogiri', '~> 1.13'
+  spec.add_runtime_dependency 'faraday',  '~> 2.0'
+  spec.add_runtime_dependency 'faraday-follow_redirects'
+
+  spec.add_runtime_dependency 'http-cookie', '~> 1.0.0'
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: maimai_net
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Rei Hakurei
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-09-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-follow_redirects
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: http-cookie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description:
+email:
+- contact@bloom-juery.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/gem.yml"
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/maimai_net.rb
+- lib/maimai_net/client.rb
+- lib/maimai_net/constants.rb
+- lib/maimai_net/core_ext.rb
+- lib/maimai_net/error.rb
+- lib/maimai_net/faraday_ext/cookie_jar.rb
+- lib/maimai_net/model-typing.rb
+- lib/maimai_net/model.rb
+- lib/maimai_net/module_ext.rb
+- lib/maimai_net/page-debug.rb
+- lib/maimai_net/page-html_helper.rb
+- lib/maimai_net/page-player_data_helper.rb
+- lib/maimai_net/page-track_result_helper.rb
+- lib/maimai_net/page.rb
+- lib/maimai_net/refines.rb
+- lib/maimai_net/region.rb
+- lib/maimai_net/user_option.rb
+- lib/maimai_net/util.rb
+- lib/maimai_net/version.rb
+- maimai-net.gemspec
+homepage: https://github.com/ReiFan49/rb.maimai-net
+licenses:
+- BSD-3-Clause-Clear
+metadata:
+  homepage_uri: https://github.com/ReiFan49/rb.maimai-net
+  source_code_uri: https://github.com/ReiFan49/rb.maimai-net
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key:
+specification_version: 4
+summary: Parses maimai-net into readable data.
+test_files: []