Publish of Github pages from Gradle.

Author: mperry

examples-java8.html

@@ -101,6 +101,9 @@ <h2>Java 8 Examples</h2>
 <li>
 <p><a href="#optionMap">Option map</a></p>
 </li>
+<li>
+<p><a href="#ioWalkthrough">IO Walkthrough</a></p>
+</li>
 </ul>
 </div>
 </div>
@@ -393,6 +396,89 @@ <h2 id="optionMap">Option Map</h2>
 </div>
 </div>
 </div>
+</div>
+<div class="sect1">
+<h2 id="ioWalkthrough">IO Walkthrough</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><a href="https://github.com/functionaljava/functionaljava/blob/master/demo/src/main/java/fj/demo/IOWalkthrough.java">Github Source</a></p>
+</div>
+<div class="paragraph">
+<p>Demonstrates how to work with the IO type.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code class="language-java" data-lang="java">// IO is just a container to defer a computation (lazy), with the intention
+// to encapsulate computations that either consume and/or produce side-effects
+// the computation is not (yet) executed on creation hence it can be treated
+// like a value
+
+final IO&lt;Unit&gt; askName = () -&gt; {
+    System.out.println("Hi, what's your name?");
+    return Unit.unit();
+};
+
+// fj.data.IOFunctions contains a lot of convenience functions regarding IO, the
+// above example could be rewritten with IOFunctions.stdoutPrintln
+// we now create an IO value to prompt for the name if executed
+
+IO&lt;Unit&gt; promptName = IOFunctions.stdoutPrint("Name: ");
+
+// we can compose these two values with fj.data.IOFunctions.append, since they
+// both are not interested in any runtime value
+
+IO&lt;Unit&gt; askAndPromptName = IOFunctions.append(askName, promptName);
+
+// now we create an IO value to read a line from stdin
+
+final IO&lt;String&gt; readName = () -&gt; new BufferedReader(new InputStreamReader(System.in)).readLine();
+
+// this is the same as IOFunctions.stdinReadLine()
+
+// now we create a function which takes a string, upper cases it and creates
+// an IO value that would print the upper cased string if executed
+
+final F&lt;String, IO&lt;Unit&gt;&gt; upperCaseAndPrint = F1Functions.&lt;String, IO&lt;Unit&gt;, String&gt;o(IOFunctions::stdoutPrintln).f(String::toUpperCase);
+
+// we now want to compose reading the name with printing it, for that we need to
+// have access to the runtime value that is returned when the
+// IO value for read is executed, hence we use fj.data.IOFunctions.bind instead
+// of fj.data.IOFunctions.append
+
+final IO&lt;Unit&gt; readAndPrintUpperCasedName = IOFunctions.bind(readName, upperCaseAndPrint);
+
+// so append is really just a specialised form of bind, ignoring the runtime
+// value of the IO execution that was composed before us
+
+final IO&lt;Unit&gt; program = IOFunctions.bind(askAndPromptName, ignored -&gt; readAndPrintUpperCasedName);
+
+// this is the same as writing IOFunctions.append(askAndPromptName, readAndPrintUpperCasedName)
+
+// we have recorded the entire program, but have not run anything yet
+// now we get to the small dirty part at the end of our program where we actually
+// execute it
+
+// we can either choose to just call program.run(), which allows the execution to escape
+// or we use safe to receive an fj.data.Either with the potential exception on the
+// left side
+
+toSafeValidation(program).run().on((IOException e) -&gt; { e.printStackTrace(); return Unit.unit(); });
+
+// doing function composition like this can be quite cumbersome, since you will end
+// up nesting parenthesis unless you flatten it out by
+// assigning the functions to variables like above, but you can use the fj.F1W
+// syntax wrapper for composing single-argument functions and fj.data.IOW
+// for composing IO values instead, the entire program can be written like so:
+
+IOW.lift(stdoutPrintln("What's your name again?"))
+        .append(stdoutPrint("Name: "))
+        .append(stdinReadLine())
+        .bind(F1W.lift((String s) -&gt; s.toUpperCase())
+        .andThen(IOFunctions::stdoutPrintln))
+        .safe().run().on((IOException e) -&gt; { e.printStackTrace(); return Unit.unit(); });</code></pre>
+</div>
+</div>
+</div>
 </div></p>
           </article>
         </div> <!-- /.col-md-12 -->

feed.xml

@@ -6,8 +6,8 @@
     <atom:link href="http://functionaljava.github.io/feed.xml" rel="self" type="application/rss+xml" />
     <description>Functional programming in Java</description>
     <language>en</language>
-    <pubDate>Jul 3, 2016 11:12:01 PM</pubDate>
-    <lastBuildDate>Jul 3, 2016 11:12:01 PM</lastBuildDate>
+    <pubDate>Jul 4, 2016 12:08:49 AM</pubDate>
+    <lastBuildDate>Jul 4, 2016 12:08:49 AM</lastBuildDate>
 
   </channel> 
 </rss>