heliodor 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f68d88cabd00c5927c58c03e62c9ef4c763ca93c
+  data.tar.gz: 4b467b876e1d87bfe3185b770f4995159a7fe14c
+SHA512:
+  metadata.gz: cd9e3c8bd52897efcb53224e430952e1e53e3c7e9ec3a49bcfe9b700b9e6f6b41c6d574a35738b032eb257a8c364fb0f663487c49e42e1984d5e7346d5f811e8
+  data.tar.gz: efc1731366889d3e9b23ebc9b8ad04ac9975f6aeb46f11d11616f2e1929d7044487c896855c5bef1ca937704f4276b8afeb6347a1284834ea9a30f7f1abbdbed

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.db

data/.rubocop.yml

@@ -0,0 +1,23 @@
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at nickolay02@inbox.ru. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in heliodor.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Nickolay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,53 @@
+# Heliodor
+
+Heliodor is server-less database management tool
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'heliodor'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install heliodor
+
+## Usage
+
+Next example creates new database file, table inside of it and inserts value
+
+```ruby
+require 'heliodor'
+db = Heliodor::DB.new './example.db'
+db
+  .query('Users') # Perform query on table 'users'
+  .ensure         # Ensure that this table exists - if it does not, create it
+  .insert(first_name: 'Vasya', last_name: 'Pupkin', age: 20) # Insert data into table
+  .write  # Write data
+  .finish # Finish query - executes all statements
+
+# Resulting table will be returned after finishing query
+
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. 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).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/handicraftsman/heliodor. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,5 @@
+require 'bundler/gem_tasks'
+task default: :spec
+task :check do
+  sh 'rubocop'
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'heliodor'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/heliodor.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'heliodor/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'heliodor'
+  spec.version       = Heliodor::VERSION
+  spec.authors       = ['Nickolay']
+  spec.email         = ['nickolay02@inbox.ru']
+
+  spec.summary       = 'NoSQL Server-Less DB-library'
+  spec.description   = 'NoSQL Server-Less DB-library'
+  spec.homepage      = 'https://github.com/handicraftsman/heliodor/'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.13'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rubocop', '~> 0.47'
+
+  spec.add_runtime_dependency 'bson', '~> 4.0'
+end

data/lib/heliodor.rb

@@ -0,0 +1,16 @@
+require 'bson'
+
+module Heliodor
+end
+
+require 'heliodor/version'
+require 'heliodor/db'
+require 'heliodor/query'
+require 'heliodor/query_internal'
+
+class Hash
+  def add_key(key)
+    self[key] = nil
+    self
+  end
+end

data/lib/heliodor/db.rb

@@ -0,0 +1,66 @@
+# Base class for accessing DBs and building queries
+# @attr file [String]
+# @attr tsafe [Bool] When true, uses mutexes for building queries
+class Heliodor::DB
+  attr_accessor :file, :tsafe
+
+  def initialize(file, tsafe = false)
+    @tsafe = tsafe
+    @mutex = Mutex.new
+    @dtable = { 'heliodor_data' => {
+      'name'            => 'Heliodor',
+      'version'         => Heliodor::VERSION,
+      'bson_version'    => Gem.loaded_specs['bson'].version.version,
+      'last_write'      => DateTime.now.strftime,
+      'ruby_version'    => RUBY_VERSION,
+      'ruby_patchlevel' => RUBY_PATCHLEVEL.to_s,
+      'ruby_platform'   => RUBY_PLATFORM
+    } }
+    @file = File.expand_path(file.to_s)
+
+    if File.exist?(@file)
+      raw = File.read(File.expand_path(@file))
+      bb = BSON::ByteBuffer.new(raw)
+      @dat = Hash.from_bson(bb)
+    else
+      File.open(@file, 'w') do |f|
+        f.write(@dtable.to_bson.to_s)
+        @dat = @dtable.clone
+      end
+    end
+  end
+
+  # Entry point for building queries
+  # @param table [String]
+  # @return [Heliodor::Query]
+  def query(table)
+    if @tsafe
+      @mutex.synchronize do
+        Heliodor::Query.new(self, table, @dat)
+      end
+    else
+      Heliodor::Query.new(self, table, @dat)
+    end
+  end
+
+  # Returns array of table names
+  # @return [Array<String>] Array of table names
+  def tables
+    Hash.from_bson(BSON::ByteBuffer.new(File.read(@file))).keys
+  end
+
+  # Writes database to file
+  # @return [self]
+  def write(dat)
+    @dat = dat
+    File.truncate(@file, 0) if File.exist?(@file)
+    File.open(@file, 'w') do |f|
+      f.write(dat.merge(@dtable).to_bson.to_s)
+    end
+    self
+  end
+
+  def inspect
+    %(#<Heliodor::DB:#{object_id.to_s(16)} @file='#{@file}'>)
+  end
+end

data/lib/heliodor/query.rb

@@ -0,0 +1,150 @@
+# Query which will be executed when #finish is called
+# @attr db [Heliodor::DB] Query's database
+# @attr table [String] Name of current table
+# @attr actions [Array<Hash>] Array of all actions
+class Heliodor::Query
+  attr_accessor :db, :actions, :table
+
+  # Initializer
+  def initialize(db, table, dat)
+    @db      = db
+    @table   = table
+    @full    = dat
+    @dat     = @full[@table]
+    @actions = []
+  end
+
+  # @!group Query Language
+
+  # Insert given data into table
+  # @param dat [Any]
+  # @return [self]
+  def insert(*dat)
+    actions << {
+      'type' => 'insert',
+      'data' => dat
+    }
+    self
+  end
+
+  # Creates table with current name. If it already exists - truncates
+  # @return [self]
+  def create
+    actions << {
+      'type' => 'create'
+    }
+    self
+  end
+
+  # If there's no table with current name, creates it
+  # @return [self]
+  def ensure
+    actions << {
+      'type' => 'ensure'
+    }
+    self
+  end
+
+  # Filters all items in current table using given block
+  # @yield [i] Is executed for each item in table.
+  #            Drops values when this block returns false value
+  # @return [self]
+  def filter(&block)
+    actions << {
+      'type'  => 'filter',
+      'block' => block
+    }
+    self
+  end
+
+  # Edits all items in current table
+  # @yield [i] Return updated value to update stuff
+  # @example Adding key to each hash in table
+  #   db.query('table_name').map do |i|
+  #     i[:keyname] = nil
+  #   end.write.finish
+  # @example Map-reduce method of getting table length
+  #   db.query('table_name').map{1}.reduce(&:+).finish # => length
+  # @return [self]
+  def map(&block)
+    actions << {
+      'type'  => 'map',
+      'block' => block
+    }
+    self
+  end
+
+  # Reduces table to single element using given block
+  # @return [self]
+  def reduce(&block)
+    actions << {
+      'type'  => 'reduce',
+      'block' => block
+    }
+    self
+  end
+
+  # Renames current table
+  # @param to [String]
+  # @return [self]
+  def rename(to)
+    actions << {
+      'type' => 'rename',
+      'to'   => to
+    }
+    self
+  end
+
+  # Writes changes to database
+  # @return [self]
+  def write
+    actions << {
+      'type' => 'write'
+    }
+    self
+  end
+
+  # Selects all values which match given hash
+  # @return [self]
+  def select(dat = {})
+    actions << {
+      'type' => 'select',
+      'dat'  => dat
+    }
+    self
+  end
+
+  # Updates all items which match first hash by merging them with second hash
+  # @return [self]
+  def update(dat1 = {}, dat2 = {})
+    actions << {
+      'type' => 'update',
+      'dat1' => dat1,
+      'dat2' => dat2
+    }
+    self
+  end
+
+  # Deletes current table. WARNING: writes changes to database
+  # @return [self]
+  def delete
+    actions << {
+      'type' => 'delete'
+    }
+    self
+  end
+
+  # Ends query and processes it
+  # @return [Array] Data in table
+  def finish
+    _process
+    @dat
+  end
+  # @!endgroup
+
+  # Inspect method
+  def inspect
+    %(#<Heliodor::Query:#{object_id.to_s(16)} @table='#{@table}' @db=#{@db}) +
+      %( @actions.length=#{@actions.length}>)
+  end
+end

data/lib/heliodor/query_internal.rb

@@ -0,0 +1,95 @@
+class Heliodor::Query
+  private
+
+  def _gen
+    @dat = []
+  end
+
+  def _filter(&_block)
+    dat = []
+    @dat.each do |item|
+      dat << item if yield(item)
+    end
+    @dat = dat
+  end
+
+  def _select(dat = {})
+    out = []
+    @dat.each do |item|
+      out << item if (v.class == Hash) && (item >= dat)
+    end
+    @dat = out
+  end
+
+  def _update(dat1 = {}, dat2 = {})
+    @dat.each_with_index do |v, k|
+      @dat[k] = v.merge(dat2) if (v.class == Hash) && (v >= dat1)
+    end
+  end
+
+  def _map(&_block)
+    @dat.each_with_index do |v, k|
+      @dat[k] = yield(v)
+    end
+  end
+
+  def _reduce(&_block)
+    @dat = [@dat.reduce(&block)]
+  end
+
+  def _insert(dat)
+    dat.each do |d|
+      @dat << d
+    end
+  end
+
+  def _rename(to)
+    @full[to] = @dat
+    @full.delete(@table)
+    @table = to
+    @dat = @full[@table]
+  end
+
+  def _delete
+    @full.delete @table
+    @db.write(@full)
+    @dat = nil
+  end
+
+  def _write
+    @full[@table] = @dat
+    @db.write(@full)
+  end
+
+  def _process
+    actions.each do |action|
+      case action['type']
+      when 'create'
+        _gen
+      when 'ensure'
+        _gen unless @dat
+      when 'filter'
+        _filter(&action['block'])
+      when 'select'
+        _select(action['dat'])
+      when 'update'
+        _update(action['dat1'], action['dat2'])
+      when 'map'
+        _map(&action['block'])
+      when 'reduce'
+        _reduce(&action['block'])
+      when 'insert'
+        _insert(action['data'])
+      when 'rename'
+        _rename(action['to'])
+      when 'delete'
+        _delete
+      when 'write'
+        _write
+      else
+        raise NotImplementedError,
+              "Action `#{action['type']}` is not yet implemented!"
+      end
+    end
+  end
+end

data/lib/heliodor/version.rb

@@ -0,0 +1,3 @@
+module Heliodor
+  VERSION = '0.1.0'.freeze
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: heliodor
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nickolay
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-03-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+- !ruby/object:Gem::Dependency
+  name: bson
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: NoSQL Server-Less DB-library
+email:
+- nickolay02@inbox.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- heliodor.gemspec
+- lib/heliodor.rb
+- lib/heliodor/db.rb
+- lib/heliodor/query.rb
+- lib/heliodor/query_internal.rb
+- lib/heliodor/version.rb
+homepage: https://github.com/handicraftsman/heliodor/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: NoSQL Server-Less DB-library
+test_files: []