sentiql 0.1.2 → 0.1.3

data/README.rdoc

@@ -0,0 +1,66 @@
+== SentiQL
+A minimalistic Ruby wrapper for MySQL. I love using SQL for data selection, except for basic selects (e.g. finding something by id), I love using OM interface to create, update and delete records in the database and I love when lib is not "overcoded". When you combine all this love, you get SentiQL.
+
+== Why SentiQL
+I don't like using ActiveRecord or other fat ORMs because I think they are breaking following rules:
+1. "Make everything as simple as possible, but not simpler" - Albert Einstein.
+2. Rule of Clarity. Clarity is better than cleverness. (Unix Philosophy)
+3. Rule of Simplicity: Design for simplicity; add complexity only where you must. (Unix Philosophy)
+
+Plus. I think it is wrong to put a thick abstraction layer on one of the biggest web application's performance bottlenecks.
+
+== Notice
+This is REALY a work in progress, I wrote this lib during one evening after reading "Metaprogramming Ruby: Program Like a Ruby Pros". It is less then 140 LOCs, so even if it is missing one or other thing, just open the sentiql.rb file and happy hacking.
+
+== Instalation
+    gem install sentiql 
+
+== How To
+1. Connect to database
+    DB = Mysql2::Client.new( 
+          :host=>'localhost', 
+          :username=>'username', 
+          :password=>'password', 
+          :database=>'db'
+        )
+    DB.query_options.merge!(:symbolize_keys=>true)
+    SentiQL::Base.connection = DB
+
+2. Working with User data
+
+    # creating
+    u = User.new :name=>'Tyler Durden', :password=>'project_mayhem'
+    u.save  
+
+    # updating
+    u[:name] = 'Tyler'
+    u.save
+
+    # reading
+    t = User.find_by :name=>'Tyler' # -> and instance of User
+    t = SentiQL::Base.first 'SELECT name FROM users where name=? LIMIT 1', ['Tyler'] # -> {:name=>'Tyler', :password=>'project_mayhem'}
+    users = SentiQL::Base.all 'SELECT name FROM users' # -> [{:name=>'Tyler'}]
+
+    # runing SQL query
+    SentiQL::Base.execute 'DELETE FROM users WHERE name=?', ['Robert Paulson']
+    
+
+3. User model
+
+    class User < SentiQL::Base
+      
+      set_schema :name, :password, :created_at            # column names of the table that you will play with
+      set_table :users                                    # table name
+
+      before_create :set_timestamp
+
+      protected 
+
+      def set_timestamp
+        self[:created_at] = Time.now
+      end
+
+    end
+
+== Licence
+I have no idea about this sort of things.

data/lib/sentiql/version.rb

@@ -1,3 +1,3 @@
 module SentiQL
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/lib/sentiql.rb

@@ -7,6 +7,7 @@ module SentiQL
 
     def initialize attrs={}
       @attrs = {}
+      @errors = {}
       attrs.each_pair do |key, value|
         @attrs[key.to_sym] = value
       end

data/spec/sentiql_spec.rb

@@ -111,12 +111,12 @@ describe SentiQL::Base do
 
   describe '.first' do
     it 'returns nil when no records found' do
-      r = SentiQL.first 'SHOW TABLES LIKE ?', ['non_existing_tbl%']
+      r = SentiQL::Base.first 'SHOW TABLES LIKE ?', ['non_existing_tbl%']
       r.should == nil
     end
 
     it 'returns a hash if record found with keys representing column values' do
-      r = SentiQL.first 'SELECT CONCAT(?,?) AS str', ['a','b']
+      r = SentiQL::Base.first 'SELECT CONCAT(?,?) AS str', ['a','b']
       r.should be_an_instance_of(Hash)
       r[:str].should == 'ab'
     end
@@ -124,7 +124,7 @@ describe SentiQL::Base do
 
   describe '.all' do
     it 'returns Mysql2::Result which holds data in Hashes' do
-      r = SentiQL.all 'SHOW OPEN TABLES'
+      r = SentiQL::Base.all 'SHOW OPEN TABLES'
       r.should be_an_instance_of(Mysql2::Result)
       r.first.should be_an_instance_of(Hash)
     end

data/spec/spec_helper.rb

@@ -4,11 +4,11 @@ require 'rspec'
 require 'active_record'
 require 'mysql2'
 
-require 'sentiql'
+#require 'sentiql'
 
 ROOT_PATH = File.dirname(__FILE__)
 
-
+require File.join(ROOT_PATH, '..', 'lib', 'sentiql')
 @config = YAML.load_file(File.join(ROOT_PATH, '..', "config/database.yml"))['test']
 
 DB = Mysql2::Client.new( 

metadata

@@ -2,7 +2,7 @@
 name: sentiql
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors: 
 - Martynas Miliauskas
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-15 00:00:00 +01:00
+date: 2011-05-23 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -69,6 +69,7 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - Gemfile
+- README.rdoc
 - Rakefile
 - config/database.yml
 - db/migrate/20110515_test_tables.rb