zresume 0.0.1 → 0.1.0

data/README.md

@@ -1,12 +1,5 @@
 # Zresume
 
-TODO:
-* Add command line interface
-  * `zresume new YourClassName` : generate the Scaffold of Your Personal Resume
-  * `zresume g [format]` : generate a static file in the format passed in .
-* Add printable feature
-  * let the customized class support .md and html
-
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -22,19 +15,39 @@ Or install it yourself as:
     $ gem install zresume
 
 ## Syntax
-`info *array` register the attributes you need.Once you set the attribute by `info` you can set it's value simply by `attrname value`.
+`info *array` register the attributes you need.Once you set the attribute by `info` you can set it's value simply following the syntax: `attrname value`.
 
-The Value can Be Any Kind of Ruby Object. Mostly you set it a string, number or array.
+The Value can Be Any Kind of Ruby Object. Mostly you set it a string, a number or an array.
 
-You can pass in a block as the value too. In this block, You can use the method `item(arg='string', &block)` to generate a  instance of Zresume::List(a hash like Class, To store more infomations) for you. if you pass in a block to `item`, in this block, you get the freedom to write code just like construct a hash just remove ':' or '=>'. In the following example, You will see it.
+Once you set the attributes by info, you get the freedom to set the nested attributes,for example, you want to show your working experiences, of course you have more than one experience, so you need an array to store it, you want to store the company name, the position you have been, the skills you use, ect. Just write it:
+
+```ruby
+  ...
+  experiences do
+    year2009_2010 'designer' do
+        company_name 'Google' #have you been there?
+        position 'Frontend Desinger'
+        use 'photoshop'
+        use 'html'
+        use 'css'
+    end
+    year2010_2012 'programmer' do
+        company_name 'home' do
+           desc 'Working as a freelancer'
+           use %W{ruby rails javascript html css photoshp}
+           #...
+        end
+    end
+  end
+``` 
 
 ## Usage
+
 ```ruby
     require 'zresume'
     class YourName
         include Zresume::Person
-        info :name, :age, :gender, :experiences, :works, :skills, :working_env, :public_
-        accounts, :gembox
+        info :name, :age, :gender, :experiences, :works, :skills, :working_env, :public_accounts, :gembox
         #register the attributes
         name 'My Name'
         age  25
@@ -61,9 +74,10 @@ You can pass in a block as the value too. In this block, You can use the method
                  And My Job is #{do_what}.
                 "
               EOF
-              #position, do_what, use, company_url, and output are not predefined methods.#You just write it, and you will get a method named by it, 
+              #position, do_what, use, company_url, and output are not predefined methods.
+              #You just write it, and you will get a method named by it, 
               #and set the value for you.right now you can access the value.
-              #In This Example, `YourName.new.experiences[0].do_what` will 
+              #In This Example, `YourName.new.experiences.item[0].do_what` will 
               #get the value 'Web Site interface design. Convert PSD to HTML+CSS+JS.' 
            end
 
@@ -83,28 +97,33 @@ You can pass in a block as the value too. In this block, You can use the method
         skills  %w{ruby rails javascript jquery html css}
 
         working_env do
-          system 'Ubuntu Linux 12.04 LTS'
-          vps  'Linode 512'
-          webserver 'Nginx'
-          editor 'Sublime Text2'
-          language 'Ruby 1.9.3'
-          framework 'Rails 2.x-3.x'
-          database 'Mysql/Mongodb'
-          test 'Rspec'
-          vcs 'Git'
+            operation_system 'Ubuntu Linux 12.04 LTS'
+            vps  'Linode 512'
+            webserver 'Nginx'
+            editor 'Sublime Text2'
+            language 'Ruby 1.9.3'
+            framework 'Rails 2.x-3.x'
+            database 'Mysql/Mongodb'
+            test_frame 'Rspec'
+            vcs 'Git'
         end
 
         public_accounts do
-          email 'zhuboliu@gmail.com'
-          qq 455912224
-          git 'https://github.com/suffering'
-          phone 11111111111
+            email 'zhuboliu@gmail.com'
+            qq 455912224
+            git 'https://github.com/suffering'
+            phone 11111111111
         end
 
         gembox %w{devise cancan bootstrap coffeescript rspec mongoid carrierwave simple_form ckeditor kaminari active_admin}
     end
 ```
-TODO: Write usage instructions here
+TODO:
+* Add command line interface
+  * `zresume new YourClassName` : generate the Scaffold of Your Personal Resume
+  * `zresume g [format]` : generate a static file in the format passed in .
+* Add printable feature
+  * let the customized class support .md and html
 
 ## Contributing
 

data/examples/zhubo.rb

@@ -0,0 +1,109 @@
+    require 'zresume'
+    class YourName
+        include Zresume::Person
+        info :name, :age, :gender, :experiences, :works, :skills, :working_env, :public_accounts, :gembox
+        #register the attributes
+        name 'My Name'
+        #.name #=> 'My Name'
+        age  25
+        gender 'male'
+        #set the value in the most simplest way. yes? we set key and value just like writting a hash, but we removed the ":" sign.
+        works do
+           url 'http://www.example.com' do
+              description 'From frontend to backend to deploy, Finished by myself.'
+           end
+           # .works.url #=> 'http://www.example.com'
+           url 'http://www.example2.com'
+           # .works.url #=> ['http://www.example.com', 'http://www.example2.com']
+           url 'http://www.example3.com'
+           # .works.url #=> ['http://www.example.com', 'http://www.example2.com', 'http://www.example3.com']
+           lastdesign 'http://www.example4.com'
+           # .works.lastdesign #=> 'http://www.example4.com'
+           github 'https://github.com/xxx1' do
+              desc 'This gem is...' do
+                d1 'deep one' do
+                  d2 'deep two' do
+                    d3 'deep three' do
+                      #...
+                        dn 'deep n'
+                      #...
+                    end
+                  end
+                end
+                #you can nest as deep as you like, but it is not a good idea.
+                d1 'deep one again' do
+                  #...
+                end
+              end
+           end
+           # .works.github #=> {:title => 'https://github.com/xxx1', :desc => 'This gem is...'}
+           github 'https://github.com/xxx2'
+           # .works.github #=> [{:title => 'https://github.com/xxx1', :desc => 'This gem is...'}, 'https://github.com/xxx2']
+           github 'https://github.com/xxx3'
+
+           # The method `url`, `lastdesign` and `github` are not predefined method, 
+           # As you write them in the block, you get these methods.
+           # If a word that not defined before occured in the block, you get a method that return the signed value.
+           # if it was called more than once, you will get an array.
+           # if you pass in a block as the last argument, you will get a hash.
+        end
+
+        experiences do
+           item '2009-2011' do
+              position 'Web Designer'
+              do_what 'Web Site interface design. Convert PSD to HTML+CSS+JS.'
+              use  %w{Photoshop Html CSS Javascript}
+              company 'company name'
+              company_url 'http://www.lonwin.net/'
+              output <<-EOF
+                "#{title}: #{position} in #{company}
+                 Using: #{use.join(',')}.
+                 And My Job is #{do_what}.
+                "
+              EOF
+              #position, do_what, use, company_url, and output are not predefined methods.#You just write it, and you will get a method named by it, 
+              #and set the value for you.right now you can access the value.
+              #In This Example, `YourName.new.experiences.item[0].do_what` will 
+              #get the value 'Web Site interface design. Convert PSD to HTML+CSS+JS.' 
+           end
+
+           item '2011-2012' do
+              company 'company name 2'
+              position 'Web Developer'
+              works 'works 1, works 2, ..., works N'
+              output <<-EOF
+                "#{title}: #{position} in #{company}
+                Do What:
+                #{works}
+                "
+              EOF
+           end
+        end
+
+        skills  %w{ruby rails javascript jquery html css}
+
+        working_env do
+            operation_system 'Ubuntu Linux 12.04 LTS'
+            vps  'Linode 512'
+            webserver 'Nginx'
+            editor 'Sublime Text2'
+            language 'Ruby 1.9.3'
+            framework 'Rails 2.x-3.x'
+            database 'Mysql/Mongodb'
+            test_frame 'Rspec'
+            vcs 'Git'
+            editor 'Vim'
+        end
+        #this will get a hash that respond to the key-value pair writed before.
+        #.working_env.editor #=> ['Sublime Text2', 'Vim']
+
+        public_accounts do
+            email 'zhuboliu@gmail.com'
+            qq 455912224
+            git 'https://github.com/suffering'
+            phone 11111111111
+        end
+
+        gembox %w{devise cancan bootstrap coffeescript rspec mongoid carrierwave simple_form ckeditor kaminari active_admin}
+    end
+    p YourName.new.skills

data/lib/zresume/box.rb

@@ -0,0 +1,9 @@
+module Zresume
+    class Box < Array
+        def method_missing(m, *a)
+            t = select {|a| a.title.to_s == m.to_s }
+            raise Exception, "There is no Item named `#{m}`." if t.empty?
+            return t[0] if t.length == 1
+        end
+    end
+end

