mongoid-geospatial 5.1.0 → 7.1.0

data/lib/mongoid/geospatial.rb

@@ -1,6 +1,7 @@
+# frozen_string_literal: true
+
 require 'mongoid'
-# require 'active_support/core_ext/string/inflections'
-# require 'active_support/concern'
+require 'active_support/concern' # Explicitly require for `extend ActiveSupport::Concern`
 require 'mongoid/geospatial/helpers/spatial'
 require 'mongoid/geospatial/helpers/sphere'
 require 'mongoid/geospatial/helpers/delegate'
@@ -55,7 +56,6 @@ module Mongoid
     @@earth_radius = EARTH_RADIUS.dup
 
     included do
-      # attr_accessor :geo
       cattr_accessor :spatial_fields, :spatial_fields_indexed
       self.spatial_fields = []
       self.spatial_fields_indexed = []
@@ -72,14 +72,10 @@ module Mongoid
     # Methods applied to Document's class
     module ClassMethods
       #
-      # Create Spatial index for given field
-      #
+      # Creates a 2d spatial index for the given field.
       #
-      # @param [String,Symbol] name
-      # @param [Hash] options options for spatial_index
-      #
-      # http://www.mongodb.org/display/DOCS/Geospatial+Indexing
-      # #GeospatialIndexing-geoNearCommand
+      # @param name [String, Symbol] The name of the field to index.
+      # @param options [Hash] Additional options for the index.
       #
       def spatial_index(name, options = {})
         spatial_fields_indexed << name
@@ -87,38 +83,249 @@ module Mongoid
       end
 
       #
-      # Creates Sphere index for given field
-      #
+      # Creates a 2dsphere index for the given field, suitable for spherical geometry calculations.
       #
-      # @param [String,Symbol] name
-      # @param [Hash] options options for spatial_index
+      # @param name [String, Symbol] The name of the field to index.
+      # @param options [Hash] Additional options for the index.
       #
-      # http://www.mongodb.org/display/DOCS/Geospatial+Indexing
-      # #GeospatialIndexing-geoNearCommand
-      def sphere_index(name, options = {})
+      def spherical_index(name, options = {})
         spatial_fields_indexed << name
         index({ name => '2dsphere' }, options)
       end
 
       #
-      # Creates Sphere index for given field
+      # # Queries
+      #
+      # MongoDB provides the following geospatial query operators.
+      #
+      # $geoIntersects
+      # Selects geometries that intersect with a GeoJSON geometry.
+      # The 2dsphere index supports $geoIntersects.
+      #
+      # $geoWithin
+      # Selects geometries within a bounding GeoJSON geometry.
+      # The 2dsphere and 2d indexes support $geoWithin.
+      #
+      # $near
+      # Returns geospatial objects in proximity to a point.
+      # Requires a geospatial index. The 2dsphere and 2d indexes support $near.
+      #
+      # $nearSphere
+      # Returns geospatial objects in proximity to a point on a sphere.
+      # Requires a geospatial index. The 2dsphere and 2d indexes support $nearSphere.
+      #
+      # # Aggregation
+      #
+      # MongoDB provides the following geospatial aggregation pipeline stage:
+      #
+      # $geoNear
+      # Returns an ordered stream of documents based on the proximity to a geospatial point.
+      # Incorporates the functionality of $match, $sort, and $limit for geospatial data.
+      # The output documents include an additional distance field and can include a location identifier field.
+      # $geoNear requires a geospatial index.
+      #
+
+      #
+      # Defines a class method to find the closest document to a given point
+      # using the specified spatial field via the `geoNear` command.
+      #
+      # @param field_name [String, Symbol] The name of the spatial field to query.
+      # @param default_geo_near_options [Hash] Default options for the geoNear command
+      #        (e.g., `{ spherical: true, max_distance: 1000 }`).
+      #        The `key` option will be automatically set to `field_name`.
       #
+      # Example:
+      #   class Place
+      #     include Mongoid::Document
+      #     include Mongoid::Geospatial
+      #     field :location, type: Array
+      #     spherical_index :location # Assumes a 2dsphere index for spherical queries
+      #     spatial_scope :location, spherical: true # Default to spherical for this scope
+      #   end
       #
-      # @param [String,Symbol] name
-      # @param [Hash] options options for spatial_index
+      #   Place.closest_to_location([lon, lat]) # Finds the single closest place
+      #   Place.closest_to_location([lon, lat], max_distance: 500) # Override/add options
       #
-      # http://www.mongodb.org/display/DOCS/Geospatial+Indexing
-      # #GeospatialIndexing-geoNearCommand
-      def spatial_scope(field, _opts = {})
+      def spatial_scope(field_name, default_geo_near_options = {})
+        method_name    = :"closest_to_#{field_name}"
+        field_name_sym = field_name.to_sym
+        # key_name       = field_name.to_s # Original geoNear used 'key' for field name
+
         singleton_class.class_eval do
-          # define_method(:close) do |args|
-          define_method(:nearby) do |args|
-            queryable.where(field.near_sphere => args)
+          define_method(method_name) do |coordinates, additional_options = {}|
+            # `coordinates` should be [lon, lat] or a GeoJSON Point hash
+            # `self` here is the class (e.g., Bar)
+
+            merged_options = default_geo_near_options.merge(additional_options)
+
+            # Determine if spherical based on options or field definition
+            is_spherical = if merged_options.key?(:spherical)
+                             merged_options[:spherical]
+                           else
+                             # self.fields uses string keys for field names
+                             field_def = fields[field_name.to_s]
+                             field_def && field_def.options[:sphere]
+                           end
+            query_operator = is_spherical ? :near_sphere : :near
+
+            # Prepare the value for the geospatial operator
+            # Mongoid::Geospatial::Point.mongoize ensures coordinates are in [lng, lat] array format
+            # from various input types (Point object, array, string, hash).
+            mongoized_coords = Mongoid::Geospatial::Point.mongoize(coordinates)
+
+            geo_query_value = if merged_options[:max_distance]
+                                {
+                                  # Using $geometry for clarity when $maxDistance is used,
+                                  # which is standard for $near/$nearSphere operators.
+                                  '$geometry' => { type: 'Point', coordinates: mongoized_coords },
+                                  '$maxDistance' => merged_options[:max_distance].to_f
+                                }
+                              else
+                                mongoized_coords # Simple array [lng, lat] for the operator
+                              end
+
+            # Start with a base criteria, applying an optional filter query
+            current_criteria = merged_options[:query] ? where(merged_options[:query]) : all
+
+            # Apply the geospatial query. $near and $nearSphere queries return sorted results.
+            current_criteria.where(field_name_sym.send(query_operator) => geo_query_value)
           end
         end
       end
