ngi_api 0.0.2

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+cacert.pem

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Marco Bulgarini
+
+MIT License
+
+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,31 @@
+# NgiApi
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ngi_api'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ngi_api
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/ngi_api/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`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+Dir.glob('tasks/**/*.rake').each(&method(:import))

data/lib/README.rdoc

@@ -0,0 +1,45 @@
+= NgiAPI {<img src="https://travis-ci.org/blacksd/ngi_api.png?rvm=1.9.3" />}[https://travis-ci.org/blacksd/ngi_api]
+
+* https://github.com/blacksd/ngi_api
+* https://rubygems.org/gems/ngi_api
+
+== Description
+
+This library is a convenient, easy way to access NGI's API for resellers - simple 
+object methods vs. custom SOAP calls. There are multiple built-in checks for type corrections, and
+the entered values are automatically adjusted. Return values are parsed and presented as a hash.
+This gem currently supports all API operations:
+* list_bts
+* list_comuni
+* info_bts
+* info_radio
+* reboot_radio
+* set_ethernet
+
+== Dependencies
+
+* rubyntlm version 0.3.2 or newer
+* savon[http://savonrb.com/] version 2
+
+== Support:
+
+The bug tracker is available here: https://github.com/blacksd/ngi_api/issues
+
+== Examples
+
+With arguments as a hash, cast a 
+
+	MyNGIAccess = NgiAPI.new(arguments)
+
+and use the instance methods. 
+
+== Authors
+
+Copyright (c) 2015 by Marco Bulgarini (marco.bulgarini@com-net.it)
+
+This library is the second attempt in using Ruby at something practical. If you
+think I did a good job, let me know!
+
+== License
+
+This library is distributed under the MIT license.

data/lib/ngi_api.rb

@@ -0,0 +1,271 @@
+# encoding: utf-8
+
+require "digest"
+# gem "rubyntlm", "~> 0.3.2" # no "gems" in here! Dependencies go through gemspec. 
+require "rubyntlm"
+require "savon"
+require "net/http"
+
+# This is the main class, holding all of the functions
+# and checks. The instance it's built with a hash of arguments.
+class NgiAPI
+
+    # call-seq:
+    #   MyNGIAccess = NgiAPI.new(arguments)    
+    #  
+    #
+    # Initialize the class instance with a hash of arguments. The hash is mandatory and must not be empty.
+    # There's a test mode and a production live mode.
+    # == Test mode
+    #   arguments[:test] = true
+    # Puts any operation in test mode, with standard login and password and a different wsdl.
+    #   arguments[:debug] = true 
+    # The :debug can be set to true for improved stdout logging.
+    # == Production mode
+    #   arguments[:partnerLogin] = "13243546"
+    #   arguments[:partnerPassword] = "randomsaltprovidedbyNGI"
+    # 
+	def initialize(args)
+        raise ArgumentError, "no arguments provided, no idea what to do" if args.empty?
+        raise ArgumentError, "\"test\" option provided with login and/or password - can't do that" if args[:test] && (!!args[:partnerLogin] || !!args[:partnerPassword])
+        raise ArgumentError, "you must give both a login and a password." if !!args[:partnerLogin] ^ !!args[:partnerPassword]
+		@partnerLogin = !!args[:test] ? "12345678" : parameter_to_string(args[:partnerLogin])
+		@partnerPassword = !!args[:test] ? "517fc7b578767ebfa6bb5252252653d2" : parameter_to_string(args[:partnerPassword])
+        fetch_cacert unless File.exist?('cacert.pem')
+        @soapClient = Savon.client do
+          wsdl !!args[:test] ? "https://www.eolo.it/ws/wsdl/?test" : "https://www.eolo.it/ws/wsdl"
+          ssl_ca_cert_file "cacert.pem"
+          if args[:debug]
+            log true 
+            log_level :debug 
+            pretty_print_xml true
+          end
+        end
+	end
+
+    # --------------------------------------
+    # :section: Available Operations
+    # As Public Instance Methods are the operations available through NGI APIs.
+    # Make good use of them, and don't abuse.
+    # --------------------------------------
+
+    # call-seq:
+    #   MyNGIAccess.infoRadio(macAddresses_clientLogins) => {...}    
+    #  
+    # Status of a radio, obtained as a string or an array of a client login/mac address.
+    def infoRadio(macAddresses_clientLogins)
+        
+        macAddressArray = []
+        clientLoginArray = []
+
+        case macAddresses_clientLogins.class.to_s
+        when "Array"
+            raise ArgumentError,"array exceeds 20 elements" if macAddresses_clientLogins.size > 20
+            macAddresses_clientLogins.each_with_index do |element,index|
+                    raise ArgumentError, "value #{element} at position #{index} is not a valid mac address or a login" unless is_valid_mac(element) || is_valid_login(element)
+                    macAddressArray.push(fix_mac_address(element)) if is_valid_mac(element)
+                    clientLoginArray.push(fix_login(element)) if is_valid_login(element)
+            end
+        when "String"
+            raise ArgumentError,"the single value to check is not a valid mac address or customer login" unless is_valid_mac(macAddresses_clientLogins) || is_valid_login(macAddresses_clientLogins)
+            macAddressArray.push(fix_mac_address(macAddresses_clientLogins)) if is_valid_mac(macAddresses_clientLogins)
+            clientLoginArray.push(fix_login(macAddresses_clientLogins)) if is_valid_login(macAddresses_clientLogins)
+        else
+            raise ArgumentError,"unsupported data type: a single mac address or login string or an array of them are the only allowed types."
+        end 
+        
+        build_and_send_query(:info_radio,
+            {
+                macAddressList: macAddressArray,
+                clientLoginList: clientLoginArray
+            }
+        )
+    end
+
+    # call-seq:
+    #   MyNGIAccess.infoBts(btsID) => {...}    
+    #  
+    # Obtain the exact informations about a specific BTS. btsID is a non-negative integer.
+    def infoBts(btsID)
+        raise ArgumentError, "btsID value not allowed" unless btsID.to_i > 0 && btsID.class.to_s == "Fixnum"
+        build_and_send_query(:info_bts,
+            {
+                btsID: parameter_to_string(btsID)
+            }
+        )
+    end
+
+    # call-seq:
+    #   MyNGIAccess.infoCoverage(via,civico,istat) => {...}    
+    #  
+    # Gets the coverage for the specified address. The address is composed of
+    # * +via+ the street location
+    # * +civico+ the number
+    # * +istat+ the istat code for the town, gathered from listComuni
+    def infoCoverage(via,civico,istat)
+        build_and_send_query(:info_coverage, 
+            {
+                via: parameter_to_string(via), 
+                civico: parameter_to_string(civico), 
+                istat: parameter_to_string(istat)
+            }
+        )
+    end
+
+    # call-seq:
+    #   MyNGIAccess.listBts => {}    
+    #  
+    # Obtain a hash of active BTSes with their details. No input needed, lots of output to be expected.
+    def listBts
+        build_and_send_query(:list_bts)
+    end
+
+    # call-seq:
+    #   MyNGIAccess.listComuni(comune) => {}    
+    #  
+    # Obtain the istat code for the town.
+    def listComuni(comune)
+        raise ArgumentError, "comune is not >=2 and <= 35 in length, or has not allowed characters" unless is_valid_comune(parameter_to_string(comune))
+        build_and_send_query(:list_comuni,
+            {
+                comune: parameter_to_string(comune)
+            }
+        )
+    end
+    
+    # call-seq:
+    #   MyNGIAccess.setEthernet(macAddress,statoEthernet) => {:stato_ethernet=>true}     
+    #  
+    # Set the ethernet adapter of a customer's radio.
+    def setEthernet(macAddress,statoEthernet)
+        raise ArgumentError, "specified mac address is wrong or in an invalid format" unless is_valid_mac(macAddress)
+        raise ArgumentError, "stato ethernet is wrong on in an invalid format" unless ["0","1"].include? parameter_to_string(statoEthernet)
+        build_and_send_query(:set_ethernet,
+            {
+                macAddress: fix_mac_address(parameter_to_string(macAddress)),
+                statoEthernet: parameter_to_string(statoEthernet)
+            }
+        )
+    end
+
+    # call-seq:
+    #   MyNGIAccess.rebootRadio(macAddress) => {esito: true}    
+    #  
+    # Reboot a customer's radio.
+    def rebootRadio(macAddress)
+        raise ArgumentError, "specified mac address is wrong or in an invalid format" unless is_valid_mac(macAddress)
+        build_and_send_query(:reboot_radio,
+            {
+                macAddress: fix_mac_address(parameter_to_string(macAddress))
+            }
+        )
+    end
+
+    private
+
+    # formats the mac address for the request, stripping separators and upcasing it
+    def fix_mac_address(mac)
+        mac.to_s.gsub(/[\.:-]?/,'').upcase    
+    end
+
+    # formats the login for the request, upcasing it 
+    def fix_login(login)
+        login.upcase
+    end
+
+    # Download the 'cacert.pem' file from "curl.haxx.se" if not found in the running directory
+    # Courtesy of https://gist.github.com/fnichol/867550
+    def fetch_cacert
+        Net::HTTP.start("curl.haxx.se") do |http|
+            resp = http.get("/ca/cacert.pem")
+            if resp.code == "200"
+                open("cacert.pem", "wb") do |file|
+                    file.write(resp.body)
+                end 
+            else
+                raise "no \"cacert.pem\" file found, and can't download it from curl website"
+            end
+        end
+    end
+
+    # Build and submit the SOAP query.
+    # Needed the operation (raise an error if it's not an allowed one from the server) and a hash of optional parameters.
+    def build_and_send_query(type,params = {})
+        type = type.to_sym
+        raise ArgumentError, "query type not included in allowed operations: #{@soapClient.operations}" unless @soapClient.operations.include? type
+        
+        message = { wsLogin: @partnerLogin }
+        checksum = @partnerLogin
+
+        case type
+        when :info_bts
+            checksum += params[:btsID]
+            message[:btsID] = params[:btsID]
+        when :list_comuni
+            checksum += params[:comune]
+            message[:comune] = params[:comune]
+        when :set_ethernet
+            checksum += params[:macAddress]
+            checksum += params[:statoEthernet]
+            message[:macAddress] = params[:macAddress]
+            message[:statoEthernet] = params[:statoEthernet]
+        when :reboot_radio
+            checksum += params[:macAddress]
+            message[:macAddress] = params[:macAddress]
+        when :info_radio
+            checksum += parameter_to_string(params[:macAddressList])
+            checksum += parameter_to_string(params[:clientLoginList])
+            message[:macAddressList] = {items: params[:macAddressList]}
+            message[:clientLoginList] = {items: params[:clientLoginList]}
+        when :list_bts # no input needed
+        end
+        
+        message[:controlHash] = Digest::MD5.hexdigest(checksum+@partnerPassword)
+        @soapClient.call(type, message: message).to_hash[(type.to_s+"_response").to_sym]
+    end
+    
+    # According to {http://unicode-table.com}[http://unicode-table.com]
+    # * \u{00E0} à
+    # * \u{00E8} è
+    # * \u{00E9} é
+    # * \u{00EC} ì
+    # * \u{00F2} ò
+    # * \u{00F9} ù
+    def is_valid_comune(comune)
+        !!comune.to_s[/^([a-zA-Z\u{00E0}\u{00E8}\u{00E9}\u{00EC}\u{00F2}\u{00F9}]{2}[a-zA-Z\u{0200}\u{0201}\u{0236}\u{0242}\u{0249}]{0,33})$/]
+    end
+
+    # Loose check for if a string is a valid login. Value must be formatted before submit with fix_login.
+    # Matches "w or W" + 11 digits
+    def is_valid_login(login)
+        !!login.to_s[/[wW]\d{11}/]
+    end
+
+    # Loose check for the validity of a MAC address. Value must be formatted with fix_mac_address before submit.
+    # Matches any of the following:
+    # * 00aabbccddee
+    # * 00-aa-bb-cc-dd-ee
+    # * 00:aa:bb:cc:dd:ee
+    # * 00.aa.bb.cc.dd.ee
+    def is_valid_mac(mac)
+        !!mac.to_s[/^([0-9a-fA-F]{2}[\.:-]?){5}([0-9a-fA-F]{2})$/]
+    end
+
+    # Formatting types according to NGI API 
+    def parameter_to_string(parameter)
+        case parameter.class.to_s
+        when "TrueClass","FalseClass" 
+            parameter ? "1" : "0"
+        when "Integer"
+            "%d" % parameter
+        when "Float"
+            "%.5f" % parameter
+        when "Array" # streamline it
+            parameter.map{ |element| parameter_to_string(element) }.join
+        else # for any other type, convert it to a string
+            "%s" % parameter.to_s
+        end
+    end
+
+end
+

data/lib/ngi_api/version.rb

@@ -0,0 +1,4 @@
+class NgiAPI
+    # gem version
+    VERSION = "0.0.2"
+end

data/lib/test_cases.rb

@@ -0,0 +1,85 @@
+# encoding: utf-8
+load ('test_class.rb')
+=begin
+
+api_config_fake = { 
+    partnerLogin: "asdasd12345", 
+    partnerPassword: "asdasdhbi8asd78972ui" 
+}
+myNgiAccess = NgiAPI.new(api_config_fake)
+
+api_config_test = { test: true }
+myNgiAccess = NgiAPI.new(api_config_test)
+
+puts myNgiAccess.operations
+puts myNgiAccess.listBts
+puts myNgiAccess.infoBts(1)
+puts myNgiAccess.listComuni("Lòp")
+puts myNgiAccess.setEthernet("00-00-00000000",false)
+
+# this will rise an exception, as per specs
+begin
+    puts myNgiAccess.setEthernet("11-11-11-11-11-11",true)   
+rescue Exception => e
+    puts "Damn! Got an exception: #{e}"
+end
+
+puts myNgiAccess.rebootRadio("aa-bb-cc-dd-ee-11")
+
+# this will rise an exception, as per specs
+begin
+    puts myNgiAccess.rebootRadio("111111111111")
+rescue Exception => e
+    puts "Damn! Got an exception, should be an internal server error: #{e}"
+end
+
+# this will trigger an ArgumentError
+begin
+    api_config_err = { test: true, partnerLogin: "asdasd12345", partnerPassword: "asdasdhbi8asd78972ui" } 
+    myNgiAccess_err = NgiAPI.new(api_config_err) 
+rescue Exception => e
+    puts "Damn! Got an exception, should be an invalid API initialization: #{e}"
+end
+
+# this will trigger an ArgumentError
+begin
+    api_config_err2 = { partnerLogin: "asdasd12345" } 
+    myNgiAccess_err2 = NgiAPI.new(api_config_err2) 
+rescue Exception => e
+    puts "Damn! Got an exception, should be an invalid API initialization: #{e}"
+end
+
+
+# this will trigger an ArgumentError
+begin
+    puts myNgiAccess.infoRadio(["aa.bb.cc.dd.ee.ff","W12345678901"])
+rescue Exception => e
+    puts "Damn! Got an exception, should be an invalid mix: #{e}"
+end
+
+=end
+
+api_config_test = { test:true }
+myNgiAccess = NgiAPI.new(api_config_test)
+
+# puts myNgiAccess.operations
+# puts myNgiAccess.infoRadio(["000000000000","aa11bb22cc33"])
+puts myNgiAccess.infoRadio(["W00001200000","00:ee:aa:bb:cc:dd","W12345678901","W09898778766"]) 
+# {:info=>{:radio_info_list=>[{:client_login=>{:"@xsi:type"=>"xsd:string"}, :mac_address=>"00EEAABBCCDD", :snr_up=>"1", :snr_down=>"2", :distanza=>"13.17", :stato_ethernet=>"1", :bts_id=>"2", :nome_cella=>nil, :tipo_radio=>nil, :"@xsi:type"=>"ns1:radioInfoType"}, {:client_login=>"W00000000001", :mac_address=>"000000000001", :snr_up=>"1", :snr_down=>"2", :distanza=>"13.17", :stato_ethernet=>"1", :bts_id=>"2", :nome_cella=>nil, :tipo_radio=>nil, :"@xsi:type"=>"ns1:radioInfoType"}], :"@xsi:type"=>"ns1:radioInfoListType"}} 
+
+puts myNgiAccess.listBts 
+# {:lista_bts=>{:items=>[{:bts_id=>"1", :nome_bts=>"1 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"2", :nome_bts=>"2 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"3", :nome_bts=>"3 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"4", :nome_bts=>"4 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"5", :nome_bts=>"5 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"6", :nome_bts=>"6 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"7", :nome_bts=>"7 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"8", :nome_bts=>"8 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"9", :nome_bts=>"9 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"10", :nome_bts=>"10 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"11", :nome_bts=>"11 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"12", :nome_bts=>"12 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"13", :nome_bts=>"13 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"14", :nome_bts=>"14 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"15", :nome_bts=>"15 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"16", :nome_bts=>"16 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"17", :nome_bts=>"17 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}, {:bts_id=>"18", :nome_bts=>"18 of 18: 12345678-a9f1870699c64a453757842d645e36ea", :lat=>"45.8", :lng=>"8.45", :attiva=>false, :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsInfoType"}], :"@xsi:type"=>"ns1:BtsListType"}} 
+
+puts myNgiAccess.listComuni("Peppinaio") 
+# {:lista_comuni=>{:items=>[{:comune=>"Alagna", :istat=>"18001", :provincia=>"PV", :"@xsi:type"=>"ns1:comuneType"}, {:comune=>"Alpignano", :istat=>"1008", :provincia=>"TO", :"@xsi:type"=>"ns1:comuneType"}, {:comune=>"Montorio al Vomano", :istat=>"67028", :provincia=>"TE", :"@xsi:type"=>"ns1:comuneType"}, {:comune=>"Roio del Sangro", :istat=>"69077", :provincia=>"CH", :"@xsi:type"=>"ns1:comuneType"}, {:comune=>"Varano de' Melegari", :istat=>"34045", :provincia=>"PR", :"@xsi:type"=>"ns1:comuneType"}, {:comune=>"Voghera", :istat=>"18182", :provincia=>"PV", :"@xsi:type"=>"ns1:comuneType"}, {:comune=>"Zoppola", :istat=>"93051", :provincia=>"PN", :"@xsi:type"=>"ns1:comuneType"}], :"@xsi:type"=>"ns1:comuneListType"}} 
+
+puts myNgiAccess.rebootRadio("00eeaabbccdd")  
+# {:esito=>true} 
+
+puts myNgiAccess.infoBts(3) 
+# {:info_bts=>{:bts_id=>"3", :nome_bts=>"il nome \u00E8: 12345678, 3, bb5fa1323d296928d1a4c2ae5a908f70", :lat=>"45.9", :lng=>"8.15", :asl=>"99", :attiva=>true, :data_attivazione=>#<Date: 2015-01-08 ((2457031j,0s,0n),+0s,2299161j)>, :file_mappa=>"mappa.file", :inf_sx_lat=>"45.79585", :inf_sx_lng=>"7.873442", :sup_dx_lat=>"46.15581", :sup_dx_lng=>"8.391391", :tech_string=>{:"@xsi:type"=>"ns1:nonNullName"}, :"@xsi:type"=>"ns1:BtsFullInfoType"}} 
+
+puts myNgiAccess.setEthernet("00aabbccddee",true) 
+# {:stato_ethernet=>true} 
+
+

data/ngi_api.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ngi_api/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ngi_api"
+  spec.version       = NgiAPI::VERSION
+  spec.platform      = Gem::Platform::RUBY
+  spec.authors       = ["Marco Bulgarini"]
+  spec.email         = ["marco.bulgarini@com-net.it"]
+  spec.summary       = "NGI's API"
+  spec.description   = "A ruby implementation of NGI's API"
+  spec.homepage      = "https://rubygems.org/gems/ngi_api"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+
+  # spec.add_runtime_dependency "digest"    # no need to add stdlib!
+  # spec.add_runtime_dependency "net/http"  # no need to add stdlib!
+  spec.add_runtime_dependency "rubyntlm", "~> 0.3.2"
+  spec.add_runtime_dependency "savon"
+end

data/spec/ngi_api_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe NgiApi do
+#  subject { NgiApi.new }
+
+#  describe '#process' do
+#    let(:input) { 'My grandmom gave me a sweater for Christmas.' }
+#    let(:output) { subject.process(input) }
+
+#    it 'converts to lowercase' do
+#      expect(output.downcase).to eq output
+#    end
+
+#    it 'combines nouns with doge adjectives' do
+#      expect(output).to match /so grandmom\./i
+#      expect(output).to match /such sweater\./i
+#      expect(output).to match /very christmas\./i
+#    end
+
+#    it 'always appends "wow."' do
+#      expect(output).to end_with 'wow.'
+#    end
+#  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'ngi_api'

data/tasks/rspec.rake

@@ -0,0 +1,3 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: ngi_api
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Marco Bulgarini
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-01-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubyntlm
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A ruby implementation of NGI's API
+email:
+- marco.bulgarini@com-net.it
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/README.rdoc
+- lib/cacert.pem
+- lib/ngi_api.rb
+- lib/ngi_api/version.rb
+- lib/test_cases.rb
+- ngi_api.gemspec
+- spec/ngi_api_spec.rb
+- spec/spec_helper.rb
+- tasks/rspec.rake
+homepage: https://rubygems.org/gems/ngi_api
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: NGI's API
+test_files:
+- spec/ngi_api_spec.rb
+- spec/spec_helper.rb
+has_rdoc: