calendario 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9291a462c911bf262155797e6e486d8732c9b5e71072e62786400f8fe2a9255c
+  data.tar.gz: a97194dcf9e9a4d26e5cf8dd549980da27d614a5056eec1c3dec5f133c29b768
+SHA512:
+  metadata.gz: 7bd0eae6c396824afcb80847c5fce30fbf7f05b4cc209376c855450cd453b12234060ef0efb241122f4a738830696731a45da4d686852ad5c2b72150a8b5d49a
+  data.tar.gz: 436d795f293c0ec6fdcc08218e9826a8d1f725ebb6dcae03b94963aded5dcff0d3c76e688a9d84641d6f4b0f0303b1fb0e843c9d24bb261bdfc562dce0d375e3

data/.editorconfig

@@ -0,0 +1,14 @@
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+max_line_length = 120
+trim_trailing_whitespace = true
+
+[*.snap]
+trim_trailing_whitespace = false
+
+# 2 space indentation
+[*.rb]
+indent_style = space
+indent_size = 2

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/.yardocck
+/coverage/
+/doc/
+/Gemfile.lock
+/measurements/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.overcommit.yml

@@ -0,0 +1,31 @@
+# Use this file to configure the Overcommit hooks you wish to use. This will
+# extend the default configuration defined in:
+# https://github.com/sds/overcommit/blob/master/config/default.yml
+#
+# At the topmost level of this YAML file is a key representing type of hook
+# being run (e.g. pre-commit, commit-msg, etc.). Within each type you can
+# customize each hook, such as whether to only run it on certain files (via
+# `include`), whether to only display output if it fails (via `quiet`), etc.
+#
+# For a complete list of hooks, see:
+# https://github.com/sds/overcommit/tree/master/lib/overcommit/hook
+#
+# For a complete list of options that you can use to customize hooks, see:
+# https://github.com/sds/overcommit#configuration
+#
+# Uncomment the following lines to make the configuration take effect.
+
+PreCommit:
+  RuboCop:
+    enabled: true
+    on_warn: fail # Treat all warnings as failures
+
+  TrailingWhitespace:
+    enabled: true
+
+#PostCheckout:
+#  ALL: # Special hook name that customizes all hooks of this type
+#    quiet: true # Change all post-checkout hooks to only display output on failure
+#
+#  IndexTags:
+#    enabled: true # Generate a tags file with `ctags` each time HEAD changes

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,27 @@
+require: rubocop-rspec
+
+AllCops:
+  DisplayCopNames: true
+  NewCops: enable
+
+# ----------------------- Layout ----------------------
+
+Layout:
+  Max: 120
+
+# ---------------------- Metrics ----------------------
+
+Metrics/BlockLength:
+  Exclude:
+    - '**/*_spec.rb'
+    - calendario.gemspec
+
+# ----------------------- RSpec -----------------------
+
+RSpec/ExampleLength:
+  Enabled: false
+
+# ----------------------- Style -----------------------
+
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/.tool-versions

@@ -0,0 +1 @@
+ruby 2.7.1

data/.travis.yml

@@ -0,0 +1,25 @@
+---
+language: ruby
+cache: bundler
+
+rvm:
+  - 2.5
+  - 2.6
+  - 2.7
+  - jruby
+
+before_install: gem install bundler -v 2.1.4
+
+before_script:
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+
+script:
+  - bundle exec bundle-audit
+  - bundle exec rspec
+  - bundle exec rubocop
+  - bundle exec rake yard:junk
+
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT

data/.yardstick.yml

