oxml_maker 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 04e8ffba5e41ae76da239d31522428b1b0ea32f66f6ecf7cbf2a5c81c742a158
+  data.tar.gz: 44b680d0515bc4081474d741a90ef4e75bb1baac4140dc25f94e54d91d4fa94c
+SHA512:
+  metadata.gz: e861ef91354f8eae531c3863fe24051e5083de602a3f4ba5968affe66c2c8b0f41c229cc6c1b987d7f1b07961827d29610d0ad23d82f175257b98c2f92a785d4
+  data.tar.gz: 565441a6e469752394a08bde5dd1baf50cb7d4bfc7e8d6d8f07fc9164f1f6354a6450fda223579421c961a9a67091f39578ad29595edd8a891abb877e0e0b494

data/.rubocop.yml

@@ -0,0 +1,9 @@
+AllCops:
+  TargetRubyVersion: 3.1
+  NewCops: enable
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,26 @@
+## [Unreleased]
+
+## [0.1.1] - 2025-10-20
+
+### Added
+- Rubyzip 3.2 support for DOCX generation
+- Comprehensive test suite (63 tests, 274 assertions)
+- Rails-optional architecture with smart public directory detection  
+- Full workflow integration tests
+- ZIP functionality tests
+- Complete documentation consolidation
+
+### Changed
+- Updated rubyzip dependency from ~> 2.3 to ~> 3.2
+- Improved method naming (`copy_zip_to_docx` → `convert_zip_to_docx`)
+- Extracted section generation logic into separate method
+- Consolidated TESTING.md and EXAMPLE.md into README.md
+
+### Fixed
+- Missing ZIP-to-DOCX conversion step in Document#create
+- Rubyzip 3.x API compatibility (removed deprecated CREATE constant)
+- Rails dependency made optional with fallback support
+
+## [0.1.0] - 2025-06-09
+
+- Initial release

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 airbearr
+
+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,295 @@
+# OxmlMaker
+
+A Ruby gem for generating Microsoft Word DOCX files using OpenXML. Create professional documents with tables, paragraphs, and custom formatting programmatically.
+
+## Features
+
+- ✅ **Generate Valid DOCX Files**: Creates Microsoft Word-compatible documents
+- ✅ **Tables with Dynamic Data**: Populate tables from Ruby objects 
+- ✅ **Paragraphs and Text**: Simple text content with proper XML structure
+- ✅ **Page Configuration**: Control page size, margins, headers/footers
+- ✅ **Rails Integration**: Automatically detects Rails environment for file placement
+- ✅ **ZIP-based Structure**: Properly formatted DOCX files using rubyzip
+- ✅ **XML Safety**: Handles special characters and escaping
+- ✅ **Public Directory Management**: Auto-creates output directories
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'oxml_maker'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install oxml_maker
+```
+
+## Quick Start
+
+```ruby
+require 'oxml_maker'
+
+# Define document parameters
+params = {
+  sections: [
+    { paragraph: { text: "Welcome to OxmlMaker" } },
+    { 
+      table: {
+        columns: [
+          { name: "Product", width: 3000 },
+          { name: "Price", width: 2000 }
+        ],
+        rows: [
+          {
+            cells: [
+              { value: :name, width: 3000 },
+              { value: :price, width: 2000 }
+            ]
+          }
+        ],
+        data: {
+          0 => [
+            OpenStruct.new(name: "Widget", price: "$10.99"),
+            OpenStruct.new(name: "Gadget", price: "$25.50")
+          ]
+        },
+        font_size: 24
+      }
+    },
+    { paragraph: { text: "End of document" } }
+  ],
+  page_size: { width: 12240, height: 15840 },
+  page_margin: {
+    top: 1440, right: 1440, bottom: 1440, left: 1440,
+    header: 720, footer: 720, gutter: 0
+  }
+}
+
+# Create and generate the document
+doc = OxmlMaker::Document.new(filename: "example.docx", params: params)
+doc.create
+
+# The file will be created in:
+# - Rails apps: Rails.root/public/example.docx
+# - Non-Rails: ./public/example.docx (auto-created)
+```
+
+## Usage Examples
+
+### Creating Tables
+
+Tables can be populated with dynamic data from Ruby objects:
+
+```ruby
+# Define table structure
+table_config = {
+  columns: [
+    { name: "Name", width: 2000 },
+    { name: "Age", width: 1500 },
+    { name: "Email", width: 3000 }
+  ],
+  rows: [
+    {
+      cells: [
+        { value: :name, width: 2000 },
+        { value: :age, width: 1500 },
+        { value: :email, width: 3000 }
+      ]
+    }
+  ],
+  data: {
+    0 => [
+      OpenStruct.new(name: "John Doe", age: 30, email: "john@example.com"),
+      OpenStruct.new(name: "Jane Smith", age: 25, email: "jane@example.com")
+    ]
+  },
+  font_size: 12
+}
+
+params = {
+  sections: [
+    { table: table_config }
+  ],
+  page_size: { width: 12240, height: 15840 },
+  page_margin: { top: 1440, right: 1440, bottom: 1440, left: 1440, header: 720, footer: 720, gutter: 0 }
+}
+```
+
+### Adding Paragraphs
+
+Simple text content with proper XML formatting:
+
+```ruby
+params = {
+  sections: [
+    { paragraph: { text: "Document Title" } },
+    { paragraph: { text: "This is the first paragraph." } },
+    { paragraph: { text: "This is the second paragraph with more content." } }
+  ],
+  page_size: { width: 12240, height: 15840 },
+  page_margin: { top: 1440, right: 1440, bottom: 1440, left: 1440, header: 720, footer: 720, gutter: 0 }
+}
+```
+
+### Output Location
+
+The gem intelligently handles output location:
+
+- **In Rails apps**: Files are saved to `Rails.root/public/`
+- **Outside Rails**: Files are saved to `./public/` (created automatically)  
+- **Custom location**: Pass a custom directory to `copy_to_public(custom_dir)`
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` 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).
+
+## Testing
+
+### Test Framework
+
+The gem uses **Minitest** as its testing framework, which is included in Ruby's standard library. The test structure follows Ruby conventions:
+
+- `test/test_helper.rb` - Common setup and helper methods
+- `test/test_*.rb` - Individual test files for each class
+- Tests run with `bundle exec rake test`
+
+### Current Test Coverage
+
+- **63 tests, 274 assertions, 0 failures, 0 errors**
+- Unit tests for all classes (Document, Paragraph, Table)
+- Integration tests for complete workflows
+- ZIP functionality tests with rubyzip
+- Rails environment detection tests
+- Error handling and edge case tests
+
+### Test Files
+
+1. **test_oxml_maker.rb** - Tests for the main module
+2. **test_paragraph.rb** - Tests for the Paragraph class  
+3. **test_table.rb** - Tests for the Table class
+4. **test_document.rb** - Tests for the Document class
+5. **test_integration.rb** - Integration tests combining multiple classes
+6. **test_zip_functionality.rb** - ZIP creation and DOCX structure tests
+7. **test_full_workflow_integration.rb** - Complete end-to-end workflow tests
+
+### Running Tests
+
+```bash
+# Run all tests
+bundle exec rake test
+
+# Run a specific test file
+bundle exec ruby -Itest test/test_paragraph.rb
+
+# Run a specific test method
+bundle exec ruby -Itest test/test_paragraph.rb -n test_initialize_with_valid_hash
+```
+
+### Types of Tests
+
+#### 1. Unit Tests
+Test individual methods and classes in isolation:
+
+```ruby
+def test_initialize_with_valid_hash
+  data = { text: "Hello, World!" }
+  paragraph = OxmlMaker::Paragraph.new(data)
+  
+  assert_equal data, paragraph.data
+end
+```
+
+#### 2. Template/Output Tests
+Verify that XML output contains expected elements:
+
+```ruby
+def test_template_includes_xml_declaration
+  doc = OxmlMaker::Document.new(params: @sample_params)
+  template = doc.template
+
+  assert_includes template, '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+end
+```
+
+#### 3. Integration Tests
+Test multiple classes working together:
+
+```ruby
+def test_document_with_mixed_content
+  params = {
+    sections: [
+      { paragraph: { text: "Document Title" } },
+      { table: table_data }
+    ],
+    page_size: { width: 12240, height: 15840 }
+  }
+
+  document = OxmlMaker::Document.new(params: params)
+  xml = document.template
+
+  assert_includes xml, "<w:t>Document Title</w:t>"
+end
+```
+
+#### 4. ZIP Functionality Tests
+Verify DOCX file creation and structure:
+
+```ruby
+def test_created_zip_is_valid_docx
+  doc = OxmlMaker::Document.new(filename: "test.docx", params: @params)
+  doc.create
+
+  # Verify ZIP structure matches DOCX requirements
+  Zip::File.open(@docx_path) do |zip|
+    assert zip.find_entry("[Content_Types].xml"), "Should contain Content Types"
+    assert zip.find_entry("_rels/.rels"), "Should contain relationships"
+    assert zip.find_entry("word/document.xml"), "Should contain main document"
+  end
+end
+```
+
+### Testing Best Practices
+
+1. **Use Setup and Teardown** for consistent test environments
+2. **Test Edge Cases** including empty inputs, nil values, and special characters
+3. **Use Descriptive Test Names** that explain what is being tested
+4. **Test Both Success and Failure Paths** to ensure robust error handling
+5. **Mock External Dependencies** when needed (Rails environment, file systems)
+
+### Common Assertions
+
+- `assert_equal expected, actual` - Test equality
+- `assert_includes collection, item` - Test inclusion
+- `assert_raises(ExceptionClass) { code }` - Test exceptions
+- `assert condition` - Test truthiness
+- `refute condition` - Test falsiness
+- `assert_kind_of Class, object` - Test object type
+
+## Dependencies
+
+- **rubyzip (~> 3.2)** - For ZIP file creation and DOCX generation
+- **Standard Ruby libraries** (FileUtils, etc.)
+- **Optional: Rails** - For automatic public directory detection
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/mode-x/oxml_maker. 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/mode-x/oxml_maker/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 OxmlMaker project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/mode-x/oxml_maker/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/lib/oxml_maker/document.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+require "zip"
+require "fileutils"
+
+# OxmlMaker module
+module OxmlMaker
+  class Document
+    attr_accessor :params
+    attr_reader :filename
+
+    def initialize(filename: nil, params: {}, &block)
+      @filename = filename
+      @params = params
+      yield(self) if block_given?
+    end
+
+    def template
+      <<~XML
+        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+        <w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
+          <w:body>
+            #{generate_sections}
+            <w:sectPr>
+              <w:pgSz w:w='#{params[:page_size][:width]}' w:h='#{params[:page_size][:height]}'/>
+              <w:pgMar w:top='#{params[:page_margin][:top]}' w:right='#{params[:page_margin][:right]}' w:bottom='#{params[:page_margin][:bottom]}' w:left='#{params[:page_margin][:left]}' w:header='#{params[:page_margin][:header]}' w:footer='#{params[:page_margin][:footer]}' w:gutter='#{params[:page_margin][:gutter]}'/>
+            </w:sectPr>
+          </w:body>
+        </w:document>
+      XML
+    end
+
+    def create
+      prepare_paths
+      cleanup_temp_files
+      ensure_directories
+      write_document_xml
+      zip_docx_folder
+      convert_zip_to_docx
+      copy_to_public
+      cleanup_temp_files
+    end
+
+    private
+
+    def generate_sections
+      params[:sections].map do |section|
+        if section[:paragraph]
+          OxmlMaker::Paragraph.new(section[:paragraph]).template
+        elsif section[:table]
+          OxmlMaker::Table.new(section[:table]).template
+        end
+      end.join("\n")
+    end
+
+    def prepare_paths
+      @docx_root = File.join(__dir__, "docx")
+      @docx_word_path = File.join(@docx_root, "word")
+      @zip_path = File.join(__dir__, "document.zip")
+      @docx_path = File.join(__dir__, "document.docx")
+    end
+
+    def cleanup_temp_files
+      FileUtils.rm_f(@zip_path)
+      FileUtils.rm_f(@docx_path)
+    end
+
+    def ensure_directories
+      FileUtils.mkdir_p(@docx_word_path)
+    end
+
+    def write_document_xml
+      File.write(File.join(@docx_word_path, "document.xml"), template)
+    end
+
+    def zip_docx_folder
+      entries = Dir.glob(File.join(@docx_root, "**", "*"), File::FNM_DOTMATCH).select { |f| File.file?(f) }
+      Zip::File.open(@zip_path, create: true) do |zipfile|
+        entries.each do |file|
+          rel_path = file.sub("#{@docx_root}/", "")
+          zipfile.add(rel_path, file)
+        end
+      end
+    end
+
+    def convert_zip_to_docx
+      FileUtils.cp(@zip_path, @docx_path)
+    end
+
+    def copy_to_public(destination_dir = nil)
+      destination_dir ||= detect_public_dir
+      ensure_public_directory(destination_dir)
+      FileUtils.cp(@docx_path, File.join(destination_dir, filename))
+    end
+
+    def detect_public_dir
+      if defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+        File.join(Rails.root, "public")
+      else
+        # For non-Rails environments (like testing), use local public directory
+        "public"
+      end
+    end
+
+    def ensure_public_directory(dir)
+      FileUtils.mkdir_p(dir)
+    end
+  end
+end

data/lib/oxml_maker/docx/[Content_Types].xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">
+  <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>
+  <Default Extension="xml" ContentType="application/xml"/>
+  <Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>
+</Types>

data/lib/oxml_maker/docx/_rels/.rels

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+  <Relationship Target="word/document.xml" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Id="rId1"/>
+</Relationships>

data/lib/oxml_maker/docx/word/document.xml

@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
+  <w:body>
+    <w:p>
+  <w:r>
+    <w:t>Test with special chars: & < > " '</w:t>
+  </w:r>
+</w:p>
+
+<w:tbl>
+  <w:tblPr>
+    <w:tblStyle w:val="DefaultTable"/>
+    <w:tblW w:w="10468" w:type="dxa"/>
+    <w:tblInd w:w="0" w:type="dxa"/>
+    <w:tblBorders>
+      <w:top w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+      <w:left w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+      <w:bottom w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+      <w:right w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+      <w:insideH w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+      <w:insideV w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+    </w:tblBorders>
+    <w:tblLayout w:type="fixed"/>
+    <w:tblLook w:val="0600"/>
+  </w:tblPr>
+  <w:tblGrid>
+    <w:gridCol w:w="3000"/>
+  </w:tblGrid>
+  <w:tr>
+    <w:tblPrEx>
+      <w:tblCellMar>
+        <w:top w:w="0" w:type="dxa"/>
+        <w:bottom w:w="0" w:type="dxa"/>
+      </w:tblCellMar>
+    </w:tblPrEx>
+    <w:trPr>
+      <w:tblAlign w:val="center"/>
+    </w:trPr>
+    <w:tc>
+  <w:tcPr>
+    <w:tcW w:w="3000"/>
+  </w:tcPr>
+  <w:p>
+    <w:pPr>
+      <w:jc w:val="center"/>
+      <w:rPr>
+        <w:b/>
+      </w:rPr>
+    </w:pPr>
+    <w:r>
+      <w:rPr>
+        <w:b/>
+        <w:sz w:val="22"/>
+      </w:rPr>
+      <w:t>Data & Info</w:t>
+    </w:r>
+  </w:p>
+</w:tc>
+
+  </w:tr>
+  <w:tr>
+  <w:tc>
+  <w:tcPr>
+    <w:tcW w:w='3000' w:type='dxa'/>
+    
+    <w:vAlign w:val="center"/>
+  </w:tcPr>
+  <w:p>
+    <w:pPr>
+      <w:jc w:val='center'/>
+    </w:pPr>
+    <w:r>
+      <w:rPr><w:sz w:val='22'/></w:rPr>
+      <w:t>Content with &lt;tags&gt; &amp; symbols</w:t>
+    </w:r>
+  </w:p>
+</w:tc>
+
+</w:tr>
+
+</w:tbl>
+
+    <w:sectPr>
+      <w:pgSz w:w='12240' w:h='15840'/>
+      <w:pgMar w:top='1440' w:right='1440' w:bottom='1440' w:left='1440' w:header='720' w:footer='720' w:gutter='0'/>
+    </w:sectPr>
+  </w:body>
+</w:document>

