tickly 2.1.6 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: d5507beab7129bc0fab4875bad56c60d27da4613
-  data.tar.gz: 3335803e4bf7621e151838262f4b096bced5bf44
+SHA256:
+  metadata.gz: 84fc69dbbbcec1f30a09e9bfe2e628739873a1943f8ed083ee2ea7b5ee3f1402
+  data.tar.gz: 8b73945da9ec7a8bff04c4cea00299fc7de5b15d5b418b9043300efec20ca41d
 SHA512:
-  metadata.gz: d343db5ed8d576c3c4220724864d908a8ce45f1db9370773563d432108ed251bd600a8d6d7506863a78e4665483aa890b8e6c72e6517c344ff2ac501113ead0c
-  data.tar.gz: 23cb0139524770b959c259f4e19f2cc5d78c17657507037e93b92c1a1d80fc878a864e73f80d1b21b7002357e64d7d68afe50caeb4d0dbcadcb68d616f1711a5
+  metadata.gz: bb277be3b1a06de64d144f0fbf745bf9eee3b74f8623ef09005f15712bef540b3dbdaa20d69da31efa9ca22098e0418e68b8370c7b46a29ba57c4ca43b35ea7e
+  data.tar.gz: e3ffde08e7ec5ef7b4e9424cb247b2d85a29246d0163e3257c54ac824aca765fb9d93218fe53a97f14380662fd835382cf9875d12c6404f829c52884c19006e8

data/.gitignore

@@ -0,0 +1,52 @@
+Gemfile.lock
+profiler_calls.html
+
+# rcov generated
+coverage
+coverage.data
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+#*.swp
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc

data/.travis.yml

@@ -1,5 +1,5 @@
 rvm:
-  - 1.8.7
-  - 1.9.2
   - 1.9.3
-  - 2.0.0-p247
+  - 2.5.0
+cache: bundler
+sudo: false

data/Gemfile

@@ -1,11 +1,3 @@
 source "http://rubygems.org"
 
-# Add dependencies to develop your gem here.
-# Include everything needed to run rake, tests, features, etc.
-group :development do
-  gem "rake"
-  gem "rdoc", "~> 3.12"
-  gem "jeweler", "~> 1.8.7"
-  # Use the older ruby-prof that still supports 1.8.7
-  gem "ruby-prof", '0.13.0'
-end
+gemspec

data/README.md