data/lib/zresume/list.rb

@@ -1,15 +1,19 @@
 module Zresume
     class List < Hash
-        instance_methods.each do |m|
-            undef_method m unless m.to_s =~ /respond_to?|method_missing|^/
-        end
-        
-        def method_missing(m, *a)
-            m.to_s =~ /=$/ ? self[$`] = a[0] : a!= [] ? self[m.to_s] = a[0] : self[m.to_s]
-        end
-        
-        def to_s
-            output || title
+        def method_missing(m, *a, &bl)
+            if !bl
+                if m.to_s =~ /=$/
+                    self[$`.intern] = a[0]
+                else
+                    return self[m] if a.empty?
+                    self[m] ? self[m]=([self[m]].flatten << a[0]) : self[m] = a[0]
+                end
+            else
+                s =  List[:title, a[0]]
+                s.instance_eval &bl
+                return self[m] = s if !self[m]
+                self[m] = [self[m]].flatten << s
+            end
         end
     end
 end

data/lib/zresume/person.rb

@@ -1,6 +1,5 @@
 #inspired by _why: http://mislav.uniqpath.com/poignant-guide/dwemthy/
-require 'yaml'
-require 'zresume/printable'
+require 'zresume/list'
 module Zresume
     module Person
         include Zresume::Printable
@@ -33,23 +32,18 @@ module Zresume
                 class_eval do
                     define_method(:initialize) do
                         self.class.info.each do |k, v|
-                            @tmpbox ||= []
-                            v =  self.instance_eval(&v) if v.respond_to? :lambda?
+                            if v.respond_to? :lambda?
+                                s =  Zresume::List[:title, k]
+                                s.instance_eval &v
+                                v = s
+                            end
                             instance_variable_set("@#{k}", v)
                             self.class.info[k] = v
-                            self.instance_eval{remove_instance_variable :@tmpbox}
                         end
                     end
                 end#initialize, add the instance variables
             end
         end
-        
-        def item arg='', &bl
-            tmp = Zresume::List.new
-            tmp.title = arg
-            tmp.instance_eval &bl if block_given?
-            @tmpbox << tmp
-        end
 
         def to_hash
             self.class.info

data/lib/zresume/version.rb

@@ -1,3 +1,3 @@
 module Zresume
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/lib/zresume.rb

@@ -1,8 +1,9 @@
 $:.unshift File.dirname(__FILE__) # For use/testing when no gem is installed
-require "zresume/list"
-require "zresume/person"
 require "zresume/version"
+require "zresume/list"
+#require "zresume/box"
 require "zresume/printable"
+require "zresume/person"
 module Zresume
   # Your code goes here...
 end

data/spec/person_spec.rb

@@ -33,26 +33,17 @@ describe Zresume::Person do
                     item 'xxx'
                 end
                 works do
+                    url 'example.com'
                     item 'http://www.tevogroup.com/'
                     item 'http://edu.tevogroup.com/'
                     item 'http://www.jndchina.com/'
                 end
-                delete do
-                    item 'test'
-                end
             end
             z = Kids.new
-            p z.to_hash
-            p z
-            # p z.class.instance_methods(false)
-            z.experience[1].title.should == "xxx"
-            z.experience[0].position.should == "Web Master & Programmer"
-            z.experience[0].time.should == "2010-2011"
-            z.experience[0].output.should == "2010-2011, Shenzhen Goldsan electronic STD, Web Master & Programmer"
-            z.works[0].title.should      == 'http://www.tevogroup.com/'
-            # p z.works[0]. to_s
-            z.works[1].title.should      == 'http://edu.tevogroup.com/'
-            z.works[2].title.should      == 'http://www.jndchina.com/'
+            z.experience.item[0].company.should == "Shenzhen Goldsan electronic STD"
+            z.works.item.should == ['http://www.tevogroup.com/', 'http://edu.tevogroup.com/', 'http://www.jndchina.com/']
+            z.works.url.should == 'example.com'
+            z.experience.item[0].output.should == "2010-2011, Shenzhen Goldsan electronic STD, Web Master & Programmer"
         end
     end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zresume
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-23 00:00:00.000000000 Z
+date: 2013-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -87,7 +87,9 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- examples/zhubo.rb
 - lib/zresume.rb
+- lib/zresume/box.rb
 - lib/zresume/list.rb
 - lib/zresume/person.rb
 - lib/zresume/printable.rb