+
+      #
+      # Provides a convenient way to find documents near a given set of coordinates.
+      # It automatically uses the first spatial field defined in the model and
+      # determines whether to use a planar (.near) or spherical (.near_sphere)
+      # query based on the field's definition options (`spatial: true` vs `sphere: true`).
+      #
+      # @param coordinates [Array, Mongoid::Geospatial::Point] The coordinates (e.g., [lon, lat])
+      #   or a Point object to find documents near to.
+      # @param _options [Hash] Optional hash for future extensions (currently unused).
+      #
+      # @return [Mongoid::Criteria] A criteria object for the query.
+      #
+      # Example:
+      #   Bar.nearby([10, 20])
+      #   Alarm.nearby(my_point_object)
+      #
+      def nearby(coordinates, _options = {})
+        if spatial_fields.empty?
+          raise "No spatial fields defined for #{name} to use with .nearby. " \
+                "Mark a field with 'spatial: true' or 'sphere: true'."
+        end
+
+        field_name_sym = spatial_fields.first.to_sym
+        field_definition = fields[field_name_sym.to_s]
+
+        raise "Could not find field definition for spatial field: #{field_name_sym}" unless field_definition
+
+        query_operator = field_definition.options[:sphere] ? :near_sphere : :near
+
+        criteria.where(field_name_sym.send(query_operator) => coordinates)
+      end
+
+      # Performs a $geoNear aggregation pipeline stage to find documents near a point,
+      # returning them sorted by distance and including the distance.
+      #
+      # This method is a wrapper around the MongoDB `$geoNear` aggregation stage,
+      # which allows for more complex queries and options than the simple `near` or `near_sphere` methods.
+      #
+      # * But it's not chainable like a standard Mongoid query *
+      #
+      # @param field_name [String, Symbol] The name of the geospatial field to query.
+      #   This field must be indexed with a geospatial index (2d or 2dsphere).
+      # @param coordinates [Array, Hash, Mongoid::Geospatial::Point] The point to search near.
+      #   Examples: `[lng, lat]`, `{ type: 'Point', coordinates: [lng, lat] }`, a `Mongoid::Geospatial::Point` object.
+      # @param options [Hash] Options for the $geoNear stage.
+      #   Key options include:
+      #   - `:spherical` [Boolean] If true, calculates distances using spherical geometry. Defaults to `false`.
+      #   - `:distanceField` [String] Name of the output field that will contain the distance. Defaults to `'distance'`.
+      #   - `:maxDistance` [Numeric] The maximum distance from the center point that documents can be.
+      #     For spherical queries, specify distance in meters. For 2d queries, in the same units as coordinates.
+      #   - `:minDistance` [Numeric] The minimum distance. (MongoDB 2.6+)
+      #   - `:query` [Hash] Limits the results to the documents that match the query.
+      #   - `:limit` [Integer] The maximum number of documents to return (applied as a separate `$limit` pipeline stage).
+      #   - `:distanceMultiplier` [Numeric] A factor to multiply all distances returned by the query.
+      #   - `:includeLocs` [String] Specifies the name of the output field that identifies the location used to calculate the distance.
+      #     This is useful when the queried field contains multiple locations (e.g., an array of points) or complex GeoJSON
+      #     geometries (e.g., a Polygon), as it shows which specific point was used for the distance calculation.
+      #     Example: `includeLocs: 'matchedPoint'` would add a `matchedPoint` field to each output document.
+      #
+      # @return [Array<Mongoid::Document>] An array of instantiated Mongoid documents.
+      #   Each document will include its original fields plus any fields added by the `$geoNear` stage,
+      #   such as the field specified by `:distanceField` (e.g., `document.distance`) and `:includeLocs`.
+      #   These additional fields are accessible as dynamic attributes on the model instances.
+      #
+      # @raise [ArgumentError] If coordinates cannot be mongoized.
+      #
+      # Example:
+      #   # Find places near [10, 20], using spherical calculations, up to 5km away
+      #   Place.geo_near(:location, [10, 20],
+      #                  spherical: true,
+      #                  maxDistance: 5000, # 5 kilometers in meters
+      #                  distanceField: 'dist.calculated',
+      #                  query: { category: 'restaurant' },
+      #                  limit: 10)
+      #
+      #   # Iterate over results
+      #   Place.geo_near(:location, [10, 20], spherical: true).each do |place|
+      #     puts "#{place.name} is #{place.distance} meters away." # Assumes distanceField is 'distance'
+      #   end
+      #
+      def geo_near(field_name, coordinates, options = {})
+        mongoized_coords = Mongoid::Geospatial::Point.mongoize(coordinates)
+
+        raise ArgumentError, "Invalid coordinates provided: #{coordinates.inspect}" unless mongoized_coords
+
+        # User-provided options. Work with a copy.
+        user_options = options.dup
+        limit_value = user_options.delete(:limit) # Handled by a separate pipeline stage
+
+        # Core $geoNear parameters derived from method arguments, these are not overrideable by user_options.
+        geo_near_core_params = {
+          key: field_name.to_s,
+          near: mongoized_coords
+        }
+
+        # Defaultable $geoNear parameters. User options will override these.
+        geo_near_defaultable_params = {
+          distanceField: 'distance',
+          spherical: false # Default to planar (2d) calculations
+        }
+
+        # Merge user options over defaults, then ensure core parameters are set.
+        geo_near_stage_options = geo_near_defaultable_params.merge(user_options).merge(geo_near_core_params)
+
+        # Ensure :spherical is a strict boolean (true/false).
+        # If user_options provided :spherical, it's already set. If not, the default is used.
+        # This line ensures the final value is strictly true or false, not just truthy/falsy.
+        geo_near_stage_options[:spherical] = !geo_near_stage_options[:spherical].nil?
+
+        # Note on performance:
+        # $geoNear is an aggregation pipeline stage. For simple proximity queries,
+        # it might exhibit slightly higher "real" time (wall-clock time) in benchmarks
+        # compared to direct query operators like $near or $nearSphere. This is often
+        # due to the inherent overhead of the aggregation framework versus a direct query.
+        # However, $geoNear offers more capabilities, such as returning the distance
+        # (distanceField), distanceMultiplier, includeLocs, and integrating with other
+        # aggregation stages, which are not available with $near/$nearSphere.
+        pipeline = [{ '$geoNear' => geo_near_stage_options }]
+
+        # Add $limit stage if limit_value was provided
+        pipeline << { '$limit' => limit_value.to_i } if limit_value
+
+        # Execute the aggregation pipeline
+        collection.aggregate(pipeline)
+
+        # Don't instantiate results here.
+        # aggregated_results = collection.aggregate(pipeline)
+        # Map the raw Hash results from aggregation to Mongoid model instances.
+        # Mongoid's #instantiate method correctly handles creating model objects
+        # and assigning attributes, including dynamic ones like the distanceField.
+        # aggregated_results.map { |attrs| instantiate(attrs) }
+      end
     end
   end
 end
