texrack 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MmE1MTFhNzg2NzBkMTRkNmYyYjMzZmM0MWM5NmMxN2RlNTRiYzM3ZA==
+  data.tar.gz: !binary |-
+    NmI3OTA3YjRhNDhlN2ExZmFmOWJiYmVjOGQyYmZmZmFkMTBkOTU5Yw==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZmI3ZDQ2MjcwYWVlYjQzNTJhNWEwYmYxYWQ0Y2I5YWZjYmQwYzI2ZTdlYzNl
+    ZjFhODc2ZDI2NjNmYTIxYWI4NjBlNjRiYzI1OGVkMDU0ODc1ZmJmMGFlYzEy
+    OGZlMzdlMmRkOGU0MDg2NDc1YmE0OWViMjk3ZTg2NTI5MDJlZTg=
+  data.tar.gz: !binary |-
+    NDE1YmZkYjY5ZTE4MDUwZDkyYTBiOTZjOTI0OWFmYmJkMWY4N2I0YjA4ZmI3
+    OGExOTUzYTQ2MDM0NGRhZGNmMmI1YzA0MzI3ZGE2MjIxODA5NGNjMGU1MWY2
+    MzZhMjc2YzNkNDJhN2M0ZGM2OWM4NDRjZmI0MGZhNTk2NmVmNjM=

checksums.yaml.gz.asc

@@ -0,0 +1,18 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG/MacGPG2 v2.0.20 (Darwin)
+Comment: GPGTools - http://gpgtools.org
+
+iQIcBAABAgAGBQJSbpGjAAoJEH1ncb0Txu7XVnoP/1lZdSrAUwVvNYSrb/bpggKa
+2C4VKplgsB204dKV8HoLgLEThqaq7ljengC8bS/YHPAKS8DTclesPN9zZ7UzvLmF
+IvLYasZnTDC6zAgMUHdhAz3Y+epUOdMPjTid25i1C/Zs19ZQaD2E9SizsoqUf6rm
+2M4bBioMoYhxK8VzZvaehl84iXAg9fkWmkBYBITPf4Sr+luMoyXPBVeQMMXXneuE
+TfBWAYLH0C1dYk8/6Ys/ZIBVdNYkMO4iz9icE/mTBhTKHPt4BtEjas8/gt4Pvjkj
+Qqme7XKXMBdwp0Y95HWsfKrCVfM08S7RcbxsgNV6xuBHZQy9k9LU2i6z4aZD08fz
+kujdSnfOc7fO/GqukiYLHzHXiYJ6/BtHPRFQpo9O7sM1GlOktuIckyOlDsAKzfH8
+Bp6YcApw39QmoH+NBkXgQQOg3TSBhlzXapjLInRv4dtAsDFNVMkQQa9YXtdKOKik
+g9H7Q6grwx3ZRv8BypDFqhUoQnD1DY7dQu0A0+1QRAo4dJcECjSWLM5oyywVVKO3
+ctYvj4nD9Ma9QxNR2oL25pogjaRbx+CUMQaZYD2lnbpVt+BoEgO27AIkGVYYzsC1
+elN9CvkxDCrJhgRygz8NHDQ2Rfm6vYCx7gnJrp7+JpesDQRs+uTExurEEAlkSLFW
+zOzAeMo2w49TQcgl1cFW
+=1Kx8
+-----END PGP SIGNATURE-----

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Per Christian B. Viken <perchr@northblue.org>
+
+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,34 @@
+# texrack
+
+Simple Rack middleware to render LaTeX to PNGs on the fly.
+
+## Requirements
+
+* `pdflatex` must exist in `$PATH`
+* RMagick does the conversion from PDF to PNG, so `ImageMagick` must be
+  installed and available.
+
+## Configuration
+
+## Usage
+
+Either POST or GET to the configured URL with `data` set to the LaTeX source to
+compile.
+
+If you `GET /` without setting `data`, you get a simple form.
+
+### Display mode
+Everything is rendered inside a displaymath block (`\[` or `$$`) by default.
+To disable the displaymath block, pass `math=0`.
+
+### Packages
+The only included package is `amsmath`.
+To add more, send a pipe-separated string as `packages`.
+Arguments can be prepended.
+
+For example: `packages="[usenames,dvipsnames,svgnames,table]xcolor|amssymb"`
+turns into
+```latex
+\usepackage[usenames,dvipsnames,svgnames,table]{xcolor}
+\usepackage{amssymb}
+```