@@ -1,3 +1,5 @@
+[![Build Status](https://travis-ci.org/julik/tickly.svg?branch=master)](https://travis-ci.org/julik/tickly)
+
 A highly simplistic TCL parser and evaluator (primarily designed for parsing Nuke scripts).
 It transforms the passed Nuke scripts into a TCL AST. 
 It also supports some cheap tricks to discard the nodes you are not interested in, since Nuke
@@ -64,10 +66,10 @@ and memory.
 To match nodes you create Ruby classes matching the node classes by name. It doesn't matter if your
 custom node handler is inside a module since the processor will only use the last part of the name.
 
-For example, to capture every +SomeNode+ in your script:
+For example, to capture every `Blur` node in your script:
     
     # Remember, only the last part of the class name matters
-    class MyAwesomeDirtyScript::SomeNode
+    class MyAwesomeDirtyScript::Blur
       attr_reader :knobs
       def initialize(string_keyed_knobs_hash)
         @knobs = string_keyed_knobs_hash
@@ -83,10 +85,10 @@ For example, to capture every +SomeNode+ in your script:
     # Open the ginormous Nuke script
     file = File.open("/mnt/raid/nuke/scripts/HugeShot_123.nk")
     
-    e.parse(file) do | every_some_node |
-      # Everytime a SomeNode is found in the script it will be instantiated,
+    e.parse(file) do | blur_node |
+      # Everytime a Blur node is found in the script it will be instantiated,
       # and the knobs of the node will be passed to the constructor that you define
-      x_position = every_some_node.knobs["x_pos"]
+      kernel_size = blur_node.knobs["radius"]
       ...
     end
 
@@ -99,11 +101,41 @@ nodes containing tracking data:
     parser.add_node_handler_class(PlanarTracker1_0)
     parser.add_node_handler_class(Tracker4)
 
+Then you will need to handle switching between node types during parsing
+
+    e.parse(file) do | detected_node |
+      if detected_node.is_a?(Tracker3)
+	    ...
+	  else
+	    ...
+	  end
+    end
+
+Node clones are not supported.
+
 ## Animation curves
 
-You can parse Nuke's animation curves using Tickly::Curve. This will give you a way to iterate over every defined keyframe.
+You can parse Nuke's animation curves using `Tickly::Curve`. This will give you a way to iterate over every defined keyframe.
 This currently does not happen automatically for things passing through the parser.
 
+## Tip: Speeding up parsing
+
+Normally, Tickly will accept strings and IO objects as sources. However if you want a little performance boost
+when parsing actual _files_ (or long IO objects that can be prebuffered) you should use it together
+with [bychar](http://rubygems.org/gems/bychar), version 3 or newer - like so:
+
+    p = Tickly::Parser.new
+    File.open("/mnt/raid/comps/s023_v23.nk", "r") do | f |
+	  expressions = p.parse(Bychar.wrap(f))
+	  ...
+	end
+	
+This way some of the IO will be prebuffered for you and give you improved reading performance when parsing.
+
+Tracksperanto does the bychar wrapping thing automatically, so no need to worry about that.
+
+
+
 ## Contributing to tickly
 
 Just like tracksperanto Tickly no longer ships with test data in gem format (since the test data amounts to

data/Rakefile

@@ -1,36 +1,5 @@
-# encoding: utf-8
-
-require 'rubygems'
-require 'bundler'
-require File.dirname(__FILE__) + "/lib/tickly"
-
-begin
-  Bundler.setup(:default, :development)
-rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
-require 'rake'
-
-require 'jeweler'
-Jeweler::Tasks.new do |gem|
-  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
-  gem.version = Tickly::VERSION
-  gem.name = "tickly"
-  gem.homepage = "http://github.com/julik/tickly"
-  gem.license = "MIT"
-  gem.summary = %Q{Assists in parsing Nuke scripts in TCL}
-  gem.description = %Q{Parses the subset of the TCL grammar needed for Nuke scripts}
-  gem.email = "me@julik.nl"
-  gem.authors = ["Julik Tarkhanov"]
-  # dependencies defined in Gemfile
-  
-  # Do not package test data
-  gem.files.exclude "test/test-data/*.*"
-end
-
-Jeweler::RubygemsDotOrgTasks.new
+require "bundler/gem_tasks"
+require 'rake/testtask'
 
 require 'rake/testtask'
 Rake::TestTask.new(:test) do |test|
@@ -39,10 +8,8 @@ Rake::TestTask.new(:test) do |test|
   test.verbose = true
 end
 
-task :default => :test
-
 require 'rdoc/task'
-Rake::RDocTask.new do |rdoc|
+RDoc::Task.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ""
 
   rdoc.rdoc_dir = 'rdoc'
@@ -51,20 +18,26 @@ Rake::RDocTask.new do |rdoc|
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
 
-desc "Profiles the parser"
-task :profile do
-  require 'ruby-prof'
-  p = Tickly::NodeProcessor.new
-  f = File.open(File.dirname(__FILE__) + "/test/test-data/huge_nuke_tcl.tcl")
+desc "Benchmarks the parser"
+task :bench do
+  require File.dirname(__FILE__) + "/lib/tickly"
+  require 'benchmark'
 
-  RubyProf.start
-  p.parse(f) {|_| }
-  result = RubyProf.stop
+  class Tracker3
+    def initialize(n); end
+  end
 
-  # Print a call graph
-  File.open("profiler_calls.html", "w") do | f |
-    RubyProf::GraphHtmlPrinter.new(result).print(f)
+  pe = Tickly::NodeProcessor.new
+  pe.add_node_handler_class(Tracker3)
+  
+  HUGE_SCRIPT = File.open(File.dirname(__FILE__) + "/test/test-data/huge_nuke_tcl.tcl", "rb")
+  Benchmark.bm do | runner |
+    runner.report("Parsing a huge Nuke script:") do
+      counter = 0
+      pe.parse(HUGE_SCRIPT) { counter += 1 }
+      HUGE_SCRIPT.rewind
+    end
   end
-  `open profiler_calls.html`
 end
 
+task :default => [:test, :bench]

data/lib/tickly/curve.rb

@@ -1,3 +1,4 @@
+# shareable_constant_value: literal
 module Tickly
   # A shorthand class for Nuke's animation curves.
   # Will convert a passed Curve expression into a set of values,

data/lib/tickly/parser.rb

@@ -1,3 +1,4 @@
+# shareable_constant_value: literal
 require 'stringio'
 
 module Tickly
@@ -53,7 +54,7 @@ module Tickly
     private
     
     TERMINATORS = ["\n", ";"]
-    ESC = 92.chr # Backslash (\)
+    ESC = 92.chr.freeze # Backslash (\)
     QUOTES = %w( " ' )
     
     # Package the expressions, stack and buffer.

data/lib/tickly/version.rb

@@ -0,0 +1,3 @@
+module Tickly
+  VERSION = "2.2.0"
+end

data/lib/tickly.rb

@@ -2,7 +2,7 @@ require File.dirname(__FILE__) + "/tickly/parser"
 require File.dirname(__FILE__) + "/tickly/evaluator"
 require File.dirname(__FILE__) + "/tickly/curve"
 require File.dirname(__FILE__) + "/tickly/node_processor"
+require File.dirname(__FILE__) + "/tickly/version"
 
 module Tickly
-  VERSION = '2.1.6'
 end

data/test/test_benchmark.rb

@@ -3,19 +3,5 @@ require 'benchmark'
 
 class TestParserEvaluator < Test::Unit::TestCase
   
-  class Tracker3
-    def initialize(n); end
-  end
-
-  def test_parses_huge
-    pe = Tickly::NodeProcessor.new
-    pe.add_node_handler_class(Tracker3)
-    
-    Benchmark.bm do | runner |
-      runner.report("Parsing a huge Nuke script:") do
-        counter = 0
-        pe.parse(HUGE_SCRIPT) { counter += 1 }
-      end
-    end
-  end
+  
 end

data/test/test_emitter.rb

@@ -13,7 +13,7 @@ class TestEmitter < Test::Unit::TestCase
     assert_equal [:b, "2", "2"], se("2", "2")
   end
   
-  def test_emitter_be
+  def test_emitter_be_with_subexpression
     assert_equal [:b, [:c,"2", "2"]], se(le("2", "2"))
   end
   

data/test/test_ractor.rb

@@ -0,0 +1,31 @@
+require 'helper'
+
+class TestRactor < Test::Unit::TestCase
+  class Tracker4
+    attr_reader :knobs
+    def initialize(knobs)
+      @knobs = knobs
+    end
+  end
+
+  def test_parses_and_evaluates_inside_a_ractor
+    omit "Needs Ruby 4.0+ Ractors" unless defined?(Ractor) && Ractor.method_defined?(:value)
+
+    path = File.dirname(__FILE__) + "/test-data/nuke7_tracker_2tracks.nk"
+    experimental_warnings, Warning[:experimental] = Warning[:experimental], false
+    begin
+      names = Ractor.new(path) do |script_path|
+        pe = Tickly::NodeProcessor.new
+        pe.add_node_handler_class(TestRactor::Tracker4)
+        File.open(script_path, "rb") do |f|
+          nodes = []
+          pe.parse(f) { |node| nodes << node.knobs["name"] }
+          nodes
+        end
+      end.value
+      assert_equal ["Tracker1"], names
+    ensure
+      Warning[:experimental] = experimental_warnings
+    end
+  end
+end

data/tickly.gemspec

@@ -1,68 +1,28 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-# stub: tickly 2.1.6 ruby lib
+require File.dirname(__FILE__) + '/lib/tickly/version'
 
 Gem::Specification.new do |s|
   s.name = "tickly"
-  s.version = "2.1.6"
+  s.version = Tickly::VERSION
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.required_ruby_version = ">= 2.6"
   s.require_paths = ["lib"]
   s.authors = ["Julik Tarkhanov"]
-  s.date = "2014-12-10"
+  s.date = Time.now.utc.strftime("%Y-%m-%d")
   s.description = "Parses the subset of the TCL grammar needed for Nuke scripts"
   s.email = "me@julik.nl"
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.md"
   ]
-  s.files = [
-    ".document",
-    ".travis.yml",
-    "Gemfile",
-    "LICENSE.txt",
-    "README.md",
-    "Rakefile",
-    "lib/tickly.rb",
-    "lib/tickly/curve.rb",
-    "lib/tickly/evaluator.rb",
-    "lib/tickly/node_processor.rb",
-    "lib/tickly/parser.rb",
-    "test/helper.rb",
-    "test/test_benchmark.rb",
-    "test/test_curve.rb",
-    "test/test_emitter.rb",
-    "test/test_evaluator.rb",
-    "test/test_node_processor.rb",
-    "test/test_parser.rb",
-    "tickly.gemspec"
-  ]
+  s.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.start_with? "test/test-data/"
+  end
   s.homepage = "http://github.com/julik/tickly"
   s.licenses = ["MIT"]
-  s.rubygems_version = "2.2.2"
   s.summary = "Assists in parsing Nuke scripts in TCL"
 
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rake>, [">= 0"])
-      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.8.7"])
-      s.add_development_dependency(%q<ruby-prof>, ["= 0.13.0"])
-    else
-      s.add_dependency(%q<rake>, [">= 0"])
-      s.add_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
-      s.add_dependency(%q<ruby-prof>, ["= 0.13.0"])
-    end
-  else
-    s.add_dependency(%q<rake>, [">= 0"])
-    s.add_dependency(%q<rdoc>, ["~> 3.12"])
-    s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
-    s.add_dependency(%q<ruby-prof>, ["= 0.13.0"])
-  end
+  s.add_development_dependency("rake")
+  s.add_development_dependency("rdoc")
+  s.add_development_dependency("benchmark")
+  s.add_development_dependency("test-unit")
 end
-

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tickly
 version: !ruby/object:Gem::Version
-  version: 2.1.6
+  version: 2.2.0
 platform: ruby
 authors:
 - Julik Tarkhanov
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-10 00:00:00.000000000 Z
+date: 2026-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -28,44 +27,44 @@ dependencies:
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: jeweler
+  name: benchmark
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.8.7
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.8.7
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: ruby-prof
+  name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: '0'
 description: Parses the subset of the TCL grammar needed for Nuke scripts
 email: me@julik.nl
 executables: []
@@ -75,6 +74,7 @@ extra_rdoc_files:
 - README.md
 files:
 - ".document"
+- ".gitignore"
 - ".travis.yml"
 - Gemfile
 - LICENSE.txt
@@ -85,6 +85,7 @@ files:
 - lib/tickly/evaluator.rb
 - lib/tickly/node_processor.rb
 - lib/tickly/parser.rb
+- lib/tickly/version.rb
 - test/helper.rb
 - test/test_benchmark.rb
 - test/test_curve.rb
@@ -92,12 +93,12 @@ files:
 - test/test_evaluator.rb
 - test/test_node_processor.rb
 - test/test_parser.rb
+- test/test_ractor.rb
 - tickly.gemspec
 homepage: http://github.com/julik/tickly
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -105,16 +106,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
-signing_key: 
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Assists in parsing Nuke scripts in TCL
 test_files: []