mongory 0.7.2-arm64-darwin-23

data/lib/mongory/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Mongory
+  VERSION = '0.7.2'
+end

data/lib/mongory.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require 'time'
+require 'date'
+require 'singleton'
+require_relative 'mongory/version'
+require_relative 'mongory/utils'
+require_relative 'mongory/matchers'
+require_relative 'mongory/query_matcher'
+require_relative 'mongory/query_builder'
+require_relative 'mongory/query_operator'
+require_relative 'mongory/converters'
+require_relative 'mongory/rails' if defined?(Rails::Railtie)
+require_relative 'mongory/mongoid' if defined?(Mongoid)
+
+# Main namespace for Mongory DSL and configuration.
+#
+# Provides access to core converters, query construction, and optional
+# integrations with frameworks like Rails or Mongoid.
+#
+# @example Basic usage
+#   Mongory.build_query(records).where(age: { :$gt => 18 })
+#
+# @example Enabling DSL snippets
+#   Mongory.enable_symbol_snippets!
+#   Mongory.register(Array)
+module Mongory
+  class Error < StandardError; end
+  class TypeError < Error; end
+
+  # Yields Mongory for configuration and freezes key components.
+  #
+  # @example Configure converters
+  #   Mongory.configure do |mc|
+  #     mc.data_converter.configure do |dc|
+  #       dc.register(MyType) { transform(self) }
+  #     end
+  #
+  #     mc.condition_converter.key_converter.configure do |kc|
+  #       kc.register(MyKeyType) { normalize_key(self) }
+  #     end
+  #
+  #     mc.condition_converter.value_converter.configure do |vc|
+  #       vc.register(MyValueType) { cast_value(self) }
+  #     end
+  #   end
+  #
+  # @yieldparam self [Mongory]
+  # @return [void]
+  def self.configure
+    yield self
+    data_converter.freeze
+    condition_converter.freeze
+    Matchers.freeze
+  end
+
+  # Returns the data converter instance.
+  #
+  # @return [Converters::DataConverter]
+  def self.data_converter
+    @data_converter ||= Converters::DataConverter.instance
+  end
+
+  # Returns the condition converter instance.
+  #
+  # @return [Converters::ConditionConverter]
+  def self.condition_converter
+    @condition_converter ||= Converters::ConditionConverter.instance
+  end
+
+  # Returns the debugger instance.
+  #
+  # @return [Utils::Debugger]
+  def self.debugger
+    @debugger ||= Utils::Debugger.instance
+  end
+
+  # Builds a new query over the given record set.
+  #
+  # @param records [Enumerable] any enumerable object (Array, AR::Relation, etc.)
+  # @return [QueryBuilder] a new query builder
+  def self.build_query(records)
+    QueryBuilder.new(records)
+  end
+
+  # Registers a class to support `.mongory` query DSL.
+  # This injects a `#mongory` method into the given class.
+  #
+  # @param klass [Class] the class to register (e.g., Array, ActiveRecord::Relation)
+  # @return [void]
+  def self.register(klass)
+    klass.include(ClassExtention)
+  end
+
+  # Enables symbol snippets like `:age.gte` or `:name.regex`
+  # by dynamically defining methods on `Symbol` for query operators.
+  #
+  # Skips operators that already exist to avoid patching Mongoid or other gems.
+  #
+  # @return [void]
+  def self.enable_symbol_snippets!
+    Matchers.enable_symbol_snippets!
+  end
+
+  # Adds a `#mongory` method to the target class via inclusion.
+  #
+  # Typically used internally by `Mongory.register(...)`.
+  module ClassExtention
+    # Returns a query builder scoped to `self`.
+    #
+    # @return [QueryBuilder]
+    def mongory
+      Mongory::QueryBuilder.new(self)
+    end
+  end
+end
+
+begin
+  require 'mongory_ext'
+  require_relative 'mongory/c_query_builder'
+rescue LoadError
+  warn('Mongory::CQueryBuilder is disabled because mongory_ext is not loaded')
+end

