nutella_framework 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d3f88ae1dc5c42c292f394ef2a47a646da9b21f7
+  data.tar.gz: 3cd6d1bfa6c0ca8526f49fe1bd9a92484632fa66
+SHA512:
+  metadata.gz: ca6269a2cc2b90c4c0b04a5a3119aa0d2abf4b9f0d1b462c589d0feb469ecb6ffd35cbfae91ed899922c373306818a2aca63636f4e7d562e602078993a015ded
+  data.tar.gz: fedcf4af33fb2298edcdec5e0eed539928eeb772ade17ef7f50b019361b1249b8134ade09e38017ab29b0972a66168aeaf32418678c9b4f1c1b48c387d18be5d

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.1.1
+notifications:
+  email: false

data/Gemfile

@@ -0,0 +1,17 @@
+source "http://rubygems.org"
+
+gem 'ansi', '~> 1.4', '>= 1.4.3'
+gem 'semantic', '~> 1.3', '>=1.3'
+gem 'logging', '~> 1.8', '>=1.8.2'
+
+group :development do
+  gem 'shoulda', '~> 3', '>= 3'
+  gem 'rdoc', '~> 4.0', '>= 4.0'
+  gem 'bundler', '~> 1.0', '>= 1.0'
+  gem 'jeweler', '~> 2.0.1', '>= 2.0.1'
+  gem 'simplecov', '~> 0', '>= 0'
+end
+
+group :test do
+  gem "rake"
+end

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 by The Board of Trustees of the University of Illinois at Chicago
+
+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,11 @@
+
+# Nutella [![Build Status](https://travis-ci.org/ltg-uic/nutella_framework.svg?branch=master)](https://travis-ci.org/ltg-uic/nutella_framework) [![Dependency Status](https://gemnasium.com/ltg-uic/nutella_framework.svg)](https://gemnasium.com/ltg-uic/nutella_framework) [![Code Climate](https://codeclimate.com/github/ltg-uic/nutella_framework/badges/gpa.svg)](https://codeclimate.com/github/ltg-uic/nutella_framework)
+Nutella is a framework to build and run "Internet of Things"-like learning applications. It's still _very_ under development so keep an eye for new version and help fix the bugs you find by sumbmitting issues.
+
+# Hello world
+For a complete guide on how to use Nutella, please refer to [this wiki](https://github.com/ltg-uic/nutella/wiki).
+You can install the most recent version of nutella with `gem install nutella_framework`. If all goes as expected you should be able to type `nutella` in your shell and get a welcome message. 
+
+
+# Building & contributing
+Clone the repo, and simply type `rake` in the repo. This will run all the tests. If you want to do some fancier tasks simply type `rake -T` for a list of awesomess.

data/Rakefile

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
+  gem.name = "nutella_framework"
+  gem.homepage = "https://github.com/ltg-uic/nutella_framework"
+  gem.license = "MIT"
+  gem.summary = %Q{IoT-like learning applications framework}
+  gem.description = %Q{Nutella is a framework to build and run "Internet of Things"-like learning applications}
+  gem.email = "tebemis@gmail.com"
+  gem.authors = ["Alessandro Gnoli"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+desc "Code coverage detail"
+task :simplecov do
+  ENV['COVERAGE'] = "true"
+  Rake::Task['test'].execute
+end
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "nutella_framework #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/nutella

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'nutella_framework'
+
+Nutella::NutellaCLI.run

data/lib/cli/nutella_cli.rb

@@ -0,0 +1,44 @@
+module Nutella
+
+  class NutellaCLI
+    
+    NUTELLA_LOGO = "                   _       _ _
+                  | |     | | |
+       _ __  _   _| |_ ___| | | __ _
+      |  _ \\| | | | __/ _ \\ | |/ _  |
+      | | | | |_| | ||  __/ | | (_| |
+      |_| |_|\\__,_|\\__\\___|_|_|\\__,_|
+      "
+    
+    # Reads the parameters and executes commands
+    def self.run
+      # Read parameters
+      args = ARGV.dup
+      args.shift
+      # Check that the command is not empty, if so, print the prompt
+      command = ARGV.first
+      if command == nil
+        printPrompt
+        exit 0
+      end
+      # Prepend warning if nutella is not ready
+      if (Nutella.config["ready"].nil? && command!="checkup")
+        console.warn "Looks like this is a fresh installation of nutella. Please run `nutella checkup` to check all dependencies are installed."
+      end
+      Nutella.executeCommand command, args
+      exit 0
+    end
+  
+    # Print Nutella logo
+    def self.printPrompt
+      console.info(NUTELLA_LOGO)
+      nutella_version = File.open(NUTELLA_HOME+"VERSION", "rb").read
+      console.info("Welcome to nutella version #{nutella_version}! For a complete lists of available commands type `nutella help`\n")
+      # Append warning if nutella is not ready
+      if (Nutella.config["ready"].nil?)
+        console.warn "Looks like this is a fresh installation of nutella. Please run `nutella checkup` to check all dependencies are installed."
+      end
+    end
+  end
+
+end

data/lib/config/config.rb

@@ -0,0 +1,72 @@
+# This handles the configuration files of Nutella
+# It's basically a hash overload that stores into a file
+require 'json'
+
+module Nutella
+  
+  class ConfigHash
+    
+    def initialize(file)
+      @config_file=file
+    end
+    
+    
+    def []=(key,val)
+      hash = loadConfig
+      hash[key]=val
+      storeConfig hash
+    end
+    
+    def [](key)
+      hash = loadConfig
+      hash[key]
+    end
+    
+    def empty?
+      hash = loadConfig
+      hash.empty?
+    end
+    
+    def has_key?(key)
+      hash = loadConfig
+      hash.has_key? key
+    end
+    
+    def to_s
+      hash = loadConfig
+      hash.to_s
+    end
+    
+    def to_h
+      hash = loadConfig
+      hash
+    end
+    
+    private
+    
+    def storeConfig(hash)
+      File.open(@config_file, "w+") do |f|
+        f.write(JSON.pretty_generate(hash))
+      end
+    end
+    
+    def loadConfig   
+      begin
+        return JSON.parse IO.read @config_file
+      rescue
+        # File doesn't exist... do nothing
+        Hash.new
+      end
+    end
+    
+    def removeConfigFile
+      File.delete(@config_file) if File.exist?(@config_file)
+    end
+    
+  end
+  
+  def Nutella.config
+    ConfigHash.new(File.dirname(__FILE__)+"/../../config.json")
+  end
+  
+end

data/lib/config/project.rb

@@ -0,0 +1,53 @@
+# handles current project files
+
+require 'singleton'
+require 'json'
+
+module Nutella
+  
+  class Project
+    
+    include Singleton
+    
+    # Check that the current directory is actually a nutella project
+    def exist?
+      @prj_dir = Dir.pwd
+      if File.exist?("#{@prj_dir}/conf/project.json")
+        conf = JSON.parse( IO.read("#{@prj_dir}/conf/project.json") )
+        if conf["nutella_version"].nil?
+          console.warn "The current directory is not a Nutella project"
+          return false
+        end
+      else
+        console.warn "The current directory is not a Nutella project"
+        return false
+      end
+      return true
+    end
+  
+    # Returns the value for an entry in the project configuration file
+    def config
+      @prj_dir = Dir.pwd
+      if File.exist? "#{@prj_dir}/conf/project.json" 
+        return ConfigHash.new "#{@prj_dir}/conf/project.json"
+        else
+          console.error "The current directory is not a Nutella project! Impossible to get project configuration file"
+        end
+    end
+    
+    # Returns current project directory
+    def dir
+      Dir.pwd
+    end
+    
+  end
+  
+  
+  def Nutella.currentProject
+    Project.instance
+  end
+  
+end
+
+
+

data/lib/config/runlist.rb

@@ -0,0 +1,91 @@
+# This handles the list of running instances of Nutella
+# The list is uniquely maintained inside a file
+require 'singleton'
+require 'json'
+require 'set'
+
+module Nutella
+  
+  class RunList
+    
+    RUN_LIST_FILE=File.dirname(__FILE__)+"/../../runlist.json"
+    
+    include Singleton
+    
+    def add?(runid)
+      begin
+        result = JSON.parse(IO.read(RUN_LIST_FILE)).to_set.add? runid
+      rescue
+        # No file, create one
+        result = [runid].to_set
+      end
+      if result!=nil
+        File.open(RUN_LIST_FILE, "w+") do |f|
+          f.write(JSON.pretty_generate(result.to_a))
+        end
+      end
+      result
+    end
+
+    def delete?(runid)
+      begin
+        result = JSON.parse(IO.read(RUN_LIST_FILE)).to_set.delete? runid
+      rescue
+        removeRunListFile
+        result = nil # List is empty, so nil
+      end
+      if result!=nil
+        File.open(RUN_LIST_FILE, "w+") do |f|
+          f.write(JSON.pretty_generate(result.to_a))
+        end
+      end
+      result
+    end
+
+    def include?(runid)
+      begin
+        return JSON.parse(IO.read(RUN_LIST_FILE)).include? runid
+      rescue
+        false # There is no file so it doens't include runid
+      end
+    end
+
+    def empty?
+      begin
+        return JSON.parse(IO.read(RUN_LIST_FILE)).empty?
+      rescue
+        true # There is no file so list is empty
+      end
+    end
+
+    def to_a(projectName=nil)
+      begin
+        list = JSON.parse(IO.read(RUN_LIST_FILE))
+        # filter by project
+        if projectName == nil
+          return list
+        else
+          return list.select { |run| run.start_with?(projectName) }
+        end
+      rescue
+        Array.new # There is no file or something went wrong
+      end
+    end
+    
+    private 
+    
+    def removeRunListFile
+      File.delete(RUN_LIST_FILE) if File.exist?(RUN_LIST_FILE)
+    end
+    
+  end
+  
+  
+  def Nutella.runlist
+    RunList.instance
+  end
+  
+end
+
+
+

data/lib/core/command.rb

@@ -0,0 +1,12 @@
+# CLI command
+
+module Nutella  
+  class Command 
+    class << self; attr_accessor :description end
+  
+    # Commands overload this method to execute
+    def run (args=nil)
+      console.error("Running a generic command! POOP!")
+    end
+  end
+end

data/lib/core/commands/broker.rb

@@ -0,0 +1,58 @@
+require 'core/command'
+require 'socket'
+
+module Nutella
+  class Broker < Command
+    @description = "Displays information about the current broker and allows us to change it"
+  
+    def run(args=nil)
+      # If no argument then we jsut display info about the broker
+      if args==nil || args.empty?
+        getBrokerInfo
+        return
+      end
+      # If there are arguments we are doing manipulations
+      case args[0]
+      when "set"
+        changeBroker args[1]
+      # when "start"
+      #   startBroker
+      # when "stop"
+      #   stopBroker
+      else
+        console.warn "Unknown `nutella broker` option #{args[0]}. Try `nutell broker`, ` nutella broker set <broker> instead"
+      end
+      
+    end
+    
+    private
+    
+    def getBrokerInfo
+      if Nutella.config["broker"].nil?
+        console.warn "No broker has been specified yet. Please, run `nutella broker set <broker>` to specify a broker."
+      else
+        console.info"Currently using broker: #{Nutella.config["broker"]}"
+      end
+    end
+    
+    
+    def changeBroker(broker)
+      # Check that there are no runs hinging on this broker
+      if !Nutella.runlist.empty?
+        console.warn "You are currently running some projects on this broker. You can't change the broker while running."
+        return
+      end
+      # Change it
+      begin
+        IPSocket.getaddress(broker)
+      rescue
+        console.warn "Not a valid hostname for a broker"
+      end
+      Nutella.config["broker"] = broker
+      console.success "Now using broker: #{Nutella.config["broker"]}"
+    end
+    
+  end
+end
+
+