time_range_uniqueness 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5d6fd29dd2746a4129bb39f795c097fe4052eb0fa7dbf9d8c6398d8c35ff4cb4
+  data.tar.gz: 9b58e702e5797b25b633eda09e77c9fd0090ba1313de7d1c25453a54584d1ff3
+SHA512:
+  metadata.gz: 85d7de7b1f1a78f47bad178fdba8d2b27c39c4322cfc528e92436985c5f451488b9a92c2a14c6945b5b5d31315f940fad718091c73958ec98ec3696a79f9c7f5
+  data.tar.gz: c62fd7916b188a288e0d5ed8c0d5c97b7bad16811173ff11614a6302b3809a90eaf2293ac5677abb5a8b269114f1897f9d73082f38403877a0d6b909227474e3

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/misc.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="Remote-asdf: ruby-3.3.0-p0" project-jdk-type="RUBY_SDK" />
+</project>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/time_range_uniqueness.iml" filepath="$PROJECT_DIR$/.idea/time_range_uniqueness.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/time_range_uniqueness.iml

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.2, Remote-asdf: ruby-3.3.0-p0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.5.5, Remote-asdf: ruby-3.3.0-p0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="language_server-protocol (v3.17.0.3, Remote-asdf: ruby-3.3.0-p0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.1.1, Remote-asdf: ruby-3.3.0-p0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.13.0, Remote-asdf: ruby-3.3.0-p0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tzinfo (v2.0.6, Remote-asdf: ruby-3.3.0-p0) [gem]" level="application" />
+  </component>
+  <component name="RakeTasksCache-v2">
+    <option name="myRootTask">
+      <RakeTaskImpl id="rake">
+        <subtasks>
+          <RakeTaskImpl description="Build time_range_uniqueness-0.1.0.gem into the pkg directory" fullCommand="build" id="build" />
+          <RakeTaskImpl id="build">
+            <subtasks>
+              <RakeTaskImpl description="Generate SHA512 checksum if time_range_uniqueness-0.1.0.gem into the checksums directory" fullCommand="build:checksum" id="checksum" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
+          <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
+          <RakeTaskImpl description="Build and install time_range_uniqueness-0.1.0.gem into system gems" fullCommand="install" id="install" />
+          <RakeTaskImpl id="install">
+            <subtasks>
+              <RakeTaskImpl description="Build and install time_range_uniqueness-0.1.0.gem into system gems without network access" fullCommand="install:local" id="local" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Create tag v0.1.0 and build and push time_range_uniqueness-0.1.0.gem to rubygems.org" fullCommand="release[remote]" id="release[remote]" />
+          <RakeTaskImpl description="Run RuboCop" fullCommand="rubocop" id="rubocop" />
+          <RakeTaskImpl id="rubocop">
+            <subtasks>
+              <RakeTaskImpl description="Autocorrect RuboCop offenses (only when it's safe)" fullCommand="rubocop:autocorrect" id="autocorrect" />
+              <RakeTaskImpl description="Autocorrect RuboCop offenses (safe and unsafe)" fullCommand="rubocop:autocorrect_all" id="autocorrect_all" />
+              <RakeTaskImpl description="" fullCommand="rubocop:auto_correct" id="auto_correct" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Run RSpec code examples" fullCommand="spec" id="spec" />
+          <RakeTaskImpl description="" fullCommand="default" id="default" />
+          <RakeTaskImpl description="" fullCommand="release" id="release" />
+          <RakeTaskImpl id="release">
+            <subtasks>
+              <RakeTaskImpl description="" fullCommand="release:guard_clean" id="guard_clean" />
+              <RakeTaskImpl description="" fullCommand="release:rubygem_push" id="rubygem_push" />
+              <RakeTaskImpl description="" fullCommand="release:source_control_push" id="source_control_push" />
+            </subtasks>
+          </RakeTaskImpl>
+        </subtasks>
+      </RakeTaskImpl>
+    </option>
+  </component>
+</module>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,7 @@
+require:
+  - rubocop-performance
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 2.6
+  NewCops: enable

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2024-09-15
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 j-boers-13
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,109 @@
+# TimeRangeUniqueness
+
+**TimeRangeUniqueness** is a Ruby gem that provides ActiveRecord migrations and model validation to ensure that time ranges do not overlap within a table. It adds support for creating exclusion constraints on PostgreSQL `tstzrange` columns and validates the uniqueness of time ranges in models.
+
+## Features
+
+- **Migration Additions**: Adds a custom method for generating exclusion constraints on time range columns in PostgreSQL using `tstzrange`.
+- **Model Additions**: Adds validation to ensure time ranges do not overlap with existing records.
+- Supports optional scoping to ensure time ranges are unique within specified contexts (e.g., unique per event name).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'time_range_uniqueness'
+```
+
+Then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install time_range_uniqueness
+```
+
+## Usage
+
+### Migration Additions
+
+In your migrations, you can use the `add_time_range_uniqueness` method to add a time range column with an exclusion constraint. This will prevent overlapping time ranges in your table.
+
+```ruby
+class AddEventTimeRangeUniqueness < ActiveRecord::Migration[6.1]
+  def change
+    add_time_range_uniqueness :events,
+      with: :event_time_range,
+      scope: :event_name, # Optional scope
+      name: 'unique_event_time_ranges' # Optional custom constraint name
+  end
+end
+```
+
+#### Options:
+- `with`: **(Required)** The name of the column that stores the time range.
+- `scope`: **(Optional)** An array of columns to scope the uniqueness check (e.g., `:event_name`).
+- `name`: **(Optional)** The name of the exclusion constraint. If not provided, a default name is generated.
+- `column_type`: The time range column type will always be `tstzrange`.
+
+### Example
+
+```ruby
+class AddEventTimeRangeUniqueness < ActiveRecord::Migration[6.1]
+  def change
+    add_time_range_uniqueness :events, with: :event_time_range, scope: :event_name
+  end
+end
+```
+
+This example ensures that the `event_time_range` column in the `events` table is unique within the scope of the `event_name` column.
+
+### Model Additions
+
+The gem also provides model-level validation to ensure time ranges do not overlap. You can include this validation in your models like this:
+
+```ruby
+class Event < ApplicationRecord
+  validates_time_range_uniqueness(
+    with: :event_time_range,
+    scope: :event_name,
+    message: 'cannot overlap with an existing event'
+  )
+end
+```
+
+#### Options:
+- `with`: **(Required)** The name of the time range column to validate.
+- `scope`: **(Optional)** An array of columns to scope the uniqueness check (e.g., `:event_name`).
+- `message`: **(Optional)** A custom error message when validation fails (default: `'overlaps with an existing record'`).
+
+### Example
+
+```ruby
+class Event < ApplicationRecord
+  validates_time_range_uniqueness with: :event_time_range, scope: :event_name
+end
+```
+
+This example ensures that the `event_time_range` in the `Event` model does not overlap with other events with the same `event_name`.
+
+### PostgreSQL Requirements
+
+Ensure that your PostgreSQL instance has the `btree_gist` extension enabled. The gem will automatically attempt to enable this extension when applying the migration.
+
+```sql
+CREATE EXTENSION IF NOT EXISTS btree_gist;
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [https://github.com/your_username/time_range_uniqueness](https://github.com/your_username/time_range_uniqueness).
+
+## License
+
+The gem is available as open-source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new do |task|
+  task.requires << 'rubocop-performance'
+  task.requires << 'rubocop-rspec'
+end
+
+task default: %i[spec rubocop]

data/lib/time_range_uniqueness/migration_additions.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module TimeRangeUniqueness
+  # This module provides methods for adding and managing time range uniqueness
+  # constraints in ActiveRecord migrations.
+  #
+  # It allows you to add an exclusion constraint to ensure that time ranges do not
+  # overlap within a table.
+  #
+  # == Example
+  #
+  #   class AddEventTimeRangeUniqueness < ActiveRecord::Migration[6.1]
+  #     def change
+  #       add_time_range_uniqueness :events,
+  #         with: :event_time_range,
+  #         scope: :event_name,
+  #         column_type: :tstzrange,
+  #         name: 'unique_event_time_ranges'
+  #     end
+  #   end
+  #
+  # == Options
+  #
+  # * +:with+ - The name of the column that stores the time range (required).
+  # * +:scope+ - (Optional) An array of columns to scope the uniqueness check.
+  # * +:column_type+ - (Optional) The type of the time range column (default: :tstzrange).
+  # * +:name+ - (Optional) The name of the constraint.
+  #
+  # == Methods
+  #
+  # * +add_time_range_uniqueness(table, options = {})+ - Adds the time range column and the exclusion constraint.
+  # * +CommandRecorder+ - Records the `add_time_range_uniqueness` command so it can be replayed during rollback.
+  module MigrationAdditions
+    # Adds a time range column and an exclusion constraint to the specified table.
+    #
+    # This method creates or modifies a column to store time ranges and ensures that
+    # no two time ranges overlap for records with the same scoped columns.
+    #
+    # @param table [Symbol, String] The name of the table to which the time range uniqueness constraint will be added.
+    # @param options [Hash] The options for the constraint.
+    # @option options [Symbol] :with The name of the time range column.
+    # @option options [Array<Symbol>] :scope (Optional) Columns to scope the uniqueness check.
+    # @option options [Symbol] :column_type (Optional) The type of the time range column (default: :tstzrange).
+    # @option options [String] :name (Optional) The name of the constraint.
+    def add_time_range_uniqueness(table, options = {})
+      time_range_column = options[:with] || :time_range
+      scope_columns = Array(options[:scope])
+      column_type = :tstzrange
+      constraint_name = options[:name] || generate_constraint_name(table, scope_columns, time_range_column)
+
+      reversible do |dir|
+        dir.up { apply_up_migration(table, time_range_column, column_type, options, constraint_name, scope_columns) }
+        dir.down { apply_down_migration(table, time_range_column, constraint_name) }
+      end
+    end
+
+    private
+
+    # Applies the changes for the up migration.
+    #
+    # @param table [Symbol, String] The name of the table.
+    # @param time_range_column [Symbol] The time range column name.
+    # @param column_type [Symbol] The type of the column.
+    # @param options [Hash] Additional options for the column.
+    # @param constraint_name [String] The name of the constraint.
+    # @param scope_columns [Array<Symbol>] The columns used in the scope.
+    def apply_up_migration(table, time_range_column, column_type, options, constraint_name, scope_columns)
+      setup_extension
+      add_column_to_table(table, time_range_column, column_type, options)
+      add_exclusion_constraint(table, constraint_name, scope_columns, time_range_column)
+    end
+
+    # Applies the changes for the down migration.
+    #
+    # @param table [Symbol, String] The name of the table.
+    # @param time_range_column [Symbol] The time range column name.
+    # @param constraint_name [String] The name of the constraint.
+    def apply_down_migration(table, time_range_column, constraint_name)
+      remove_exclusion_constraint(table, constraint_name)
+      remove_column_from_table(table, time_range_column)
+    end
+
+    # Generates a default constraint name based on table and columns.
+    #
+    # @param table [Symbol, String] The name of the table.
+    # @param scope_columns [Array<Symbol>] The columns used in the scope.
+    # @param time_range_column [Symbol] The time range column name.
+    # @return [String] The generated constraint name.
+    def generate_constraint_name(table, scope_columns, time_range_column)
+      "exclude_#{table}_on_#{[scope_columns, time_range_column].flatten.join('_')}"
+    end
+
+    # Ensures the btree_gist extension is enabled.
+    def setup_extension
+      enable_extension 'btree_gist' unless extension_enabled?('btree_gist')
+    end
+
+    # Adds a column to the table if it does not exist.
+    #
+    # @param table [Symbol, String] The name of the table.
+    # @param time_range_column [Symbol] The time range column name.
+    # @param column_type [Symbol] The type of the column.
+    # @param options [Hash] Additional options for the column.
+    def add_column_to_table(table, time_range_column, column_type, options)
+      return if column_exists?(table, time_range_column)
+
+      add_column table, time_range_column, column_type, **options.slice(:null, :default)
+    end
+
+    # Adds an exclusion constraint to the table.
+    #
+    # @param table [Symbol, String] The name of the table.
+    # @param constraint_name [String] The name of the constraint.
+    # @param scope_columns [Array<Symbol>] The columns used in the scope.
+    # @param time_range_column [Symbol] The time range column name.
+    def add_exclusion_constraint(table, constraint_name, scope_columns, time_range_column)
+      columns = scope_columns.map { |col| "#{col} WITH =" }
+      columns << "#{time_range_column} WITH &&"
+      expression = columns.join(', ')
+
+      execute <<-SQL
+        ALTER TABLE #{table}
+        ADD CONSTRAINT #{constraint_name}
+        EXCLUDE USING GIST (#{expression});
+      SQL
+    end
+
+    # Removes an exclusion constraint from the table.
+    #
+    # @param table [Symbol, String] The name of the table.
+    # @param constraint_name [String] The name of the constraint.
+    def remove_exclusion_constraint(table, constraint_name)
+      execute <<-SQL
+        ALTER TABLE #{table}
+        DROP CONSTRAINT IF EXISTS #{constraint_name};
+      SQL
+    end
+
+    # Removes a column from the table if it exists.
+    #
+    # @param table [Symbol, String] The name of the table.
+    # @param time_range_column [Symbol] The time range column name.
+    def remove_column_from_table(table, time_range_column)
+      remove_column table, time_range_column if column_exists?(table, time_range_column)
+    end
+
+    # This module extends the ActiveRecord::Migration::CommandRecorder to record
+    # the custom `add_time_range_uniqueness` command so that it can be replayed
+    # during rollback operations.
+    module CommandRecorder
+      # Records the `add_time_range_uniqueness` command.
+      #
+      # @param table [Symbol, String] The name of the table.
+      # @param options [Hash] The options for the constraint.
+      def add_time_range_uniqueness(table, options = {})
+        # Record the command so it can be replayed during rollback
+        record(:add_time_range_uniqueness, table, options)
+      end
+    end
+  end
+end

data/lib/time_range_uniqueness/model_additions.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module TimeRangeUniqueness
+  # The `ModelAdditions` module provides a custom validation for ensuring that time ranges
+  # in ActiveRecord models are unique across records, optionally scoped by other columns.
+  #
+  # This module is intended to be included in ActiveRecord models and used to add
+  # validation methods to check for overlapping time ranges between records.
+  #
+  # == Example
+  #
+  #   class Event < ApplicationRecord
+  #     validates_time_range_uniqueness(
+  #       with: :event_time_range,
+  #       scope: :event_name,
+  #       message: 'cannot overlap with an existing event'
+  #     )
+  #   end
+  #
+  # This example ensures that the `event_time_range` column in the `Event` model does not overlap
+  # with other records having the same `event_name`. If a new event's time range overlaps, an
+  # error is added to the `event_time_range` field.
+  #
+  # == Options
+  #
+  # * +:with+ - The name of the time range column (required).
+  # * +:scope+ - (Optional) An array of columns to scope the uniqueness check (e.g., event name).
+  # * +:message+ - (Optional) A custom error message when validation fails. Defaults to
+  #   'overlaps with an existing record' if not provided.
+  #
+  # == Methods
+  #
+  # * +validates_time_range_uniqueness+ - Adds a validation for time range uniqueness.
+  # * +validate_records+ - Internal method to perform the validation.
+  # * +time_range_column_overlapping?+ - Internal method to check for overlapping time ranges.
+  #
+  # When included in an ActiveRecord model, this module adds the ability to ensure that
+  # the specified time range does not overlap with other records' time ranges, optionally
+  # scoped by additional fields.
+  module ModelAdditions
+    # Adds a custom validation method to ensure that the specified time range column
+    # is unique across all records, optionally scoped by other columns.
+    #
+    # Raises an ArgumentError if the +:with+ option is not specified.
+    #
+    # @param options [Hash] The options for the validation.
+    # @option options [Symbol] :with The name of the time range column.
+    # @option options [Array<Symbol>] :scope (Optional) Columns to scope the uniqueness check.
+    # @option options [String] :message (Optional) Custom error message when validation fails.
+    def validates_time_range_uniqueness(options = {})
+      raise ArgumentError, 'You must specify the :with option with the time range column name' unless options[:with]
+
+      time_range_column = options[:with]
+      scope_columns = Array(options[:scope])
+
+      validate_records(time_range_column, scope_columns, options)
+    end
+
+    private
+
+    # Defines the validation logic for ensuring time range uniqueness.
+    #
+    # This method is called internally by the validation and checks whether a record's
+    # time range overlaps with any other records, optionally scoped by other columns.
+    #
+    # @param time_range_column [Symbol] The name of the time range column.
+    # @param scope_columns [Array<Symbol>] The columns to scope the uniqueness check.
+    # @param options [Hash] The options for the validation.
+    def validate_records(time_range_column, scope_columns, options)
+      validate do
+        time_range = public_send(time_range_column)
+
+        next if time_range.nil?
+
+        relation = self.class.where.not(id: id)
+
+        scope_columns.each do |col|
+          relation = relation.where(col => public_send(col))
+        end
+
+        overlapping = time_range_column_overlapping?(relation, time_range_column, time_range)
+
+        errors.add(time_range_column, options[:message] || 'overlaps with an existing record') if overlapping
+      end
+    end
+
+    # Checks if the given time range overlaps with any existing records.
+    #
+    # This method performs the actual overlap check by querying the database using the
+    # GiST index for range data types in PostgreSQL.
+    #
+    # @param relation [ActiveRecord::Relation] The scope of records to check against.
+    # @param time_range_column [Symbol] The name of the time range column.
+    # @param time_range [Range] The time range to check for overlap.
+    # @return [Boolean] True if there is an overlap, false otherwise.
+    def time_range_column_overlapping?(relation, time_range_column, time_range)
+      relation.where(
+        "#{time_range_column} && tstzrange(?, ?, '[)')",
+        time_range.begin,
+        time_range.end
+      ).exists?
+    end
+  end
+end

data/lib/time_range_uniqueness/version.rb

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

data/lib/time_range_uniqueness.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative 'time_range_uniqueness/version'
+require 'active_record'
+require_relative 'time_range_uniqueness/migration_additions'
+require_relative 'time_range_uniqueness/model_additions'
+
+module TimeRangeUniqueness
+  class Error < StandardError; end
+
+  ActiveRecord::Migration::CommandRecorder.include TimeRangeUniqueness::MigrationAdditions::CommandRecorder
+
+  # Include migration additions into ActiveRecord::Migration
+  ActiveRecord::Migration.include TimeRangeUniqueness::MigrationAdditions
+end
+
+ActiveSupport.on_load(:active_record) do
+  ActiveRecord::Base.extend TimeRangeUniqueness::ModelAdditions
+  ActiveRecord::Base.include TimeRangeUniqueness::ModelAdditions
+end

data/time_range_uniqueness.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative 'lib/time_range_uniqueness/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'time_range_uniqueness'
+  spec.version = TimeRangeUniqueness::VERSION
+  spec.authors = ['j-boers-13']
+  spec.email = ['jeroen.boers1@gmail.com']
+
+  spec.summary = 'Easily set up time range uniqueness in Ruby On Rails.'
+  # spec.description = "TODO: Write a longer description or delete this line."
+  # spec.homepage = "TODO: Put your gem's website or public repo URL here."
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.6.0'
+
+  # 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 Gemfile])
+    end
+  end
+  spec.extra_rdoc_files = ['README.md']
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'activerecord', '>= 5.2', '< 8.0'
+  spec.add_dependency 'pg', '>= 0.18'
+
+  spec.add_development_dependency 'dotenv'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-performance'
+  spec.add_development_dependency 'rubocop-rspec'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: time_range_uniqueness
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- j-boers-13
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2024-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  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: 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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  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: rubocop-performance
+  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: rubocop-rspec
+  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'
+description: 
+email:
+- jeroen.boers1@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- ".idea/.gitignore"
+- ".idea/misc.xml"
+- ".idea/modules.xml"
+- ".idea/time_range_uniqueness.iml"
+- ".idea/vcs.xml"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/time_range_uniqueness.rb
+- lib/time_range_uniqueness/migration_additions.rb
+- lib/time_range_uniqueness/model_additions.rb
+- lib/time_range_uniqueness/version.rb
+- time_range_uniqueness.gemspec
+homepage: 
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.3
+signing_key: 
+specification_version: 4
+summary: Easily set up time range uniqueness in Ruby On Rails.
+test_files: []