-
 require 'mongoid/geospatial/config'

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mongoid-geospatial
 version: !ruby/object:Gem::Version
-  version: 5.1.0
+  version: 7.1.0
 platform: ruby
 authors:
 - Ryan Ong
 - Marcos Piccinini
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mongoid
@@ -33,23 +32,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".coveralls.yml"
-- ".gitignore"
-- ".hound.yml"
-- ".rspec"
-- ".rubocop.yml"
-- ".rubocop_todo.yml"
-- ".travis.yml"
-- CHANGELOG.md
-- CONTRIBUTING.md
-- Dangerfile
-- Gemfile
-- Guardfile
 - MIT-LICENSE
 - README.md
-- RELEASING.md
-- Rakefile
-- bench/bench
 - lib/mongoid/geospatial.rb
 - lib/mongoid/geospatial/config.rb
 - lib/mongoid/geospatial/config/point.rb
@@ -66,39 +50,11 @@ files:
 - lib/mongoid/geospatial/version.rb
 - lib/mongoid/geospatial/wrappers/georuby.rb
 - lib/mongoid/geospatial/wrappers/rgeo.rb
-- mongoid-geospatial.gemspec
-- spec/models/address.rb
-- spec/models/alarm.rb
-- spec/models/bar.rb
-- spec/models/bus.rb
-- spec/models/event.rb
-- spec/models/farm.rb
-- spec/models/person.rb
-- spec/models/phone.rb
-- spec/models/place.rb
-- spec/models/river.rb
-- spec/mongoid/geospatial/config_spec.rb
-- spec/mongoid/geospatial/fields/box_spec.rb
-- spec/mongoid/geospatial/fields/circle_spec.rb
-- spec/mongoid/geospatial/fields/line_string_spec.rb
-- spec/mongoid/geospatial/fields/point_spec.rb
-- spec/mongoid/geospatial/fields/polygon_spec.rb
-- spec/mongoid/geospatial/geospatial_spec.rb
-- spec/mongoid/geospatial/helpers/core_spec.rb
-- spec/mongoid/geospatial/helpers/delegate_spec.rb
-- spec/mongoid/geospatial/helpers/spatial_spec.rb
-- spec/mongoid/geospatial/helpers/sphere_spec.rb
-- spec/mongoid/geospatial/wrappers/georuby_spec.rb
-- spec/mongoid/geospatial/wrappers/rgeo_spec.rb
-- spec/spec_helper.rb
-- spec/support/authentication.rb
-- spec/support/mongod.conf
-- spec/support/mongoid.yml
 homepage: https://github.com/mongoid/mongoid-geospatial
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -106,43 +62,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Mongoid Extension that simplifies MongoDB Geospatial Operations.
-test_files:
-- spec/models/address.rb
-- spec/models/alarm.rb
-- spec/models/bar.rb
-- spec/models/bus.rb
-- spec/models/event.rb
-- spec/models/farm.rb
-- spec/models/person.rb
-- spec/models/phone.rb
-- spec/models/place.rb
-- spec/models/river.rb
-- spec/mongoid/geospatial/config_spec.rb
-- spec/mongoid/geospatial/fields/box_spec.rb
-- spec/mongoid/geospatial/fields/circle_spec.rb
-- spec/mongoid/geospatial/fields/line_string_spec.rb
-- spec/mongoid/geospatial/fields/point_spec.rb
-- spec/mongoid/geospatial/fields/polygon_spec.rb
-- spec/mongoid/geospatial/geospatial_spec.rb
-- spec/mongoid/geospatial/helpers/core_spec.rb
-- spec/mongoid/geospatial/helpers/delegate_spec.rb
-- spec/mongoid/geospatial/helpers/spatial_spec.rb
-- spec/mongoid/geospatial/helpers/sphere_spec.rb
-- spec/mongoid/geospatial/wrappers/georuby_spec.rb
-- spec/mongoid/geospatial/wrappers/rgeo_spec.rb
-- spec/spec_helper.rb
-- spec/support/authentication.rb
-- spec/support/mongod.conf
-- spec/support/mongoid.yml
+test_files: []

