polites 0.1.0

data/lib/polites/block.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative '../polites'
+require_relative './node'
+
+module Polites
+  # A block represents a structural element in a Polites document, mapping to
+  # block-level elements in HTML. Examples include paragraphs and headings.
+  #
+  # Blocks may technically  contain other blocks, as well as {Text} and {Span}
+  # elements.
+  class Block < Node
+    # Build the proper kind of span from the given arguments.
+    #
+    # @param [Array<Node>] children
+    # @param [String] kind the type Polites has given to this node.
+    # @param [Fixnum] level the indentation level used by list items.
+    # @param [String] syntax the syntax attribute used in code blocks.
+    # @raise [ParseError] when encountering unexpected `kind`
+    # @return [Span]
+    def self.build(children = [], kind: 'paragraph', level: 0, syntax: nil)
+      case kind
+      when 'heading1'
+        Heading1.new(children)
+      when 'heading2'
+        Heading2.new(children)
+      when 'heading3'
+        Heading3.new(children)
+      when 'heading4'
+        Heading4.new(children)
+      when 'heading5'
+        Heading5.new(children)
+      when 'heading6'
+        Heading6.new(children)
+      when 'paragraph'
+        Paragraph.new(children)
+      when 'unorderedList'
+        UnorderedList.new(children, level)
+      when 'orderedList'
+        OrderedList.new(children, level)
+      when 'blockquote'
+        Blockquote.new(children)
+      when 'divider'
+        Divider.new(children)
+      when 'codeblock'
+        CodeBlock.new(children, syntax)
+      else
+        raise ParseError, "unknown block type #{kind.inspect}"
+      end
+    end
+  end
+end
+
+require_relative './block/heading1'
+require_relative './block/heading2'
+require_relative './block/heading3'
+require_relative './block/heading4'
+require_relative './block/heading5'
+require_relative './block/heading6'
+require_relative './block/paragraph'
+require_relative './block/ordered_list'
+require_relative './block/unordered_list'
+require_relative './block/blockquote'
+require_relative './block/divider'
+require_relative './block/code_block'

data/lib/polites/block/blockquote.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative '../block'
+
+module Polites
+  class Block::Blockquote < Block
+  end
+end

data/lib/polites/block/code_block.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative '../block'
+
+module Polites
+  class Block::CodeBlock < Block
+    attr_reader :syntax
+
+    def initialize(children, syntax)
+      @syntax = syntax
+      super(children)
+    end
+
+    def eql?(other)
+      super && syntax == other.syntax
+    end
+  end
+end

data/lib/polites/block/divider.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative '../block'
+
+module Polites
+  class Block::Divider < Block
+  end
+end

data/lib/polites/block/heading.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative '../block'
+
+module Polites
+  class Block::Heading < Block
+  end
+end

data/lib/polites/block/heading1.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './heading'
+
+module Polites
+  class Block::Heading1 < Block::Heading
+  end
+end

data/lib/polites/block/heading2.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './heading'
+
+module Polites
+  class Block::Heading2 < Block::Heading
+  end
+end

data/lib/polites/block/heading3.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './heading'
+
+module Polites
+  class Block::Heading3 < Block::Heading
+  end
+end

data/lib/polites/block/heading4.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './heading'
+
+module Polites
+  class Block::Heading4 < Block::Heading
+  end
+end

data/lib/polites/block/heading5.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './heading'
+
+module Polites
+  class Block::Heading5 < Block::Heading
+  end
+end

data/lib/polites/block/heading6.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './heading'
+
+module Polites
+  class Block::Heading6 < Block::Heading
+  end
+end

data/lib/polites/block/list.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative '../block'
+
+module Polites
+  class Block::List < Block
+    attr_reader :level
+
+    def initialize(children, level)
+      super(children)
+      @level = level
+    end
+  end
+end

data/lib/polites/block/ordered_list.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './list'
+
+module Polites
+  class Block::OrderedList < Block::List
+  end
+end

data/lib/polites/block/paragraph.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative '../block'
+
+module Polites
+  class Block::Paragraph < Block
+  end
+end

data/lib/polites/block/unordered_list.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative './list'
+
+module Polites
+  class Block::UnorderedList < Block::List
+  end
+end