data/mongory.gemspec

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative 'lib/mongory/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'mongory'
+  spec.version = Mongory::VERSION
+  spec.authors = ['koten0224']
+  spec.email = ['koten0224@gmail.com']
+
+  spec.summary = 'MongoDB-like in-memory query DSL for Ruby'
+  spec.description = 'A Mongo-like in-memory query DSL for Ruby'
+  spec.homepage = 'https://mongoryhq.github.io/mongory-rb/'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.6.0'
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/mongoryhq/mongory-rb'
+  spec.metadata['changelog_uri'] = 'https://github.com/mongoryhq/mongory-rb/blob/main/CHANGELOG.md'
+
+  # 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.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w(bin/ test/ spec/ features/ .git .github appveyor Gemfile))
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # C extension configuration
+  spec.extensions = ['ext/mongory_ext/extconf.rb']
+
+  # Ensure submodule files are included
+  spec.files += Dir['ext/mongory_ext/mongory-core/src/foundations/*.{c,h}']
+  spec.files += Dir['ext/mongory_ext/mongory-core/src/matchers/*.{c,h}']
+  spec.files += Dir['ext/mongory_ext/mongory-core/include/**/*.h']
+
+  # Include compiled native binaries when present (for native/platform gems)
+  spec.files += Dir['lib/**/*.{so,bundle,dll}']
+
+  # When building a native/platform gem, set platform to current
+  if ENV['NATIVE_BUILD'] == '1'
+    spec.platform = Gem::Platform::CURRENT
+  end
+end

data/scripts/build_with_core.sh

