uk_academic_calendar 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 71d754790b2fdbde926c3ba208b5e860d00d5e1804ea07c74bab60d9478807d4
+  data.tar.gz: 4bbc74989d5cffb7e3fda1789a01112e45379474b0b4e6cad8e3645e8f75a507
+SHA512:
+  metadata.gz: 89aadec469b4df7320211d795dbf992c7e55083f486f8767dd6083d236d0f5a3ba8208654861545d2fe0ab60022bccd51ed0deb501cbd64f94ae88f10722f672
+  data.tar.gz: 163abbbdde711855ab3e6218278a61d84b58c83025c74dc397dd346662498de48009f7761f3692f36c0b6b661dac7ab892d0f577cb014da8a1a0a3b9feffc622

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,22 @@
+AllCops:
+  TargetRubyVersion: 2.6
+  NewCops: enable
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Style/SymbolArray:
+  EnforcedStyle: brackets
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/BlockLength:
+  Exclude:
+    - '*.gemspec'
+    - 'spec/**/*.rb'

data/.ruby-version

@@ -0,0 +1 @@
+3.2.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Matthew Smith
+
+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,63 @@
+# UKAcademicCalendar
+
+Designed to assist in Ruby programs dealing with the UK Academic Calendar, i.e. the Sept - Sept academic year, and the 3 'terms' (Autumn, Spring, Summer).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'uk_academic_calendar'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install uk_academic_calendar
+
+## Usage
+
+```ruby
+require 'uk_academic_calendar'
+
+# Assuming today is 20th Jan 2024
+Date.today.academic_year #=> 2023
+Date.today.beginning_of_academic_year #=> 2023-09-01
+Date.today.end_of_academic_year #=> 2024-08-31
+# or...
+Time.now.academic_year #=> 2023
+Time.now.beginning_of_academic_year #=> 2023-09-01 00:00:00 +0100
+Time.now.end_of_academic_year #=> 2024-08-31 23:59:59.999999999 +0100
+
+term_now = Date.today.academic_term #=> Spring 2023/2024
+term_now.start_date #=> 2024-01-01
+term_now.end_date #=> 2024-03-31, i.e. Easter Sunday
+term_now.start_date = '2025-01-01' #=> raises #UKAcademicCalendar::InvalidTermStart error
+term_now.to_range #=> (2024-01-01..2024-03-31)
+term_now.all_dates #=> #<SortedSet:{Mon, 01 Jan 2024...}
+```
+
+See rubydoc [docs](https://www.rubydoc.info/github/m-smiff/uk_academic_calendar/main) for full details on the API (with help from Yard).
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## TODO
+
+- Further granularity around the 'teachable', and inversely, 'unteachable' days within a term (e.g. adding bank holidays/inset days etc)
+- Considering the above, implementation of e.g., `#teachable_days` and `#non_teachable_days` returning sorted sets of applicable dates
+- Setting of 'contexts' so terms understand what dates to apply for a given 'context' (e.g. a particular local authority)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/uk_academic_calendar.
+
+## 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,12 @@
+# 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
+
+task default: [:spec, :rubocop]

data/lib/uk_academic_calendar/autumn_term.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'term'
+
+module UKAcademicCalendar
+  # Concrete class allowing instantiation of instances of an Autumn term, for a given academic year
+  class AutumnTerm < Term
+    # @return [Date] Sep 1st
+    def nominal_start_date
+      @nominal_start_date ||= Date.today.beginning_of_academic_year.change(year: academic_year)
+    end
+
+    # @return [Date] Dec 31st
+    def nominal_end_date
+      @nominal_end_date ||= nominal_start_date.end_of_year
+    end
+  end
+end

data/lib/uk_academic_calendar/core_ext/date.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/date'
+require_relative '../mixins/date_and_time_instance_methods'
+
+class Date
+  # includes "UKAcademicCalendar::DateAndTimeInstanceMethods"
+  # @!parse include UKAcademicCalendar::DateAndTimeInstanceMethods
+  include UKAcademicCalendar::DateAndTimeInstanceMethods
+end

data/lib/uk_academic_calendar/core_ext/integer.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative '../mixins/succ_slashable'
+
+class Integer
+  # prepends "UKAcademicCalendar::SuccSlashable"
+  # @!parse prepend UKAcademicCalendar::SuccSlashable
+  prepend UKAcademicCalendar::SuccSlashable
+end

data/lib/uk_academic_calendar/core_ext/time.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/time'
+require_relative '../mixins/date_and_time_instance_methods'
+
+class Time
+  # includes "UKAcademicCalendar::DateAndTimeInstanceMethods"
+  # @!parse include UKAcademicCalendar::DateAndTimeInstanceMethods
+  include UKAcademicCalendar::DateAndTimeInstanceMethods
+end

data/lib/uk_academic_calendar/errors/error.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module UKAcademicCalendar
+  class Error < StandardError; end
+end

data/lib/uk_academic_calendar/errors/invalid_term_bound.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative 'error'
+
+module UKAcademicCalendar
+  # Error class raised when a concrete term class is deemed to have an invalid date-bound
+  class InvalidTermBound < Error
+    def initialize(date, comparand)
+      @date = date
+      @comparand = comparand
+      super(message)
+    end
+
+    # @return [String]
+    def message
+      "#{@date} is invalid. Must be #{comparison_qualifier} #{@comparand}"
+    end
+
+    private
+
+    def comparison_qualifier
+      @comparand.instance_of?(Range) && 'within'
+    end
+  end
+end

data/lib/uk_academic_calendar/errors/invalid_term_end.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative 'invalid_term_bound'
+
+module UKAcademicCalendar
+  # @see InvalidTermBound
+  class InvalidTermEnd < InvalidTermBound
+    private
+
+    def comparison_qualifier
+      super || '>'
+    end
+  end
+end

data/lib/uk_academic_calendar/errors/invalid_term_start.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative 'invalid_term_bound'
+
+module UKAcademicCalendar
+  # @see InvalidTermBound
+  class InvalidTermStart < InvalidTermBound
+    private
+
+    def comparison_qualifier
+      super || '<'
+    end
+  end
+end

data/lib/uk_academic_calendar/mixins/date_and_time_instance_methods.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module UKAcademicCalendar
+  # Mixin included in Date and Time classes providing academic year related instance methods
+  module DateAndTimeInstanceMethods
+    # @return [Integer] integer representing the calendar year within the academic year started in
+    # @example
+    #   Date.new(2024, 8, 31).academic_year #=> 2023
+    #   Time.new(2024, 9, 1, 12).academic_year #=> 2024
+    def academic_year
+      return year if yday >= start_yday
+
+      year - 1
+    end
+
+    # @return [#to_date] instance of self.class representing the beginning of the academic year
+    # @example
+    #   Date.new(2024, 8, 31).beginning_of_academic_year #=> 2023-09-01
+    #   Time.new(2024, 9, 1, 12).beginning_of_academic_year #=> 2024-09-01 00:00:00 +0100
+    def beginning_of_academic_year
+      shifted = change(year: academic_year, month: YEAR_OFFSET_START_MONTH, day: 1)
+      return shifted unless acts_like? :time
+
+      shifted.beginning_of_day
+    end
+
+    # @return [#to_date] instance of self.class representing the end of the academic year
+    # @example
+    #   Date.new(2024, 8, 31).end_of_academic_year #=> 2024-08-31
+    #   Time.new(2024, 9, 1, 12).end_of_academic_year #=> 2025-08-31 23:59:59.999999999 +0100
+    def end_of_academic_year
+      shifted = beginning_of_academic_year.next_year.prev_day
+      return shifted unless acts_like? :time
+
+      shifted.end_of_day
+    end
+
+    # @return [Integer] integer representing the month of the academic year including self
+    # @example
+    #   Date.new(2024, 8, 31).academic_year_month #=> 12
+    #   Time.new(2024, 11, 1, 12).academic_year_month #=> 3
+    def academic_year_month
+      ac_yr_start_month = YEAR_OFFSET_START_MONTH
+      ((month - ac_yr_start_month) % 12) + 1
+    end
+
+    # @return [UKAcademicCalendar::AutumnTerm, UKAcademicCalendar::SpringTerm, UKAcademicCalendar::SummerTerm]
+    #   term object including self
+    # @example
+    #   Date.new(2024, 8, 31).academic_term #=> Summer 2023/2024
+    #   Time.new(2024, 11, 1, 12).academic_term #=> Autumn 2024/2025
+    def academic_term
+      UKAcademicCalendar.term_including self
+    end
+
+    # @return [#to_date] instance of self.class representing the beginning of the academic term including self
+    # @example
+    #   Date.new(2024, 2, 25).beginning_of_academic_term #=> 2024-01-01
+    #   Time.new(2024, 9, 1, 12).beginning_of_academic_term #=> 2024-09-01 00:00:00 +0100
+    def beginning_of_academic_term
+      term_start = academic_term.start_date
+      shifted = change(year: term_start.year, month: term_start.month, day: term_start.day)
+      return shifted unless acts_like? :time
+
+      shifted.beginning_of_day
+    end
+
+    # @return [#to_date] instance of self.class representing the end of the academic term including self
+    # @example
+    #   Date.new(2024, 11, 25).end_of_academic_term #=> 2024-12-31
+    #   Time.new(2024, 7, 1, 12).end_of_academic_term #=> 2024-08-31 23:59:999999999 +0100
+    def end_of_academic_term
+      term_end = academic_term.end_date
+      shifted = change(year: term_end.year, month: term_end.month, day: term_end.day)
+      return shifted unless acts_like? :time
+
+      shifted.end_of_day
+    end
+
+    private
+
+    def start_yday
+      self.class.new(year, YEAR_OFFSET_START_MONTH, 1).yday
+    end
+  end
+end

data/lib/uk_academic_calendar/mixins/succ_slashable.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module UKAcademicCalendar
+  # Mixin included in Integer class
+  module SuccSlashable
+    # @param base [Integer]
+    # @param slash_succ [Boolean] option specifying whether to leverage the "slash_succ" option
+    # @return [String] string where self is concatenated with the value succeeding self, seperated by a forward slash
+    # @example
+    #   2023.to_s(slash_succ: true) #=> "2023/2024"
+    def to_s(base = 10, slash_succ: false)
+      if slash_succ
+        "#{to_i}/#{to_i.succ}"
+      else
+        super(base)
+      end
+    end
+  end
+end

data/lib/uk_academic_calendar/spring_term.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'term'
+
+module UKAcademicCalendar
+  # Concrete class allowing instantiation of instances of an spring term, for a given academic year
+  class SpringTerm < Term
+    # @return [Date] Jan 1st
+    def nominal_start_date
+      nominal_end_date.beginning_of_year
+    end
+
+    # @return [Date] Easter Sunday
+    def nominal_end_date
+      Easter.easter(academic_year + 1)
+    end
+  end
+end

data/lib/uk_academic_calendar/summer_term.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'term'
+
+module UKAcademicCalendar
+  # Concrete class allowing instantiation of instances of an Summer term, for a given academic year
+  class SummerTerm < Term
+    # @return [Date] the Monday after Easter Sunday
+    def nominal_start_date
+      Easter.easter(academic_year + 1).next_day
+    end
+
+    # @return [Date] Aug 31st
+    def nominal_end_date
+      nominal_start_date.end_of_academic_year
+    end
+  end
+end

data/lib/uk_academic_calendar/term.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require 'abstract_class'
+require 'easter'
+require 'forwardable'
+require 'sorted_set'
+
+require_relative 'errors/invalid_term_start'
+require_relative 'errors/invalid_term_end'
+
+module UKAcademicCalendar
+  # Abstract class representing blueprint behaviour for academic terms, bounded by writeable start and end dates
+  class Term
+    extend AbstractClass
+
+    extend Forwardable
+    # @!method include?
+    #   Forwards to Range
+    #   @see Range#include?
+    # @!method each
+    #   Forwards to Range
+    #   @see Range#each
+    def_delegators :to_range, :include?, :each
+
+    # @param academic_year [Integer]
+    # @return [UKAcademicCalendar::AutumnTerm, UKAcademicCalendar::SpringTerm, UKAcademicCalendar::SummerTerm]
+    def initialize(academic_year)
+      @academic_year = academic_year
+      @season = extract_season_from_class_name
+      @start_date = nominal_start_date
+      @end_date = nominal_end_date
+    end
+
+    # @return [Integer] the calendar year within which the term's academic year starts in
+    attr_reader :academic_year
+    # @overload start_date
+    # @overload start_date=(value)
+    # Sets value to @start_date, first going through validation
+    # @param val [#to_date, nil] the start date of the term. If nil given, falls back to #nominal_start_date
+    # @return [Date] assigned date value
+    # @raise [UKAcademicCalendar::InvalidTermStart, UKAcademicCalendar::InvalidTermEnd] if the assigned date is
+    #   considered invalid
+    attr_accessor :start_date
+    # @overload end_date
+    # @overload end_date=(value)
+    # Sets value to @end_date, first going through validation
+    # @param val [#to_date, nil] the end date of the term. If nil given, falls back to #nominal_end_date
+    # @return [Date] assigned date value
+    # @raise [UKAcademicCalendar::InvalidTermStart, UKAcademicCalendar::InvalidTermEnd] if the assigned date is
+    #   considered invalid
+    attr_accessor :end_date
+    # @return [Symbol] the name of the season the term spans
+    attr_reader :season
+
+    # @return [Integer] the integer hash value for self
+    def hash
+      [self.class, academic_year, start_date, end_date].hash
+    end
+
+    # @param other [#hash] any object that responds to `#hash`
+    # @return [Boolean] true if self and other are of the same class, academic_year, and have eql start and end dates.
+    #   Otherwise returns false.
+    def eql?(other)
+      hash == other.hash
+    end
+    alias == eql?
+
+    # @return [String] prettified string describing the term, e.g. "Summer 2023/2024"
+    # @example
+    #   term = UKAcademicCalendar::SummerTerm 2023
+    #   term.to_s #=> "Summer 2023/2024"
+    def to_s
+      "#{season.to_s.titleize} #{academic_year.to_s(slash_succ: true)}"
+    end
+
+    def inspect
+      to_s
+    end
+
+    def start_date=(val) # rubocop:disable Lint/DuplicateMethods
+      @start_date = validate_date(val&.to_date, :start)
+    end
+
+    def end_date=(val) # rubocop:disable Lint/DuplicateMethods
+      @end_date = validate_date(val&.to_date, :end)
+    end
+
+    # @return [Range] range bounded by start and end dates, end inclusive
+    def to_range
+      start_date..end_date
+    end
+
+    # @return [SortedSet<Date>] sorted set of dates making up the term
+    def all_dates
+      SortedSet.new(to_range.to_a)
+    end
+
+    private
+
+    def extract_season_from_class_name
+      self.class.to_s.demodulize[/(.*)Term\z/, 1].downcase.to_sym
+    end
+
+    def validate_date(date, bound)
+      return public_send(:"nominal_#{bound}_date") unless date.present?
+
+      # First validate the date is within bounds...
+      validate_within_bounds(date, nominal_start_date..nominal_end_date, bound)
+      # ...then validate the dates are in acceptable (i.e. start < end) sequence
+      validate_sequence(date, bound)
+
+      date
+    end
+
+    def validate_within_bounds(date, range, date_bound)
+      return if date.in? range
+
+      raise date_error_class(date_bound).new(date, range)
+    end
+
+    def validate_sequence(date, date_bound)
+      operator, comparand = date_bound == :start ? [:<, :end_date] : [:>, :start_date]
+      # Assuming this is for :start_date, return if #start_date == nil OR date < #end_date
+      return if send(comparand).nil? || date.send(operator, send(comparand))
+
+      raise date_error_class(date_bound).new(date, send(comparand))
+    end
+
+    def date_error_class(date_bound)
+      case date_bound
+      when :start then InvalidTermStart
+      when :end then InvalidTermEnd
+      end
+    end
+  end
+end

data/lib/uk_academic_calendar/version.rb

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

data/lib/uk_academic_calendar.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'uk_academic_calendar/version'
+
+require 'uk_academic_calendar/core_ext/date'
+require 'uk_academic_calendar/core_ext/time'
+require 'uk_academic_calendar/core_ext/integer'
+require 'uk_academic_calendar/autumn_term'
+require 'uk_academic_calendar/spring_term'
+require 'uk_academic_calendar/summer_term'
+
+require 'active_support/core_ext/class/subclasses'
+require 'active_support/core_ext/object/inclusion'
+
+# Top-level namespace, itself implementing a number of constants and module methods documented below.
+module UKAcademicCalendar
+  # The month-number corresponding to the first month within the calendar year that the academic year starts in.
+  YEAR_OFFSET_START_MONTH = 9 # September
+  # The season-names designating the 3 terms.
+  SEASONS = [:autumn, :spring, :summer].freeze
+
+  class << self
+    # @!method autumn_term
+    # @param academic_year [Integer] the calendar year the academic year starts in.
+    # @return [UKAcademicCalendar::AutumnTerm] instance of Autumn term.
+
+    # @!method spring_term
+    # @param academic_year [Integer] the calendar year the academic year starts in.
+    # @return [UKAcademicCalendar::SpringTerm] instance of Spring term.
+
+    # @!method summer_term
+    # @param academic_year [Integer] the calendar year the academic year starts in.
+    # @return [UKAcademicCalendar::SummerTerm] instance of Summer term.
+    SEASONS.each do |season|
+      define_method(:"#{season}_term") do |academic_year|
+        klass = Term.descendants.find { |c| c.to_s.demodulize.downcase.start_with? season.to_s }
+        klass.new(academic_year)
+      end
+    end
+
+    # @param academic_year [Integer] the calendar year the academic year starts in.
+    # @return [Array(UKAcademicCalendar::AutumnTerm, UKAcademicCalendar::SpringTerm, UKAcademicCalendar::SummerTerm)]
+    #   array containing ordered instances of Autumn, Spring and Summer term.
+    def all_terms(academic_year)
+      SEASONS.map { |term_name| public_send(:"#{term_name}_term", academic_year) }
+    end
+
+    # Convenience method for retrieving the term object including Date.today
+    # @return [UKAcademicCalendar::AutumnTerm, UKAcademicCalendar::SpringTerm, UKAcademicCalendar::SummerTerm] instance
+    #   of Autumn/Spring/Summer term deemed to contain today's date.
+    def term_now
+      term_including
+    end
+
+    # @param val [#to_date]
+    # @return [UKAcademicCalendar::AutumnTerm, UKAcademicCalendar::SpringTerm, UKAcademicCalendar::SummerTerm] instance
+    #   of Autumn/Spring/Summer term deemed to contain date param.
+    def term_including(val = Date.today)
+      date = val.to_date
+      all_terms(date.academic_year).find { |term| date.in? term }
+    end
+  end
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: uk_academic_calendar
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Matt
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-02-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: abstract_class
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: easter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: sorted_set
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Designed to assist in Ruby programs dealing with the UK Academic Calendar
+email:
+- jetnova@pm.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/uk_academic_calendar.rb
+- lib/uk_academic_calendar/autumn_term.rb
+- lib/uk_academic_calendar/core_ext/date.rb
+- lib/uk_academic_calendar/core_ext/integer.rb
+- lib/uk_academic_calendar/core_ext/time.rb
+- lib/uk_academic_calendar/errors/error.rb
+- lib/uk_academic_calendar/errors/invalid_term_bound.rb
+- lib/uk_academic_calendar/errors/invalid_term_end.rb
+- lib/uk_academic_calendar/errors/invalid_term_start.rb
+- lib/uk_academic_calendar/mixins/date_and_time_instance_methods.rb
+- lib/uk_academic_calendar/mixins/succ_slashable.rb
+- lib/uk_academic_calendar/spring_term.rb
+- lib/uk_academic_calendar/summer_term.rb
+- lib/uk_academic_calendar/term.rb
+- lib/uk_academic_calendar/version.rb
+homepage: https://www.github.com/m-smiff/uk_academic_calendar
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://www.github.com/m-smiff/uk_academic_calendar
+  documentation_uri: https://www.rubydoc.info/github/m-smiff/uk_academic_calendar/main
+  source_code_uri: https://www.github.com/m-smiff/uk_academic_calendar
+  changelog_uri: https://www.github.com/m-smiff/uk_academic_calendar
+  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.5
+signing_key:
+specification_version: 4
+summary: UK Academic Calendar
+test_files: []