moon_phase_tracker 1.3.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3fbc22c1b9f3481bd4585f49394696bea4bbef56302467bc0d9433bc17f6c179
+  data.tar.gz: bd9d8566042eb8d1dccc4ab8ce66de2e6542e9103e3c2732ee45c0f467c98e3d
+SHA512:
+  metadata.gz: b5575c03ca0ea020a9b9332c0c624567dd9cd370192c0db29ef5578d28c0f98bfbc8c5d2811eeb3498d270b2e1ee8ef279028c0f4638ae4063ff7958abe02457
+  data.tar.gz: ffe82390f6ad4deab517a8aaa0ef0e32541da030b0b0a10ba5d6991ae1749d2219069d5838cad8e05bff76f3c31913355536e766b50052fa590b177b046c2c7a

data/.rubocop.yml

@@ -0,0 +1,8 @@
+# Omakase Ruby styling for Rails
+inherit_gem: { rubocop-rails-omakase: rubocop.yml }
+
+# Overwrite or add rules to create your own house style
+#
+# # Use `[a, [b, c]]` not `[ a, [ b, c ] ]`
+# Layout/SpaceInsideArrayLiteralBrackets:
+#   Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,166 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.3.2] - 2025-08-04
+
+### Changed
+- **Phase Class Refactoring**
+  - Refactored `Phase` class following SOLID principles  
+  - Extracted specialized components: `Parser`, `Formatter`, `Comparator`, `Mapper`
+  - Applied Single Responsibility Principle with dedicated phase/ namespace
+  - Improved error handling with graceful degradation
+  - Enhanced code maintainability while preserving 100% API compatibility
+  - All 53 tests continue to pass with identical functionality
+
+## [1.3.1] - 2025-08-04
+
+### Changed
+- **Major Code Refactoring**
+  - Refactored `Tracker` class following SOLID principles
+  - Extracted specialized services: `PhaseQueryService`, `PhaseFormatter`, `DateParser`, `Validators`
+  - Refactored `PhaseCalculator` class with composition over inheritance
+  - Extracted specialized classes: `PhaseInterpolator`, `CycleEstimator`
+  - Applied Single Responsibility Principle across all classes
+  - Implemented early return patterns for better code flow
+  - Improved method naming and code organization
+  - Added comprehensive English comments for maintainability
+
+### Technical
+- **Architecture Improvements**
+  - Converted large classes into smaller, focused service objects
+  - Improved testability and maintainability through better separation of concerns
+  - Enhanced code readability with descriptive method and variable names
+  - Eliminated code duplication and improved DRY principles
+  - Better error handling with specific exception types
+  - Removed generic `rescue StandardError` anti-patterns
+
+## [1.3.0] - 2025-08-04
+
+### Added
+- **Rate Limiting Support**
+  - Implemented configurable rate limiting using token bucket algorithm
+  - Default rate limit: 1 request per second with burst size of 1
+  - New `RateLimiter` class with thread-safe token bucket implementation
+  - Environment variable configuration: `MOON_PHASE_RATE_LIMIT` and `MOON_PHASE_BURST_SIZE`
+  - Rate limiting can be disabled by setting `MOON_PHASE_RATE_LIMIT=0`
+  - Added `rate_limit_info` method to inspect current rate limiting configuration
+  - Custom rate limiter can be passed to `Tracker.new(rate_limiter: custom_limiter)`
+
+### Changed
+- **Client API Updates**
+  - `Client.new` now accepts optional `rate_limiter` parameter
+  - `Tracker.new` now accepts optional `rate_limiter` parameter
+  - All API requests are now automatically rate limited by default
+
+### Technical
+- Added comprehensive test coverage for rate limiting functionality
+- Added `examples/rate_limiting_example.rb` demonstrating all rate limiting features
+- Updated documentation with rate limiting configuration and usage examples
+
+## [1.2.0] - 2025-08-04
+
+### Added
+- **8 Moon Phases Support**
+  - Complete support for all 8 lunar phases instead of just 4 major phases
+  - Added intermediate phases: Waxing Crescent 🌒, Waxing Gibbous 🌔, Waning Gibbous 🌖, Waning Crescent 🌘
+  - New `PhaseCalculator` class for interpolating intermediate phases between major phases
+  - `interpolated` attribute on `Phase` class to distinguish calculated from official phases
+  
+- **New Public API Methods**
+  - `MoonPhaseTracker.all_phases_for_month(year, month)` - Get all 8 phases for a specific month
+  - `MoonPhaseTracker.all_phases_for_year(year)` - Get all 8 phases for a year
+  - `MoonPhaseTracker.all_phases_from_date(date, num_cycles)` - Get all 8 phases from a specific date
+  
+- **Enhanced Phase Representation**
+  - Updated `PHASE_SYMBOLS` constant with all 8 phase emojis
+  - Updated `PHASE_NAMES` mapping to include intermediate phases
+  - Visual indicator (`~`) for interpolated phases in formatted output
+  - Enhanced `format_phases` method to show major vs interpolated phase counts
+
+- **Examples & Documentation**
+  - New `examples/eight_phases_example.rb` demonstrating 8-phase functionality
+  - Comprehensive comparison between 4-phase and 8-phase outputs
+  - Phase symbols reference with visual emojis
+
+### Changed
+- **Precision & Accuracy**
+  - Interpolation algorithm provides ~85-90% accuracy for intermediate phases
+  - Suitable for lunar calendar applications requiring higher phase granularity
+  - Maintains backward compatibility with existing 4-phase API methods
+
+## [1.1.0] - 2025-08-04
+
+### Changed
+- **BREAKING CHANGE**: Date format standardized to ISO 8601 (YYYY-MM-DD)
+  - `Phase#formatted_date` now returns dates in ISO 8601 format instead of DD/MM/YYYY
+  - `Phase#to_s` output format updated to use ISO 8601 dates
+  - All documentation and examples updated to reflect new date format
+
+- **Internationalization Updates**
+  - User interface completely translated to American English
+  - Error messages now in English instead of Brazilian Portuguese
+  - Month names in `Tracker.month_name` changed from Portuguese to English
+  - Console messages and examples translated to English
+  - `Phase#to_s` separator changed from "às" to "at"
+  
+- **Date/Time Consistency**
+  - All date representations now use consistent ISO 8601 format
+  - Improved international compatibility and API consistency
+  - Enhanced sorting and comparison reliability
+
+## [1.0.0] - 2025-08-04
+
+### Added
+- **Core Functionality**
+  - Integration with USNO Navy API 4.0.1 for accurate moon phase data
+  - `MoonPhaseTracker.phases_for_month(year, month)` - Get phases for a specific month
+  - `MoonPhaseTracker.phases_for_year(year)` - Get all phases for a year
+  - `MoonPhaseTracker.phases_from_date(date, num_phases)` - Get phases from a specific date
+
+- **Phase Representation**
+  - `Phase` class with emoji symbols for each moon phase (🌑🌓🌕🌗)
+  - ISO 8601 date formatting (YYYY-MM-DD)
+  - Multiple output formats (string, hash, formatted display)
+  - Phase comparison and sorting capabilities
+
+- **Tracker Interface**
+  - `Tracker` class for advanced moon phase operations
+  - `current_month_phases` and `current_year_phases` convenience methods
+  - `next_phase` to get the upcoming moon phase
+  - `format_phases` with English month names
+
+- **HTTP Client**
+  - Robust HTTP client with timeout handling
+  - URI caching for performance optimization
+  - Comprehensive error handling (network, API, parsing)
+  - User-Agent header with gem version
+
+- **Error Handling**
+  - Custom exception hierarchy (`APIError`, `NetworkError`, `InvalidDateError`)
+  - Input validation for dates, years, and phase counts
+  - English error messages
+
+- **Testing & Documentation**
+  - Complete RSpec test suite with 21 passing tests
+  - Aggregate failure testing approach for efficiency
+  - Mocked API responses for reliable testing
+  - Comprehensive README with usage examples
+  - Interactive console with helpful examples
+  - Usage example script in `examples/` directory
+
+- **Dependencies**
+  - `net-http ~> 0.4` for HTTP requests
+  - `json ~> 2.7` for JSON parsing
+  - Ruby 3.2.0+ compatibility
+
+### Technical Details
+- API endpoint: `https://aa.usno.navy.mil/api/moon/phases/`
+- All times provided in Universal Time (UTC)
+- Supports date range from 1700 to current year + 10
+- Phase count range: 1-99 phases per request

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Daniel K Lima
+
+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,302 @@
+# MoonPhaseTracker 🌙
+
+A Ruby gem for tracking moon phases using the official US Naval Observatory (USNO) API. Perfect for creating lunar calendar-based scheduling applications.
+
+**Expected accuracy: ~85-90% (suitable for lunar calendars)**
+
+## Features
+
+- 🌑 Query moon phases by month, year, or from a specific date
+- 🌒 Complete 8-phase lunar cycle support (4 major + 4 intermediate phases)
+- 🌓 Simple and intuitive interface  
+- 🌔 Accurate data from the official USNO Navy API
+- 🌕 Visual representation with moon phase emojis
+- 🌖 Interpolated intermediate phases for enhanced precision
+- 🌗 Visual indicators for calculated vs official phases
+- 🌘 Automatic caching to optimize requests
+- ⚡ Robust error handling
+- 🚦 Configurable rate limiting to respect API limits
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'moon_phase_tracker'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it directly:
+
+```bash
+gem install moon_phase_tracker
+```
+
+## Usage
+
+### Basic Usage (4 Major Phases)
+
+```ruby
+require 'moon_phase_tracker'
+
+# Moon phases for August 2025 (4 major phases only)
+phases = MoonPhaseTracker.phases_for_month(2025, 8)
+puts phases.first.to_s
+# => "🌑 New Moon - 2025-08-04 at 11:13"
+
+# All phases for 2025
+year_phases = MoonPhaseTracker.phases_for_year(2025)
+
+# Next 6 phases from a specific date
+future_phases = MoonPhaseTracker.phases_from_date("2025-08-01", 6)
+```
+
+### Complete 8-Phase Lunar Cycle
+
+```ruby
+require 'moon_phase_tracker'
+
+# All 8 phases for August 2025 (major + intermediate)
+all_phases = MoonPhaseTracker.all_phases_for_month(2025, 8)
+all_phases.each do |phase|
+  indicator = phase.interpolated ? "~ " : "  "
+  puts "#{indicator}#{phase}"
+end
+# =>   🌑 New Moon - 2025-08-04 at 11:13
+# => ~ 🌒 Waxing Crescent - 2025-08-08 at 03:16
+# =>   🌓 First Quarter - 2025-08-12 at 15:19
+# => ~ 🌔 Waxing Gibbous - 2025-08-15 at 16:53
+# =>   🌕 Full Moon - 2025-08-19 at 18:26
+# => ~ 🌖 Waning Gibbous - 2025-08-22 at 13:56 
+# =>   🌗 Last Quarter - 2025-08-26 at 09:26
+# => ~ 🌘 Waning Crescent - 2025-08-29 at 02:56
+
+# All 8 phases for entire year
+all_year_phases = MoonPhaseTracker.all_phases_for_year(2025)
+
+# All 8 phases from specific date (2 lunar cycles)
+extended_phases = MoonPhaseTracker.all_phases_from_date("2025-08-01", 2)
+```
+
+### Using the Tracker Class
+
+```ruby
+tracker = MoonPhaseTracker::Tracker.new
+
+# Automatic formatting for display
+august_phases = tracker.phases_for_month(2025, 8)
+formatted = tracker.format_phases(august_phases, "August Phases")
+puts formatted
+
+# Next moon phase
+next_phase = tracker.next_phase
+puts next_phase.to_s
+
+# Current month phases
+current_month = tracker.current_month_phases
+```
+
+### Working with Individual Phases
+
+```ruby
+phase = phases.first
+
+# Phase information
+puts phase.name          # "New Moon"
+puts phase.symbol        # "🌑"
+puts phase.formatted_date # "2025-08-04"
+puts phase.formatted_time # "11:13"
+puts phase.interpolated   # false (official USNO data)
+
+# Working with interpolated phases
+interpolated_phase = all_phases.find(&:interpolated)
+puts interpolated_phase.interpolated  # true (calculated)
+puts interpolated_phase.name         # "Waxing Crescent"
+puts interpolated_phase.symbol       # "🌒"
+
+# Complete hash with all data
+details = phase.to_h
+# => {
+#   name: "New Moon",
+#   phase_type: :new_moon,
+#   date: "2025-08-04",
+#   time: "11:13",
+#   symbol: "🌑",
+#   iso_date: "2025-08-04",
+#   utc_time: "2025-08-04T11:13:00Z",
+#   interpolated: false
+# }
+
+# Date checks
+phase.in_month?(2025, 8)  # => true
+phase.in_year?(2025)      # => true
+```
+
+### Error Handling
+
+```ruby
+begin
+  phases = MoonPhaseTracker.phases_for_month(2025, 8)
+rescue MoonPhaseTracker::NetworkError => e
+  puts "Network error: #{e.message}"
+rescue MoonPhaseTracker::APIError => e
+  puts "API error: #{e.message}"
+rescue MoonPhaseTracker::InvalidDateError => e
+  puts "Invalid date: #{e.message}"
+end
+```
+
+### Practical Examples
+
+See the `examples/usage_example.rb` and `examples/eight_phases_example.rb` files for complete usage examples.
+
+## API Reference
+
+### Main Methods (4 Major Phases)
+
+- `MoonPhaseTracker.phases_for_month(year, month)` - Major phases for a specific month
+- `MoonPhaseTracker.phases_for_year(year)` - All major phases for a year
+- `MoonPhaseTracker.phases_from_date(date, num_phases)` - Major phases from a specific date
+
+### 8-Phase Methods (Major + Intermediate)
+
+- `MoonPhaseTracker.all_phases_for_month(year, month)` - All 8 phases for a specific month
+- `MoonPhaseTracker.all_phases_for_year(year)` - All 8 phases for a year
+- `MoonPhaseTracker.all_phases_from_date(date, num_cycles)` - All 8 phases from a specific date
+
+### Complete Phase Types
+
+#### Major Phases (Official USNO Data)
+- 🌑 `:new_moon` - New Moon
+- 🌓 `:first_quarter` - First Quarter
+- 🌕 `:full_moon` - Full Moon
+- 🌗 `:last_quarter` - Last Quarter
+
+#### Intermediate Phases (Interpolated ~85-90% accuracy)
+- 🌒 `:waxing_crescent` - Waxing Crescent 
+- 🌔 `:waxing_gibbous` - Waxing Gibbous
+- 🌖 `:waning_gibbous` - Waning Gibbous
+- 🌘 `:waning_crescent` - Waning Crescent
+
+## Data Source
+
+This gem uses the official US Naval Observatory (USNO) API:
+- **Base URL**: https://aa.usno.navy.mil/api/moon/phases/
+- **API Version**: 4.0.1
+- **Documentation**: https://aa.usno.navy.mil/data/api
+
+All times are provided in Universal Time (UTC).
+
+## Rate Limiting
+
+The gem implements respectful rate limiting to avoid overwhelming the USNO Navy API. By default, it allows **1 request per second** with a burst size of 1.
+
+### Default Rate Limiting
+
+```ruby
+# Default: 1 request per second
+tracker = MoonPhaseTracker::Tracker.new
+
+# Check current rate limit configuration
+puts tracker.rate_limit_info
+# => {:requests_per_second=>1.0, :burst_size=>1, :available_tokens=>1}
+
+# Multiple requests will be automatically rate limited
+start = Time.now
+tracker.phases_for_year(2025)  # Immediate
+tracker.phases_for_year(2024)  # Waits ~1 second
+puts "Total time: #{Time.now - start}s"  # ~1.0 seconds
+```
+
+### Custom Rate Limiting
+
+```ruby
+# Create custom rate limiter: 3 requests per second, burst of 2
+rate_limiter = MoonPhaseTracker::RateLimiter.new(
+  requests_per_second: 3.0,
+  burst_size: 2
+)
+
+tracker = MoonPhaseTracker::Tracker.new(rate_limiter: rate_limiter)
+
+# Burst requests are immediate, then rate limited
+tracker.phases_for_year(2025)  # Immediate
+tracker.phases_for_year(2024)  # Immediate (burst)
+tracker.phases_for_year(2023)  # Waits ~0.33 seconds
+```
+
+### Environment Variable Configuration
+
+```ruby
+# Set via environment variables
+ENV["MOON_PHASE_RATE_LIMIT"] = "2.5"
+ENV["MOON_PHASE_BURST_SIZE"] = "3"
+
+tracker = MoonPhaseTracker::Tracker.new
+puts tracker.rate_limit_info
+# => {:requests_per_second=>2.5, :burst_size=>3, :available_tokens=>3}
+```
+
+### Disabling Rate Limiting
+
+```ruby
+# Disable rate limiting completely
+ENV["MOON_PHASE_RATE_LIMIT"] = "0"
+
+tracker = MoonPhaseTracker::Tracker.new
+puts tracker.rate_limit_info  # => nil
+
+# Or pass nil explicitly
+tracker = MoonPhaseTracker::Tracker.new(rate_limiter: nil)
+```
+
+### Rate Limit Monitoring
+
+```ruby
+rate_limiter = MoonPhaseTracker::RateLimiter.new(
+  requests_per_second: 1.0,
+  burst_size: 2
+)
+
+# Check if request can proceed without waiting
+puts rate_limiter.can_proceed?  # => true
+
+# Check current token status
+puts rate_limiter.configuration
+# => {:requests_per_second=>1.0, :burst_size=>2, :available_tokens=>2}
+
+# Manual rate limiting control
+rate_limiter.throttle  # Waits if necessary and consumes token
+```
+
+### Token Bucket Algorithm
+
+The rate limiter uses a token bucket algorithm:
+
+- **Tokens**: Represent available requests
+- **Bucket Size**: Maximum burst requests allowed
+- **Refill Rate**: How quickly tokens are replenished
+- **Thread Safe**: Handles concurrent requests safely
+
+## 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 the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/dklima/moon_phase_tracker. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/dklima/moon_phase_tracker/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the MoonPhaseTracker project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/dklima/moon_phase_tracker/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec