task_list 1.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c880856dc7b8d07412ca13a34e76735b76fe3a89
+  data.tar.gz: 12d60a0027b513fd71d955155a9a93f800ac3ff3
+SHA512:
+  metadata.gz: db517c764d14e7d36d1a7528d54ca01d302c0d42525fa19451cddaf2ef0ef798a3e53ffcaefb5e3d7671c92a9c37ee1369e07f1f54235f9367153c6d0983fd04
+  data.tar.gz: c949fcc3518569cd16fefec6332dd79773ad927ee1043b039a15a00f1854051485a949aa746b380b114fe95c8e8e531bce1a67d7a31df9710849b0827b2200bf

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+bin/
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+bower_components
+node_modules
+vendor/gems/

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+install: ./script/bootstrap
+script: ./script/cibuild
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.1
+notifications:
+  email: false

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 GitHub, Inc.
+
+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,76 @@
+# Task Lists
+
+This package provides various components necessary for integrating
+[Task Lists](https://github.com/blog/1375-task-lists-in-gfm-issues-pulls-comments)
+into your GitHub-flavored-Markdown user content.
+
+## Components
+
+The Task List feature is actually made of several different components:
+
+* GitHub-flavored-Markdown Filter
+* Model: summarizes task list items
+* JavaScript: task list update behavior
+* CSS: styles Markdown task list items
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'task_list'
+
+And then execute:
+
+    $ bundle
+
+### Rails 3+: Railtie method
+
+``` ruby
+# config/application.rb
+require 'task_list/railtie'
+```
+
+### Rails 2.3: Manual method
+
+Wherever you have your Sprockets setup:
+
+``` ruby
+Sprockets::Environment.new(Rails.root) do |env|
+  # Load TaskList assets
+  require 'task_list/railtie'
+  TaskList.asset_paths.each do |path|
+    env.append_path path
+  end
+end
+```
+
+If you're not using Sprockets, you're on your own but it's pretty straight
+forward. `task_list/railtie` defines `TaskList.asset_paths` which you can use
+to manage building your asset bundles.
+
+### CoffeeScript Requirements
+
+Aside from requiring CoffeeScript, jQuery is the only other requirement.
+
+## Testing and Development
+
+JavaScript unit tests can be run with `script/testsuite`.
+
+Ruby unit tests can be run with `rake test`.
+
+Functional tests are more for manual testing in the browser. To run, install
+the necessary components with `script/bootstrap` then run the server:
+
+```
+rackup -p 4011
+```
+
+Navigate to http://localhost:4011/test/functional/test_task_lists_behavior.html
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task :default => :test
+Rake::TestTask.new do |t|
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end

data/app/assets/javascripts/task_list.coffee

@@ -0,0 +1,237 @@
+# TaskList Behavior
+#
+#= provides tasklist:enabled
+#= provides tasklist:disabled
+#= provides tasklist:change
+#= provides tasklist:changed
+#
+#= require jquery
+#
+# Enables Task List update behavior.
+#
+# ### Example Markup
+#
+#   <div class="js-task-list-container">
+#     <ul class="task-list">
+#       <li class="task-list-item">
+#         <input type="checkbox" class="js-task-list-item-checkbox" disabled />
+#         text
+#       </li>
+#     </ul>
+#     <form>
+#       <textarea class="js-task-list-field">- [ ] text</textarea>
+#     </form>
+#   </div>
+#
+# ### Specification
+#
+# TaskLists MUST be contained in a `(div).js-task-list-container`.
+#
+# TaskList Items SHOULD be an a list (`UL`/`OL`) element.
+#
+# Task list items MUST match `(input).task-list-item-checkbox` and MUST be
+# `disabled` by default.
+#
+# TaskLists MUST have a `(textarea).js-task-list-field` form element whose
+# `value` attribute is the source (Markdown) to be udpated. The source MUST
+# follow the syntax guidelines.
+#
+# TaskList updates trigger `tasklist:change` events. If the change is
+# successful, `tasklist:changed` is fired. The change can be canceled.
+#
+# jQuery is required.
+#
+# ### Methods
+#
+# `.taskList('enable')` or `.taskList()`
+#
+# Enables TaskList updates for the container.
+#
+# `.taskList('disable')`
+#
+# Disables TaskList updates for the container.
+#
+## ### Events
+#
+# `tasklist:enabled`
+#
+# Fired when the TaskList is enabled.
+#
+# * **Synchronicity** Sync
+# * **Bubbles** Yes
+# * **Cancelable** No
+# * **Target** `.js-task-list-container`
+#
+# `tasklist:disabled`
+#
+# Fired when the TaskList is disabled.
+#
+# * **Synchronicity** Sync
+# * **Bubbles** Yes
+# * **Cancelable** No
+# * **Target** `.js-task-list-container`
+#
+# `tasklist:change`
+#
+# Fired before the TaskList item change takes affect.
+#
+# * **Synchronicity** Sync
+# * **Bubbles** Yes
+# * **Cancelable** Yes
+# * **Target** `.js-task-list-field`
+#
+# `tasklist:changed`
+#
+# Fired once the TaskList item change has taken affect.
+#
+# * **Synchronicity** Sync
+# * **Bubbles** Yes
+# * **Cancelable** No
+# * **Target** `.js-task-list-field`
+#
+# ### NOTE
+#
+# Task list checkboxes are rendered as disabled by default because rendered
+# user content is cached without regard for the viewer.
+
+incomplete = "[ ]"
+complete   = "[x]"
+
+# Escapes the String for regular expression matching.
+escapePattern = (str) ->
+  str.
+    replace(/([\[\]])/g, "\\$1"). # escape square brackets
+    replace(/\s/, "\\s").         # match all white space
+    replace("x", "[xX]")          # match all cases
+
+incompletePattern = ///
+  #{escapePattern(incomplete)}
+///
+completePattern = ///
+  #{escapePattern(complete)}
+///
+
+# Pattern used to identify all task list items.
+# Useful when you need iterate over all items.
+itemPattern = ///
+  ^
+  (?:                     # prefix, consisting of
+    \s*                   # optional leading whitespace
+    (?:>\s*)*             # zero or more blockquotes
+    (?:[-+*]|(?:\d+\.))   # list item indicator
+  )
+  \s*                     # optional whitespace prefix
+  (                       # checkbox
+    #{escapePattern(complete)}|
+    #{escapePattern(incomplete)}
+  )
+  \s+                     # is followed by whitespace
+  (?!
+    \(.*?\)               # is not part of a [foo](url) link
+  )
+  (?=                     # and is followed by zero or more links
+    (?:\[.*?\]\s*(?:\[.*?\]|\(.*?\))\s*)*
+    (?:[^\[]|$)           # and either a non-link or the end of the string
+  )
+///
+
+# Used to filter out code fences from the source for comparison only.
+# http://rubular.com/r/x5EwZVrloI
+# Modified slightly due to issues with JS
+codeFencesPattern = ///
+  ^`{3}           # ```
+    (?:\s*\w+)?   # followed by optional language
+    [\S\s]        # whitespace
+  .*              # code
+  [\S\s]          # whitespace
+  ^`{3}$          # ```
+///mg
+
+# Used to filter out potential mismatches (items not in lists).
+# http://rubular.com/r/OInl6CiePy
+itemsInParasPattern = ///
+  ^
+  (
+    #{escapePattern(complete)}|
+    #{escapePattern(incomplete)}
+  )
+  .+
+  $
+///g
+
+# Given the source text, updates the appropriate task list item to match the
+# given checked value.
+#
+# Returns the updated String text.
+updateTaskListItem = (source, itemIndex, checked) ->
+  clean = source.replace(/\r/g, '').replace(codeFencesPattern, '').
+    replace(itemsInParasPattern, '').split("\n")
+  index = 0
+  result = for line in source.split("\n")
+    if line in clean && line.match(itemPattern)
+      index += 1
+      if index == itemIndex
+        line =
+          if checked
+            line.replace(incompletePattern, complete)
+          else
+            line.replace(completePattern, incomplete)
+    line
+  result.join("\n")
+
+# Updates the $field value to reflect the state of $item.
+# Triggers the `tasklist:change` event before the value has changed, and fires
+# a `tasklist:changed` event once the value has changed.
+updateTaskList = ($item) ->
+  $container = $item.closest '.js-task-list-container'
+  $field     = $container.find '.js-task-list-field'
+  index      = 1 + $container.find('.task-list-item-checkbox').index($item)
+  checked    = $item.prop 'checked'
+
+  event = $.Event 'tasklist:change'
+  $field.trigger event, [index, checked]
+
+  unless event.isDefaultPrevented()
+    $field.val updateTaskListItem($field.val(), index, checked)
+    $field.trigger 'change'
+    $field.trigger 'tasklist:changed', [index, checked]
+
+# When the task list item checkbox is updated, submit the change
+$(document).on 'change', '.task-list-item-checkbox', ->
+  updateTaskList $(this)
+
+# Enables TaskList item changes.
+enableTaskList = ($container) ->
+  if $container.find('.js-task-list-field').length > 0
+    $container.
+      find('.task-list-item').addClass('enabled').
+      find('.task-list-item-checkbox').attr('disabled', null)
+    $container.addClass('is-task-list-enabled').
+      trigger 'tasklist:enabled'
+
+# Enables a collection of TaskList containers.
+enableTaskLists = ($containers) ->
+  for container in $containers
+    enableTaskList $(container)
+
+# Disable TaskList item changes.
+disableTaskList = ($container) ->
+  $container.
+    find('.task-list-item').removeClass('enabled').
+    find('.task-list-item-checkbox').attr('disabled', 'disabled')
+  $container.removeClass('is-task-list-enabled').
+    trigger 'tasklist:disabled'
+
+# Disables a collection of TaskList containers.
+disableTaskLists = ($containers) ->
+  for container in $containers
+    disableTaskList $(container)
+
+$.fn.taskList = (method) ->
+  $container = $(this).closest('.js-task-list-container')
+
+  methods =
+    enable: enableTaskLists
+    disable: disableTaskLists
+
+  methods[method || 'enable']($container)

data/app/assets/stylesheets/task_list.scss

@@ -0,0 +1,20 @@
+// Requires use of `.markdown-body` to override default markdown list styles
+.markdown-body .task-list {
+  list-style-type: none;
+  padding-left: 10px;
+}
+
+.task-list-item {
+  padding-left: 20px;
+}
+.task-list-item label {
+  font-weight: normal;
+}
+.task-list-item + .task-list-item {
+  margin-top: 3px;
+}
+.task-list-item-checkbox {
+  float: left;
+  margin-left: -20px;
+  margin-top: 4px;
+}

data/bower.json

@@ -0,0 +1,26 @@
+{
+  "name": "task_list",
+  "version": "1.0.2",
+  "dependencies": {
+    "jquery": ">= 1.9.1"
+  },
+  "devDependencies": {
+    "qunit": ">= 1.0"
+  },
+  "main": [
+    "app/assets/javascripts/task_list.coffee",
+    "app/assets/stylesheets/task_list.scss"
+  ],
+  "ignore": [
+    ".gitignore",
+    ".travis.yml",
+    "*.gemspec",
+    "*.md",
+    "config.ru",
+    "Gemfile",
+    "lib/",
+    "Rakefile",
+    "script/",
+    "test/"
+  ]
+}

data/config.ru

@@ -0,0 +1,30 @@
+# Rack environment for testing purposes
+
+require 'coffee-script'
+require 'json'
+require 'sprockets'
+
+Root = File.expand_path("..", __FILE__)
+
+Assets = Sprockets::Environment.new(Root) do |env|
+  env.append_path "bower_components"
+  env.append_path "app/assets/javascripts"
+  env.append_path "app/assets/stylesheets"
+  env.append_path "test"
+end
+
+map "/assets" do
+  run Assets
+end
+
+map "/update" do
+  run lambda { |env|
+    sleep 0.5
+    req = Rack::Request.new(env)
+    [200, {'Content-Type' => 'application/json'}, [req.params.to_json]]
+  }
+end
+
+map "/" do
+  run Rack::Directory.new(Root)
+end