csvdb 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 01b591779bbeda29a4abd006ff1c9e8497435081
-  data.tar.gz: 10446b54f89b929d518bcc37592a90ce611d1d17
+  metadata.gz: c89ea1821aaa5b1728600ac8b404796ac1c4dc93
+  data.tar.gz: 89d7d20acea0bdca8b7ec695ea6bc7897267e761
 SHA512:
-  metadata.gz: 630ff17554d73ecee364aa64f7b85c51e04f0746d93a34030f179ac38ac7c9bb2bfbbb4ef190432ccf2409bf5e772dbe9518fbc680a3616031e3814d498c1384
-  data.tar.gz: f3f6eebeb7e6969f24e7dafcf1062fbdc00cfd8c3ce8080ab4b7f1a17ce3ea0f789d41b34bfc903ee8c4bfc111a99a9806aeab4c66ff24deaddda246a4a85789
+  metadata.gz: 0a5553377d18108ca657d41a3514fdcf46c405259256f9a5e87aeaaf911826cc6587dc1506154a9cc38680689220e13ecf8c85e04f891187723e9fdff5006031
+  data.tar.gz: cd14b88f02430cdc95dbd71d4c5b0bb0edde4a5c068fbf1438fb2e6499ca927fefe2110bcfe9fb5c864456c0257966c4fdffece39bddfe4848d29ca1b19d3b3e

data/README.md

@@ -1,8 +1,6 @@
 # Csvdb
 
-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/csvdb`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+Really simple object relational mapping for CSV spreadsheets. Loads all data into a ruby array first so not appropriate for very large datasets. However, it's just as fast as working with a 2d ruby array, so it's very fast for reasonably sized datasets.
 
 ## Installation
 
@@ -22,17 +20,51 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+#### CRUD Functions
+```ruby
+table = Csvdb.new(file: 'table.csv')
+table.cols.keys           #=> [:id, :name] The table headings (from row[0] in file)
+table.create(
+  id: 1, name: 'foobar'
+)                         #=> [1, 'foobar'] Newly created row
+row = table.find(0)       #=> [1, 'foobar'] find by index in array
+row.id                    #=> 1
+row.update(id: 2)         #=> [2, 'foobar']
+row.delete
+row.find(0)               #=> nil
+```
+
+#### Querying
+```ruby
+table = Csvdv.new(file: 'table.csv')
+table.count #=> 5
+
+# queries always return new table objects, with the same headings,
+# just filtered by the block
+query = table.where { |row| row[table.id] == 1 }
+query.count #=> 1
 
-## Development
+# joins also always return table objects.
+# the join joins on the same column name in each table.
+joined = table.join(another_table, :column)
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+#### Printing
+```ruby
+table = Csvdb.new(file: 'table.csv')
+table.pretty
++---------+-------+--------+--------+----------+
+| version | type  | counts | resets | time     |
++---------+-------+--------+--------+----------+
+| 1.1.0   | build | 741    | 6      | 0.046694 |
+...
+
+```
 
-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` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/csvdb/fork )
+1. Fork it ( https://github.com/ColDog/csvdb/fork )
 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`)

data/lib/csvdb/errors.rb

@@ -3,4 +3,6 @@ module Csvdb
   end
   class ParseError < StandardError
   end
+  class TableError < StandardError
+  end
 end

data/lib/csvdb/table.rb

@@ -3,10 +3,20 @@ require 'csvdb/row'
 require 'csvdb/errors'
 
 module Csvdb
+
+  class Join
+
+  end
+
   class Table
-    attr_accessor :cols, :table
+    attr_accessor :cols, :table, :table_name
 
     def initialize(opts = {})
+      if opts[:name]
+        @table_name = opts[:name]
+      else
+        raise TableError, 'No name on that table'
+      end
 
       if opts[:file]
         @file = opts[:file]
@@ -17,7 +27,7 @@ module Csvdb
         table = opts[:ary]
         @cols = opts[:cols]
       else
-        raise ParseError, 'No table or file to parse.'
+        raise TableError, 'No table or file to parse.'
       end
 
       @cols.each do |col, val|
@@ -32,6 +42,7 @@ module Csvdb
     end
 
     def write(file = @file)
+      File.open(file, 'w') unless File.file?(file)
       CSV.open(file, 'wb') do |csv|
         csv << @cols.keys
         @table.each do |row|
@@ -56,8 +67,38 @@ module Csvdb
       @table << Row.new(new_row, self, @table.length)
     end
 
-    def where
-      Table.new(ary: @table.select { |row| yield(row) }, cols: self.cols)
+    def add(attrs)
+      @table << Row.new(attrs, self, @table.length)
+    end
+
+    def where(search_name = 'search')
+      Table.new(
+        ary: @table.select { |row| yield(row) },
+        cols: self.cols,
+        name: search_name
+      )
+    end
+
+    def join(table, opts = {})
+      col1 = opts[:col1] ; idx1 = self.send(col1)
+      col2 = opts[:col2] ; idx2 = self.send(col2)
+      cols = ([col1] + (self.cols.keys - [col1])
+                .map { |k| "#{k}_#{self.table_name}".to_sym } +
+                ((table.cols.keys - [col1])
+                .map { |k| "#{k}_#{table.table_name}".to_sym }))
+                .map.with_index {|head,idx| [head.to_sym,idx] }.to_h
+
+      joined = Table.new(ary: [], cols: cols, name: "#{self.table_name}.#{cols[:col1]} join #{table.table_name}.#{cols[:col2]}")
+      ids = (self.pluck(col1) + table.pluck(col2)).uniq
+      ids.each do |id|
+        self.where { |row| row[idx1] == id }.table.each do |outer_row|
+          table.where { |row| row[idx2] == id }.table.each do |inner_row|
+            inner_row.delete_at(idx2)
+            joined.add(outer_row + inner_row)
+          end
+        end
+      end
+      return joined
     end
 
     def find(idx = nil)

data/lib/csvdb/version.rb

@@ -1,3 +1,3 @@
 module Csvdb
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: csvdb
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Colin Walker
@@ -81,7 +81,6 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
-- csvdb-0.1.0.gem
 - csvdb.gemspec
 - lib/csvdb.rb
 - lib/csvdb/errors.rb