vundabar 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a40d667bbf9462b66e3a9db53f164f05014bac50
-  data.tar.gz: a6a1a243025c5428612d45400475520172cbba5b
+  metadata.gz: 383d22761f7d3f810fa8b75e482d557e4594a231
+  data.tar.gz: 1b019deff9b54eebd8458a21a1061efacfbb4446
 SHA512:
-  metadata.gz: 460a0417ca149659dae914e826061e9a163b3a69637feabccbbbad2b36075501662c90105e826c09cfb92e141ec635d3adf4d041a9996ca1baa1280a01e3939e
-  data.tar.gz: 12374f2a117928e638559c34a223d7c1a3683162e8be02c1306fe3a2bc78f7446b798c1e9b5a9437bf86c2a2dc92efff1e0e2ffc7a53770897739b06ba6115c2
+  metadata.gz: 89cdf283e7de312a7b79706a4b992f251f597e9b9be5e0623b5ded9e5b6b9f9993a79b3c289cf097383c03dcb09ecf013e1441ae6f05d8cdcf9a3ffb00fdb44a
+  data.tar.gz: 609c138c146bbb68332b05baa45f13a168d82e36c9740dab8c83457eb29f71bb5dcaada9fbc741e4c36a74a53c9b699d9e8340f60565c19239d727892be6b0cd

data/.rubocop.yml

@@ -2,10 +2,7 @@ AllCops:
   Exclude:
     - "vendor/**/*"
     - "db/schema.rb"
-    - "Gemfile"
-    - "config/**/*"
-    - "spec/rails_helper.rb"
-    - "spec/spec_helper.rb"
+    - "*.gemspec"
   UseCache: false
 Style/CollectionMethods:
   Description: Preferred collection methods.

data/README.md