data/lib/oxml_maker/paragraph.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# OxmlMaker module
+module OxmlMaker
+  # Represents a paragraph in an OXML document.
+  # It can be used to create structured text content within a Word document.
+  # The class is initialized with data that will be used to populate the paragraph.
+  # @param data [Hash] The data to be used in the paragraph.
+  # @example
+  #   paragraph = Oxml::Paragraph.new(data: {text: "Hello, World!"})
+  #   puts paragraph.template
+  #   # Output: <w:p><w:r><w:t>Hello, World!</w:t></w:r></w:p>
+  class Paragraph
+    attr_reader :data
+
+    def initialize(data = {})
+      raise ArgumentError, "Data must be a Hash" unless data.is_a?(Hash)
+
+      @data = data
+    end
+
+    def template
+      <<~XML
+        <w:p>
+          <w:r>
+            <w:t>#{data[:text]}</w:t>
+          </w:r>
+        </w:p>
+      XML
+    end
+  end
+end

data/lib/oxml_maker/table.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+# OxmlMaker module
+module OxmlMaker
+  # Table class represents a table in an OXML document.
+  # Initialized with a hash containing :columns, :rows, :data, and :font_size.
+  class Table
+    attr_reader :table
+
+    def initialize(table)
+      @table = table
+    end
+
+    def template
+      <<~XML
+        <w:tbl>
+          <w:tblPr>
+            <w:tblStyle w:val="DefaultTable"/>
+            <w:tblW w:w="10468" w:type="dxa"/>
+            <w:tblInd w:w="0" w:type="dxa"/>
+            <w:tblBorders>
+              <w:top w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+              <w:left w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+              <w:bottom w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+              <w:right w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+              <w:insideH w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+              <w:insideV w:color="666666" w:val="single" w:sz="4" w:space="0"/>
+            </w:tblBorders>
+            <w:tblLayout w:type="fixed"/>
+            <w:tblLook w:val="0600"/>
+          </w:tblPr>
+          <w:tblGrid>
+            #{table[:columns].map { |col| grid_col(col) }.join("\n")}
+          </w:tblGrid>
+          <w:tr>
+            <w:tblPrEx>
+              <w:tblCellMar>
+                <w:top w:w="0" w:type="dxa"/>
+                <w:bottom w:w="0" w:type="dxa"/>
+              </w:tblCellMar>
+            </w:tblPrEx>
+            <w:trPr>
+              <w:tblAlign w:val="center"/>
+            </w:trPr>
+            #{table[:columns].map { |column| header_row(column) }.join("\n")}
+          </w:tr>
+          #{table[:data].map { |_k, data| body_row(data) }.flatten.join("\n")}
+        </w:tbl>
+      XML
+    end
+
+    private
+
+    def grid_col(column)
+      width = column[:width] || 2000
+      "<w:gridCol w:w=\"#{width}\"/>"
+    end
+
+    def header_row(column)
+      <<~XML
+        <w:tc>
+          <w:tcPr>
+            <w:tcW w:w="#{column[:width] || 2000}"/>
+          </w:tcPr>
+          <w:p>
+            <w:pPr>
+              <w:jc w:val="center"/>
+              <w:rPr>
+                <w:b/>
+              </w:rPr>
+            </w:pPr>
+            <w:r>
+              <w:rPr>
+                <w:b/>
+                <w:sz w:val="#{table[:font_size] || 22}"/>
+              </w:rPr>
+              <w:t>#{column[:name]}</w:t>
+            </w:r>
+          </w:p>
+        </w:tc>
+      XML
+    end
+
+    def body_row(data)
+      data.map.with_index do |item, index|
+        <<~XML
+          <w:tr>
+            #{table[:rows][0][:cells].map { |cell| cell_xml(cell, item, index) }.join("\n")}
+          </w:tr>
+        XML
+      end.join("\n")
+    end
+
+    def cell_xml(cell, item, index)
+      width = cell[:width] || 2000
+      value = begin
+        item.send(cell[:value])
+      rescue StandardError
+        ""
+      end
+      if cell[:new_line]
+        <<~XML
+          <w:tc>
+            <w:tcPr>
+              <w:tcW w:w='#{width}' w:type='dxa'/>
+              <w:vAlign w:val="center"/>
+            </w:tcPr>
+            #{multi_line_cell_content(value)}
+          </w:tc>
+        XML
+      else
+        <<~XML
+          <w:tc>
+            <w:tcPr>
+              <w:tcW w:w='#{width}' w:type='dxa'/>
+              #{v_merge_tag(cell, index)}
+              <w:vAlign w:val="center"/>
+            </w:tcPr>
+            <w:p>
+              <w:pPr>
+                <w:jc w:val='center'/>
+              </w:pPr>
+              <w:r>
+                <w:rPr><w:sz w:val='#{table[:font_size] || 22}'/></w:rPr>
+                <w:t>#{cell_value(value)}</w:t>
+              </w:r>
+            </w:p>
+          </w:tc>
+        XML
+      end
+    end
+
+    def multi_line_cell_content(value)
+      if value.nil? || value.to_s.strip.empty?
+        <<~XML
+          <w:p>
+            <w:pPr>
+              <w:spacing w:after='0'/>
+              <w:jc w:val='center'/>
+            </w:pPr>
+            <w:r>
+              <w:rPr><w:sz w:val='22'/></w:rPr>
+              <w:t></w:t>
+            </w:r>
+          </w:p>
+        XML
+      else
+        value.split(", ").map do |line|
+          <<~XML
+            <w:p>
+              <w:pPr>
+                <w:spacing w:after='0'/>
+                <w:jc w:val='center'/>
+              </w:pPr>
+              <w:r>
+                <w:rPr><w:sz w:val='22'/></w:rPr>
+                <w:t>#{cell_value(line)}</w:t>
+              </w:r>
+            </w:p>
+          XML
+        end.join("\n")
+      end
+    end
+
+    def v_merge_tag(cell, index)
+      return "" unless cell[:v_merge]
+
+      index.zero? ? '<w:vMerge w:val="restart"/>' : '<w:vMerge w:val="continue"/>'
+    end
+
+    def cell_value(value)
+      value.to_s
+           .gsub("&", "&amp;")
+           .gsub("<", "&lt;")
+           .gsub(">", "&gt;")
+           .gsub('"', "&quot;")
+           .gsub("'", "&apos;")
+    end
+  end
+end