@@ -0,0 +1,292 @@
+#!/bin/bash
+
+# Build script for mongory-rb with mongory-core submodule
+# This script handles submodule initialization, dependency checking, and C extension compilation
+
+set -e  # Exit on any error
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+CORE_DIR="$PROJECT_ROOT/ext/mongory_ext/mongory-core"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Function to print colored output
+log() {
+    local color=$1
+    shift
+    echo -e "${color}$*${NC}"
+}
+
+# Function to check if command exists
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# Function to check system dependencies
+check_dependencies() {
+    log $BLUE "🔍 Checking system dependencies..."
+
+    local missing_deps=()
+
+    # Check for required tools
+    if ! command_exists git; then
+        missing_deps+=("git")
+    fi
+
+    if ! command_exists make; then
+        missing_deps+=("make")
+    fi
+
+    if ! command_exists gcc && ! command_exists clang; then
+        missing_deps+=("gcc or clang")
+    fi
+
+    # Check for pkg-config (optional)
+    if ! command_exists pkg-config; then
+        missing_deps+=("pkg-config")
+    fi
+
+    if [ ${#missing_deps[@]} -gt 0 ]; then
+        log $RED "❌ Missing dependencies: ${missing_deps[*]}"
+        log $YELLOW "Please install the missing dependencies:"
+
+        if [[ "$OSTYPE" == "darwin"* ]]; then
+            log $BLUE "  macOS (Homebrew): brew install ${missing_deps[*]// /}"
+        elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+            if command_exists apt; then
+                log $BLUE "  Ubuntu/Debian: sudo apt update && sudo apt install build-essential pkg-config"
+            elif command_exists yum; then
+                log $BLUE "  CentOS/RHEL: sudo yum install gcc make pkg-config"
+            elif command_exists dnf; then
+                log $BLUE "  Fedora: sudo dnf install gcc make pkg-config"
+            fi
+        fi
+
+        exit 1
+    fi
+
+    log $GREEN "✅ All dependencies found"
+}
+
+# Function to initialize/update submodules
+init_submodules() {
+    log $BLUE "📥 Initializing/updating submodules..."
+
+    cd "$PROJECT_ROOT"
+
+    if [ ! -d "$CORE_DIR" ] || [ ! "$(ls -A "$CORE_DIR")" ]; then
+        log $YELLOW "Submodule not initialized, initializing now..."
+        git submodule update --init --recursive
+    else
+        log $YELLOW "Updating existing submodule..."
+        git submodule update --recursive
+    fi
+
+    if [ ! -f "$CORE_DIR/README.md" ]; then
+        log $RED "❌ Failed to initialize mongory-core submodule"
+        exit 1
+    fi
+
+    log $GREEN "✅ Submodule initialized/updated successfully"
+}
+
+# Function to build mongory-core if needed
+build_core() {
+    # mongory-rb 直接由 extconf.rb 編譯 mongory-core 的源碼，不需要獨立建置靜態庫
+    # 同時避免觸發 mongory-core 的 CMake（其需要 cJSON 僅用於測試）
+    log $YELLOW "Skipping mongory-core standalone build (not required for mongory-rb)"
+}
+
+# Function to build the Ruby C extension
+build_extension() {
+    log $BLUE "🔨 Building Ruby C extension..."
+
+    cd "$PROJECT_ROOT"
+
+    # Clean previous builds
+    if [ -d "ext/mongory_ext/Makefile" ]; then
+        cd ext/mongory_ext
+        make clean 2>/dev/null || true
+        cd "$PROJECT_ROOT"
+    fi
+
+    # Build the extension
+    cd ext/mongory_ext
+
+    # Set DEBUG flag if requested
+    if [[ "$1" == "--debug" ]]; then
+        export DEBUG=1
+        log $YELLOW "Building in debug mode..."
+    fi
+
+    ruby extconf.rb
+    make
+
+    if [ $? -eq 0 ]; then
+        log $GREEN "✅ C extension built successfully"
+    else
+        log $RED "❌ Failed to build C extension"
+        exit 1
+    fi
+
+    cd "$PROJECT_ROOT"
+}
+
+# Function to run tests
+run_tests() {
+    log $BLUE "🧪 Running tests..."
+
+    cd "$PROJECT_ROOT"
+
+    # Run Ruby tests
+    if command_exists bundle; then
+        bundle exec rspec
+    else
+        rspec
+    fi
+
+    if [ $? -eq 0 ]; then
+        log $GREEN "✅ All tests passed"
+    else
+        log $RED "❌ Some tests failed"
+        exit 1
+    fi
+}
+
+# Function to clean build artifacts
+clean() {
+    log $BLUE "🧹 Cleaning build artifacts..."
+
+    cd "$PROJECT_ROOT"
+
+    # Clean C extension
+    if [ -d "ext/mongory_ext" ]; then
+        cd ext/mongory_ext
+        make clean 2>/dev/null || true
+        rm -f Makefile *.o foundations/*.o matchers/*.o mongory_ext.so
+        cd "$PROJECT_ROOT"
+    fi
+
+    # Clean mongory-core build
+    if [ -d "$CORE_DIR/build" ]; then
+        rm -rf "$CORE_DIR/build"
+    fi
+
+    log $GREEN "✅ Cleaned build artifacts"
+}
+
+# Function to display help
+show_help() {
+    cat << EOF
+Usage: $0 [OPTIONS]
+
+Build script for mongory-rb with mongory-core submodule integration.
+
+OPTIONS:
+  --help          Show this help message
+  --clean         Clean build artifacts and exit
+  --debug         Build in debug mode
+  --no-deps       Skip dependency checking
+  --no-tests      Skip running tests
+  --force-rebuild Force rebuild of everything
+
+EXAMPLES:
+  $0                    # Normal build
+  $0 --debug            # Debug build
+  $0 --clean            # Clean only
+  $0 --no-tests         # Build without running tests
+
+EOF
+}
+
+# Main execution flow
+main() {
+    local clean_only=false
+    local skip_deps=false
+    local skip_tests=false
+    local force_rebuild=false
+    local debug_mode=false
+
+    # Parse command line arguments
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --help)
+                show_help
+                exit 0
+                ;;
+            --clean)
+                clean_only=true
+                shift
+                ;;
+            --debug)
+                debug_mode=true
+                shift
+                ;;
+            --no-deps)
+                skip_deps=true
+                shift
+                ;;
+            --no-tests)
+                skip_tests=true
+                shift
+                ;;
+            --force-rebuild)
+                force_rebuild=true
+                shift
+                ;;
+            *)
+                log $RED "Unknown option: $1"
+                show_help
+                exit 1
+                ;;
+        esac
+    done
+
+    log $GREEN "🚀 Starting mongory-rb build process..."
+
+    # Clean and exit if requested
+    if $clean_only; then
+        clean
+        exit 0
+    fi
+
+    # Force rebuild if requested
+    if $force_rebuild; then
+        clean
+    fi
+
+    # Check dependencies unless skipped
+    if ! $skip_deps; then
+        check_dependencies
+    fi
+
+    # Initialize submodules
+    init_submodules
+
+    # Build mongory-core
+    build_core
+
+    # Build Ruby C extension
+    if $debug_mode; then
+        build_extension --debug
+    else
+        build_extension
+    fi
+
+    # Run tests unless skipped
+    if ! $skip_tests; then
+        run_tests
+    fi
+
+    log $GREEN "🎉 Build completed successfully!"
+    log $BLUE "You can now use mongory-rb with C extension support."
+}
+
+# Run main function with all arguments
+main "$@"

data/sig/mongory.rbs

@@ -0,0 +1,4 @@
+module Mongory
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,164 @@
+--- !ruby/object:Gem::Specification
+name: mongory
+version: !ruby/object:Gem::Version
+  version: 0.7.2
+platform: arm64-darwin-23
+authors:
+- koten0224
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-08-24 00:00:00.000000000 Z
+dependencies: []
+description: A Mongo-like in-memory query DSL for Ruby
+email:
+- koten0224@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".yardopts"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- SUBMODULE_INTEGRATION.md
+- docs/advanced_usage.md
+- docs/clang_bridge.md
+- docs/field_names.md
+- docs/migration.md
+- docs/performance.md
+- examples/README.md
+- examples/benchmark-rails.rb
+- examples/benchmark.rb
+- ext/mongory_ext/extconf.rb
+- ext/mongory_ext/mongory-core/include/mongory-core.h
+- ext/mongory_ext/mongory-core/include/mongory-core/foundations/array.h
+- ext/mongory_ext/mongory-core/include/mongory-core/foundations/config.h
+- ext/mongory_ext/mongory-core/include/mongory-core/foundations/error.h
+- ext/mongory_ext/mongory-core/include/mongory-core/foundations/memory_pool.h
+- ext/mongory_ext/mongory-core/include/mongory-core/foundations/table.h
+- ext/mongory_ext/mongory-core/include/mongory-core/foundations/value.h
+- ext/mongory_ext/mongory-core/include/mongory-core/matchers/matcher.h
+- ext/mongory_ext/mongory-core/src/foundations/array.c
+- ext/mongory_ext/mongory-core/src/foundations/array_private.h
+- ext/mongory_ext/mongory-core/src/foundations/config.c
+- ext/mongory_ext/mongory-core/src/foundations/config_private.h
+- ext/mongory_ext/mongory-core/src/foundations/error.c
+- ext/mongory_ext/mongory-core/src/foundations/memory_pool.c
+- ext/mongory_ext/mongory-core/src/foundations/string_buffer.c
+- ext/mongory_ext/mongory-core/src/foundations/string_buffer.h
+- ext/mongory_ext/mongory-core/src/foundations/table.c
+- ext/mongory_ext/mongory-core/src/foundations/utils.c
+- ext/mongory_ext/mongory-core/src/foundations/utils.h
+- ext/mongory_ext/mongory-core/src/foundations/value.c
+- ext/mongory_ext/mongory-core/src/matchers/array_record_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/array_record_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/base_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/base_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/compare_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/compare_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/composite_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/composite_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/existance_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/existance_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/external_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/external_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/inclusion_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/inclusion_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/literal_matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/literal_matcher.h
+- ext/mongory_ext/mongory-core/src/matchers/matcher.c
+- ext/mongory_ext/mongory-core/src/matchers/matcher_explainable.c
+- ext/mongory_ext/mongory-core/src/matchers/matcher_explainable.h
+- ext/mongory_ext/mongory-core/src/matchers/matcher_traversable.c
+- ext/mongory_ext/mongory-core/src/matchers/matcher_traversable.h
+- ext/mongory_ext/mongory_ext.c
+- lib/generators/mongory/install/install_generator.rb
+- lib/generators/mongory/install/templates/initializer.rb.erb
+- lib/generators/mongory/matcher/matcher_generator.rb
+- lib/generators/mongory/matcher/templates/matcher.rb.erb
+- lib/generators/mongory/matcher/templates/matcher_spec.rb.erb
+- lib/mongory.rb
+- lib/mongory/c_query_builder.rb
+- lib/mongory/converters.rb
+- lib/mongory/converters/abstract_converter.rb
+- lib/mongory/converters/condition_converter.rb
+- lib/mongory/converters/converted.rb
+- lib/mongory/converters/data_converter.rb
+- lib/mongory/converters/key_converter.rb
+- lib/mongory/converters/value_converter.rb
+- lib/mongory/matchers.rb
+- lib/mongory/matchers/abstract_matcher.rb
+- lib/mongory/matchers/abstract_multi_matcher.rb
+- lib/mongory/matchers/and_matcher.rb
+- lib/mongory/matchers/array_record_matcher.rb
+- lib/mongory/matchers/elem_match_matcher.rb
+- lib/mongory/matchers/eq_matcher.rb
+- lib/mongory/matchers/every_matcher.rb
+- lib/mongory/matchers/exists_matcher.rb
+- lib/mongory/matchers/field_matcher.rb
+- lib/mongory/matchers/gt_matcher.rb
+- lib/mongory/matchers/gte_matcher.rb
+- lib/mongory/matchers/hash_condition_matcher.rb
+- lib/mongory/matchers/in_matcher.rb
+- lib/mongory/matchers/literal_matcher.rb
+- lib/mongory/matchers/lt_matcher.rb
+- lib/mongory/matchers/lte_matcher.rb
+- lib/mongory/matchers/ne_matcher.rb
+- lib/mongory/matchers/nin_matcher.rb
+- lib/mongory/matchers/not_matcher.rb
+- lib/mongory/matchers/or_matcher.rb
+- lib/mongory/matchers/present_matcher.rb
+- lib/mongory/matchers/regex_matcher.rb
+- lib/mongory/matchers/size_matcher.rb
+- lib/mongory/mongoid.rb
+- lib/mongory/query_builder.rb
+- lib/mongory/query_matcher.rb
+- lib/mongory/query_operator.rb
+- lib/mongory/rails.rb
+- lib/mongory/utils.rb
+- lib/mongory/utils/context.rb
+- lib/mongory/utils/debugger.rb
+- lib/mongory/utils/rails_patch.rb
+- lib/mongory/utils/singleton_builder.rb
+- lib/mongory/version.rb
+- lib/mongory_ext.bundle
+- mongory.gemspec
+- scripts/build_with_core.sh
+- sig/mongory.rbs
+homepage: https://mongoryhq.github.io/mongory-rb/
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://mongoryhq.github.io/mongory-rb/
+  source_code_uri: https://github.com/mongoryhq/mongory-rb
+  changelog_uri: https://github.com/mongoryhq/mongory-rb/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.3.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: MongoDB-like in-memory query DSL for Ruby
+test_files: []