@@ -1,8 +1,10 @@
-# Vundabar
+# Vundabar [![Code Climate](https://codeclimate.com/github/andela-oeyiowuawi/Vundabar/badges/gpa.svg)](https://codeclimate.com/github/andela-oeyiowuawi/Vundabar) [![Coverage Status](https://coveralls.io/repos/github/andela-oeyiowuawi/Vundabar/badge.svg?branch=master)](https://coveralls.io/github/andela-oeyiowuawi/Vundabar?branch=master) [![CircleCI](https://circleci.com/gh/andela-oeyiowuawi/Vundabar.svg?style=svg)](https://circleci.com/gh/andela-oeyiowuawi/Vundabar)
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/vundabar`. To experiment with that code, run `bin/console` for an interactive prompt.
 
-TODO: Delete this and the text above, and describe your gem
+Vundabar is a lightweight portable ruby web framework modelled after Rails and inspired by Sinatra. It is an attempt to understand the awesome features of Rails by reimplementing something similar from scratch.
+
+Vundabar is ligthweight and hence fit for simple and quick applications. Since it is a light weight framework it is very fast.
+
 
 ## Installation
 
@@ -22,15 +24,148 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+When creating a new Vundabar app, a few things need to be setup and a few rules adhered to. Vundabar basically follows the same folder structure as a typical rails app with all of the model, view and controller code packed inside of an app folder, configuration based code placed inside a config folder and the main database file in a db folder.
+
+View a sample app built using Vundabar framework [Here](https://github.com/andela-oeyiowuawi/Todo)
+
+## Key Features
+
+### Routing
+Routing with Vundabar deals with directing requests to the appropriate controllers. A sample route file is:
+
+```ruby
+TodoApplication.routes.draw do
+  get "/todo", to: "todo#index"
+  get "/todo/new", to: "todo#new"
+  post "/todo", to: "todo#create"
+  get "/todo/:id", to: "todo#show"
+  get "/todo/:id/edit", to: "todo#edit"
+  patch "/todo/:id", to: "todo#update"
+  put "/todo/:id", to: "todo#update"
+  delete "/todo/:id", to: "todo#destroy"
+end
+```
+Vundabar supports GET, DELETE, PATCH, POST, PUT requests.
+
+
+### Models
+All models to be used with the Vundabar framework are to inherit from the BaseModel class provided by Vundabar, in order to access the rich ORM functionalities provided. The BaseModel class acts as an interface between the model class and its database representation. A sample model file is provided below:
+
+```ruby
+class Todo < Vundabar::BaseModel
+  to_table :todos
+  property :id, type: :integer, primary_key: true
+  property :title, type: :text, nullable: false
+  property :body, type: :text, nullable: false
+  property :status, type: :text, nullable: false
+  property :created_at, type: :text, nullable: false
+  create_table
+end
+```
+The `to_table` method provided stores the table name used while creating the table record in the database.
+
+The `property` method is provided to declare table columns, and their properties. The first argument to `property` is the column name, while subsequent hash arguments are used to provide information about properties.
+
+The `type` argument represents the data type of the column. Supported data types by Vundabar are:
+
+  * integer (for numeric values)
+  * boolean (for boolean values [true or false])
+  * text    (for alphanumeric values)
+
+The `primary_key` argument is used to specify that the column should be used as the primary key of the table. If this is an integer, the value is auto-incremented by the database.
+
+The `nullable` argument is used to specify whether a column should have null values, or not.
+
+
+On passing in the table name, and its properties, a call should be made to the `create_table` method to persist the model to database by creating the table.
+
+
+### Controllers
+Controllers are key to the MVC structure, as they handle receiving requests, interacting with the database, and providing responses. Controllers are placed in the controllers folder, which is nested in the app folder.
+
+All controllers should inherit from the BaseController class provided by Vundabar to inherit methods which simplify accessing request parameters and returning responses by rendering views.
+
+A sample structure for a controller file is:
+
+```ruby
+class TodoController < Vundabar::BaseController
+  def index
+    @todos = Todo.all
+  end
+
+  def new
+  end
+
+  def show
+    todo = Todo.find(params[:id])
+  end
+
+  def destroy
+    todo.destroy
+    redirect_to "/"
+  end
+end
+```
+
+Instance variables set by the controllers are passed to the routes while rendering responses.
+
+Explicitly calling `render` to render template files is optional. If it's not called by the controller action, then it's done automatically by the framework with an argument that's the same name as the action. Thus, you can decide to call `render` explicitly when you want to render a view with a name different from the action.
+You can also use relationships similar to rails. `has_many` and `belongs_to` are available.
+
+
+### Views
+Currently, view templates are handled through the Tilt gem, with the Erubis template engine. See https://github.com/rtomayko/tilt for more details.
+
+View templates are mapped to controller actions and must assume the same nomenclature as their respective actions.Erbuis is used as the templating engine and files which are views are required to have the .erb file extension after the .html extension. Views are placed inside the `app/views` folder. A view to be rendered for the new action in the todoController for example is saved as `new.html.erb` in the todo folder, nested in the views folder.
+
+### External Dependencies
+The Vundabar framework has a few dependencies. These are listed below, with links to source pages for each.
+
+  * sqlite3     - https://github.com/sparklemotion/sqlite3-ruby
+  * erubis      - https://rubygems.org/gems/erubis
+  * bundler     - https://github.com/bundler/bundler
+  * rake        - https://github.com/ruby/rake
+  * rack        - https://github.com/rack/rack
+  * rack-test   - https://github.com/brynary/rack-test
+  * rspec       - https://github.com/rspec/rspec
+  * tilt        - https://github.com/rtomayko/tilt
+
+## Running the tests
+
+Test files are placed inside the spec folder and have been split into two sub folders, one for unit tests and the other for integration tests. You can run the tests from your command line client by typing `rspec spec`
+## Generators
+There are a few generators available in the vundabar framework.
+
+`new` generator similar to rails is used to create the skeleton of the whole app. To use this generator, run
+`vundabar new <app_name>`.
+This will create a folder called `<app_name>` with the neccesary structure for your new app.
+`version` generator can be used to check the version of the gem that you are using.
+`server` generator can be used to start the server to your new application. To use this, run
+`vundabar server` or simply `vundabar s`.
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+##Limitations
+
+This version of the gem does not implement callbacks, support migration generation and generating schema.
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/vundabar.
+To contribute to this work:
+
+1. Fork it ( https://github.com/[andela-oeyiowuawi]/Vundabar )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+6. Wait
+
+
+
+## License
 
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/generators/generators.rb

@@ -12,7 +12,7 @@ module Vundabar
     def server
       exec "rackup"
     end
-    map %w(s, server) => "server"
+    map %w(s server) => "server"
 
     desc "new APP_NAME", "create the app boiler plate file structure"
 
@@ -20,7 +20,7 @@ module Vundabar
       @app = app_name.downcase
       say "creating your new app #{app}"
       create_app_directory
-      
+
       create_config_files
       empty_directory "#{app}/db"
       create_public_directory

data/lib/vundabar.rb

@@ -1,5 +1,6 @@
 require "vundabar/version"
-require 'active_support/inflector'
+require "json"
+require "active_support/inflector"
 require "vundabar/utilities"
 require "vundabar/dependencies"
 require "vundabar/routing/routing"
@@ -22,6 +23,9 @@ module Vundabar
     def call(env)
       request = Rack::Request.new(env)
       route = mapper.find_route(request)
+      # return invalid_route_processor(request) unless route
+      # call_controller_and_action(request, route[:klass_and_method])
+      #
       if route
         call_controller_and_action(request, route[:klass_and_method])
       else

data/lib/vundabar/controller.rb

@@ -15,7 +15,11 @@ module Vundabar
     end
 
     def render(*args)
-      response(render_template(*args))
+      if args[0].instance_of? Hash
+        return process_hash(args[0])
+      else
+        response(render_template(*args))
+      end
     end
 
     def response(body, status = 200, header = {})
@@ -65,5 +69,16 @@ module Vundabar
       klass = self.class.to_s.gsub(/Controller$/, "")
       klass.to_snake_case
     end
+
+    def process_hash(hash)
+      status = hash.fetch(:status, 200)
+      body = hash[:json].to_hsh
+      suuplied_header = hash.fetch(:headers, {})
+      headers = suuplied_header.merge!("Content-Type" => "application/json")
+      if hash.key? :json
+        [:headers, :json, :status].each {|key| hash.delete(key) }
+        response(body.merge!(hash).to_json, status, headers)
+      end
+    end
   end
 end

data/lib/vundabar/orm/associations.rb

@@ -10,7 +10,6 @@ module Vundabar
       end
     end
 
-
     def belongs_to(model_name, options = {})
       define_method(model_name) do
         class_name = model_name.to_s.singularize.capitalize

data/lib/vundabar/orm/base_model.rb

@@ -59,6 +59,14 @@ module Vundabar
       Database.execute_query query, values
     end
 
+    def to_hsh
+      model_hsh = {}
+      self.class.properties.keys.each do |key|
+        model_hsh[key] = send(key)
+      end
+      model_hsh
+    end
+
     alias save! save
 
     def self.all

data/lib/vundabar/orm/validations.rb

@@ -1,5 +1,4 @@
 class Validations
   def initialize
-    
   end
 end

data/lib/vundabar/routing/routing.rb

@@ -47,7 +47,7 @@ module Vundabar
       end
 
       def controller_and_action(to)
-        controller, action = to.split('#')
+        controller, action = to.split("#")
         controller = "#{controller.to_camel_case}Controller"
         [controller, action]
       end

data/lib/vundabar/version.rb

@@ -1,3 +1,3 @@
 module Vundabar
-  VERSION = "0.1.0".freeze
+  VERSION = "0.2.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vundabar
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Eyiowuawi Olalekan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-22 00:00:00.000000000 Z
+date: 2016-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -279,7 +279,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.6.6
 signing_key: 
 specification_version: 4
 summary: A simple rack-based MVC framework