data/config.ru

@@ -0,0 +1,4 @@
+$:.unshift 'lib'
+require 'texrack'
+
+run Texrack::Endpoint

data/lib/texrack/endpoint.rb

@@ -0,0 +1,45 @@
+require 'sinatra/base'
+require 'erb'
+
+module Texrack
+  class Endpoint < Sinatra::Base
+    enable :logging
+
+    get '/' do
+      if params[:data].to_s.strip != ""
+        render_png(params[:data])
+      else
+        erb :form
+      end
+    end
+
+    post '/' do
+      render_png(params[:data])
+    end
+
+    def render_png(source)
+      content_type 'image/png'
+      @data      = source
+      pdf_source = erb :latex
+      pdf = Texrack::LatexToPdf.new(pdf_source, logger).generate_pdf
+      tmp = Tempfile.new(["texrack-output", ".png"])
+      png = Texrack::PdfToPng.new(pdf).to_file(tmp)
+      png
+    end
+
+    helpers do
+      def math_mode?
+        params[:math] != "0"
+      end
+
+      def packages
+        found = {}
+        params[:packages].to_s.split("|").each do |package|
+          details = package.match /(?:\[([^\]]+)\])?([A-Za-z]+)/
+          found[details[2]] = details[1]
+        end
+        found
+      end
+    end
+  end
+end

data/lib/texrack/latex_to_pdf.rb

@@ -0,0 +1,55 @@
+class Texrack::LatexToPdf
+  def self.config
+    @config ||= {command: 'pdflatex', arguments: [], parse_twice: false}
+  end
+
+  attr_reader :config, :latex, :logger
+
+  def initialize(latex, logger=Logger.new(STDOUT), overrides = {})
+    @latex  = latex
+    @logger = logger
+    @config = self.class.config.merge(overrides)
+  end
+
+  # Converts a string of LaTeX code into a binary string of PDF.
+  #
+  # pdflatex is used to convert the file.
+  def generate_pdf
+    logger.debug "Generating PDF from #{latex}"
+    input = Tempfile.new(["texrack-input", ".tex"])
+    input.binmode
+    input.write(latex)
+    input.flush
+
+    Process.waitpid(
+      fork do
+        begin
+          Dir.chdir File.dirname(input)
+          args = config[:arguments] + %w[-shell-escape -interaction batchmode -halt-on-error] + [input.path]
+
+          if config[:parse_twice]
+            logger.debug("Texrack executing (parse twice): #{config[:command]} -draftmode #{args}")
+            system config[:command], '-draftmode', *args
+          end
+
+          logger.debug "Texrack executing: #{config[:command]} #{args}"
+          exec config[:command], *args
+        rescue
+          logger.error "#{$!.message}:\n#{$!.backtrace.join("\n")}\n"
+        ensure
+          Process.exit! 1
+        end
+      end)
+
+    output = input.path.sub(/\.tex$/, '.pdf')
+    if File.exist?(output)
+      result = File.read(output)
+    else
+      logger.warn "Unable to find file #{output}"
+      raise "pdflatex failed"
+    end
+
+    input.close
+    result
+  end
+end

data/lib/texrack/pdf_to_png.rb

@@ -0,0 +1,15 @@
+require 'RMagick'
+
+class Texrack::PdfToPng
+  def initialize(blob)
+    @img = Magick::Image.from_blob(blob) do |info|
+      info.density = "300x300"
+      info.quality = 90
+    end[0]
+  end
+
+  def to_file(file)
+    @img.write('png:' + file.path)
+    file
+  end
+end

data/lib/texrack/version.rb