@@ -0,0 +1,22 @@
+threshold: 100
+rules:
+  ApiTag::Presence:
+    enabled: true
+  ApiTag::Inclusion:
+    enabled: true
+  ApiTag::ProtectedMethod:
+    enabled: true
+  ApiTag::PrivateMethod:
+    enabled: true
+  ExampleTag:
+    enabled: true
+  ReturnTag:
+    enabled: true
+  Summary::Presence:
+    enabled: true
+  Summary::Length:
+    enabled: false
+  Summary::Delimiter:
+    enabled: true
+  Summary::SingleLine:
+    enabled: false

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2020-06-25
+### Added
+- Initial core functionality
+- Codebase maintenance tools
+
+[0.1.0]: https://github.com/wilsonsilva/tuga/compare/15adab8...v0.1.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers 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, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at wilson.dsigns@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [https://contributor-covenant.org/version/1/4][version]
+
+[homepage]: https://contributor-covenant.org
+[version]: https://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in calendario.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,20 @@
+guard :bundler do
+  watch('calendario.gemspec')
+end
+
+guard :bundler_audit, run_on_start: true do
+  watch('Gemfile.lock')
+end
+
+group :tests do
+  guard :rspec, all_on_start: true, cmd: 'COVERAGE=false bundle exec rspec --format progress' do
+    watch(%r{^spec/.+_spec\.rb$})
+    watch(%r{^lib/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+    watch('spec/spec_helper.rb') { 'spec' }
+  end
+end
+
+guard :rubocop do
+  watch(/.+\.rb$/)
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Wilson Silva
+
+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,122 @@
+# Calendario
+
+[![Gem Version](https://badge.fury.io/rb/caendario.svg)](https://badge.fury.io/rb/caendario)
+[![Build Status](https://travis-ci.org/wilsonsilva/caendario.svg?branch=master)](https://travis-ci.org/wilsonsilva/caendario)
+[![Maintainability](https://api.codeclimate.com/v1/badges/7afec90a09db3956b7dc/maintainability)](https://codeclimate.com/github/wilsonsilva/caendario/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/7afec90a09db3956b7dc/test_coverage)](https://codeclimate.com/github/wilsonsilva/caendario/test_coverage)
+[![Security](https://hakiri.io/github/wilsonsilva/caendario/master.svg)](https://hakiri.io/github/wilsonsilva/caendario/master)
+[![Inline docs](http://inch-ci.org/github/wilsonsilva/caendario.svg?branch=master)](http://inch-ci.org/github/wilsonsilva/caendario)
+
+A cal-like calendar.
+
+```shell script
+                            2020
+      January               February               March
+Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
+          1  2  3  4                     1   1  2  3  4  5  6  7
+ 5  6  7  8  9 10 11   2  3  4  5  6  7  8   8  9 10 11 12 13 14
+12 13 14 15 16 17 18   9 10 11 12 13 14 15  15 16 17 18 19 20 21
+19 20 21 22 23 24 25  16 17 18 19 20 21 22  22 23 24 25 26 27 28
+26 27 28 29 30 31     23 24 25 26 27 28 29  29 30 31
+
+
+       April                  May                   June
+Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
+          1  2  3  4                  1  2      1  2  3  4  5  6
+ 5  6  7  8  9 10 11   3  4  5  6  7  8  9   7  8  9 10 11 12 13
+12 13 14 15 16 17 18  10 11 12 13 14 15 16  14 15 16 17 18 19 20
+19 20 21 22 23 24 25  17 18 19 20 21 22 23  21 22 23 24 25 26 27
+26 27 28 29 30        24 25 26 27 28 29 30  28 29 30
+                      31
+
+        July                 August              September
+Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
+          1  2  3  4                     1         1  2  3  4  5
+ 5  6  7  8  9 10 11   2  3  4  5  6  7  8   6  7  8  9 10 11 12
+12 13 14 15 16 17 18   9 10 11 12 13 14 15  13 14 15 16 17 18 19
+19 20 21 22 23 24 25  16 17 18 19 20 21 22  20 21 22 23 24 25 26
+26 27 28 29 30 31     23 24 25 26 27 28 29  27 28 29 30
+                      30 31
+
+      October               November              December
+Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
+             1  2  3   1  2  3  4  5  6  7         1  2  3  4  5
+ 4  5  6  7  8  9 10   8  9 10 11 12 13 14   6  7  8  9 10 11 12
+11 12 13 14 15 16 17  15 16 17 18 19 20 21  13 14 15 16 17 18 19
+18 19 20 21 22 23 24  22 23 24 25 26 27 28  20 21 22 23 24 25 26
+25 26 27 28 29 30 31  29 30                 27 28 29 30 31
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'calendario'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install calendario
+
+## Usage
+
+Rendering the current year:
+```ruby
+calendar = Calendario::Calendar.new
+puts calendar.render_current_year
+```
+
+You can also customize what to display on each day. For example, this code wil display the letters WE on weekends:
+```ruby
+calendar = Calendario::Calendar.new
+rendered_calendar = calendar.render_current_year do |date|
+  if date.wday == 5 ||  if date.wday == 6
+    'WE'
+  else
+    date.day.to_s.rjust(2)
+  end
+end
+
+puts rendered_calendar
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies, configure git hooks and create support files.
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+The health and maintainability of the codebase is ensured through a set of
+Rake tasks to test, lint and audit the gem for security vulnerabilities and documentation:
+
+```
+rake bundle:audit          # Checks for vulnerable versions of gems
+rake qa                    # Test, lint and perform security and documentation audits
+rake rubocop               # Lint the codebase with RuboCop
+rake rubocop:auto_correct  # Auto-correct RuboCop offenses
+rake spec                  # Run RSpec code examples
+rake verify_measurements   # Verify that yardstick coverage is at least 100%
+rake yard                  # Generate YARD Documentation
+rake yard:junk             # Check the junk in your YARD Documentation
+rake yardstick_measure     # Measure docs in lib/**/*.rb with yardstick
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/wilsonsilva/calendario. 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/wilsonsilva/calendario/blob/master/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 Calendario project's codebases, issue trackers, chat rooms and mailing lists is expected
+to follow the [code of conduct](https://github.com/wilsonsilva/calendario/blob/master/CODE_OF_CONDUCT.md).

data/ROADMAP.md

@@ -0,0 +1,7 @@
+# Roadmap
+
+- [ ] Support the formatting of different kinds of time periods (not just years)
+- [ ] Add more time period formats (horizontal, different columns)
+- [ ] Add a CLI and make it behave a little like Unix's `cal`
+- [ ] Support different calendar types (Julian, etc)
+- [ ] Support for themes, perhaps with a plugin extension `calendario-themes` that depends on the `pastel` gem

data/Rakefile

@@ -0,0 +1,37 @@
+require 'bundler/audit/task'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'yaml'
+require 'yard/rake/yardoc_task'
+require 'yard-junk/rake'
+require 'yardstick/rake/measurement'
+require 'yardstick/rake/verify'
+
+yardstick_options = YAML.load_file('.yardstick.yml')
+
+Bundler::Audit::Task.new
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+YARD::Rake::YardocTask.new
+YardJunk::Rake.define_task
+Yardstick::Rake::Measurement.new(:yardstick_measure, yardstick_options)
+Yardstick::Rake::Verify.new
+
+task default: :spec
+
+# Remove the report on rake clobber
+CLEAN.include('measurements', 'doc', '.yardoc', 'tmp')
+
+# Delete these files and folders when running rake clobber.
+CLOBBER.include('coverage', '.rspec_status')
+
+desc 'Run spec with coverage'
+task :coverage do
+  ENV['COVERAGE'] = 'true'
+  Rake::Task['spec'].execute
+  `open coverage/index.html`
+end
+
+desc 'Test, lint and perform security and documentation audits'
+task qa: %w[spec rubocop yard:junk verify_measurements bundle:audit]

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'calendario'
+require 'pry'
+
+Pry.start

data/bin/setup

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+if ! which overcommit >/dev/null; then
+  echo 'The gem overcommit is not installed. It is necessary to lint the git history through git hooks.'
+  echo 'Please install overcommit and run this script again.'
+  exit 1
+fi
+
+overcommit --install

data/calendario.gemspec

@@ -0,0 +1,48 @@
+require_relative 'lib/calendario/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'calendario'
+  spec.version       = Calendario::VERSION
+  spec.authors       = ['Wilson Silva']
+  spec.email         = ['me@wilsonsilva.net']
+
+  spec.summary       = 'A cal-like calendar'
+  spec.description   = 'A cal-like calendar'
+  spec.homepage      = 'https://github.com/wilsonsilva/calendario'
+  spec.license       = 'MIT'
+
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
+
+  spec.metadata['homepage_uri']    = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/wilsonsilva/calendario'
+  spec.metadata['changelog_uri']   = 'https://github.com/wilsonsilva/calendario/blob/master/CHANGELOG.md'
+
+  # 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(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler-audit', '~> 0.7'
+  spec.add_development_dependency 'guard', '~> 2.16'
+  spec.add_development_dependency 'guard-bundler', '~> 3.0'
+  spec.add_development_dependency 'guard-bundler-audit', '~> 0.1'
+  spec.add_development_dependency 'guard-rspec', '~> 4.7'
+  spec.add_development_dependency 'guard-rubocop', '~> 1.3'
+  spec.add_development_dependency 'memoria', '~> 0.1'
+  spec.add_development_dependency 'overcommit', '~> 0.53'
+  spec.add_development_dependency 'pry', '~> 0.13'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 0.85'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.40'
+  spec.add_development_dependency 'simplecov', '~> 0.17.1'
+  spec.add_development_dependency 'simplecov-console', '~> 0.7'
+  spec.add_development_dependency 'yard', '~> 0.9'
+  spec.add_development_dependency 'yard-junk', '~> 0.0.7'
+  spec.add_development_dependency 'yardstick', '~> 0.9'
+end

data/lib/calendario.rb

@@ -0,0 +1,6 @@
+require 'calendario/calendar'
+require 'calendario/version'
+
+# Encapsulates all the calendar logic
+module Calendario
+end

data/lib/calendario/calendar.rb

@@ -0,0 +1,49 @@
+require 'calendario/renderers/year_renderer'
+require 'calendario/year'
+
+module Calendario
+  # A time period to be rendered
+  class Calendar
+    # Formats a year, line by line, in a table of 3 columns by 4 rows
+    #
+    # @api private
+    # @return [Calendario::Renderers::YearRenderer]
+    #
+    attr_reader :year_renderer
+
+    # Initialize a calendar
+    #
+    # @api private
+    # @param [Calendario::Renderers::YearRenderer] year_renderer # Formats a year, line by line, in a
+    # table of 3 columns by 4 rows
+    #
+    def initialize(year_renderer = Renderers::YearRenderer.new)
+      @year_renderer = year_renderer
+    end
+
+    # Renders the current year as a string
+    #
+    # @api public
+    #
+    # @example Rendering the current year
+    #  calendar = Calendario::Calendar.new
+    #  calendar.render_current_year
+    #
+    # @example Rendering a customized version of the current year
+    #  calendar = Calendario::Calendar.new
+    #  calendar.render_current_year do |date|
+    #    if date.wday == 5 ||  if date.wday == 6
+    #      'WE'
+    #    else
+    #      date.day.to_s.rjust(2)
+    #    end
+    #  end
+    #
+    # @return [String]
+    #
+    def render_current_year(&block)
+      year = Year.new(Date.today.year)
+      year_renderer.render(year, &block)
+    end
+  end
+end

data/lib/calendario/month.rb

@@ -0,0 +1,83 @@
+require 'date'
+
+module Calendario
+  # Any of the twelve parts, as January or February, into which the calendar year is divided
+  class Month
+    # List of month names (January, February, etc)
+    MONTH_NAMES = Date::MONTHNAMES.freeze
+
+    # The last day of the week is Saturday, in conformity with Ruby's standard library
+    LAST_DAY_OF_THE_WEEK = 'Saturday'.freeze
+
+    # Array of 28 to 31 days, depending on the month
+    #
+    # @api private
+    # @return [Array<Date>]
+    #
+    attr_reader :days
+
+    # The month's number from 1 to 12
+    #
+    # @api private
+    # @return [Integer]
+    #
+    attr_reader :month_number
+
+    # The primitive numeric representation of a year
+    #
+    # @api private
+    # @return [Integer]
+    #
+    attr_reader :year_number
+
+    # Initialize a month
+    #
+    # @api private
+    # @param [Integer] year_number The primitive numeric representation of a year
+    # @param [Integer] month_number The month's number from 1 to 12
+    #
+    def initialize(year_number = 2020, month_number = 1)
+      @year_number = year_number
+      @month_number = month_number
+      @days = (first_day..last_day).to_a
+    end
+
+    # First day of the month
+    #
+    # @api private
+    # @return [Date]
+    #
+    def first_day
+      @first_day ||= Date.new(year_number, month_number, 1)
+    end
+
+    # Last day of the month
+    #
+    # @api private
+    # @return [Date]
+    #
+    def last_day
+      @last_day ||= Date.new(year_number, month_number, -1)
+    end
+
+    # Array of weeks in the month. Weeks start on Sunday and end on Saturday
+    #
+    # @api private
+    # @return [Array<Date>]
+    #
+    def weeks
+      @weeks ||= days.slice_when do |day|
+        Date::DAYNAMES[day.wday] == LAST_DAY_OF_THE_WEEK
+      end.to_a
+    end
+
+    # Full name of the month (ex: January)
+    #
+    # @api private
+    # @return [String]
+    #
+    def name
+      MONTH_NAMES[month_number]
+    end
+  end
+end

data/lib/calendario/renderers/year_renderer.rb

@@ -0,0 +1,148 @@
+require 'calendario/month'
+
+module Calendario
+  module Renderers
+    # Formats a year, line by line, in a table of 3 columns by 4 rows
+    class YearRenderer
+      # The space of an empty day (3 = 2 digits + 1 space between digits)
+      EMPTY_DAY_SPACES = ' ' * 3
+
+      # The space to add on the 6th row of a month when that row is empty
+      EMPTY_WEEK_SPACES = ' ' * 20
+
+      # Formats a year, line by line, in a table of 3 columns by 4 rows like this:
+      #
+      #                             2020                                  | Title, centered
+      #       January               February               March          | Names of months, centered
+      # Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  | Weekday initials
+      #           1  2  3  4                     1   1  2  3  4  5  6  7  | Rows of weeks
+      #  5  6  7  8  9 10 11   2  3  4  5  6  7  8   8  9 10 11 12 13 14  |
+      # 12 13 14 15 16 17 18   9 10 11 12 13 14 15  15 16 17 18 19 20 21  |
+      # 19 20 21 22 23 24 25  16 17 18 19 20 21 22  22 23 24 25 26 27 28  |
+      # 26 27 28 29 30 31     23 24 25 26 27 28 29  29 30 31              | Add spaces after the last day of the
+      #                                                                   | month until the first day of the week of
+      #                                                                   | the month of the following month on the
+      #        April                  May                   June          | same row.
+      # Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  |
+      #           1  2  3  4                  1  2      1  2  3  4  5  6  | Add spaces before the first day of the
+      #  5  6  7  8  9 10 11   3  4  5  6  7  8  9   7  8  9 10 11 12 13  | month unless it is a Sunday.
+      # 12 13 14 15 16 17 18  10 11 12 13 14 15 16  14 15 16 17 18 19 20  |
+      # 19 20 21 22 23 24 25  17 18 19 20 21 22 23  21 22 23 24 25 26 27  |
+      # 26 27 28 29 30        24 25 26 27 28 29 30  28 29 30              |
+      #                       31                                          | Add spaces before a day on the second
+      #                                                                   | or third month columns if the first or
+      #         July                 August              September        | second columns month are empty.
+      # Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  |
+      #           1  2  3  4                     1         1  2  3  4  5  |
+      #  5  6  7  8  9 10 11   2  3  4  5  6  7  8   6  7  8  9 10 11 12  |
+      # 12 13 14 15 16 17 18   9 10 11 12 13 14 15  13 14 15 16 17 18 19  |
+      # 19 20 21 22 23 24 25  16 17 18 19 20 21 22  20 21 22 23 24 25 26  |
+      # 26 27 28 29 30 31     23 24 25 26 27 28 29  27 28 29 30           |
+      #                       30 31                                       |
+      #                                                                   |
+      #       October               November              December        |
+      # Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  |
+      #              1  2  3   1  2  3  4  5  6  7         1  2  3  4  5  |
+      #  4  5  6  7  8  9 10   8  9 10 11 12 13 14   6  7  8  9 10 11 12  |
+      # 11 12 13 14 15 16 17  15 16 17 18 19 20 21  13 14 15 16 17 18 19  |
+      # 18 19 20 21 22 23 24  22 23 24 25 26 27 28  20 21 22 23 24 25 26  |
+      # 25 26 27 28 29 30 31  29 30                 27 28 29 30 31        |
+      #
+      # @api private
+      # @param [Year] year The year to be formatted.
+      # @return [String]
+      #
+      def render(year)
+        output = centered_year_line(year)
+
+        # Display months in
+        year.months.each_slice(3).with_index do |group_of_3_months, month_row|
+          output << month_names_line(group_of_3_months)
+          output << weekdays_initials_line
+
+          # Display 6 rows of days. Each row is a week.
+          0.upto(5) do |week_number|
+            # Display
+            group_of_3_months.each_with_index do |month, index|
+              # Correct the position for the first date of the first week
+              output << EMPTY_DAY_SPACES * month.first_day.wday if week_number.zero?
+
+              # Display a complete row of week days
+              output << (month.weeks[week_number] || []).map do |date|
+                if block_given?
+                  yield(date)
+                else
+                  date.day.to_s.rjust(2)
+                end
+              end.join(' ') + '  '
+
+              # Correct the position for the first date of the following month
+              output << lead_space_after_last_day(month) if last_week_of_the_month?(month, week_number)
+
+              # Correct the position of the dates on empty rows (usually the last week)
+              output << EMPTY_WEEK_SPACES if week_number == 5 && group_of_3_months[index - 1].weeks[week_number].nil?
+            end
+
+            # End of the week row. Start the next one on the next line
+            output << "\n"
+          end
+
+          # Separate rows of months
+          output << "\n" if month_row < 3
+        end
+
+        output
+      end
+
+      private
+
+      # Adds blank spaces to fill the empty week days on the last week row of the month
+      #
+      # @api private
+      # @param [Month] month
+      # @return [String]
+      #
+      def lead_space_after_last_day(month)
+        EMPTY_DAY_SPACES * (6 - month.last_day.wday)
+      end
+
+      # Centers the year in the middle of the calendar
+      #
+      # @api private
+      # @param [Year] year The year to be displayed at the top of the calendar
+      # @return [String]
+      #
+      def centered_year_line(year)
+        year.year_number.to_s.center(61) + "\n"
+      end
+
+      # Displays 3 columns of month names in a line
+      #
+      # @api private
+      # @param [Array<Month>] group_of_3_months The list of months whose names will be displayed
+      # @return [String]
+      #
+      def month_names_line(group_of_3_months)
+        group_of_3_months.map { |month| month.name.center(20) }.join(' ') + " \n"
+      end
+
+      # Displays 3 columns of weekdays initials in a line
+      #
+      # @api private
+      # @return [String]
+      #
+      def weekdays_initials_line
+        "Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  \n"
+      end
+
+      # Whether the week is the last week of the month
+      #
+      # @api private
+      # @return [Boolean]
+      #
+      def last_week_of_the_month?(month, week_number)
+        month.weeks[week_number] == month.weeks.last
+      end
+    end
+  end
+end

data/lib/calendario/version.rb

@@ -0,0 +1,3 @@
+module Calendario
+  VERSION = '0.1.0'.freeze
+end

data/lib/calendario/year.rb

@@ -0,0 +1,60 @@
+require 'calendario/month'
+require 'date'
+
+module Calendario
+  # A period of 365 or 366 days, in the Gregorian calendar, divided into 12 calendar months
+  class Year
+    # Array of all calendar months
+    #
+    # @api private
+    # @return [Array<Month>]
+    #
+    attr_reader :months
+
+    # The primitive numeric representation of a year
+    #
+    # @api private
+    # @return [Integer]
+    #
+    attr_reader :year_number
+
+    # Initialize a year
+    #
+    # @api private
+    # @param [Integer] year_number The primitive numeric representation of a year
+    #
+    def initialize(year_number = 2020)
+      @year_number = year_number
+      @months = 1.upto(12).map do |month_number|
+        Month.new(year_number, month_number)
+      end
+    end
+
+    # The first day of the year (1st of January)
+    #
+    # @api private
+    # @return [Date]
+    #
+    def first_day
+      @first_day ||= months.first.first_day
+    end
+
+    # The last day of the year (31st of December)
+    #
+    # @api private
+    # @return [Date]
+    #
+    def last_day
+      @last_day ||= months.last.last_day
+    end
+
+    # An array of 365 or 365 dates representing every day of the year
+    #
+    # @api private
+    # @return [Date]
+    #
+    def days
+      @days ||= months.map(&:days).flatten
+    end
+  end
+end

metadata

@@ -0,0 +1,323 @@
+--- !ruby/object:Gem::Specification
+name: calendario
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Wilson Silva
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-06-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.16'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  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: guard-bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: guard-rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: memoria
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: overcommit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.53'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.53'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !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: '0.85'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.85'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.40'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.40'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.1
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: yard-junk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.7
+- !ruby/object:Gem::Dependency
+  name: yardstick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: A cal-like calendar
+email:
+- me@wilsonsilva.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".gitignore"
+- ".overcommit.yml"
+- ".rspec"
+- ".rubocop.yml"
+- ".tool-versions"
+- ".travis.yml"
+- ".yardstick.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- ROADMAP.md
+- Rakefile
+- bin/console
+- bin/setup
+- calendario.gemspec
+- lib/calendario.rb
+- lib/calendario/calendar.rb
+- lib/calendario/month.rb
+- lib/calendario/renderers/year_renderer.rb
+- lib/calendario/version.rb
+- lib/calendario/year.rb
+homepage: https://github.com/wilsonsilva/calendario
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/wilsonsilva/calendario
+  source_code_uri: https://github.com/wilsonsilva/calendario
+  changelog_uri: https://github.com/wilsonsilva/calendario/blob/master/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: A cal-like calendar
+test_files: []