swift-playground 0.0.1

data/lib/swift/playground/util/pipeline/section_filter.rb

@@ -0,0 +1,55 @@
+require 'html/pipeline'
+
+module Swift::Playground::Util
+  class Pipeline
+    class SectionFilter < HTML::Pipeline::Filter
+      def call
+        # Solution derived from http://stackoverflow.com/a/4799902
+        children = doc.children # Every immediate child of the doc
+        doc.inner_html = ''     # Empty the doc now that we have our nodes
+
+        # Comments preceding a swift code section can have meaning, so we need
+        # to track the last comment made:
+        last_comment = nil
+        section = new_section(doc) # Create our first container in the doc
+        children.each do |node|
+          if node.name == 'comment'
+            last_comment = node.content.strip
+          elsif node.name == 'pre' && node[:lang] == 'swift' && last_comment != 'IGNORE'
+            # If this code is the first thing in the document then the previous
+            # section will be empty and the only child of the document, so we
+            # should remove it:
+            section.remove if section.content.empty? && doc.children.count == 1
+
+            swift_section = new_section(doc, role: 'code')
+            swift_section[:title] = last_comment unless last_comment.blank?
+            node.remove_attribute('lang')
+            swift_section << node
+
+            section = new_section(doc) # Create a new container for subsequent nodes
+          else
+            last_comment = nil unless node.name == 'text' && node.content.blank?
+            section << node
+          end
+        end
+        section.remove if section.content.empty?  # Get rid of a trailing, empty section
+
+        doc
+      end
+
+      private
+
+      def new_section(doc, attributes = {})
+        attributes = {
+          role: 'documentation'
+        }.merge(attributes)
+
+        section = (doc << '<section>').children.last
+        attributes.each do |attribute, value|
+          section[attribute] = value
+        end
+        section
+      end
+    end
+  end
+end

data/lib/swift/playground/util/pipeline/unicode_emoji_filter.rb

@@ -0,0 +1,27 @@
+require 'html/pipeline'
+
+module Swift::Playground::Util
+  class Pipeline
+    class UnicodeEmojiFilter < HTML::Pipeline::EmojiFilter
+
+      def validate
+        # No need to for :asset_root in context like EmojiFilter requires
+      end
+
+      # Override EmojiFilter's image replacement to replace with Unicode instead:
+      def emoji_image_filter(text)
+        text.gsub(emoji_pattern) do |match|
+          name = $1
+          "<span class='emoji'>#{emoji_unicode_replacement(name)}</span>"
+        end
+      end
+
+      private
+
+      def emoji_unicode_replacement(name)
+        Emoji.find_by_alias(name).raw
+      end
+
+    end
+  end
+end

data/lib/swift/playground/util/syntax_highlighting.rb

@@ -0,0 +1,24 @@
+require 'pygments'
+
+module Swift
+  class Playground
+    module Util
+      class SyntaxHighlighting
+        class << self
+          def available?
+            Gem::Specification::find_all_by_name('github-linguist').any? &&
+            Gem::Specification::find_all_by_name('pygments.rb').any?
+          end
+
+          def css(style = 'default')
+            if available?
+              Pygments.css('.highlight', style: style)
+            else
+              ''
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/swift-playground.gemspec

@@ -0,0 +1,29 @@
+# Ensure we require the local version and not one we might have installed already
+require File.join([File.dirname(__FILE__), 'lib', 'swift', 'playground', 'metadata.rb'])
+spec = Gem::Specification.new do |s|
+  s.name          = 'swift-playground'
+  s.version       = Swift::Playground::VERSION
+  s.authors       = ['Mark Haylock']
+  s.email         = ['mark@resolvedigital.co.nz']
+  s.homepage      = 'https://github.com/resolve/swift-playground'
+  s.license       = 'MIT'
+  s.summary       = Swift::Playground::SUMMARY
+  s.description   = Swift::Playground::DESCRIPTION
+
+  s.files         = `git ls-files -z`.split("\x0")
+  s.executables   = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ['lib']
+
+  s.required_ruby_version = '>= 2.0.0'
+
+  s.add_runtime_dependency 'html-pipeline', '~> 1.11'
+  s.add_runtime_dependency 'activesupport', '~> 4.0'
+  s.add_runtime_dependency 'github-markdown', '~> 0.6.7'
+  s.add_runtime_dependency 'sanitize', '~> 3.0'
+  s.add_runtime_dependency 'gemoji', '~> 2.1.0'
+  s.add_runtime_dependency 'gli', '~> 2.12.2'
+  s.add_runtime_dependency 'paint', '~> 0.9.0'
+  s.add_runtime_dependency 'highline', '~> 1.6.21'
+  s.add_runtime_dependency 'sass', '~> 3.4.10'
+end

metadata

@@ -0,0 +1,207 @@
+--- !ruby/object:Gem::Specification
+name: swift-playground
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mark Haylock
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: html-pipeline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: github-markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.7
+- !ruby/object:Gem::Dependency
+  name: sanitize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: gemoji
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.2
+- !ruby/object:Gem::Dependency
+  name: paint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.21
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.21
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.4.10
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.4.10
+description: A Ruby API and CLI tool for manipulating Xcode Swift Playgrounds. Supports
+  generation from markdown files with the intent to aide in the production of polished
+  playground documents.
+email:
+- mark@resolvedigital.co.nz
+executables:
+- swift-playground
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/swift-playground
+- lib/swift/playground.rb
+- lib/swift/playground/asset.rb
+- lib/swift/playground/assets/javascript.rb
+- lib/swift/playground/assets/stylesheet.rb
+- lib/swift/playground/cli.rb
+- lib/swift/playground/cli/commands/generate.rb
+- lib/swift/playground/cli/commands/new.rb
+- lib/swift/playground/cli/definition.rb
+- lib/swift/playground/cli/global/error_handling.rb
+- lib/swift/playground/cli/shared_attributes.rb
+- lib/swift/playground/cli/ui.rb
+- lib/swift/playground/debug.rb
+- lib/swift/playground/generator.rb
+- lib/swift/playground/metadata.rb
+- lib/swift/playground/section.rb
+- lib/swift/playground/sections/code_section.rb
+- lib/swift/playground/sections/documentation_section.rb
+- lib/swift/playground/template/Documentation/defaults.css.scss
+- lib/swift/playground/template/Documentation/section.html.erb
+- lib/swift/playground/template/contents.xcplayground.erb
+- lib/swift/playground/util.rb
+- lib/swift/playground/util/path_or_content.rb
+- lib/swift/playground/util/pipeline.rb
+- lib/swift/playground/util/pipeline/section_filter.rb
+- lib/swift/playground/util/pipeline/unicode_emoji_filter.rb
+- lib/swift/playground/util/syntax_highlighting.rb
+- swift-playground.gemspec
+homepage: https://github.com/resolve/swift-playground
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Create Xcode Swift Playgrounds, including generating from Markdown files.
+test_files: []