data/lib/oxml_maker/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module OxmlMaker
+  VERSION = "0.1.1"
+end

data/lib/oxml_maker.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "oxml_maker/version"
+require_relative "oxml_maker/document"
+require_relative "oxml_maker/paragraph"
+require_relative "oxml_maker/table"
+
+module OxmlMaker
+  class Error < StandardError; end
+  # Your code goes here...
+end

data/sig/oxml_maker.rbs

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

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: oxml_maker
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- airbearr
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+description: A Ruby gem for creating Microsoft Word DOCX files programmatically. Features
+  include tables with dynamic data, paragraphs, custom page settings, Rails integration,
+  and ZIP-based DOCX structure using rubyzip.
+email:
+- emmanuel.abia@corsearch.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/oxml_maker.rb
+- lib/oxml_maker/document.rb
+- lib/oxml_maker/docx/[Content_Types].xml
+- lib/oxml_maker/docx/_rels/.rels
+- lib/oxml_maker/docx/word/document.xml
+- lib/oxml_maker/paragraph.rb
+- lib/oxml_maker/table.rb
+- lib/oxml_maker/version.rb
+- sig/oxml_maker.rbs
+homepage: https://github.com/mode-x/oxml_maker
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/mode-x/oxml_maker
+  source_code_uri: https://github.com/mode-x/oxml_maker
+  changelog_uri: https://github.com/mode-x/oxml_maker/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Generate Microsoft Word DOCX files using OpenXML in Ruby
+test_files: []