solar_terms_24 1.0.0

data/lib/solar_terms_24/solar_term.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'i18n'
+require 'tzinfo'
+require 'json'
+
+I18n.load_path += Dir["#{File.dirname(__FILE__)}/locales/*.yml"]
+
+module SolarTerms24
+  # :nodoc:
+  class SolarTerm
+    attr_accessor :solar_term_key, :timezone, :lang
+    attr_reader :time
+
+    def initialize(solar_term_key, time, timezone: 'UTC', lang: :en)
+      @solar_term_key = solar_term_key
+      @time = time
+      @timezone = timezone
+      @lang = lang
+    end
+
+    def datetime
+      tz = TZInfo::Timezone.get(@timezone)
+      tz.to_local(@time)
+    end
+
+    def date
+      datetime.to_date
+    end
+
+    def name
+      I18n.locale = @lang
+      I18n.t(@solar_term_key)
+    end
+
+    def as_json
+      {
+        date: date.strftime('%Y-%m-%d'),
+        datetime: datetime.strftime(SolarTerms24::Cache::TIME_FORMAT),
+        lang: @lang,
+        name: name,
+        solar_term_key: @solar_term_key,
+        timezone: @timezone
+      }
+    end
+
+    def to_json
+      JSON.pretty_generate(as_json)
+    end
+  end
+end

data/lib/solar_terms_24/solar_terms.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'tzinfo'
+
+module SolarTerms24
+  # :nodoc:
+  class SolarTerms
+    attr_accessor :year, :timezone, :lang
+    attr_reader :solar_terms
+
+    def initialize(year, timezone: 'UTC', lang: :en)
+      @year = year
+      @timezone = timezone
+      @lang = lang
+
+      if SolarTerms24::Cache.has?(year)
+        data = SolarTerms24::Cache.load(year)
+      else
+        data = SolarTerms24::Horizons.find_solar_terms_times(year)
+        SolarTerms24::Cache.save(year, data)
+      end
+
+      @solar_terms = data.each_key.each_with_object({}) do |key, h|
+        h[key.to_sym] = SolarTerms24::SolarTerm.new(key.to_sym, data[key], timezone: timezone, lang: lang)
+      end
+    end
+
+    ::SolarTerms24::Horizons::SOLAR_TERMS.each_key do |key|
+      define_method(key) { instance_variable_get('@solar_terms')[key] }
+    end
+
+    def change_timezone(timezone)
+      @timezone = timezone
+      @solar_terms.each_value do |solar_term|
+        solar_term.timezone = timezone
+      end
+    end
+
+    def change_lang(lang)
+      @lang = lang
+      @solar_terms.each_value do |solar_term|
+        solar_term.lang = lang
+      end
+    end
+
+    def dates
+      @solar_terms.map { |_, v| v.date }.sort
+    end
+
+    def to_json
+      JSON.pretty_generate(
+        year: @year,
+        timezone: @timezone,
+        lang: @lang,
+        solar_terms: @solar_terms.transform_values(&:as_json)
+      )
+    end
+  end
+end

data/lib/solar_terms_24/version.rb

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

data/lib/solar_terms_24.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative 'solar_terms_24/version'
+require_relative 'solar_terms_24/horizons'
+require_relative 'solar_terms_24/cache'
+require_relative 'solar_terms_24/solar_term'
+require_relative 'solar_terms_24/solar_terms'
+require_relative 'solar_terms_24/cli'
+
+module SolarTerms24
+  class Error < StandardError; end
+end

data/sig/horizons_solar_terms.rbs

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

metadata