data/lib/polites/cli.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require_relative './convert'
+require_relative './version'
+
+module Polites
+  # Provides the implentation of the command-line interface, exposing functions
+  # to be called from a shell or other programs.
+  #
+  # @example
+  #   Cli.new(stdin: $stdin, $stdout: stdout).call(ARGV)
+  class Cli
+    # @param [IO] stdin to read input from
+    # @param [IO] stdout to write output to
+    # @param [Hash] options default options
+    def initialize(stdin:, stdout:, options: {})
+      @stdin = stdin
+      @stdout = stdout
+      @options = options
+    end
+
+    # Invoke the program with some options.
+    #
+    # @param [Array<String>] args arguments given to the program invocation.
+    # @return [nil]
+    def call(args)
+      filenames = option_parser.parse(args, into: @options)
+      if @options[:help]
+        @stdout.puts option_parser
+      elsif @options[:version]
+        @stdout.puts Polites::VERSION
+      elsif filenames.any?
+        filenames.each do |filename|
+          @stdout.puts Convert.new.call(filename)
+        end
+      end
+      nil
+    end
+
+    private
+
+    def option_parser
+      @option_parser ||=
+        OptionParser.new do |o|
+          o.banner = 'Usage: polites [options] FILE'
+          o.on_tail '-v', '--version', 'Show current version'
+          o.on_tail '-h', '--help', 'Show this message'
+        end
+    end
+  end
+end

data/lib/polites/convert.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative './parser'
+require_relative './html_formatter'
+require_relative './file'
+
+module Polites
+  # Convert a Polites file to another format.
+  class Convert
+    # @param [Polites::Parser] parser
+    # @param [Polites::HtmlFormatter] formatter
+    def initialize(parser: Polites::Parser.new, formatter: Polites::HtmlFormatter.new)
+      @parser = parser
+      @formatter = formatter
+    end
+
+    # Convert the contents of `filename` to HTML and return the result as a String.
+    #
+    # @param [#to_s, #to_path] filename
+    # @return [String]
+    def call(filename)
+      File.open(filename) do |f|
+        f.content
+         .then { |c| @parser.parse_sheet(c) }
+         .then { |c| @formatter.call(c) }
+      end
+    end
+  end
+end

data/lib/polites/doc/_index.html

@@ -0,0 +1,85 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  Documentation by YARD 0.9.25
+  
+</title>
+
+  <link rel="stylesheet" href="css/style.css" type="text/css" />
+
+  <link rel="stylesheet" href="css/common.css" type="text/css" />
+
+<script type="text/javascript">
+  pathId = null;
+  relpath = '';
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="class_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><h1 class="noborder title">Documentation by YARD 0.9.25</h1>
+<div id="listing">
+  <h1 class="alphaindex">Alphabetic Index</h1>
+  
+<div class="clear"></div>
+<h2>Namespace Listing A-Z</h2>
+
+
+
+
+<table>
+  <tr>
+    <td valign='top' width="33%">
+      
+    </td>
+  </tr>
+</table>
+
+</div>
+
+</div>
+
+      <div id="footer">
+  Generated on Mon Nov 30 11:14:54 2020 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.25 (ruby-2.7.2).
+</div>
+
+    </div>
+  </body>
+</html>

data/lib/polites/doc/class_list.html

@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta charset="utf-8" />
+    
+      <link rel="stylesheet" href="css/full_list.css" type="text/css" media="screen" />
+    
+      <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" />
+    
+
+    
+      <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+    
+      <script type="text/javascript" charset="utf-8" src="js/full_list.js"></script>
+    
+
+    <title>Class List</title>
+    <base id="base_target" target="_parent" />
+  </head>
+  <body>
+    <div id="content">
+      <div class="fixed_header">
+        <h1 id="full_list_header">Class List</h1>
+        <div id="full_list_nav">
+          
+            <span><a target="_self" href="class_list.html">
+              Classes
+            </a></span>
+          
+            <span><a target="_self" href="method_list.html">
+              Methods
+            </a></span>
+          
+            <span><a target="_self" href="file_list.html">
+              Files
+            </a></span>
+          
+        </div>
+
+        <div id="search">Search: <input type="text" /></div>
+      </div>
+
+      <ul id="full_list" class="class">
+        <li id="object_" class="odd"><div class="item" style="padding-left:30px"><span class='object_link'><a href="top-level-namespace.html" title="Top Level Namespace (root)">Top Level Namespace</a></span></div></li>
+
+
+      </ul>
+    </div>
+  </body>
+</html>

data/lib/polites/doc/css/common.css

@@ -0,0 +1 @@
+/* Override this file with custom rules */

data/lib/polites/doc/css/full_list.css

