Project

shubox

0.0
No commit activity in last 3 years
No release in over 3 years
shubox lowers the barrier to entry for test-driven learning by providing a basic infrastructure in which to start coding: A directory structure, some classes and unit tests to get started, and a build script.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 2.3.3

Runtime

= 1.5.2
 Project Readme

shubox - A framework to create sandboxes for test-driven learning¶ ↑

github.com/bobbyno/shubox/tree/master

More on Test-Driven Learning: www.bobbynorton.com/?p=36

DESCRIPTION¶ ↑

shubox lowers the barrier to entry for test-driven learning by providing a basic infrastructure in which to start coding: A directory structure, some classes and unit tests to get started, and a build script.

TEST-DRIVEN LEARNING¶ ↑

Test-driven learning is a way to master a programming language by writing unit tests around its API’s. After installing shubox and generating a testing environment, you’ll start off with some passing tests that exercise parts of the language’s API. Write new learning tests, naming each method with the intent of the lesson, then write the code that makes a test pass.

Can you complete the lesson again from memory? If not, you may need to study the concept more closely and implement the tests again. According to a paper by Karpicke and Roediger, “repeated retrieval practice led to greater than 150% improvements in long-term retention than studying alone. …Although educators and psychologists often consider testing a neutral process that merely assesses the contents of memory, practicing retrieval during tests clearly produces more learning than additional encoding or study once an item has been recalled.”

shubox makes repeated testing easy by providing built-in test cleaners that delete your test implementations, while keeping comments and test names to express the intent of the test. shubox currently creates environments for Ruby and Java, but can easily be extended to any language that lends itself to unit testing. shubox is built on newgem, so extending the framework is as simple as creating new generator scripts.

INSTALL¶ ↑

The shubox application is distributed as a RubyGem and is available immediately after installation.

$ gem sources -a http:http://gemcutter.org

$ sudo gem install shubox

RUBY USAGE¶ ↑

Ruby is the default language option in shubox:

$ shubox /tmp/learn_ruby

$ cd /tmp/learn_ruby

$ rake

To clean all tests in your project:

$ script/clean_test_unit .

If you’re using TextMate, you can quickly reset a test file from within the editor using “Text -> Filter Through Command”. Select “/tmp/learn_ruby/script/filter_test_unit” as the command, select “Document” as input, and select “Replace Document” as output. Alternately, save the contents of the filter script to a custom TextMate command to easily run it with a keyboard shortcut.

JAVA USAGE¶ ↑

shubox supports Java:

$ shubox -l=java /tmp/LearnJava

$ cd /tmp/LearnJava

$ ant -f build/build.xml

The Java command will also generate a <project name>.ipr file to allow the project to easily be opened in IntelliJ 8.

shubox does not currently include a JUnit cleaner script. Patches welcome. ;-)

CLOJURE USAGE¶ ↑

shubox also supports Clojure:

$ shubox -l=clojure /tmp/learn_clojure

$ cd /tmp/learn_clojure

$ ant

The Clojure command will also generate a <project name>.ipr file to allow the project to easily be opened in IntelliJ 8.

shubox does not currently include a clojure test cleaner script. Patches welcome. ;-)

APPLICATION ARCHITECTURE¶ ↑

shubox is organized as a set of generators, as in newgem and RubiGen.

app_generators are where we define the basic environment for one of our supported languages.

cleaner_generators hold the test framework cleaning implementations to reset tests. In the future, these can be mixed and matched to support polyglots like JRuby by installing both JUnit and Test::Unit cleaners. Run script/generate in a generated shubox to see the list of available cleaners and generators that can be installed.

cleaner/lib folders hold the implementations of the cleaners referenced in the clean_xxx files copied to the generated application. This makes it easy to upgrade existing shuboxes.

REQUIREMENTS¶ ↑

  • newgem

CONTRIBUTORS¶ ↑

Initial concept - Bobby Norton

bendyworks for Test::Unit cleaner patch

THANKS!¶ ↑

DRW Trading Group for time and feedback

Test-Driven Learning Attendees at SCNA 2009

Dr. Nic Williams for newgem and rubigen: RubyConf 2007 Presentation

Jim Weirich and EdgeCase for ruby_koans

Stu Halloway for the clojure project structure in clojure_bowling