data/.coveralls.yml

@@ -1 +0,0 @@
-service_name: travis-ci

data/.gitignore

@@ -1,49 +0,0 @@
-Gemfile.lock
-# rcov generated
-coverage
-
-# rdoc generated
-rdoc
-
-# yard generated
-doc
-.yardoc
-
-# bundler
-.bundle
-
-# jeweler generated
-pkg
-
-# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
-#
-# * Create a file at ~/.gitignore
-# * Include files you want ignored
-# * Run: git config --global core.excludesfile ~/.gitignore
-#
-# After doing this, these files will be ignored in all your git projects,
-# saving you from having to 'pollute' every project you touch with them
-#
-# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
-#
-# For MacOS:
-#
-.DS_Store
-
-# For TextMate
-#*.tmproj
-#tmtags
-
-# For emacs:
-#*~
-#\#*
-#.\#*
-
-# For vim:
-*.swp
-
-# For redcar:
-#.redcar
-
-# For rubinius:
-#*.rbc

data/.hound.yml

@@ -1,2 +0,0 @@
-ruby:
-  enabled: true

data/.rspec

@@ -1,3 +0,0 @@
---tty
---color
---format documentation

data/.rubocop.yml

@@ -1,6 +0,0 @@
-AllCops:
-  Exclude:
-    - vendor/**/*
-    - bin/**/*
-
-inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -1,93 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2018-11-09 16:09:41 -0500 using RuboCop version 0.60.0.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 4
-# Configuration parameters: Include.
-# Include: **/*.gemfile, **/Gemfile, **/gems.rb
-Bundler/DuplicatedGem:
-  Exclude:
-    - 'Gemfile'
-
-# Offense count: 2
-Lint/DuplicateMethods:
-  Exclude:
-    - 'lib/mongoid/geospatial/fields/circle.rb'
-
-# Offense count: 3
-Metrics/AbcSize:
-  Max: 22
-
-# Offense count: 21
-# Configuration parameters: CountComments, ExcludedMethods.
-# ExcludedMethods: refine
-Metrics/BlockLength:
-  Max: 216
-
-# Offense count: 1
-Metrics/CyclomaticComplexity:
-  Max: 7
-
-# Offense count: 1
-# Configuration parameters: CountComments, ExcludedMethods.
-Metrics/MethodLength:
-  Max: 11
-
-# Offense count: 1
-Naming/AccessorMethodName:
-  Exclude:
-    - 'spec/models/address.rb'
-
-# Offense count: 9
-# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
-# AllowedNames: io, id, to, by, on, in, at, ip, db
-Naming/UncommunicativeMethodParamName:
-  Exclude:
-    - 'lib/mongoid/geospatial/fields/point.rb'
-    - 'lib/mongoid/geospatial/geometry_field.rb'
-
-# Offense count: 3
-Style/ClassVars:
-  Exclude:
-    - 'lib/mongoid/geospatial.rb'
-
-# Offense count: 4
-Style/CommentedKeyword:
-  Exclude:
-    - 'lib/mongoid/geospatial/fields/point.rb'
-
-# Offense count: 6
-Style/Documentation:
-  Exclude:
-    - 'spec/**/*'
-    - 'test/**/*'
-    - 'bench/bench'
-    - 'lib/mongoid/geospatial/config.rb'
-    - 'lib/mongoid/geospatial/config/point.rb'
-
-# Offense count: 2
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: module_function, extend_self
-Style/ModuleFunction:
-  Exclude:
-    - 'lib/mongoid/geospatial/config.rb'
-    - 'lib/mongoid/geospatial/config/point.rb'
-
-# Offense count: 4
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, AllowInnerSlashes.
-# SupportedStyles: slashes, percent_r, mixed
-Style/RegexpLiteral:
-  Exclude:
-    - 'Guardfile'
-
-# Offense count: 15
-# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
-# URISchemes: http, https
-Metrics/LineLength:
-  Max: 113