@@ -0,0 +1,3 @@
+module Texrack
+  VERSION = "0.1.0"
+end

data/lib/texrack/views/form.erb

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html>
+<head>
+<title>Texrack</title>
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<link rel="stylesheet" href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css">
+</head>
+<body>
+<div class="container">
+<h1 class="page-header">Render <img src="/?data=\LaTeX&math=0" alt="LaTeX"> as a PNG</h1>
+
+<form role="form" action="/" method="POST">
+  <div class="form-group">
+    <label for="data">LaTeX to render</label>
+    <textarea class="form-control" id="data" name="data" rows="5"></textarea>
+  </div>
+  <div class="checkbox">
+    <label>
+      <input type="hidden" name="math" value="0">
+      <input type="checkbox" checked name="math" value="1"> Render in math mode?
+    </label>
+  </div>
+  <div class="form-group">
+    <label for="packages">Extra packages to include</label>
+    <input type="text" class="form-control" id="packages" name="packages">
+    <p class="help-block">
+      Separate packages with a pipe (|).
+      Arguments are also supported. Example: "[english]babel|amsmath"
+    </p>
+  </div>
+
+  <div class="form-actions">
+    <input type="submit" class="btn btn-primary" value="Render PNG">
+  </div>
+</form>
+</div>
+</body>
+</html>

data/lib/texrack/views/latex.erb

@@ -0,0 +1,12 @@
+\documentclass[border=2pt,varwidth]{standalone}
+\usepackage{standalone}
+<% packages.each_pair do |package, arguments| %>
+  \usepackage<% if arguments %>[<%= arguments.to_s %>]<% end %>{<%= package %>}
+<% end %>
+\usepackage{amsmath}
+\begin{document}
+<% if math_mode? %>\[<% end %>
+<%= @data %>
+<% if math_mode? %>\]<% end %>
+\end{document}
+

data/lib/texrack.rb

@@ -0,0 +1,4 @@
+require 'texrack/version'
+require 'texrack/latex_to_pdf'
+require 'texrack/pdf_to_png'
+require 'texrack/endpoint'

data/texrack.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "texrack/version"
+
+Gem::Specification.new do |s|
+  s.name        = "texrack"
+  s.version     = Texrack::VERSION
+  s.authors     = ["Per Christian B. Viken"]
+  s.email       = ["perchr@northblue.org"]
+  s.homepage    = "https://github.com/PerfectlyNormal/texrack"
+  s.summary     = %q{Rack microservice to render LaTeX as PNG}
+  s.description = %q{texrack is a microservice that renders LaTeX as PNG files. Can be mounted in a Rack app}
+  s.licenses    = "MIT"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+
+  s.rdoc_options = [%q{--main=README.md}]
+
+  s.extra_rdoc_files = [
+    "MIT-LICENSE",
+    "README.md"
+  ]
+
+  s.add_dependency 'sinatra', '~> 1.4.4'
+  s.add_dependency 'rmagick', '~> 2.13.2'
+end

data.tar.gz.asc

