RubyGems - trackler - Versions diffs - 2.2.1.40 → 2.2.1.41 - Mend

trackler 2.2.1.40 → 2.2.1.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (376) hide show

data/tracks/cfml/docs/INSTALLATION.md ADDED Viewed

@@ -0,0 +1,35 @@
+## Installation
+The only thing you will need to run these exercises is [CommandBox CLI](https://ortus.gitbooks.io/commandbox-documentation/content/getting_started_guide.html) and [Java 7+](https://java.com/en/download/) installed.  CommandBox CLI is supported on Mac, Linux, and Windows, and the installation guide can be found here:
+[https://ortus.gitbooks.io/commandbox-documentation/content/setup/installation.html](https://ortus.gitbooks.io/commandbox-documentation/content/setup/installation.html)
+An example of getting CommandBox CLI setup if you're a Homebrew user on Mac would be:
+```bash
+brew install commandbox
+```
+Once you have the CLI installed, you can play withe REPL:
+```bash
+box repl
+```
+You can directly execute .cfm pages:
+```bash
+box exec myTest.cfm
+```
+And you can even start up a web server in any directory of your hard drive:
+```bash
+box server start
+```
+CommandBox has an interactive shell you can use that has enhanced tab completion and runs faster.  Enter it by just running the `box` binary with no arguments.
+```bash
+box
+```

data/tracks/cfml/docs/LEARNING.md ADDED Viewed

@@ -0,0 +1,37 @@
+## Recommended Learning Resources
+Welcome to learning ColdFusion (CFML)!  CFML is a dynamic and loosely typed JVM scripting language.  It has two different file types. `.cfm` files (ColdFusion markup)_ are purely procedural and use the tag-based syntax for templating out HTML.  You would use these for views if building a web site:
+**index.cfm**
+```xml
+<cfoutput>
+	<html>
+		<h1>Welcome to my site, #FirstName# #LastName#!
+	</html>
+</cfoutput>
+```
+The other type of file is the `.cfc` (ColdFusion Component) and it is how you declare a class.  Components are used for business logic, models, and controllers.  These usually use the script syntax, which reads similar to JavaScript.
+**Car.cfc**
+```js
+component accessors=true {
+	property name='make' type='string';
+	property name='model' type='string';
+	property name='year' type='number';
+	function init() {
+		return this;
+	}
+}
+```
+Here are some guides for learning more about CFML
+* [Modern ColdFusion (CFML) in 100 Minutes](https://www.gitbook.com/book/ortus/modern-coldfusion-cfml-in-100-minutes/details)
+* [CF SCript Cheatsheet](http://www.petefreitag.com/cheatsheets/coldfusion/cfscript/)
+* [Learn CF In A Week](http://www.learncfinaweek.com/)
+* [CommandBox CLI Getting Started Guide](https://ortus.gitbooks.io/commandbox-documentation/content/getting_started_guide.html)

data/tracks/cfml/docs/RESOURCES.md ADDED Viewed

@@ -0,0 +1,29 @@
+## Recommended Resources
+### Learning
+* [Modern ColdFusion (CFML) in 100 Minutes](https://www.gitbook.com/book/ortus/modern-coldfusion-cfml-in-100-minutes/details)
+* [CF SCript Cheatsheet](http://www.petefreitag.com/cheatsheets/coldfusion/cfscript/)
+* [Learn CF In A Week](http://www.learncfinaweek.com/)
+### CF Engines
+* [Lucee Server](http://lucee.org/) - A free open source CFML engine
+* [Adobe ColdFusion](http://www.adobe.com/products/coldfusion-family.html) - A commercially supported Enterprise CF engine
+### Online Communities
+* [CFML Slack](https://cfml-slack.herokuapp.com/)
+* [Stack Overflow](https://stackoverflow.com/questions/tagged/coldfusion)
+* [Community Resource Page](http://carehart.org/cf411/)
+* [Lucee Server Discourse Forum](https://dev.lucee.org/)
+* [Twitter](https://twitter.com/search?q=coldfusion&src=typd)
+### Tools
+* [CF Docs](https://cfdocs.org/)
+* [Try CF](https://www.trycf.com/)
+* [ColdBox MVC](https://coldbox.ortusbooks.com/content/full/getting_started_guide/)
+* [CFWheels  MVC](https://cfwheels.org/)
+* [FW/1 MVC](http://framework-one.github.io/documentation/)
+* [CommandBox CLI](https://ortus.gitbooks.io/commandbox-documentation/content/getting_started_guide.html)
+* [ForgeBox Package repo](https://www.forgebox.io/)

data/tracks/cfml/docs/SNIPPET.txt ADDED Viewed

@@ -0,0 +1,8 @@
+component {
+  // helloWorld greets the world.
+  function helloWorld() {
+    return 'Hello, World!';
+  }
+}

data/tracks/cfml/docs/TESTS.md ADDED Viewed

@@ -0,0 +1,13 @@
+## Running Tests
+To run the test for a given exercise, `cd` into the folder and run the following:
+```bash
+box task run TestRunner
+# Or start up a test watcher that will rerun when files change
+box task run TestRunner --:watcher
+```
+The tests leverage a library called TestBox which supports xUnit and BDD style of testing.  All test suites will be written in the [BDD style](https://testbox.ortusbooks.com/content/primers/bdd/specs.html) which uses closures to define test specs.  You won't need to worry about installing TestBox.  The CLI test runner will take care of that for you.  You just need to be connected to the internet the first time you run it.  You can read more about it here:
+[https://testbox.ortusbooks.com/content/](https://testbox.ortusbooks.com/content/)

data/tracks/cfml/exercises/acronym/.meta/HINTS.md ADDED Viewed

File without changes

data/tracks/cfml/exercises/acronym/Acronym.cfc ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+* Your implmentation of the Acronym exercise
+*/
+component {
+	/**
+	* @returns
+	*/
+	 function abbreviate( phrase ) {
+		// Implement me here
+	}
+}

data/tracks/cfml/exercises/acronym/AcronymTest.cfc ADDED Viewed

@@ -0,0 +1,43 @@
+component extends="testbox.system.BaseSpec" {
+	function beforeAll(){
+	  SUT = createObject( 'Acronym' );
+	}
+	function run(){
+		describe( "My Acronym class", function(){
+			describe( 'Abbreviate a phrase', function(){
+				it( 'basic', function(){
+					expect( SUT.abbreviate( phrase='Portable Network Graphics' ) ).toBe( 'PNG' );
+				});
+				it( 'lowercase words', function(){
+					expect( SUT.abbreviate( phrase='Ruby on Rails' ) ).toBe( 'ROR' );
+				});
+				it( 'punctuation', function(){
+					expect( SUT.abbreviate( phrase='First In,  First Out' ) ).toBe( 'FIFO' );
+				});
+				it( 'all caps words', function(){
+					expect( SUT.abbreviate( phrase='PHP: Hypertext Preprocessor' ) ).toBe( 'PHP' );
+				});
+				it( 'non-acronym all caps word', function(){
+					expect( SUT.abbreviate( phrase='GNU Image Manipulation Program' ) ).toBe( 'GIMP' );
+				});
+				it( 'hyphenated', function(){
+					expect( SUT.abbreviate( phrase='Complementary metal-oxide semiconductor' ) ).toBe( 'CMOS' );
+				});
+			});
+		});
+	}
+}

data/tracks/cfml/exercises/acronym/Solution.cfc ADDED Viewed

@@ -0,0 +1,22 @@
+/**
+* Here is an example solution for the Acronym exercise
+*/
+component {
+	function abbreviate( phrase ) {
+		return phrase
+			// Break up string on spaces or hyphens
+			.listToArray( ' -' )
+			// Strip first char of each word
+			.map( function( word ) {
+				return word.left( 1 );
+			} )
+			// Concat back to string
+			.toList( '' )
+			// Upper case for good measure
+			.uCase();
+	}
+}

data/tracks/cfml/exercises/acronym/SolutionTest.cfc ADDED Viewed

@@ -0,0 +1,7 @@
+component extends="AcronymTest" {
+	function beforeAll(){
+	  SUT = createObject( 'Solution' );
+	}
+}

data/tracks/cfml/exercises/acronym/TestRunner.cfc ADDED Viewed

@@ -0,0 +1,103 @@
+/**
+* I am a CommandBox task runner which you can use to test your implementation of this exercise against the
+* provided test suite.  To use me, open the CommandBox CLI and run this:
+*
+* CommandBox> task run TestRunner
+*
+* To start up a test watcher that will automatically rerun the test suite every time you save a file change, run this:
+*
+* CommandBox> task run TestRunner --watcher
+*
+*/
+component {
+	/**
+	* @solution Runs the tests against the solution
+	* @watcher Start up a file watch that re-runs the tests on file changes. Use Ctrl-C to stop
+	*/
+	function run( boolean solution=false, boolean watcher=false ) {
+		ensureTestBox();
+		if( watcher ) {
+			// Tabula rasa
+			command( 'cls' ).run();
+			// Start watcher
+			watch()
+				.paths( '*.cfc' )
+				.inDirectory( getCWD() )
+				.withDelay( 500 )
+				.onChange( function() {
+					// Clear the screen
+					command( 'cls' )
+						.run();
+					// This is neccessary so changes to tests get picked up right away.
+					pagePoolClear();
+					runTests( solution );
+				} )
+				.start();
+		} else {
+			runTests( solution );
+		}
+	}
+	/**
+	* Make sure the TestBox framework is installed
+	*/
+	private function ensureTestBox() {
+		var excerciseRoot = getCWD();
+		var testBoxRoot = excerciseRoot & '/testbox';
+		if( !directoryExists( testBoxRoot ) ) {
+			print.boldYellowLine( 'Installing some missing dependencies for you!' ).toConsole();
+			command( 'install' )
+				.inWorkingDirectory( excerciseRoot )
+				.run();
+		}
+		// Bootstrap TestBox framework
+		filesystemUtil.createMapping( '/testbox', testBoxRoot );
+	}
+	/**
+	* Invoke TestBox to run the test suite
+	*/
+	private function runTests( boolean solution=false ) {
+		// Create TestBox and run the tests
+		testData = new testbox.system.TestBox()
+			.runRaw( directory = {
+				// Find all CFCs...
+				mapping = filesystemUtil.makePathRelative( getCWD() ),
+				// ... in this directory ...
+				recurse = false,
+				// ... whose name ends in "test"
+				filter = function( path ) {
+					return path.reFind( ( solution ? 'Solution' : '' ) & 'Test.cfc$' );
+				 }
+			} )
+			.getMemento();
+		// Print out the results with ANSI formatting for the CLI
+		getInstance( 'CLIRenderer@testbox-commands' )
+			.render( print, testData, true );
+		print.toConsole();
+		// Set proper exit code
+		if( testData.totalFail || testData.totalError ) {
+			setExitCode( 1 );
+		}
+	}
+}

data/tracks/cfml/exercises/acronym/box.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+    "dependencies":{
+        "testbox":"^2.5.0+107"
+    },
+    "installPaths":{
+        "testbox":"testbox"
+    }
+}

data/tracks/cfml/exercises/acronym/index.cfm ADDED Viewed

@@ -0,0 +1,37 @@
+<!---
+This file will only be used if you want to start up a web server in this directory.  You can do so by running:
+$> box
+CommandBox> install
+CommandBox> server start
+However, this is not necessary unless you really just want to use the HTML reporters on TestBox.
+Ideally, you'll skip the need for this file entirely and just run the tests directly frm the CLI like this:
+CommandBox> task run TestRunner
+ --->
+<cfsetting showDebugOutput="false">
+<cfparam name="url.reporter" 		default="simple">
+<cfscript>
+	// get a list of all CFCs in this folder whose name looks like "XXXTest.cfc"
+	// And turn it into compnent path relative to the web root
+	url.bundles = directoryList(
+			path=expandPath( '/' ),
+			filter='*Test.cfc' )
+		.map( function( path ) {
+			return path
+					.replaceNoCase( expandPath( '/' ), '' )
+					.left( -4 )
+		} )
+		.toList();
+</cfscript>
+<!--- Ensure TestBox --->
+<cfif fileExists( "/testbox/system/runners/HTMLRunner.cfm" )>
+	<!--- Include the TestBox HTML Runner --->
+	<cfinclude template="/testbox/system/runners/HTMLRunner.cfm">
+<cfelse>
+	Oops, you don't have TestBox installed yet! Please run <b>box install</b> from the root of your excercise folder and refresh this page.
+</cfif>

data/tracks/cfml/exercises/atbash-cipher/.meta/HINTS.md ADDED Viewed

File without changes

data/tracks/cfml/exercises/atbash-cipher/AtbashCipher.cfc ADDED Viewed

@@ -0,0 +1,14 @@
+/**
+* Your implmentation of the AtbashCipher exercise
+*/
+component {
+	function encode( phrase ) {
+		// Implement me here
+	}
+	function decode( phrase ) {
+		// Implement me here
+	}
+}

data/tracks/cfml/exercises/atbash-cipher/AtbashCipherTest.cfc ADDED Viewed

@@ -0,0 +1,71 @@
+component extends="testbox.system.BaseSpec" {
+	function beforeAll(){
+	  SUT = createObject( 'AtbashCipher' );
+	}
+	function run(){
+		describe( "My AtbashCipher class", function(){
+			describe( 'encode', function(){
+				it( 'encode yes', function(){
+					expect( SUT.encode( phrase='yes' ) ).toBe( 'bvh' );
+				});
+				it( 'encode no', function(){
+					expect( SUT.encode( phrase='no' ) ).toBe( 'ml' );
+				});
+				it( 'encode OMG', function(){
+					expect( SUT.encode( phrase='OMG' ) ).toBe( 'lnt' );
+				});
+				it( 'encode spaces', function(){
+					expect( SUT.encode( phrase='O M G' ) ).toBe( 'lnt' );
+				});
+				it( 'encode mindblowingly', function(){
+					expect( SUT.encode( phrase='mindblowingly' ) ).toBe( 'nrmwy oldrm tob' );
+				});
+				it( 'encode numbers', function(){
+					expect( SUT.encode( phrase='Testing, 1 2 3,  testing.' ) ).toBe( 'gvhgr mt123 gvhgr mt' );
+				});
+				it( 'encode deep thought', function(){
+					expect( SUT.encode( phrase='Truth is fiction.' ) ).toBe( 'gifgs rhurx grlm' );
+				});
+				it( 'encode all the letters', function(){
+					expect( SUT.encode( phrase='The quick brown fox jumps over the lazy dog.' ) ).toBe( 'gsvjf rxpyi ldmul cqfnk hlevi gsvoz abwlt' );
+				});
+			});
+			describe( 'decode', function(){
+				it( 'decode exercism', function(){
+					expect( SUT.decode( phrase='vcvix rhn' ) ).toBe( 'exercism' );
+				});
+				it( 'decode a sentence', function(){
+					expect( SUT.decode( phrase='zmlyh gzxov rhlug vmzhg vkkrm thglm v' ) ).toBe( 'anobstacleisoftenasteppingstone' );
+				});
+				it( 'decode numbers', function(){
+					expect( SUT.decode( phrase='gvhgr mt123 gvhgr mt' ) ).toBe( 'testing123testing' );
+				});
+				it( 'decode all the letters', function(){
+					expect( SUT.decode( phrase='gsvjf rxpyi ldmul cqfnk hlevi gsvoz abwlt' ) ).toBe( 'thequickbrownfoxjumpsoverthelazydog' );
+				});
+			});
+		});
+	}
+}

data/tracks/cfml/exercises/atbash-cipher/Solution.cfc ADDED Viewed

@@ -0,0 +1,56 @@
+/**
+* Here is an example solution for the AtbashCipher exercise
+*/
+component {
+	function encode( phrase ) {
+		var result = '';
+		var breakCounter = 0;
+		phrase
+			.lcase()
+			// Clean anything not alphanumeric
+			.reReplace( '[^0-9a-z]', '', 'all' )
+			.listToArray( '' )
+			// Loop over each char
+			.each( function( char ) {
+				breakCounter++;
+				result &= invertChar( char );
+				// Every 5th char gets a space
+				if( breakCounter % 5 == 0 ) {
+					result &= ' ';
+				}
+			} );
+		// Nuke trailing spaces
+		return result.trim();
+	}
+	function decode( phrase ) {
+		var result = '';
+		phrase
+			.lcase()
+			// Clean anything not alphanumeric
+			.reReplace( '[^0-9a-z]', '', 'all' )
+			.listToArray( '' )
+			// Loop over each char
+			.each( function( char ) {
+				result &= invertChar( char );
+			} );
+		return result;
+	}
+	private function invertChar( char ) {
+		// Pass numbers straight through
+		if( asc( char ) >= 49 && asc( char ) <= 57 ) {
+			return char;
+		} else {
+			// For letters, find the offset from "a" and reverse it from "z"
+			// Using the ascii codes as a handy reference intead of creating an array of chars
+			return chr( 122 - ( asc( char ) - 97 )  );
+		}
+	}
+}

data/tracks/cfml/exercises/atbash-cipher/SolutionTest.cfc ADDED Viewed

@@ -0,0 +1,7 @@
+component extends="AtbashCipherTest" {
+	function beforeAll(){
+	  SUT = createObject( 'Solution' );
+	}
+}

data/tracks/cfml/exercises/atbash-cipher/TestRunner.cfc ADDED Viewed

@@ -0,0 +1,103 @@
+/**
+* I am a CommandBox task runner which you can use to test your implementation of this exercise against the
+* provided test suite.  To use me, open the CommandBox CLI and run this:
+*
+* CommandBox> task run TestRunner
+*
+* To start up a test watcher that will automatically rerun the test suite every time you save a file change, run this:
+*
+* CommandBox> task run TestRunner --watcher
+*
+*/
+component {
+	/**
+	* @solution Runs the tests against the solution
+	* @watcher Start up a file watch that re-runs the tests on file changes. Use Ctrl-C to stop
+	*/
+	function run( boolean solution=false, boolean watcher=false ) {
+		ensureTestBox();
+		if( watcher ) {
+			// Tabula rasa
+			command( 'cls' ).run();
+			// Start watcher
+			watch()
+				.paths( '*.cfc' )
+				.inDirectory( getCWD() )
+				.withDelay( 500 )
+				.onChange( function() {
+					// Clear the screen
+					command( 'cls' )
+						.run();
+					// This is neccessary so changes to tests get picked up right away.
+					pagePoolClear();
+					runTests( solution );
+				} )
+				.start();
+		} else {
+			runTests( solution );
+		}
+	}
+	/**
+	* Make sure the TestBox framework is installed
+	*/
+	private function ensureTestBox() {
+		var excerciseRoot = getCWD();
+		var testBoxRoot = excerciseRoot & '/testbox';
+		if( !directoryExists( testBoxRoot ) ) {
+			print.boldYellowLine( 'Installing some missing dependencies for you!' ).toConsole();
+			command( 'install' )
+				.inWorkingDirectory( excerciseRoot )
+				.run();
+		}
+		// Bootstrap TestBox framework
+		filesystemUtil.createMapping( '/testbox', testBoxRoot );
+	}
+	/**
+	* Invoke TestBox to run the test suite
+	*/
+	private function runTests( boolean solution=false ) {
+		// Create TestBox and run the tests
+		testData = new testbox.system.TestBox()
+			.runRaw( directory = {
+				// Find all CFCs...
+				mapping = filesystemUtil.makePathRelative( getCWD() ),
+				// ... in this directory ...
+				recurse = false,
+				// ... whose name ends in "test"
+				filter = function( path ) {
+					return path.reFind( ( solution ? 'Solution' : '' ) & 'Test.cfc$' );
+				 }
+			} )
+			.getMemento();
+		// Print out the results with ANSI formatting for the CLI
+		getInstance( 'CLIRenderer@testbox-commands' )
+			.render( print, testData, true );
+		print.toConsole();
+		// Set proper exit code
+		if( testData.totalFail || testData.totalError ) {
+			setExitCode( 1 );
+		}
+	}
+}

data/tracks/cfml/exercises/atbash-cipher/box.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+    "dependencies":{
+        "testbox":"^2.5.0+107"
+    },
+    "installPaths":{
+        "testbox":"testbox"
+    }
+}

data/tracks/cfml/exercises/atbash-cipher/index.cfm ADDED Viewed

@@ -0,0 +1,37 @@
+<!---
+This file will only be used if you want to start up a web server in this directory.  You can do so by running:
+$> box
+CommandBox> install
+CommandBox> server start
+However, this is not necessary unless you really just want to use the HTML reporters on TestBox.
+Ideally, you'll skip the need for this file entirely and just run the tests directly frm the CLI like this:
+CommandBox> task run TestRunner
+ --->
+<cfsetting showDebugOutput="false">
+<cfparam name="url.reporter" 		default="simple">
+<cfscript>
+	// get a list of all CFCs in this folder whose name looks like "XXXTest.cfc"
+	// And turn it into compnent path relative to the web root
+	url.bundles = directoryList(
+			path=expandPath( '/' ),
+			filter='*Test.cfc' )
+		.map( function( path ) {
+			return path
+					.replaceNoCase( expandPath( '/' ), '' )
+					.left( -4 )
+		} )
+		.toList();
+</cfscript>
+<!--- Ensure TestBox --->
+<cfif fileExists( "/testbox/system/runners/HTMLRunner.cfm" )>
+	<!--- Include the TestBox HTML Runner --->
+	<cfinclude template="/testbox/system/runners/HTMLRunner.cfm">
+<cfelse>
+	Oops, you don't have TestBox installed yet! Please run <b>box install</b> from the root of your excercise folder and refresh this page.
+</cfif>

data/tracks/cfml/exercises/bob/.meta/HINTS.md ADDED Viewed

File without changes