ruby_wordcram 1.0.1 → 2.0.0

data/src/wordcram/WordSkipReason.java

@@ -0,0 +1,42 @@
+package wordcram;
+
+public enum WordSkipReason {
+	
+	/**
+     * Skip Reason: the Word was skipped because the WordCram had already drawn
+     * the {@link WordCram#maxNumberOfWordsToDraw(int)}.
+     * It's really about the Word's rank, its position in the list once the
+     * words are sorted by weight: if its rank is greater than the value passed
+     * to maxNumberOfWordsToDraw(), then it'll be skipped, and this will be the
+     * reason code.
+     */
+	WAS_OVER_MAX_NUMBER_OF_WORDS("we already reached the maxNumberOfWordsToDraw threshold"),
+	
+	/**
+     * Skip Reason: the Word's shape was smaller than
+     * {@link WordCram#minShapeSize(int)}.
+     * WordCram will only render words so small, for performance reasons. You
+     * can set the minimum Word shape size via
+     * {@link WordCram#minShapeSize(int)}.
+     */
+    SHAPE_WAS_TOO_SMALL("it was below the minShapeSize threshold"),
+    
+    /**
+     * Skip Reason: WordCram tried placing the Word, but it couldn't find a
+     * clear spot. The {@link WordNudger} nudged it around a bunch (according
+     * to {@link WordCram#maxAttemptsToPlaceWord(int)}, if it was set), but
+     * there was just no room.
+     */
+    NO_SPACE("there wasn't enough space near where you wanted it placed");
+
+    String reason;
+
+    WordSkipReason(String reason) {
+        this.reason = reason;
+    }
+
+        @Override
+    public String toString() {
+        return reason;
+    }
+}

data/src/wordcram/WordSorterAndScaler.java

@@ -0,0 +1,31 @@
+package wordcram;
+
+import java.util.Arrays;
+
+class WordSorterAndScaler {
+
+    public Word[] sortAndScale(Word[] rawWords) {
+    	if (rawWords.length == 0) {
+    		return rawWords;
+    	}
+
+        Word[] words = copy(rawWords);
+        Arrays.sort(words);
+        float maxWeight = words[0].weight;
+
+        for (Word word : words) {
+            word.weight = word.weight / maxWeight;
+        }
+
+        return words;
+    }
+
+    private Word[] copy(Word[] rawWords) {
+
+        // was Arrays.copyOf(rawWords, rawWords.length); - removed for Java 1.5 compatibility.
+
+        Word[] copy = new Word[rawWords.length];
+        System.arraycopy(rawWords, 0, copy, 0, copy.length);
+        return copy;
+    }
+}

data/src/wordcram/WordSource.java

@@ -0,0 +1,5 @@
+package wordcram;
+
+public interface WordSource {
+  public Word[] getWords();
+}

data/src/wordcram/text/Html.java

@@ -0,0 +1,15 @@
+package wordcram.text;
+
+public class Html implements TextSource {
+
+    private final String src;
+
+    public Html(String htmlSrc) {
+        src = htmlSrc;
+    }
+
+    @Override
+    public String getText() {
+        return new Html2Text().text(src, null);
+    }
+}

data/src/wordcram/text/Html2Text.java

@@ -0,0 +1,17 @@
+package wordcram.text;
+
+import org.jsoup.Jsoup;
+import org.jsoup.nodes.Document;
+
+class Html2Text {
+	public String text(String html, String cssSelector) {
+		Document doc = Jsoup.parse(html);
+
+		if (cssSelector == null) {
+			return doc.text();
+		}
+		else {
+			return doc.select(cssSelector).text();
+		}
+	}
+}

data/src/wordcram/text/Text.java

@@ -0,0 +1,15 @@
+package wordcram.text;
+
+public class Text implements TextSource {
+
+    private final String text;
+
+    public Text(String _text) {
+        text = _text;
+    }
+
+    @Override
+    public String getText() {
+        return text;
+    }
+}

data/src/wordcram/text/TextFile.java

