Soup is a bit of everything, summoned from nothing. Soup is like an imaginary friend - comforting, 
and will often talk to you, but when you look closely, they don't exist.

Terrifying. And so:

  require 'soup'
  soup = Soup.new(File.join("soup", __FILE__))

  soup << { 
    :name => "James",
    :skills => "Bowstaff, nunchuck" 
  }

  # ...much later...

  s = soup['james']
  s.skills # => "Bowstaff, nunchuck"

  soup << {
    :mane => "Lush and thick"
    :teeth => "Sharp and ready"
    :position => "Above my bed!!!" 
  }


The point is that you can set any attribute on a Soup data, and it will be persisted without 
care. With reckless abandon, really.

The data can be stored using anything - Soup doesn't really care much about the underlying 
persistence layer. I've written implementations using DataMapper, ActiveRecord and Sequel... 
there are other implementations of course. Unknowable implementations. 
Terrifying implementations. You Fool! Warren is Dead!



(c) 2008 James Adam, MIT LICENSE. Yeah.

  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXP
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXY?"""  .
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXY?""   ,;ciCCC
  "?YXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXYYY??""   .,;iCCCCCCCCCC
  .,.  `""""""???YYYYYYYYYYXXXXXXXYYYYY???"""""""   ..,;ciiCCCCCCCCCCC''`
  ```'`CCiiicccccccccc;;,,.    .,..,..,;cccciiiCCCCCCC????>''`````   .;ciCCC
  Cic;,.   `''<<????CCCCCCCCCCCC?????''''''''`````'   ..,;;;ccciiiCCCCCCCCCC
  CCCCCCCCCCCCcc;;;,,.       .,..,..,..,;;cciiiiCCCCCCCCCCCCCCCCCCCCC??>'`
  ``''?CCCCCCCCCC"'```''CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC??""''``   _.,;cciCC
  ic;;,. ````'<?Ciiccc;,,.  ````'''`CCCCCC''''''''`' .,;cciiiCCCCCCCCCC?"'`
  CCCCCCCCCiic;._  ```''"<?CCC;;;,,,.,..,...,;;;;;;C777???CC'''''``'  _,xiXX
  .  ```'''`CCCCCCCiicc;,,,,,..        ```````'            .,,,xiiXXXXXXXXXX
  XXXXXxXx,,,.   ```````````````````   .,..,..,.xiXiiXiiXXXXXXXXXXXXXXXXXXXX
  XXXXXXXXXXXXXXXXXXxXxxXxXXXXXxxXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXY??"""
  """?YXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXYY???"""
  =          """""???YYXXXXXXXXXXXXXXXXXXXXXXXXXXYYY???""                 ,;
   -;ccccc;;,.,..            """"""""""                          ,;ciCC'``'
  ;;, ```'???CCCCC  `''--;CCicc;;,      .,;;,,,.   ..      .,;ciCCCCCCCicc;-
  C'```CCiiiiiCCCCtCiicc;,.  ```' . .,;;iCCCCC'' .,;;cccc-''`CCCCCCCCCCCCC;;
  CCCCc;,,.,;CCCcc,,,,..'' .;CC'`'CCCCCCCCCC'' ``' .,;;;cc===`CC''````````'
  .,...```' .C.,.`""""?CCCCC'`CCC''''``'  .,.,;ciCCCCCC..,;cciiCtttCCCCCCCtt
   ```'     `'`CCCCCCCCCCC' . `'       ```' .,. ```CCC''''`CCCCCCCCCCCCC?"''
  ..                           ``'                            ```'
  $$$$$$$$$$$$ccc$$$$$$$$"?hccc=Jcc$$hccccccc$$$$$$$$$$$$$cccccc,,,,,ccc,,..
  $$$??hcccci???CCCCCC$$L ,$$$$c $$hcccccJ???LcccccccccJCCC???????CCCC??????
  $$F `?$$$$$$$$$$$$$$$$. ,$$"$$.?$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
  $$,. ,$$$$$$$$$$$$$$$$. ,$$ $$h $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$??????????$$
  $$$h $$$$$$$$$$$$$$$$$$ $$$ ?$h ?$$$$$$$$$$$$$$$$$$$$$$$???izc?????????i??
  ???" ?????$$$$$$$""""""  "" ?"" `"?"""$$$$$$$$??<Lr??cr?=""    .  .      .
  ,,,,,,,,,J$$$$$$$$,.,,,,,,,,..       ,$$$$$$P>JP"       .,;;,.!!;,.!!!!!!!
  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$C3$$  -'  --''`!!!!'`'   ..  `!
  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$Ci??c,,,.,..,.            `````
  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$JJCCCC????????$$????rrrcccc,
  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$C<<$$$$$PF<$$$$
  $$$$$cizccCCCCCCCCCcccc$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$?????)>>J$CLccc$??""
  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$????ii?iiJJJ$$??"""
  $$$$$$$$$$$$$??$$$$????P$$$???iiiiicccccc<<????)Cicc$P""      ..   .,;;!!!
  $$$$$CCCCCCC>>J>>>>cccccc>>>??C????CC>cccJ$??"""""         -``!!;!'  .!!!'
  $$$$$??CCCCCCCCCCCff>>>>>J$$$P""""""""            ..,;;;;;;;!'`.,;;!'''
  ??????????????"""""'' `'              .,..,;;;;!!!'```..```' .,.,;;;- `,;'
                      .,.    ,;;----'''''''```````'  `''`,;;!!'''`..,;;'' ,;
  ---;;;;;;;-----'''''''''``'  --- `'  .,,ccc$$hcccccc,.  `' ,;;!!!'``,;;!!'
  ;;;;,,.,;-------''''''' ,;;!!-    .zJ$$$$$$$$$$$$$$$$$$$c,. `' ,;;!!!!' ,;
    ```'    -;;;!'''''-  `.,..   .zJ$$$$$$$$$$$$$$$$$$$$$$$$$$c, `!!'' ,;!!'
  !!-  ' `,;;;;;;;;;;'''''```' ,c$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$c,  ;!!'' ,;
  ,;;;!!!!!!!!''``.,;;;;!'`'  z$$$$$$$$???"""""'.,,.`"?$$$$$$$$$$$  ``,;;!!!
  ;;..       --''```_..,;;!  J$$$$$$??,zcd$$$$$$$$$$$$$$$$$$$$$$$$h  ``'``'
  ```'''   ,;;''``.,.,;;,  ,$$$$$$F,z$$$$$$$$$$$$$$$$$$$c,`""?$$$$$h
  !!!!;;;;,   --`!'''''''  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$h.`"$$$$h .
  `'''``.,;;;!;;;--;;   zF,$$$$$$$$$$?????$$$$$$$$$$$$$?????$$r ;?$$$ $.
  !;.,..,.````.,;;;;  ,$P'J"$$$$$$P" .,c,,.J$$$$$$$$$"',cc,_`?h.`$$$$ $L
  '``````'    .,..  ,$$". $ $$$$P",c$$$$$$$$$$$$$$$$',$$$$$$$$$$ $$$$ $$c,
  !!!!!!!!!!!!!'''  J$',$ $.`$$P c$$$$$$$$$$$$$$$$$$,$$$$$$$$$$$ $$$$ $$$$C
     ``            J$ ,$P $$ ?$',$$$$???$$$$$$$$$$$$$$$??"""?$$$ <$$$ $$$$$
  c           ;,  z$F,$$  `$$ $ ?$"      "$$$.?$$$ $$$P c??c, ?$.<$$',$$$$$F
  $$h.  -!>   ('  $" $F ,F ?$ $ F ,="?$$c,`$$F $$"z$$',$' ,$$P $h.`$ ?$$$$$r
  $$$$$hc,. ``'  J$ $P J$ . $$F L ",,J$$$F <$hc$$ "$L,`??????,J$$$.` z$$$$$
  $$$$$$$$$$c,'' ?F,$',$F.: $$ c$c,,,,,c,,J$$$$$$$ ?$$$c,,,c$$$$$$F. $$$$$$
  `"$$$$$$$$$$$c, $$',$$ :: $$$$$$$$F"',$$$$$$$$$$h ?$$$L;;$$$??$$$$ $$$$$$
     "?$$$$$$$$$$ $$$$$$ : .`F"$$$$$$$$$$$$""""?"""h $$$$$$$"$,J$$$$ $$$$$'
        "?$$$$$$$ $$$$$$.`.` h `$$$$$$$$$$$cccc$$c,zJ$$$$$P' $$$$$P',$$$$P
  $.       `""?$$ $$$$$$$  ` "$c "?$$$$$$$$$$$$??$$$$$$$$" ,J$$$P",J$$$$P
  ..           `" ?$$$$$$h    ?$$c.`?$$$$$$$$$' . <$$$$$' ,$$$"  ,$$$$$"
  !!>. .          `$$$$$$$h  . "$$$c,"$$$$$$$' `' `$$$P  ,$$$' ,c$$$$$'   ;!
  ```<!!!>         `$$$$$$$c     "$$$c`?$$$$$  : : $$$  ,$$P' z$$$$$$'   ;!!
  $hc ```'  ;       `$$$$$$$.      ?$$c ?$$$$ .: : $$$  $$F ,J$$$$$$'   ;!!
  .,..      '        `$$$$$$$       "$$h`$$$$ .' ' $$$ ,$$ ,J$$$$$$'    !!!
  ????P               `$$$$$$L       $$$ $$$F :.: J$$P J$F J$$$$$P     ;!!
  -=<                  ?$$."$$       `$$ ?$$' `' z$$$F $P  $$$$$$'     !!'
  cc                   `$$$c`?        ?$.`$$hc, cd$$F ,$'  $$$$$$     ;!!
                        $$$$c         `$$c$$$$$$$$$",c$'   $$$$$$     `!!
                        $$$$$          `?$$$$$$$$$$$$P'    $$$$$$> ..
                        $$$$$            `"?$$$$$$$P"      $$$$$$L $$c,
            !!         <$$$$$            zc,`"""',         <$$$$$$.`$$$$cc,
            !!         J$$$$P            `$$$$$$$' !'       $$$$$$L `$$$$$$h
           ;,          $$$$$L          `! J$$$$$',!!        $$$$$$$  `$$$$$$
            '         <$$$$$.           ! $$$$$$ !!         ?$$$$$$   `$$$$$
                     ,$$$$$$$c          `,`???? ;'         c,?$$$$'    `?$$$
                     $$$$$$$??           `!;;;;!     .     `h."?$P      `$$$
                    ,$$$$$$$h.            `'''      `'      `$$$P        `?$
                     $$$$$$$$h                      `!'      `"'           `
                    `$$$$$$$$F          !;     !    ;,
                     `$$$$$$$'         `!!>         `!
  c,        ;,        `?$$$$P           !!>             .
  $F        !!>         `""'            `!!            ;!>    <-
  $F       `!!'                      ;!; '   `!        <!>    ;
  $F        `'      <!               !!!               !!>    !!
  ?'       `'      !!!               !!!               !!>    !!
           !!'    <!!               ;!!!               `'     ;
          ;!!     !!                !!!!                      !'
          !!!     `'                !!!                       '            ;
          !!                       ;!!'                                    !
                                   !!!                      ;!             !
                                  <!!!                      )'            `!
            ,;;>                 ;!!!                                     `!
            `''                 ;!!!                     !                `!
                ;!             ;!!!                                  ,$$c, `
              !''             ;!!!           '                    ,c$$$$$$c.
  >                       ;   !!!                                 ?$$$$$$$$$
  !!>                   ;!! .!!!     .!>                           "?$$$$$$$
  <! `!         ,;     ;!!  !!!!     !!                              `"?$$$$
   . '          '    ;!!! .!!!!     !!   .                              `"?$
   `'               <!!' .!!!!!!   !!!'  !                     >           `
                  .!!!  <!!'`!!! .!!!!;                   !!>
                  !!!  <!!'  !! ;!!!!!!                   (' ;,
                 <!!  !!!'  !!! !!!'!!!                   !> `!
                 !!' !!!'  `!!';!>  !!                 <! `' `!  !>.
                 ' ;<!!'  .!!! !!' <!'       ;        `!! ;  `!  !!!>
              .<!>;!!!'   !!! `!! <!!                .. ' '      !!!' ;,
             <!!! <!! ;   !!! !!>;!!''!             J$$c         `!!; !!>
            ;!!! ;!! <!   !!> !! `!! !'            J$$$$hr        `'' !!!,;;
            ;!!! !! <!!  <!!  !' ;!! '            <$$$$$$$.           <!!!'!
            !!!  !;<!!'  !!! ;!  !!>              $$$$$$$$$$.          `'  !
           `!!! !!!!!'   !!! !! `!!!              ?$$$$$$$??$c        !!>;
           ;!! ;!!!!!   ;!!> !! <!!>               ?$$$$$$c,`$$.      `!!!
           !!! !!! !'   `!!> !! !!!                 "?$$$$$$ "?$c      `<!
          ;!!  !! ;!    !!!> ! ;!!!,                  "$$$$$$c,"?$c,
          ;!!  !! ;!    !!!! ! `!!!!                    "$$$$$$c ?$$h.
          !!!> !! !!    !!!!    !!!                       "?$$$$c "$$$c,
          !!!' '  !!    `!!!    `!                          "$$$$h.`?$$$c,
         <!!!>   <!!    `!!!     !>                          ?$$$$$c ?$$$$h.
         `!!!    `!!     !!!     `'                           "?$$$$h.`?$$$$
          `!!>    !!     `!!                                    `?$$$$$$$$$$
           `!'    !!      `'                                      "$$$$$$$$$
                  `!>                                               ?$$$$$$$
                   `!                                                `"?$$$$
                    `-                ;!                                `"$$
                                                                          `?
(http://www.edvard-munch.com/Paintings/other_artists/scream_ascii_3.htm)