@@ -0,0 +1,18 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG/MacGPG2 v2.0.20 (Darwin)
+Comment: GPGTools - http://gpgtools.org
+
+iQIcBAABAgAGBQJSbpGiAAoJEH1ncb0Txu7XPisP/R45LFwRbSbSsqUgfE4hTNda
+3XZhBDwrno1Rc/i3i29klT3/YmxhMSzNosDQReqrJA2rhC7eu/1lq8Ndt2gih/Pu
+9f0nOVauXAz1LwQgAn5M3jelqCt9PSUZfJVxsV1k48zFh0Vbl+oogZ25VRqcurN7
+bfMb3QdtXv3iIi9s1x5OwjVtpHqzMFVI4JpvAUTAOXacnaN1tnlTaUY9avoDrZc1
+Av0pk8Pu0w+G1IPEb3GRicXdq4Bl8dD/qlgSIXO/KWvgmVHqjoJTWHBnF92Ehist
+0SsZvEwY6VTZ19hYhCWKRpIbh37wR18e3rcRRia91d3iU1ggCJCSX8pBqkxsozFN
+h34jKTR45bIZOSEVV87Gdksea2PlgtG5uw1qBFXCEDkAQoMfKIom8bLvpssTNczf
+hg9wazU0CmJHddFqFA6SqtWf6BwZoJ0O/GXOso7MeBJ6y2Pl5IWyr8tBbqZf5NpF
+FIP7uPKLMO7KE28DYtrmcEKvA2jXmnQtK5ddztJkIUlZwie4zvS3WVSwKBjxOhFs
+XzYPV1q9bxiuVES2AGWA0yq/m4RBpKfJT+N47jm5zXMgvphJiQpHbPO3EA5RE+dQ
+TLmGAqZ1lM77WnN3qDCvfHNm+ovh2H9KixfOwnlahVL1WEhWA+XEki3sFemx1BB0
+OWV9BKLJ6NO1SAw/Tb5l
+=Vq2I
+-----END PGP SIGNATURE-----

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: texrack
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Per Christian B. Viken
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.4.4
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.4.4
+  type: :runtime
+  prerelease: false
+  name: sinatra
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.2
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.2
+  type: :runtime
+  prerelease: false
+  name: rmagick
+description: texrack is a microservice that renders LaTeX as PNG files. Can be mounted
+  in a Rack app
+email:
+- perchr@northblue.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- MIT-LICENSE
+- README.md
+files:
+- MIT-LICENSE
+- README.md
+- config.ru
+- lib/texrack.rb
+- lib/texrack/endpoint.rb
+- lib/texrack/latex_to_pdf.rb
+- lib/texrack/pdf_to_png.rb
+- lib/texrack/version.rb
+- lib/texrack/views/form.erb
+- lib/texrack/views/latex.erb
+- texrack.gemspec
+homepage: https://github.com/PerfectlyNormal/texrack
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- --main=README.md
+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.0.3
+signing_key: 
+specification_version: 4
+summary: Rack microservice to render LaTeX as PNG
+test_files: []
+has_rdoc: 

metadata.gz.asc

@@ -0,0 +1,18 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG/MacGPG2 v2.0.20 (Darwin)
+Comment: GPGTools - http://gpgtools.org
+
+iQIcBAABAgAGBQJSbpGiAAoJEH1ncb0Txu7X2UwP/1PwVQwNgtK6Q9fSQOiyDuyK
+teRGNeHN+AzddQ5z0YeA++fa8xUPRHbkc5VScZspypHoRVzrzbLsmrNHjRf95qNF
+ZcIoOXePuYSpUNLsVekUruB9EUC6LuXbgBxSuDkwP/pCpUnXARADP6qCVXDDJCwr
+xzwzvIQRkM3WkrxwaNDx8GKkwCuRu+bTPFg98XDHdqM4eK8faQKozzchFfFgGutB
+73VISK3SZFf9ciXH9HfeTi21SoyW3bQFO/Nzx+rFtOI/6A9XFvQ3yL6AWuBOnru3
+2J657sWu3N59spiuepU3V6b6esUiS6Oe1sJPIiUgVk5UFsWQ252baz6jIXaIBs7M
+E8eC/OUp2zGFUYv+gpr0wWQ9rnSG4KmHD7YSVQ2E+DrFKI+aNekVvrKvGkp+6qwa
+lReG7URHF7x6OXdC4WIZMYBPWzkpUF9TFdTGUyRYguItsOO0Gk0r1Amyl7E+SN1v
+wkaQ8GFO4pM3UxrEbtzKaSd0utGB1GeuHEnXfPeuEWG2vfRoGNJMB6y4GzpB3uLf
+jprL4cmUQgCMZz5+MPopneP5y1UK1i0fZLUCn0dcMoNpPa4Ga0zP+3y5VibzfsYW
+CHMkXPDstJAzmXjNngYz/CtlePt2X2nZSrfnocq0rr7/U2icqyMi78HaNLTF1bkC
+syu+g/0vyVyWXNEI84Uf
+=c1X7
+-----END PGP SIGNATURE-----