@@ -0,0 +1,23 @@
+package wordcram.text;
+
+import processing.core.PApplet;
+
+public class TextFile implements TextSource {
+
+    private final String path;
+
+    // TODO if we move all .text.* classes into WordCram, we can kill this, and
+    // use pkg-local methods for setting the parent...
+    private final PApplet parent;
+
+    public TextFile(String path, PApplet parent) {
+        this.path = path;
+        this.parent = parent;
+    }
+
+    @Override
+    public String getText() {
+        return PApplet.join(parent.loadStrings(path), ' ');
+    }
+
+}

data/src/wordcram/text/TextSource.java

@@ -0,0 +1,5 @@
+package wordcram.text;
+
+public interface TextSource {
+    public String getText();
+}

data/src/wordcram/text/WebPage.java

@@ -0,0 +1,23 @@
+package wordcram.text;
+
+import processing.core.PApplet;
+
+public class WebPage implements TextSource {
+
+    private final String url;
+    private final String cssSelector;
+    private final PApplet parent;
+
+    public WebPage(String url, String cssSelector, PApplet parent) {
+        this.url = url;
+        this.cssSelector = cssSelector;
+        this.parent = parent;
+    }
+
+    @Override
+    public String getText() {
+        String html = PApplet.join(parent.loadStrings(url), ' ');
+        return new Html2Text().text(html, cssSelector);
+    }
+
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_wordcram
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Dan Bernier
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-08 00:00:00.000000000 Z
+date: 2017-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -42,6 +42,8 @@ extra_rdoc_files:
 - LICENSE
 files:
 - ".gitignore"
+- ".mvn/extensions.xml"
+- ".mvn/wrapper/maven-wrapper.properties"
 - CHANGELOG.md
 - LICENSE
 - README.md
@@ -59,6 +61,7 @@ files:
 - docs/_layouts/page.html
 - docs/_layouts/post.html
 - docs/_posts/2017-03-07-getting_started.md
+- docs/_posts/2017-03-07-under_the_hood.md
 - docs/_sass/_base.scss
 - docs/_sass/_layout.scss
 - docs/_sass/_syntax-highlighting.scss
@@ -70,12 +73,98 @@ files:
 - example/data/MINYN___.TTF
 - example/test.rb
 - lib/WordCram.jar
-- lib/cue.language.jar
-- lib/jsoup-1.7.2.jar
+- lib/jsoup-1.10.2.jar
 - lib/ruby_wordcram.rb
 - lib/ruby_wordcram/version.rb
+- pom.rb
+- pom.xml
 - ruby_wordcram.gemspec
-- vendors/Rakefile
+- src/cue/lang/Counter.java
+- src/cue/lang/IterableText.java
+- src/cue/lang/NGramIterator.java
+- src/cue/lang/SentenceIterator.java
+- src/cue/lang/WordIterator.java
+- src/cue/lang/stop/StopWords.java
+- src/cue/lang/stop/arabic
+- src/cue/lang/stop/armenian
+- src/cue/lang/stop/catalan
+- src/cue/lang/stop/croatian
+- src/cue/lang/stop/czech
+- src/cue/lang/stop/danish
+- src/cue/lang/stop/dutch
+- src/cue/lang/stop/english
+- src/cue/lang/stop/esperanto
+- src/cue/lang/stop/farsi
+- src/cue/lang/stop/finnish
+- src/cue/lang/stop/french
+- src/cue/lang/stop/german
+- src/cue/lang/stop/greek
+- src/cue/lang/stop/hebrew
+- src/cue/lang/stop/hindi
+- src/cue/lang/stop/hungarian
+- src/cue/lang/stop/italian
+- src/cue/lang/stop/latin
+- src/cue/lang/stop/norwegian
+- src/cue/lang/stop/polish
+- src/cue/lang/stop/portuguese
+- src/cue/lang/stop/romanian
+- src/cue/lang/stop/russian
+- src/cue/lang/stop/slovak
+- src/cue/lang/stop/slovenian
+- src/cue/lang/stop/spanish
+- src/cue/lang/stop/swedish
+- src/cue/lang/stop/turkish
+- src/cue/lang/unicode/BlockUtil.java
+- src/cue/lang/unicode/Normalizer.java
+- src/cue/lang/unicode/Normalizer6.java
+- src/license.txt
+- src/wordcram/Anglers.java
+- src/wordcram/BBTree.java
+- src/wordcram/BBTreeBuilder.java
+- src/wordcram/Colorers.java
+- src/wordcram/EngineWord.java
+- src/wordcram/Fonters.java
+- src/wordcram/HsbWordColorer.java
+- src/wordcram/ImageShaper.java
+- src/wordcram/Observer.java
+- src/wordcram/PlacerHeatMap.java
+- src/wordcram/Placers.java
+- src/wordcram/PlottingWordNudger.java
+- src/wordcram/PlottingWordPlacer.java
+- src/wordcram/ProcessingWordRenderer.java
+- src/wordcram/RandomWordNudger.java
+- src/wordcram/RenderOptions.java
+- src/wordcram/ShapeBasedPlacer.java
+- src/wordcram/Sizers.java
+- src/wordcram/SketchCallbackObserver.java
+- src/wordcram/SpiralWordNudger.java
+- src/wordcram/SvgWordRenderer.java
+- src/wordcram/SwirlWordPlacer.java
+- src/wordcram/UpperLeftWordPlacer.java
+- src/wordcram/WaveWordPlacer.java
+- src/wordcram/Word.java
+- src/wordcram/WordAngler.java
+- src/wordcram/WordArray.java
+- src/wordcram/WordBag.java
+- src/wordcram/WordColorer.java
+- src/wordcram/WordCounter.java
+- src/wordcram/WordCram.java
+- src/wordcram/WordCramEngine.java
+- src/wordcram/WordFonter.java
+- src/wordcram/WordNudger.java
+- src/wordcram/WordPlacer.java
+- src/wordcram/WordRenderer.java
+- src/wordcram/WordShaper.java
+- src/wordcram/WordSizer.java
+- src/wordcram/WordSkipReason.java
+- src/wordcram/WordSorterAndScaler.java
+- src/wordcram/WordSource.java
+- src/wordcram/text/Html.java
+- src/wordcram/text/Html2Text.java
+- src/wordcram/text/Text.java
+- src/wordcram/text/TextFile.java
+- src/wordcram/text/TextSource.java
+- src/wordcram/text/WebPage.java
 homepage: http://ruby-processing.github.io/WordCram/
 licenses:
 - Apache-2.0

data/vendors/Rakefile

@@ -1,51 +0,0 @@
-require 'rake/clean'
-
-WARNING = <<-EOS.freeze
-   WARNING: you may not have wget installed
-
-EOS
-
-WORDCRAM_VERSION     = '1.0.0'
-CLOBBER.include("wordcram.#{WORDCRAM_VERSION}.zip")
-
-desc "download, and copy to wordcram/lib"
-task :default => [:download, :unpack_library, :copy_jars]
-
-desc "download wordcram upstream sources"
-task :download => ["wordcram.#{WORDCRAM_VERSION}.zip"]
-
-file "wordcram.#{WORDCRAM_VERSION}.zip" do
-  begin
-    sh "wget http://wordcram.org/wordcram.#{WORDCRAM_VERSION}.zip"
-  rescue
-    warn(WARNING)
-  end
-  check_sha256("wordcram.#{WORDCRAM_VERSION}.zip", "d6b936db3628806099eba3f309fad81dae7f3db5e2a2846742c959b03eb0d25f")
-end
-
-desc "unpack wordcram library"
-task :unpack_library do
-  sh "unzip wordcram.#{WORDCRAM_VERSION}.zip"
-end
-
-directory "../lib"
-
-desc "copy jars"
-task :copy_jars => ["../lib"] do
-  sh "cp -v WordCram/library/WordCram.jar ../lib/WordCram.jar"
-  sh "cp -v WordCram/library/cue.language.jar ../lib/cue.language.jar"
-  sh "cp -v WordCram/library/jsoup-1.7.2.jar ../lib/jsoup-1.7.2.jar"
-end
-
-def check_sha256(filename, expected_hash)
-  require "digest"
-  sha256 = Digest::SHA256.new
-  File.open(filename, "r") do |f|
-    while buf = f.read(4096)
-      sha256.update(buf)
-    end
-  end
-  if sha256.hexdigest != expected_hash
-    raise "bad sha256 checksum for #{filename} (expected #{expected_hash} got #{sha256.hexdigest})"
-  end
-end