axlsx_enhanced 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 78ae4908ae887f44e7165f416b8f44b5dd7f042ae728f1d70784611b03fda387
+  data.tar.gz: cb8bd047be9faf2044fdf907c9c385f9cf8b75e1e21c902b7618b31a6682d7f2
+SHA512:
+  metadata.gz: f1e0f075cad1f2a27bc374525db110faa70cf4d755c8f9d444aba362de751e7699bdb9ab54cea7ab15a21d0d0b34aca6451162164828a1bf9c90704e2f093143
+  data.tar.gz: d836fe1d0d6f67a71d0ff33150cda310e15b80ad3d610ac5346e18b3e97a52150b28f1c2183ea68cd3c7fdd44ee9d76ebce241f5c959f15fbcb79e87d2b549ec

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+.DS_Store
+.gem

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.0
+before_install: gem install bundler -v 1.16.2

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 TODO: Write your email address. 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 [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in axlsx_enhanced.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,58 @@
+PATH
+  remote: .
+  specs:
+    axlsx_enhanced (0.1.1)
+      activesupport (~> 5.2)
+      axlsx (~> 2.0, >= 2.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.2.2)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    axlsx (2.0.1)
+      htmlentities (~> 4.3.1)
+      nokogiri (>= 1.4.1)
+      rubyzip (~> 1.0.0)
+    concurrent-ruby (1.1.4)
+    diff-lcs (1.3)
+    htmlentities (4.3.4)
+    i18n (1.5.3)
+      concurrent-ruby (~> 1.0)
+    mini_portile2 (2.4.0)
+    minitest (5.11.3)
+    nokogiri (1.10.1)
+      mini_portile2 (~> 2.4.0)
+    rake (10.5.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    rubyzip (1.0.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  axlsx_enhanced!
+  bundler (~> 1.16)
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   1.16.2

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Oscar Rodríguez
+
+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,147 @@
+# AxlsxEnhanced
+
+Provides a better way to serialize xlsx documents using axlsx gem. Enhances axlsx styling while building a spreadsheet by ruby code.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'axlsx_enhanced', '~> 0.1.2'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install axlsx_enhanced
+
+## Usage
+
+### Default usage
+
+AxlsxEnhanced uses the same Axlsx syntax, and just injected some useful methods for building a worksheet:
+
+```ruby
+document = Axlsx::Package.new do |p|
+  # Creates a new worksheet
+  # args:
+  #  *(built-in Axlsx args)
+  #  name:         String, default: ""
+  #  smart_styles: Array,  default: AxlsxEnhanced::Helpers::Styles.defaults
+  p.workbook.smart_add_worksheet(name: 'Sheet 1') do |sheet|
+    # METHOD 1
+    ## Sets bold style for all cells
+    sheet.smart_add_row ["Cell 1", "Cell 2", "Cell 3"], style: :bold
+    
+    # METHOD 2
+    ## Sets italic style for cell #1 and underline style for cell #2
+    sheet.smart_add_row ["Cell 1", "Cell 2"], style: [:italic, :underline]
+    
+    # METHOD 3
+    ## Sets cell styles for specific cells in a row
+    row = sheet.smart_add_row ["Cell 1", "Cell 2", "Cell 3"]
+    ## Sets bold style for cell #1
+    row.cells[0].smart_style = :bold
+    ## Sets italic + underline style for cell #3
+    row.cells[2].smart_style = [:italic, :underline]
+  end
+
+  p.serialize('hello.xlsx')
+end
+```
+
+### Styles
+
+Styling worksheets are easier now after we created the following structure for it:
+
+```ruby
+# Creates a style
+style = {
+  name: :custom_style,
+  properties: {
+    b:        true,
+    sz:       12,
+    fg_color: "FFFFFF",
+    bg_color: "004586",
+    alignment: {
+      horizontal: :center,
+      vertical:   :center,
+      wrap_text:  true
+    },
+    border: {
+      style: :thick,
+      color: "FFFF0000",
+      edges: [:top, :bottom]
+    }
+  }
+}
+```
+
+For more style properties examples see Axlsx properties examples [in here](https://github.com/randym/axlsx/blob/master/examples/example.rb).
+
+### Using the default style templates
+You can use our default style templates while building a worksheet, to see all the available style names check out [this file](https://github.com/mldoscar/axlsx_enhanced/blob/master/lib/axlsx_enhanced/helpers/styles/defaults.rb).
+
+### Create your own style templates
+
+Creating and reusing your own templates now is possible using `smart_styles` option when creating a worksheet as the example given below:
+
+```ruby
+# Creates a custom template
+my_template = [
+  {
+    name: :bold_italic,
+    properties: {
+      b: true, 
+      i: true
+    }
+  },
+  {
+    name: :center_middle_text,
+    properties: {
+      alignment: {
+        horizontal: :center,
+        vertical:   :center
+      }
+    }
+  }
+]
+```
+
+After that, now we are able to use our custom template:
+
+```ruby
+# Use the template in a worksheet
+document = Axlsx::Package.new do |p|
+  p.workbook.smart_add_worksheet(name: 'Sheet 1', smart_styles: my_template) do |sheet|
+    sheet.smart_add_row ["Cell 1", "Cell 2", "Cell 3"], style: :bold_italic
+  end
+  p.serialize('hello.xlsx')
+end
+```
+
+**NOTE THAT** using your custom style templates will override our default style template. For combining our style template with yours you can merge the styles in a new variable and the use it for creating a spreadsheet:
+
+```ruby
+combined_template  = []
+
+combined_template += my_template
+combined_template += AxlsxEnhanced::Helpers::Styles.defaults
+```
+
+## 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).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/mldoscar/axlsx_enhanced. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## Code of Conduct
+
+Everyone interacting in the AxlsxEnhanced project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/mldoscar/axlsx_enhanced/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/axlsx_enhanced.gemspec

@@ -0,0 +1,41 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "axlsx_enhanced/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "axlsx_enhanced"
+  spec.version       = AxlsxEnhanced::VERSION
+  spec.authors       = ["Oscar Rodriguez"]
+  spec.email         = ["soporte@nicacode.com"]
+
+  spec.summary       = %q{Provides better syntax and helpers for building xlsx documents with Axlsx gem}
+  spec.description   = %q{Enhances axlsx styling while building a spreadsheet by ruby code}
+  spec.homepage      = "https://github.com/mldoscar/axlsx_enhanced"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  # 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('..', __FILE__)) 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", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  
+  spec.add_runtime_dependency "activesupport", "~> 5.2"
+  spec.add_runtime_dependency "axlsx", "~> 2.0", ">= 2.0.1"
+end

data/bin/bundle

@@ -0,0 +1,105 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bundle' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "rubygems"
+
+m = Module.new do
+    module_function
+
+  def invoked_as_script?
+    File.expand_path($0) == File.expand_path(__FILE__)
+  end
+
+  def env_var_version
+    ENV["BUNDLER_VERSION"]
+  end
+
+  def cli_arg_version
+    return unless invoked_as_script? # don't want to hijack other binstubs
+    return unless "update".start_with?(ARGV.first || " ") # must be running `bundle update`
+    bundler_version = nil
+    update_index = nil
+    ARGV.each_with_index do |a, i|
+      if update_index && update_index.succ == i && a =~ Gem::Version::ANCHORED_VERSION_PATTERN
+        bundler_version = a
+      end
+      next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/
+      bundler_version = $1 || ">= 0.a"
+      update_index = i
+    end
+    bundler_version
+  end
+
+  def gemfile
+    gemfile = ENV["BUNDLE_GEMFILE"]
+    return gemfile if gemfile && !gemfile.empty?
+
+    File.expand_path("../../Gemfile", __FILE__)
+  end
+
+  def lockfile
+    lockfile =
+      case File.basename(gemfile)
+      when "gems.rb" then gemfile.sub(/\.rb$/, gemfile)
+      else "#{gemfile}.lock"
+      end
+    File.expand_path(lockfile)
+  end
+
+  def lockfile_version
+    return unless File.file?(lockfile)
+    lockfile_contents = File.read(lockfile)
+    return unless lockfile_contents =~ /\n\nBUNDLED WITH\n\s{2,}(#{Gem::Version::VERSION_PATTERN})\n/
+    Regexp.last_match(1)
+  end
+
+  def bundler_version
+    @bundler_version ||= begin
+      env_var_version || cli_arg_version ||
+        lockfile_version || "#{Gem::Requirement.default}.a"
+    end
+  end
+
+  def load_bundler!
+    ENV["BUNDLE_GEMFILE"] ||= gemfile
+
+    # must dup string for RG < 1.8 compatibility
+    activate_bundler(bundler_version.dup)
+  end
+
+  def activate_bundler(bundler_version)
+    if Gem::Version.correct?(bundler_version) && Gem::Version.new(bundler_version).release < Gem::Version.new("2.0")
+      bundler_version = "< 2"
+    end
+    gem_error = activation_error_handling do
+      gem "bundler", bundler_version
+    end
+    return if gem_error.nil?
+    require_error = activation_error_handling do
+      require "bundler/version"
+    end
+    return if require_error.nil? && Gem::Requirement.new(bundler_version).satisfied_by?(Gem::Version.new(Bundler::VERSION))
+    warn "Activating bundler (#{bundler_version}) failed:\n#{gem_error.message}\n\nTo install the version of bundler this project requires, run `gem install bundler -v '#{bundler_version}'`"
+    exit 42
+  end
+
+  def activation_error_handling
+    yield
+    nil
+  rescue StandardError, LoadError => e
+    e
+  end
+end
+
+m.load_bundler!
+
+if m.invoked_as_script?
+  load Gem.bin_path("bundler", "bundle")
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "axlsx_enhanced"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/htmldiff

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "htmldiff")

data/bin/ldiff

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "ldiff")

data/bin/nokogiri

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'nokogiri' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("nokogiri", "nokogiri")

data/bin/rackup

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rackup' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rack", "rackup")

data/bin/rake

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/rspec

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/axlsx_enhanced.rb

@@ -0,0 +1,21 @@
+require "active_support/core_ext/object/blank"
+require "active_support/core_ext/hash/deep_merge"
+require "axlsx"
+
+module AxlsxEnhanced
+  require "axlsx_enhanced/version"
+  require "axlsx_enhanced/helpers"
+end
+
+module Axlsx
+  # Inclussions
+  class Workbook
+    include AxlsxEnhanced::Helpers::Injections::Workbook
+  end
+  class Worksheet
+    include AxlsxEnhanced::Helpers::Injections::Worksheet
+  end
+  class Cell
+    include AxlsxEnhanced::Helpers::Injections::Cell
+  end
+end

data/lib/axlsx_enhanced/helpers.rb

@@ -0,0 +1,12 @@
+module AxlsxEnhanced
+  module Helpers
+    # Requirements
+    require File.expand_path(File.dirname(__FILE__)) + '/helpers/styles/defaults'
+    require File.expand_path(File.dirname(__FILE__)) + '/helpers/styles/style'
+    require File.expand_path(File.dirname(__FILE__)) + '/helpers/styles/style_collection'
+    
+    require File.expand_path(File.dirname(__FILE__)) + '/helpers/injections/worksheet'
+    require File.expand_path(File.dirname(__FILE__)) + '/helpers/injections/workbook'
+    require File.expand_path(File.dirname(__FILE__)) + '/helpers/injections/cell'
+  end
+end

data/lib/axlsx_enhanced/helpers/injections/cell.rb

@@ -0,0 +1,38 @@
+module AxlsxEnhanced
+  module Helpers
+    module Injections
+      module Cell
+        def smart_style=(value)
+          return if value.nil?
+      
+          # Get sheet and workbook
+          sheet = self.row.worksheet
+          book  = sheet.workbook
+      
+          if value.is_a? Array
+            # Iterate style if value is an Array
+            new_style = {}
+      
+            value.each do |v|
+              # Find the specified style and merge it into the new style
+              s = sheet.smart_styles.find(v.to_sym)
+              new_style.deep_merge! s.properties
+            end
+          else
+            # Find the specified style
+            new_style = sheet.smart_styles.find(value).properties
+          end
+      
+          # Add the style to the workbook
+          style_id = book.styles.add_style new_style
+      
+          # Assign the style into the cell
+          self.style = style_id
+      
+          # Return the style id
+          return style_id
+        end
+      end
+    end
+  end
+end

data/lib/axlsx_enhanced/helpers/injections/workbook.rb

@@ -0,0 +1,20 @@
+module AxlsxEnhanced
+  module Helpers
+    module Injections
+      module Workbook
+        def smart_add_worksheet(options)
+          # Create the worksheet
+          worksheet = self.add_worksheet(options)
+          
+          # Assign smart styles if any is given, and clean options hash
+          worksheet.smart_styles = options[:smart_styles] || AxlsxEnhanced::Helpers::Styles.defaults
+          options.delete(:smart_styles)
+      
+          # Perform a block yield if necessary
+          yield worksheet if block_given?
+          worksheet
+        end
+      end
+    end
+  end
+end

data/lib/axlsx_enhanced/helpers/injections/worksheet.rb

@@ -0,0 +1,71 @@
+module AxlsxEnhanced
+  module Helpers
+    module Injections
+      module Worksheet
+        def smart_styles=(value)
+          @smart_styles = AxlsxEnhanced::Helpers::Styles::StyleCollection.new(self, value || [])
+        end
+      
+        def smart_styles
+          return @smart_styles
+        end
+      
+        def smart_add_separator
+          return self.add_row [nil]
+        end
+      
+        def smart_add_row(array, args = {})
+          unless args[:style].blank?
+            if args[:style].is_a?(Array)
+              # Look for all smart styles and parse them into base styles
+              base_styles = []
+      
+              args[:style].each do |item|
+                style_hash = {}
+      
+                # Parse the item into an array
+                item_array = item.is_a?(Array) ? item : [item]
+      
+                item_array.each do |style|
+                  next if style.nil?
+                  
+                  # Get smart style object
+                  smart_style = self.smart_styles.find(style)
+      
+                  # Merge the smart style properties into the style hash
+                  style_hash.deep_merge!(smart_style.properties)
+                end
+      
+                # Extract heigh property if any
+                args[:height] ||= style_hash[:height] if style_hash[:height].present?
+      
+                # Push a parsed base style into the array
+                base_styles.push self.styles.add_style(style_hash)
+              end
+            else
+              style_hash = {}
+      
+              # Get smart style object
+              smart_style = self.smart_styles.find args[:style]
+      
+              # Merge the smart style properties into the style hash
+              style_hash.deep_merge!(smart_style.properties)
+      
+              # Extract heigh property if any
+              args[:height] ||= style_hash[:height] if style_hash[:height].present?
+      
+              # Set a base style as a single Integer number
+              base_styles = self.styles.add_style(smart_style.properties)
+            end
+      
+            # Re-write style args setting the base styles
+            args[:style] = base_styles
+          end
+      
+          # Call original row creation method
+          return self.add_row(array, args)
+        end
+      end
+    end
+  end
+end

data/lib/axlsx_enhanced/helpers/styles/defaults.rb

@@ -0,0 +1,90 @@
+module AxlsxEnhanced
+  module Helpers
+    module Styles
+      def self.defaults
+        return [
+          # Text style
+          { name: :bold,            properties: { b: true } },
+          { name: :italic,          properties: { i: true } },
+          { name: :underline,       properties: { u: true } },
+          { name: :strike,          properties: { strike: true } },
+  
+          # Horizontal alignment
+          { name: :halign_left,     properties: { alignment: { horizontal: :left   } } },
+          { name: :halign_center,   properties: { alignment: { horizontal: :center } } },
+          { name: :halign_right,    properties: { alignment: { horizontal: :right  } } },
+  
+          # Vertical alignment
+          { name: :valign_top,      properties: { alignment: { vertial: :top    } } },
+          { name: :valign_center,   properties: { alignment: { vertial: :center } } },
+          { name: :valign_right,    properties: { alignment: { vertial: :bottom } } },
+          { name: :wrap_text,       properties: { alignment: { wrap_text: true  } } },
+  
+          # Borders
+          { name: :border_top_1,    properties: { border: { style: :thin,   color: 'FF000000', edges: [:top, :bottom, :left, :right] } } },
+          { name: :border_top_2,    properties: { border: { style: :medium, color: 'FF000000', edges: [:top, :bottom, :left, :right] } } },
+  
+          # Number formats
+          {
+            name: :number, properties: {
+              format_code: '#,##0.00'
+            }
+          },
+          {
+            name: :int_number, properties: {
+              format_code: '#,##0'
+            }
+          },
+  
+          # Date formats
+          {
+            name: :date, properties: {
+              format_code: 'DD/MM/YYYY'
+            }
+          },
+  
+          # Text colors
+          {
+            name: :red_text, properties: {
+              fg_color: 'FF0000'
+            }
+          },
+  
+          # Custom presets
+          {
+            name: :report_title, properties: {
+              sz: 14,
+              b: true,
+              alignment: { vertical: :center, horizontal: :center },
+              height: 30
+            }
+          },
+          {
+            name: :report_subtitle, properties: {
+              sz: 12,
+              b: true,
+              alignment: { vertical: :center, horizontal: :center },
+              height: 20
+            }
+          },
+          { 
+            name: :table_header, properties: {
+              b: true, 
+              alignment: { vertical: :center, horizontal: :center }, 
+              height: 20,
+              bg_color: '2196F3', fg_color: 'FF'
+            }
+          },
+          {
+            name: :table_footer, properties: {
+              b: true,
+              alignment: { vertical: :center, horizontal: :center },
+              height: 20,
+              bg_color: '2196F3', fg_color: 'FF'
+            }
+          }
+        ]
+      end
+    end
+  end
+end

data/lib/axlsx_enhanced/helpers/styles/style.rb

@@ -0,0 +1,26 @@
+module AxlsxEnhanced
+  module Helpers
+    module Styles
+      class Style
+        attr_accessor :properties
+
+        def initialize(args = {})
+          self.name       = args[:name]
+          self.properties = args[:properties]
+        end
+      
+        def name=(value)
+          @name = value.to_sym
+        end
+      
+        def name
+          return @name
+        end
+      
+        def add_property(hash)
+          self.properties.deep_merge! hash
+        end
+      end
+    end
+  end
+end

data/lib/axlsx_enhanced/helpers/styles/style_collection.rb

@@ -0,0 +1,34 @@
+module AxlsxEnhanced
+  module Helpers
+    module Styles
+      class StyleCollection
+        def initialize(worksheet, items = [])
+          @worksheet = worksheet
+          @collection = []
+      
+          self.add(items)
+        end
+      
+        def worksheet
+          return @worksheet
+        end
+      
+        def collection
+          return @collection
+        end
+      
+        def add(args)
+          items = args.is_a?(Array) ? args : [args]
+      
+          items.each do |item|
+            self.collection.push AxlsxEnhanced::Helpers::Styles::Style.new(item)
+          end
+        end
+        
+        def find(name)
+          return @collection.find { |x| x.name == name.to_sym }
+        end
+      end
+    end
+  end
+end

data/lib/axlsx_enhanced/version.rb

@@ -0,0 +1,3 @@
+module AxlsxEnhanced
+  VERSION = "0.1.2"
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: axlsx_enhanced
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Oscar Rodriguez
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-01-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.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: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: axlsx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+description: Enhances axlsx styling while building a spreadsheet by ruby code
+email:
+- soporte@nicacode.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- axlsx_enhanced.gemspec
+- bin/bundle
+- bin/console
+- bin/htmldiff
+- bin/ldiff
+- bin/nokogiri
+- bin/rackup
+- bin/rake
+- bin/rspec
+- bin/setup
+- lib/axlsx_enhanced.rb
+- lib/axlsx_enhanced/helpers.rb
+- lib/axlsx_enhanced/helpers/injections/cell.rb
+- lib/axlsx_enhanced/helpers/injections/workbook.rb
+- lib/axlsx_enhanced/helpers/injections/worksheet.rb
+- lib/axlsx_enhanced/helpers/styles/defaults.rb
+- lib/axlsx_enhanced/helpers/styles/style.rb
+- lib/axlsx_enhanced/helpers/styles/style_collection.rb
+- lib/axlsx_enhanced/version.rb
+homepage: https://github.com/mldoscar/axlsx_enhanced
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.7
+signing_key: 
+specification_version: 4
+summary: Provides better syntax and helpers for building xlsx documents with Axlsx
+  gem
+test_files: []