data/.travis.yml

@@ -1,33 +0,0 @@
-sudo: false
-
-language: ruby
-
-cache: bundler
-
-services: mongodb
-
-rvm:
-  - 2.5.3
-
-before_install:
-  - gem update bundler
-
-before_script:
-  - bundle exec danger
-
-addons:
-  apt:
-    sources:
-      - mongodb-3.2-precise
-    packages:
-      - mongodb-org-server
-
-env:
-  - MONGOID_VERSION=5
-  - MONGOID_VERSION=6
-  - MONGOID_VERSION=7
-  - MONGOID_VERSION=HEAD
-
-matrix:
-  allow_failures:
-    - env: MONGOID_VERSION=HEAD

data/CHANGELOG.md

@@ -1,19 +0,0 @@
-## 5.1.0 (2018/11/09)
-
-* [#61](https://github.com/mongoid/mongoid-geospatial/pull/64): Add global configuration for switching between LngLat and LatLng - [@dblock](https://github.com/dblock).
-* [#59](https://github.com/mongoid/mongoid-geospatial/pull/59), [#65](https://github.com/mongoid/mongoid-geospatial/pull/65): Test against Mongoid 5, 6 and 7 - [@dblock](https://github.com/dblock).
-* [#52](https://github.com/mongoid/mongoid-geospatial/pull/52), [#70](https://github.com/mongoid/mongoid-geospatial/pull/70): Added Danger and Rubocop, PR and code linters - [@dblock](https://github.com/dblock).
-
-## 5.0.0 (2015/07/23)
-
-* Mongoid 5 support - [@nofxx](https://github.com/nofxx).
-
-## 4.0.1 (2015/03/04)
-
-## 4.0.0 (2015/01/11)
-
-* Mongoid 4 support - [@nofxx](https://github.com/nofxx).
-
-## 3.9.0 (2014/12/22)
-
-* Initial public release - [@nofxx](https://github.com/nofxx).