@@ -0,0 +1,58 @@
+body {
+  margin: 0;
+  font-family: "Lucida Sans", "Lucida Grande", Verdana, Arial, sans-serif;
+  font-size: 13px;
+  height: 101%;
+  overflow-x: hidden;
+  background: #fafafa;
+}
+
+h1 { padding: 12px 10px; padding-bottom: 0; margin: 0; font-size: 1.4em; }
+.clear { clear: both; }
+.fixed_header { position: fixed; background: #fff; width: 100%; padding-bottom: 10px; margin-top: 0; top: 0; z-index: 9999; height: 70px; }
+#search { position: absolute; right: 5px; top: 9px; padding-left: 24px; }
+#content.insearch #search, #content.insearch #noresults { background: url(data:image/gif;base64,R0lGODlhEAAQAPYAAP///wAAAPr6+pKSkoiIiO7u7sjIyNjY2J6engAAAI6OjsbGxjIyMlJSUuzs7KamppSUlPLy8oKCghwcHLKysqSkpJqamvT09Pj4+KioqM7OzkRERAwMDGBgYN7e3ujo6Ly8vCoqKjY2NkZGRtTU1MTExDw8PE5OTj4+PkhISNDQ0MrKylpaWrS0tOrq6nBwcKysrLi4uLq6ul5eXlxcXGJiYoaGhuDg4H5+fvz8/KKiohgYGCwsLFZWVgQEBFBQUMzMzDg4OFhYWBoaGvDw8NbW1pycnOLi4ubm5kBAQKqqqiQkJCAgIK6urnJyckpKSjQ0NGpqatLS0sDAwCYmJnx8fEJCQlRUVAoKCggICLCwsOTk5ExMTPb29ra2tmZmZmhoaNzc3KCgoBISEiIiIgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH/C05FVFNDQVBFMi4wAwEAAAAh/hpDcmVhdGVkIHdpdGggYWpheGxvYWQuaW5mbwAh+QQJCAAAACwAAAAAEAAQAAAHaIAAgoMgIiYlg4kACxIaACEJCSiKggYMCRselwkpghGJBJEcFgsjJyoAGBmfggcNEx0flBiKDhQFlIoCCA+5lAORFb4AJIihCRbDxQAFChAXw9HSqb60iREZ1omqrIPdJCTe0SWI09GBACH5BAkIAAAALAAAAAAQABAAAAdrgACCgwc0NTeDiYozCQkvOTo9GTmDKy8aFy+NOBA7CTswgywJDTIuEjYFIY0JNYMtKTEFiRU8Pjwygy4ws4owPyCKwsMAJSTEgiQlgsbIAMrO0dKDGMTViREZ14kYGRGK38nHguHEJcvTyIEAIfkECQgAAAAsAAAAABAAEAAAB2iAAIKDAggPg4iJAAMJCRUAJRIqiRGCBI0WQEEJJkWDERkYAAUKEBc4Po1GiKKJHkJDNEeKig4URLS0ICImJZAkuQAhjSi/wQyNKcGDCyMnk8u5rYrTgqDVghgZlYjcACTA1sslvtHRgQAh+QQJCAAAACwAAAAAEAAQAAAHZ4AAgoOEhYaCJSWHgxGDJCQARAtOUoQRGRiFD0kJUYWZhUhKT1OLhR8wBaaFBzQ1NwAlkIszCQkvsbOHL7Y4q4IuEjaqq0ZQD5+GEEsJTDCMmIUhtgk1lo6QFUwJVDKLiYJNUd6/hoEAIfkECQgAAAAsAAAAABAAEAAAB2iAAIKDhIWGgiUlh4MRgyQkjIURGRiGGBmNhJWHm4uen4ICCA+IkIsDCQkVACWmhwSpFqAABQoQF6ALTkWFnYMrVlhWvIKTlSAiJiVVPqlGhJkhqShHV1lCW4cMqSkAR1ofiwsjJyqGgQAh+QQJCAAAACwAAAAAEAAQAAAHZ4AAgoOEhYaCJSWHgxGDJCSMhREZGIYYGY2ElYebi56fhyWQniSKAKKfpaCLFlAPhl0gXYNGEwkhGYREUywag1wJwSkHNDU3D0kJYIMZQwk8MjPBLx9eXwuETVEyAC/BOKsuEjYFhoEAIfkECQgAAAAsAAAAABAAEAAAB2eAAIKDhIWGgiUlh4MRgyQkjIURGRiGGBmNhJWHm4ueICImip6CIQkJKJ4kigynKaqKCyMnKqSEK05StgAGQRxPYZaENqccFgIID4KXmQBhXFkzDgOnFYLNgltaSAAEpxa7BQoQF4aBACH5BAkIAAAALAAAAAAQABAAAAdogACCg4SFggJiPUqCJSWGgkZjCUwZACQkgxGEXAmdT4UYGZqCGWQ+IjKGGIUwPzGPhAc0NTewhDOdL7Ykji+dOLuOLhI2BbaFETICx4MlQitdqoUsCQ2vhKGjglNfU0SWmILaj43M5oEAOwAAAAAAAAAAAA==) no-repeat center left; }
+#full_list { padding: 0; list-style: none; margin-left: 0; margin-top: 80px; font-size: 1.1em; }
+#full_list ul { padding: 0; }
+#full_list li { padding: 0; margin: 0; list-style: none; }
+#full_list li .item { padding: 5px 5px 5px 12px; }
+#noresults { padding: 7px 12px; background: #fff; }
+#content.insearch #noresults { margin-left: 7px; }
+li.collapsed ul { display: none; }
+li a.toggle { cursor: default; position: relative; left: -5px; top: 4px; text-indent: -999px; width: 10px; height: 9px; margin-left: -10px; display: block; float: left; background: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAASCAYAAABb0P4QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAK8AAACvABQqw0mAAAABx0RVh0U29mdHdhcmUAQWRvYmUgRmlyZXdvcmtzIENTM5jWRgMAAAAVdEVYdENyZWF0aW9uIFRpbWUAMy8xNC8wOeNZPpQAAAE2SURBVDiNrZTBccIwEEXfelIAHUA6CZ24BGaWO+FuzZAK4k6gg5QAdGAq+Bxs2Yqx7BzyL7Llp/VfzZeQhCTc/ezuGzKKnKSzpCxXJM8fwNXda3df5RZETlIt6YUzSQDs93sl8w3wBZxCCE10GM1OcWbWjB2mWgEH4Mfdyxm3PSepBHibgQE2wLe7r4HjEidpnXMYdQPKEMJcsZ4zs2POYQOcaPfwMVOo58zsAdMt18BuoVDPxUJRacELbXv3hUIX2vYmOUvi8C8ydz/ThjXrqKqqLbDIAdsCKBd+Wo7GWa7o9qzOQHVVVXeAbs+yHHCH4aTsaCOQqunmUy1yBUAXkdMIfMlgF5EXLo2OpV/c/Up7jG4hhHcYLgWzAZXUc2b2ixsfvc/RmNNfOXD3Q/oeL9axJE1yT9IOoUu6MGUkAAAAAElFTkSuQmCC) no-repeat bottom left; }
+li.collapsed a.toggle { opacity: 0.5; cursor: default; background-position: top left; }
+li { color: #888; cursor: pointer; }
+li.deprecated { text-decoration: line-through; font-style: italic; }
+li.odd { background: #f0f0f0; }
+li.even { background: #fafafa; }
+.item:hover { background: #ddd; }
+li small:before { content: "("; }
+li small:after { content: ")"; }
+li small.search_info { display: none; }
+a, a:visited { text-decoration: none; color: #05a; }
+li.clicked > .item { background: #05a; color: #ccc; }
+li.clicked > .item a, li.clicked > .item a:visited { color: #eee; }
+li.clicked > .item a.toggle { opacity: 0.5; background-position: bottom right; }
+li.collapsed.clicked a.toggle { background-position: top right; }
+#search input { border: 1px solid #bbb; border-radius: 3px; }
+#full_list_nav { margin-left: 10px; font-size: 0.9em; display: block; color: #aaa; }
+#full_list_nav a, #nav a:visited { color: #358; }
+#full_list_nav a:hover { background: transparent; color: #5af; }
+#full_list_nav span:after { content: ' | '; }
+#full_list_nav span:last-child:after { content: ''; }
+
+#content h1 { margin-top: 0; }
+li { white-space: nowrap; cursor: normal; }
+li small { display: block; font-size: 0.8em; }
+li small:before { content: ""; }
+li small:after { content: ""; }
+li small.search_info { display: none; }
+#search { width: 170px; position: static; margin: 3px; margin-left: 10px; font-size: 0.9em; color: #888; padding-left: 0; padding-right: 24px; }
+#content.insearch #search { background-position: center right; }
+#search input { width: 110px; }
+
+#full_list.insearch ul { display: block; }
+#full_list.insearch .item { display: none; }
+#full_list.insearch .found { display: block; padding-left: 11px !important; }
+#full_list.insearch li a.toggle { display: none; }
+#full_list.insearch li small.search_info { display: block; }