excelinator_ruby3 1.3.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6d9637000deffe5f7b7b34a3540385519c9577a1d4fabccab2633ce50d179c21
+  data.tar.gz: 5c3efdbe98b66c1b9aa0d9110a11d8f68fd044607babd3d6c8049d804c182509
+SHA512:
+  metadata.gz: 9fb7c5c7bff988745b902f2e3f4628790b301c2b1bc8d3db2eaa3dbb39bd87065d5e10cbb8e9268f9deca2cffe4caa3173263ccdbbadf4cc87d5f4e108cdd916
+  data.tar.gz: 0041025f34662cc4105b498a8dbe4f37cf4deeb14e48e39da7dba944984df870b82e9190a2e60ad85110222594b91c388cb4ed1f619b1c3289aeea18e07cd141

data/README.md

@@ -0,0 +1,179 @@
+# Excelinator Fork
+
+> Fork of [Excelinator](https://github.com/livingsocial/excelinator) to run with
+rails 7 and ruby 3.2.1 due to changes in the `CSV.parse(..)` method.
+
+Small gem for generating _real_ Excel spreadsheets from existing CSV data and
+HTML tables that fully supports UTF-8 characters.
+
+## Why?
+
+Well, when you're starting up and things are small and then things grow and
+then people want reports and they'd like them in Excel most of the time and
+then you realize you can just throw some cheap CSV views at them and Excel
+will be fine with them and then you get even bigger and you start getting,
+like, friggin' _international_ and then the French dudes are like, "My umlauts
+look like chewed croissant" and you try prefixing your CSV with a UTF-8 BOM
+and that makes some Excels happy (Windows) but not others (Mac) and you think
+man I totally want to just, y'know, _eat_ the croissant like it was meant to
+be eaten y'know? and there's a zillion spreadsheet gems out there already
+except they all like merge back to that one spreadsheet gem, and you could go
+XMLDoc maybe, but then it's just like lemme use the CSV I've already got and
+try to not make me work much?
+
+## No Rails Required
+
+The heart of this gem has a couple of small methods to handle the
+transformations. If that's all you need, you're good to go.
+
+### CSV
+
+Call `Excelinator.csv_to_xls(csv_content)`. The csv_content will be parsed by
+FasterCSV and converted to Excel spreadsheet contents ready to be saved to
+file or sent across the wire.
+
+If you have a lot of CSV content and don't want to do all of this work in
+memory, call `Excelinator.csv_to_xls_file(csv_path, file)`, passing the path to
+the CSV file and a path to the .xls file you'd like the workbook saved to.
+(contributed by [maxwell](https://github.com/maxwell))
+
+If you want the CSV Data not to be separated by ',' (as it is by default) you can call
+`Excelinator.csv_to_xls_file(csv_path, file, ";")` or
+`Excelinator.csv_to_xls(csv_content, ";")` or with any other separator char.
+
+### HTML
+
+Call `Excelinator.html_as_xls(html_content)`. The table element from the HTML
+content is extracted, a meta tag indicating utf-8 encoding is prepended and
+that's it. The resulting content isn't actually an Excel spreadsheet, just the
+HTML data. But write this out to a file with an .xls extension and Excel will
+open the contents and translate the `<table>` for you, formatting and all.
+
+_NOTE: While some spreadsheet programs (e.g. Google Docs) will not translate
+HTML tables like this, both Excel on Windows and Mac will as well as
+OpenOffice._
+
+## But I Need Rails
+
+As you wish. As always, [TMTOWTDI](http://en.wikipedia.org/wiki/There's_more_than_one_way_to_do_it),
+but here are a few usage options. All examples work in Rails 2 and 3, except
+where noted.
+
+If you want to make an explicit xls view that has CSV content in it:
+
+```ruby
+class FooController < ApplicationController
+  def report
+    respond_to do |format|
+      format.html
+      format.csv
+      format.xls { render :xls => 'foo_report.xls' }
+    end
+  end
+end
+```
+
+Rails 2 doesn't support custom renderers, but the guts of our :xls renderer
+are mixed into the controllers, so you can call it directly this way:
+
+```ruby
+      format.xls { send_xls_data 'foo_report.xls' }
+```
+
+If you want to re-use an existing HTML view:
+
+```ruby
+      format.xls { send_xls_data 'foo_report.xls', :file => 'foo/report.html.erb' }
+```
+_`:template` also works in place of `:file` in Rails 3. `render :xls =>` also
+works in place of `send_xls_data` in Rails 3._
+
+Also note, `send_xls_data` (the guts of `render :xls`) will parse the given
+content and detect CSV or HTML, so no need to specify which is being passed in.
+
+You can even go with just an explicit xls view and no controller code, but
+you'll need to convert the CSV content yourself inside the view:
+
+```ruby
+<%= Excelinator.csv_to_xls(render :file => 'foo/xls_view.csv.erb').html_safe %>
+```
+_`:template` works in place of `:file` here as well in Rails 3._
+
+Or ... refactor the CSV content to a format-less partial:
+
+```ruby
+# _report.erb
+<%= generate_csv_report %>
+
+# report.csv.erb
+<%= render :partial => 'report' %>
+
+# report.xls.erb
+<%= Excelinator.csv_to_xls(render :partial => 'report').html_safe %>
+```
+
+There are test apps included in the source repo that exercise these different
+options.
+
+FAQ
+---
+
+###You lied when you said "_real_ Excel spreadsheets from ... HTML tables." What about converting HTML tables to a _real_ Excel file?
+
+I did, and I apologize. Lemme know when your pull request is ready.
+
+###Are there any options to re-use CSV/HTML views with No additional controller/view code?
+
+I've tinkered with it, but it requires a bit of duck punching of the
+Rails rendering code. Checkout
+[exceliderp](https://github.com/chrismo/exceliderp) and see if I've
+pushed it up there yet.
+
+###What if I want to generate a real Excel spreadsheet from scratch with all sorts of awesome in it?
+
+This gem uses `spreadsheet` under the covers. There are also others that
+support a wide variety of Excel features:
+
+- https://github.com/zdavatz/spreadsheet
+- http://surpass.ananelson.com/ 
+- https://github.com/randym/axlsx
+
+With any of these, you can create specific .xls views and have them use the
+classes in these gems that let you define a Workbook with multiple Worksheets
+with rows and columns of formatted formulas.
+
+For support higher up the ladder within Rails and/or ActiveRecord, here are a
+few options I've found, though I can't vouch for any. Search rubygems and
+github for 'spreadsheet' 'excel' and 'xls' and you'll find lots of additional
+projects. Most appear to use either the above Spreadsheet gem or generate
+XMLDoc.
+
+- https://github.com/glebm/to_spreadsheet 
+- https://github.com/splendeo/to_xls 
+- https://github.com/asanghi/excel_rails 
+- https://github.com/hallelujah/rails-excel
+- https://github.com/liangwenke/to_xls-rails
+
+###Some of the links in the test Rails apps don't work
+
+They're not all supposed to work. Think of it more as a workshop for example
+code.
+
+CHANGELOG
+---------
+#### 1.3.1
+
+Merged PRs (effectively and actually) from ikusei and maxwell to remove the versioning on 
+the dependent `spreadsheet` gem and allow for a custom separator.
+
+#### 1.3.0
+
+Added `csv_to_xls_file(csv_path, file)` (contributed by [maxwell](https://github.com/maxwell))
+
+#### 1.2.0
+
+Ruby 2 support
+
+#### 1.1.0
+
+Added Ruby 1.9 support.

data/lib/excelinator/rails.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Excelinator
+  # register as rails module
+  module Rails
+    def self.setup
+      require 'action_controller'
+
+      Mime::Type.register Excelinator::MIME_TYPE, :xls
+
+      add_renderer if ::Rails::VERSION::MAJOR >= 3
+    end
+
+    def self.add_renderer
+      ActionController::Renderers.add :xls do |filename, options|
+        send_xls_data(filename, options)
+      end
+    end
+
+    # Not rails module
+    module ACMixin
+      def send_xls_data(filename, options = {})
+        content = render_to_string(options)
+        xls_content = Excelinator.convert_content(content)
+        send_data(xls_content, filename:, type: Excelinator::MIME_TYPE, disposition: 'inline')
+      end
+    end
+  end
+end

data/lib/excelinator/version.rb

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

data/lib/excelinator/xls.rb

@@ -0,0 +1,62 @@
+# Excelinator module
+module Excelinator
+  MIME_TYPE = 'application/vnd.ms-excel'
+
+  # Detects HTML table content (with a rather stupid regex: /<table/) and re-uses it, or attempts to convert from
+  # CSV if HTML not detected.
+  def self.convert_content(content)
+    content =~ /<table/ ? Excelinator.html_as_xls(content) : Excelinator.csv_to_xls(content)
+  end
+
+  # rubocop:disable Metrics/MethodLength
+  def self.csv_to_xls(csv_content, separator = ',')
+    ary = (!old_ruby? ? CSV : FasterCSV).parse(csv_content, col_sep: separator)
+
+    book = Spreadsheet::Workbook.new
+    sheet = book.create_worksheet
+    ary.each_with_index do |row_ary, index|
+      row = sheet.row(index)
+      row.push(*row_ary)
+    end
+    content = ''
+    ios = StringIO.new(content)
+    book.write(ios)
+    content
+  end
+  # rubocop:enable Metrics/MethodLength
+
+  # rubocop:disable Metrics/MethodLength
+  def self.csv_to_xls_file(csv_path, file, separator = ',')
+    book = Spreadsheet::Workbook.new
+    sheet = book.create_worksheet
+
+    CSV.open(csv_path, col_sep: separator) do |csv|
+      index = 0
+      csv.each do |raw_row|
+        row = sheet.row(index)
+        row.push(*raw_row)
+        index += 1
+      end
+    end
+
+    book.write(file)
+    file
+  end
+  # rubocop:enable Metrics/MethodLength
+
+  # This only strips a <table> out of the html and adds a meta tag for utf-8 support. Excel will open an .xls file
+  # with this content and grok it correctly (including formatting); however, many alternate spreadsheet applications
+  # will not do this.
+  #
+  # If the html_content is very large, the default behavior of scanning out the table contents will consume a lot
+  # of memory. If the :do_not_strip option is passed, this expensive scan call will be skipped and the entire
+  # contents will be returned.
+  #
+  # If you don't have need of utf-8 encoding, or want to prepend that yourself, there's no need to use this method.
+  def self.html_as_xls(html_content, options = {})
+    encoding_meta_tag = '<meta http-equiv="Content-Type" content="text/html; charset=utf-8">'
+    encoding_meta_tag + (options.delete(:do_not_strip) ? html_content : html_content.scan(%r{<table.*/table>}mi).join)
+  end
+
+  # def self.html_to_xls might be nice to do - convert html table to _real_ xls file
+end

data/lib/excelinator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'excelinator/xls'
+require 'excelinator/rails'
+require 'excelinator/version'
+require 'spreadsheet'
+
+def old_ruby?
+  RUBY_VERSION.to_f < 1.9
+end
+
+if old_ruby?
+  require 'fastercsv'
+else
+  require 'csv'
+end
+
+if defined?(Rails)
+  Excelinator::Rails.setup
+  module ActionController
+    class Base
+      include Excelinator::Rails::ACMixin
+    end
+  end
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: excelinator_ruby3
+version: !ruby/object:Gem::Version
+  version: 1.3.2
+platform: ruby
+authors:
+- ChrKahl
+- chrismo
+- jwhitmire
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-09-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: spreadsheet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: convert your csv data and html tables to excel data
+email:
+- ChristophKahl@gmx.de
+- chrismo@clabs.org
+- jeff@jwhitmire.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/excelinator.rb
+- lib/excelinator/rails.rb
+- lib/excelinator/version.rb
+- lib/excelinator/xls.rb
+homepage: https://github.com/chrkahl/excelinator
+licenses: []
+metadata: {}
+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: []
+rubygems_version: 3.4.6
+signing_key: 
+specification_version: 4
+summary: Excel Converter for ruby version 3
+test_files: []