@@ -0,0 +1,382 @@
+--- !ruby/object:Gem::Specification
+name: solar_terms_24
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- kevinluo201
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2022-12-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  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: thor
+  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: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: It uses JPL Horizons System API to calculate the accurate solar terms'
+  times and can translate them into different timezones and languages.
+email:
+- kevin.luo@hey.com
+executables:
+- solar_terms_24
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- Timezones.md
+- exe/solar_terms_24
+- lib/solar_terms_24.rb
+- lib/solar_terms_24/cache.rb
+- lib/solar_terms_24/cli.rb
+- lib/solar_terms_24/db/1900.json
+- lib/solar_terms_24/db/1901.json
+- lib/solar_terms_24/db/1902.json
+- lib/solar_terms_24/db/1903.json
+- lib/solar_terms_24/db/1904.json
+- lib/solar_terms_24/db/1905.json
+- lib/solar_terms_24/db/1906.json
+- lib/solar_terms_24/db/1907.json
+- lib/solar_terms_24/db/1908.json
+- lib/solar_terms_24/db/1909.json
+- lib/solar_terms_24/db/1910.json
+- lib/solar_terms_24/db/1911.json
+- lib/solar_terms_24/db/1912.json
+- lib/solar_terms_24/db/1913.json
+- lib/solar_terms_24/db/1914.json
+- lib/solar_terms_24/db/1915.json
+- lib/solar_terms_24/db/1916.json
+- lib/solar_terms_24/db/1917.json
+- lib/solar_terms_24/db/1918.json
+- lib/solar_terms_24/db/1919.json
+- lib/solar_terms_24/db/1920.json
+- lib/solar_terms_24/db/1921.json
+- lib/solar_terms_24/db/1922.json
+- lib/solar_terms_24/db/1923.json
+- lib/solar_terms_24/db/1924.json
+- lib/solar_terms_24/db/1925.json
+- lib/solar_terms_24/db/1926.json
+- lib/solar_terms_24/db/1927.json
+- lib/solar_terms_24/db/1928.json
+- lib/solar_terms_24/db/1929.json
+- lib/solar_terms_24/db/1930.json
+- lib/solar_terms_24/db/1931.json
+- lib/solar_terms_24/db/1932.json
+- lib/solar_terms_24/db/1933.json
+- lib/solar_terms_24/db/1934.json
+- lib/solar_terms_24/db/1935.json
+- lib/solar_terms_24/db/1936.json
+- lib/solar_terms_24/db/1937.json
+- lib/solar_terms_24/db/1938.json
+- lib/solar_terms_24/db/1939.json
+- lib/solar_terms_24/db/1940.json
+- lib/solar_terms_24/db/1941.json
+- lib/solar_terms_24/db/1942.json
+- lib/solar_terms_24/db/1943.json
+- lib/solar_terms_24/db/1944.json
+- lib/solar_terms_24/db/1945.json
+- lib/solar_terms_24/db/1946.json
+- lib/solar_terms_24/db/1947.json
+- lib/solar_terms_24/db/1948.json
+- lib/solar_terms_24/db/1949.json
+- lib/solar_terms_24/db/1950.json
+- lib/solar_terms_24/db/1951.json
+- lib/solar_terms_24/db/1952.json
+- lib/solar_terms_24/db/1953.json
+- lib/solar_terms_24/db/1954.json
+- lib/solar_terms_24/db/1955.json
+- lib/solar_terms_24/db/1956.json
+- lib/solar_terms_24/db/1957.json
+- lib/solar_terms_24/db/1958.json
+- lib/solar_terms_24/db/1959.json
+- lib/solar_terms_24/db/1960.json
+- lib/solar_terms_24/db/1961.json
+- lib/solar_terms_24/db/1962.json
+- lib/solar_terms_24/db/1963.json
+- lib/solar_terms_24/db/1964.json
+- lib/solar_terms_24/db/1965.json
+- lib/solar_terms_24/db/1966.json
+- lib/solar_terms_24/db/1967.json
+- lib/solar_terms_24/db/1968.json
+- lib/solar_terms_24/db/1969.json
+- lib/solar_terms_24/db/1970.json
+- lib/solar_terms_24/db/1971.json
+- lib/solar_terms_24/db/1972.json
+- lib/solar_terms_24/db/1973.json
+- lib/solar_terms_24/db/1974.json
+- lib/solar_terms_24/db/1975.json
+- lib/solar_terms_24/db/1976.json
+- lib/solar_terms_24/db/1977.json
+- lib/solar_terms_24/db/1978.json
+- lib/solar_terms_24/db/1979.json
+- lib/solar_terms_24/db/1980.json
+- lib/solar_terms_24/db/1981.json
+- lib/solar_terms_24/db/1982.json
+- lib/solar_terms_24/db/1983.json
+- lib/solar_terms_24/db/1984.json
+- lib/solar_terms_24/db/1985.json
+- lib/solar_terms_24/db/1986.json
+- lib/solar_terms_24/db/1987.json
+- lib/solar_terms_24/db/1988.json
+- lib/solar_terms_24/db/1989.json
+- lib/solar_terms_24/db/1990.json
+- lib/solar_terms_24/db/1991.json
+- lib/solar_terms_24/db/1992.json
+- lib/solar_terms_24/db/1993.json
+- lib/solar_terms_24/db/1994.json
+- lib/solar_terms_24/db/1995.json
+- lib/solar_terms_24/db/1996.json
+- lib/solar_terms_24/db/1997.json
+- lib/solar_terms_24/db/1998.json
+- lib/solar_terms_24/db/1999.json
+- lib/solar_terms_24/db/2000.json
+- lib/solar_terms_24/db/2001.json
+- lib/solar_terms_24/db/2002.json
+- lib/solar_terms_24/db/2003.json
+- lib/solar_terms_24/db/2004.json
+- lib/solar_terms_24/db/2005.json
+- lib/solar_terms_24/db/2006.json
+- lib/solar_terms_24/db/2007.json
+- lib/solar_terms_24/db/2008.json
+- lib/solar_terms_24/db/2009.json
+- lib/solar_terms_24/db/2010.json
+- lib/solar_terms_24/db/2011.json
+- lib/solar_terms_24/db/2012.json
+- lib/solar_terms_24/db/2013.json
+- lib/solar_terms_24/db/2014.json
+- lib/solar_terms_24/db/2015.json
+- lib/solar_terms_24/db/2016.json
+- lib/solar_terms_24/db/2017.json
+- lib/solar_terms_24/db/2018.json
+- lib/solar_terms_24/db/2019.json
+- lib/solar_terms_24/db/2020.json
+- lib/solar_terms_24/db/2021.json
+- lib/solar_terms_24/db/2022.json
+- lib/solar_terms_24/db/2023.json
+- lib/solar_terms_24/db/2024.json
+- lib/solar_terms_24/db/2025.json
+- lib/solar_terms_24/db/2026.json
+- lib/solar_terms_24/db/2027.json
+- lib/solar_terms_24/db/2028.json
+- lib/solar_terms_24/db/2029.json
+- lib/solar_terms_24/db/2030.json
+- lib/solar_terms_24/db/2031.json
+- lib/solar_terms_24/db/2032.json
+- lib/solar_terms_24/db/2033.json
+- lib/solar_terms_24/db/2034.json
+- lib/solar_terms_24/db/2035.json
+- lib/solar_terms_24/db/2036.json
+- lib/solar_terms_24/db/2037.json
+- lib/solar_terms_24/db/2038.json
+- lib/solar_terms_24/db/2039.json
+- lib/solar_terms_24/db/2040.json
+- lib/solar_terms_24/db/2041.json
+- lib/solar_terms_24/db/2042.json
+- lib/solar_terms_24/db/2043.json
+- lib/solar_terms_24/db/2044.json
+- lib/solar_terms_24/db/2045.json
+- lib/solar_terms_24/db/2046.json
+- lib/solar_terms_24/db/2047.json
+- lib/solar_terms_24/db/2048.json
+- lib/solar_terms_24/db/2049.json
+- lib/solar_terms_24/db/2050.json
+- lib/solar_terms_24/db/2051.json
+- lib/solar_terms_24/db/2052.json
+- lib/solar_terms_24/db/2053.json
+- lib/solar_terms_24/db/2054.json
+- lib/solar_terms_24/db/2055.json
+- lib/solar_terms_24/db/2056.json
+- lib/solar_terms_24/db/2057.json
+- lib/solar_terms_24/db/2058.json
+- lib/solar_terms_24/db/2059.json
+- lib/solar_terms_24/db/2060.json
+- lib/solar_terms_24/db/2061.json
+- lib/solar_terms_24/db/2062.json
+- lib/solar_terms_24/db/2063.json
+- lib/solar_terms_24/db/2064.json
+- lib/solar_terms_24/db/2065.json
+- lib/solar_terms_24/db/2066.json
+- lib/solar_terms_24/db/2067.json
+- lib/solar_terms_24/db/2068.json
+- lib/solar_terms_24/db/2069.json
+- lib/solar_terms_24/db/2070.json
+- lib/solar_terms_24/db/2071.json
+- lib/solar_terms_24/db/2072.json
+- lib/solar_terms_24/db/2073.json
+- lib/solar_terms_24/db/2074.json
+- lib/solar_terms_24/db/2075.json
+- lib/solar_terms_24/db/2076.json
+- lib/solar_terms_24/db/2077.json
+- lib/solar_terms_24/db/2078.json
+- lib/solar_terms_24/db/2079.json
+- lib/solar_terms_24/db/2080.json
+- lib/solar_terms_24/db/2081.json
+- lib/solar_terms_24/db/2082.json
+- lib/solar_terms_24/db/2083.json
+- lib/solar_terms_24/db/2084.json
+- lib/solar_terms_24/db/2085.json
+- lib/solar_terms_24/db/2086.json
+- lib/solar_terms_24/db/2087.json
+- lib/solar_terms_24/db/2088.json
+- lib/solar_terms_24/db/2089.json
+- lib/solar_terms_24/db/2090.json
+- lib/solar_terms_24/db/2091.json
+- lib/solar_terms_24/db/2092.json
+- lib/solar_terms_24/db/2093.json
+- lib/solar_terms_24/db/2094.json
+- lib/solar_terms_24/db/2095.json
+- lib/solar_terms_24/db/2096.json
+- lib/solar_terms_24/db/2097.json
+- lib/solar_terms_24/db/2098.json
+- lib/solar_terms_24/db/2099.json
+- lib/solar_terms_24/db/2100.json
+- lib/solar_terms_24/horizons.rb
+- lib/solar_terms_24/locales/en.yml
+- lib/solar_terms_24/locales/ja.yml
+- lib/solar_terms_24/locales/ko.yml
+- lib/solar_terms_24/locales/vi.yml
+- lib/solar_terms_24/locales/zh-CN.yml
+- lib/solar_terms_24/locales/zh-TW.yml
+- lib/solar_terms_24/solar_term.rb
+- lib/solar_terms_24/solar_terms.rb
+- lib/solar_terms_24/version.rb
+- sig/horizons_solar_terms.rbs
+homepage: https://github.com/kevinluo201/solar_terms_24
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/kevinluo201/solar_terms_24
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: "`solar_terms_24` calculates and collects 24 solar terms each year."
+test_files: []