tex_to_unicode 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 758d993499f29b722dad34af1ceb5ec83d73fb1fb9a72e00acd2e2b2a792c2b6
+  data.tar.gz: 9f538d5baf5abe40fe927ee34b082ecd144e3bf7c6e499ffcee1188e10d64b42
+SHA512:
+  metadata.gz: c73fde054663f346c7af90734416dce4c9107e0c86f86f55fec88ff777174bbf926c24c52a042128ea94359db21ef9a517fa32f8ad1e580ec1d901cc56f7701e
+  data.tar.gz: 2a2b20a8ed92f4d02275c9a49b93e1135fe44c431ad814bd6bfa93451d88946bb8446965bcc94e64bd6375b18e85718b987e7b52b06718531bf49a694f8da360

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Thomas Powell
+
+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,168 @@
+# TexToUnicode
+
+A Ruby gem that converts TeX mathematical and other symbols to their Unicode character equivalents, enabling easier display of mathematical notation in plain text.
+
+## Installation
+
+Install the gem locally:
+
+```bash
+gem build tex_to_unicode.gemspec
+gem install tex_to_unicode-0.1.0.gem
+```
+
+Or add it to your Gemfile:
+
+```ruby
+gem 'tex_to_unicode'
+```
+
+## Usage
+
+### Command Line
+
+The gem provides a `tex_to_unicode` executable that converts TeX expressions passed as arguments:
+
+```bash
+# Basic usage
+tex_to_unicode '\alpha + \beta = \gamma'
+# Output: α + β = γ
+
+# Greek letters
+tex_to_unicode '\pi \approx 3.14159'
+# Output: π ≈ 3.14159
+
+# Math operators
+tex_to_unicode 'x \times y \leq z'
+# Output: x × y ≤ z
+
+# Arrows
+tex_to_unicode 'A \rightarrow B \Rightarrow C'
+# Output: A → B ⇒ C
+
+# Integrals and sums
+tex_to_unicode '\int_0^\infty x^2 dx'
+# Output: ∫₀^∞ x² dx
+
+# Set notation
+tex_to_unicode 'x \in \mathbb{R}, y \notin \emptyset'
+# Output: x ∈ ℝ, y ∉ ∅
+
+# Complex expressions
+tex_to_unicode '\forall x \exists y : x \leq y'
+# Output: ∀ x ∃ y : x ≤ y
+```
+
+### Ruby API
+
+You can also use the gem in your Ruby code:
+
+```ruby
+require 'tex_to_unicode'
+
+# Convert TeX to Unicode
+result = TexToUnicode.convert('\alpha + \beta = \gamma')
+puts result  # => α + β = γ
+
+# Use in string interpolation
+formula = '\sum_{i=1}^n i = \frac{n(n+1)}{2}'
+puts "The formula is: #{TexToUnicode.convert(formula)}"
+# Output: The formula is: ∑ᵢ₌₁ⁿ i = n(n+1)/2
+```
+
+## Supported Symbols
+
+The gem supports a wide range of TeX symbols including:
+
+### Greek Letters
+- Lowercase: `\alpha`, `\beta`, `\gamma`, `\delta`, `\epsilon`, `\theta`, `\lambda`, `\mu`, `\pi`, `\sigma`, `\phi`, `\omega`, etc.
+- Uppercase: `\Gamma`, `\Delta`, `\Theta`, `\Lambda`, `\Pi`, `\Sigma`, `\Phi`, `\Omega`, etc.
+
+### Math Operators
+- `\pm` (±), `\times` (×), `\div` (÷), `\cdot` (·)
+- `\oplus` (⊕), `\otimes` (⊗), `\ast` (∗)
+
+### Relations
+- `\leq` (≤), `\geq` (≥), `\neq` (≠), `\approx` (≈)
+- `\equiv` (≡), `\sim` (∼), `\propto` (∝)
+- `\subset` (⊂), `\supset` (⊃), `\in` (∈), `\notin` (∉)
+
+### Arrows
+- `\rightarrow` or `\to` (→), `\leftarrow` (←), `\leftrightarrow` (↔)
+- `\Rightarrow` (⇒), `\Leftarrow` (⇐), `\Leftrightarrow` (⇔)
+- `\uparrow` (↑), `\downarrow` (↓)
+
+### Calculus & Analysis
+- `\int` (∫), `\sum` (∑), `\prod` (∏)
+- `\partial` (∂), `\nabla` (∇), `\infty` (∞)
+
+### Logic & Set Theory
+- `\forall` (∀), `\exists` (∃), `\neg` (¬)
+- `\land` (∧), `\lor` (∨), `\cap` (∩), `\cup` (∪)
+- `\emptyset` (∅), `\therefore` (∴), `\because` (∵)
+
+### Superscripts & Subscripts
+- `^0` through `^9` (⁰¹²³⁴⁵⁶⁷⁸⁹)
+- `_0` through `_9` (₀₁₂₃₄₅₆₇₈₉)
+- `^+`, `^-`, `^(`, `^)` and subscript equivalents
+
+### Brackets
+- `\langle`, `\rangle` (⟨⟩)
+- `\lceil`, `\rceil` (⌈⌉)
+- `\lfloor`, `\rfloor` (⌊⌋)
+
+### Miscellaneous
+- `\checkmark` (✓), `\degree` (°), `\copyright` (©)
+- `\dots` (…), `\cdots` (⋯)
+- Musical symbols: `\sharp` (♯), `\flat` (♭), `\natural` (♮)
+
+## Examples
+
+```bash
+# Quadratic formula
+tex_to_unicode 'x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}'
+# Output: x = -b ± √(b² - 4ac)/2a
+
+# Euler's identity
+tex_to_unicode 'e^{i\pi} + 1 = 0'
+# Output: eⁱᵖⁱ + 1 = 0
+
+# Set theory
+tex_to_unicode 'A \cup B = \{x : x \in A \lor x \in B\}'
+# Output: A ∪ B = {x : x ∈ A ∨ x ∈ B}
+
+# Calculus
+tex_to_unicode '\int_a^b f(x)dx = F(b) - F(a)'
+# Output: ∫ₐᵇ f(x)dx = F(b) - F(a)
+```
+
+## Limitations
+
+While Unicode provides many mathematical symbols, some TeX constructs cannot be perfectly represented:
+- Complex fractions are approximated
+- Matrices and arrays have limited support
+- Some accents and diacritics are approximated
+- Subscripts and superscripts support limited characters
+
+## Development
+
+To build and test locally:
+
+```bash
+# Build the gem
+gem build tex_to_unicode.gemspec
+
+# Install locally
+gem install tex_to_unicode-0.1.0.gem
+
+# Test the executable
+tex_to_unicode '\alpha + \beta'
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome!
+
+## License
+
+This gem is available as open source under the terms of the MIT License.

data/bin/tex_to_unicode

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/tex_to_unicode'
+
+if ARGV.empty?
+  puts "Usage: tex_to_unicode <TeX expressions>"
+  puts "Example: tex_to_unicode '\\alpha + \\beta = \\gamma'"
+  exit 1
+end
+
+# Join all arguments with spaces
+input = ARGV.join(' ')
+
+# Convert and output
+output = TexToUnicode.convert(input)
+puts output

data/lib/tex_to_unicode/converter.rb

@@ -0,0 +1,128 @@
+module TexToUnicode
+  class Converter
+    # Comprehensive mapping of TeX commands to Unicode characters
+    TEX_TO_UNICODE = {
+      # Greek letters (lowercase)
+      '\\alpha' => 'α', '\\beta' => 'β', '\\gamma' => 'γ', '\\delta' => 'δ',
+      '\\epsilon' => 'ε', '\\varepsilon' => 'ϵ', '\\zeta' => 'ζ', '\\eta' => 'η',
+      '\\theta' => 'θ', '\\vartheta' => 'ϑ', '\\iota' => 'ι', '\\kappa' => 'κ',
+      '\\lambda' => 'λ', '\\mu' => 'μ', '\\nu' => 'ν', '\\xi' => 'ξ',
+      '\\pi' => 'π', '\\varpi' => 'ϖ', '\\rho' => 'ρ', '\\varrho' => 'ϱ',
+      '\\sigma' => 'σ', '\\varsigma' => 'ς', '\\tau' => 'τ', '\\upsilon' => 'υ',
+      '\\phi' => 'φ', '\\varphi' => 'ϕ', '\\chi' => 'χ', '\\psi' => 'ψ',
+      '\\omega' => 'ω',
+
+      # Greek letters (uppercase)
+      '\\Gamma' => 'Γ', '\\Delta' => 'Δ', '\\Theta' => 'Θ', '\\Lambda' => 'Λ',
+      '\\Xi' => 'Ξ', '\\Pi' => 'Π', '\\Sigma' => 'Σ', '\\Upsilon' => 'Υ',
+      '\\Phi' => 'Φ', '\\Psi' => 'Ψ', '\\Omega' => 'Ω',
+
+      # Math operators
+      '\\pm' => '±', '\\mp' => '∓', '\\times' => '×', '\\div' => '÷',
+      '\\cdot' => '·', '\\ast' => '∗', '\\star' => '⋆', '\\circ' => '∘',
+      '\\bullet' => '•', '\\oplus' => '⊕', '\\ominus' => '⊖', '\\otimes' => '⊗',
+      '\\oslash' => '⊘', '\\odot' => '⊙', '\\bigcirc' => '◯',
+
+      # Relations
+      '\\leq' => '≤', '\\le' => '≤', '\\geq' => '≥', '\\ge' => '≥',
+      '\\neq' => '≠', '\\ne' => '≠', '\\equiv' => '≡', '\\approx' => '≈',
+      '\\cong' => '≅', '\\simeq' => '≃', '\\sim' => '∼', '\\propto' => '∝',
+      '\\ll' => '≪', '\\gg' => '≫', '\\asymp' => '≍',
+      '\\subset' => '⊂', '\\supset' => '⊃', '\\subseteq' => '⊆', '\\supseteq' => '⊇',
+      '\\in' => '∈', '\\ni' => '∋', '\\notin' => '∉',
+
+      # Arrows
+      '\\leftarrow' => '←', '\\gets' => '←', '\\rightarrow' => '→', '\\to' => '→',
+      '\\leftrightarrow' => '↔', '\\Leftarrow' => '⇐', '\\Rightarrow' => '⇒',
+      '\\Leftrightarrow' => '⇔', '\\uparrow' => '↑', '\\downarrow' => '↓',
+      '\\updownarrow' => '↕', '\\Uparrow' => '⇑', '\\Downarrow' => '⇓',
+      '\\Updownarrow' => '⇕', '\\mapsto' => '↦', '\\longleftarrow' => '⟵',
+      '\\longrightarrow' => '⟶', '\\longleftrightarrow' => '⟷',
+      '\\Longleftarrow' => '⟸', '\\Longrightarrow' => '⟹', '\\Longleftrightarrow' => '⟺',
+
+      # Special symbols
+      '\\infty' => '∞', '\\partial' => '∂', '\\nabla' => '∇', '\\emptyset' => '∅',
+      '\\varnothing' => '∅', '\\aleph' => 'ℵ', '\\wp' => '℘', '\\Re' => 'ℜ',
+      '\\Im' => 'ℑ', '\\ell' => 'ℓ', '\\hbar' => 'ℏ', '\\angle' => '∠',
+      '\\forall' => '∀', '\\exists' => '∃', '\\nexists' => '∄',
+      '\\neg' => '¬', '\\lnot' => '¬', '\\land' => '∧', '\\lor' => '∨',
+      '\\wedge' => '∧', '\\vee' => '∨', '\\cap' => '∩', '\\cup' => '∪',
+      '\\top' => '⊤', '\\bot' => '⊥', '\\perp' => '⊥',
+
+      # Calculus
+      '\\int' => '∫', '\\iint' => '∬', '\\iiint' => '∭', '\\oint' => '∮',
+      '\\sum' => '∑', '\\prod' => '∏', '\\coprod' => '∐',
+
+      # Set theory
+      '\\setminus' => '∖', '\\bigcap' => '⋂', '\\bigcup' => '⋃',
+      '\\sqsubset' => '⊏', '\\sqsupset' => '⊐', '\\sqsubseteq' => '⊑', '\\sqsupseteq' => '⊒',
+
+      # Logic
+      '\\vdash' => '⊢', '\\dashv' => '⊣', '\\models' => '⊨',
+      '\\therefore' => '∴', '\\because' => '∵',
+
+      # Misc
+      '\\dagger' => '†', '\\ddagger' => '‡', '\\S' => '§', '\\P' => '¶',
+      '\\copyright' => '©', '\\pounds' => '£', '\\yen' => '¥', '\\euro' => '€',
+      '\\degree' => '°', '\\prime' => '′', '\\dprime' => '″',
+      '\\dots' => '…', '\\ldots' => '…', '\\cdots' => '⋯',
+      '\\vdots' => '⋮', '\\ddots' => '⋱',
+
+      # Fractions (common ones)
+      '\\frac12' => '½', '\\frac13' => '⅓', '\\frac14' => '¼',
+      '\\frac23' => '⅔', '\\frac34' => '¾',
+
+      # Superscripts
+      '^0' => '⁰', '^1' => '¹', '^2' => '²', '^3' => '³', '^4' => '⁴',
+      '^5' => '⁵', '^6' => '⁶', '^7' => '⁷', '^8' => '⁸', '^9' => '⁹',
+      '^+' => '⁺', '^-' => '⁻', '^=' => '⁼', '^(' => '⁽', '^)' => '⁾',
+      '^n' => 'ⁿ', '^i' => 'ⁱ',
+
+      # Subscripts
+      '_0' => '₀', '_1' => '₁', '_2' => '₂', '_3' => '₃', '_4' => '₄',
+      '_5' => '₅', '_6' => '₆', '_7' => '₇', '_8' => '₈', '_9' => '₉',
+      '_+' => '₊', '_-' => '₋', '_=' => '₌', '_(' => '₍', '_)' => '₎',
+
+      # Brackets
+      '\\langle' => '⟨', '\\rangle' => '⟩', '\\lceil' => '⌈', '\\rceil' => '⌉',
+      '\\lfloor' => '⌊', '\\rfloor' => '⌋', '\\lbrace' => '{', '\\rbrace' => '}',
+      '\\lbrack' => '[', '\\rbrack' => ']',
+
+      # Accents and modifiers (approximate)
+      '\\hat{a}' => 'â', '\\hat{e}' => 'ê', '\\hat{i}' => 'î', '\\hat{o}' => 'ô', '\\hat{u}' => 'û',
+      '\\tilde{a}' => 'ã', '\\tilde{n}' => 'ñ', '\\tilde{o}' => 'õ',
+      "\\'{a}" => 'á', "\\'{e}" => 'é', "\\'{i}" => 'í', "\\'{o}" => 'ó', "\\'{u}" => 'ú',
+      '\\`{a}' => 'à', '\\`{e}' => 'è', '\\`{i}' => 'ì', '\\`{o}' => 'ò', '\\`{u}' => 'ù',
+
+      # Box drawing
+      '\\square' => '□', '\\blacksquare' => '■', '\\Box' => '□',
+      '\\triangle' => '△', '\\blacktriangle' => '▲',
+      '\\diamondsuit' => '♦', '\\heartsuit' => '♥', '\\clubsuit' => '♣', '\\spadesuit' => '♠',
+
+      # Musical
+      '\\sharp' => '♯', '\\flat' => '♭', '\\natural' => '♮',
+
+      # Misc symbols
+      '\\checkmark' => '✓', '\\maltese' => '✠',
+
+      # Blackboard bold (common sets)
+      '\\mathbb{C}' => 'ℂ', '\\mathbb{H}' => 'ℍ', '\\mathbb{N}' => 'ℕ',
+      '\\mathbb{P}' => 'ℙ', '\\mathbb{Q}' => 'ℚ', '\\mathbb{R}' => 'ℝ',
+      '\\mathbb{Z}' => 'ℤ',
+
+      # Additional useful symbols
+      '\\sqrt' => '√', '\\surd' => '√',
+    }.freeze
+
+    def self.convert(text)
+      result = text.dup
+
+      # Sort by length (descending) to match longer patterns first
+      TEX_TO_UNICODE.keys.sort_by { |k| -k.length }.each do |tex|
+        result.gsub!(tex, TEX_TO_UNICODE[tex])
+      end
+
+      result
+    end
+  end
+end

data/lib/tex_to_unicode.rb

@@ -0,0 +1,9 @@
+require_relative 'tex_to_unicode/converter'
+
+module TexToUnicode
+  VERSION = '0.1.0'
+
+  def self.convert(text)
+    Converter.convert(text)
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: tex_to_unicode
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Your Name
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-11-13 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby gem that converts TeX mathematical and other symbols to their
+  Unicode character equivalents, enabling easier display of mathematical notation
+  in plain text.
+email:
+- your.email@example.com
+executables:
+- tex_to_unicode
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/tex_to_unicode
+- lib/tex_to_unicode.rb
+- lib/tex_to_unicode/converter.rb
+homepage: https://github.com/yourusername/tex_to_unicode
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/yourusername/tex_to_unicode
+  bug_tracker_uri: https://github.com/yourusername/tex_to_unicode/issues
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Convert TeX math symbols to Unicode approximations
+test_files: []