kono_utils 0.15.15 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ff064113668b46f7504e1651bdb503ae8f909314
-  data.tar.gz: 361d5bcb1a36aaa98371c414d736e8fc27aa7595
+SHA256:
+  metadata.gz: c5015498a44dc1be3efa63b564cc3ad7e0198e40ba2477d1fee1cfaad0bbe97f
+  data.tar.gz: f23eaa227ce615b319615dbc816e694641c875c9abfeba4d4cdd0d736ebf1783
 SHA512:
-  metadata.gz: d0f05be12fb1dccedcca3ca8fbb9e4889c71d6768d1438eacecc37a4d9a44461fdca88ead73513a7fd35da5749f2f9cb3a946f472f1d6818b5d76f800953f659
-  data.tar.gz: ef3990575b03a918549b49ad75883b72811acb7f78a720522ef5d08d85986051fe7ee6f20bb8deb8980604782e6f7a85e7f036addaa48a73e12d7cffb936fd61
+  metadata.gz: 667bcd329e9df24bce3836715b866f431fad52f29c63939ca7386e6a8dfc04bd68ead2158310755987d52919f955ef099059a1d15c49571cce90fe9cdbf68f37
+  data.tar.gz: a12bdf8b96758abcaea4e7e540fb936973936e7f388cbbb1450694cdc4b07b3fe118f42cf245450399c82b6553093dde433cce149701759845678ff8825396fd

data/README.rdoc

@@ -7,13 +7,28 @@ libreria di utilità per i vari progetti utilizzati da Archimedia.
 
 == Installazione
  aggiungere nel proprio gemfile
- source 'https://rails-assets.org'
 
  gem 'kono_utils'
 
- per avere anche le utilities in javascript:
+ bundle
+
+ Generatore:
+
+ bin/rails g kono_utils:install
+
+
+ che istalla le dipendenze con yarn e aggiunge il:
+
  require kono_utils/utilities
 
+== Upgrade From 0.x
+ After bundle update make
+
+ bin/rails g kono_utils:install
+
+ so you have the yarn packages appended
+
+
 == Controllers/Views
 
 === ChangeLog
@@ -37,82 +52,6 @@ libreria di utilità per i vari progetti utilizzati da Archimedia.
     -  **Feature**          lorem
   </code>
 
-== TmpFile
- Classe Funzionante prettamente con RAILS
-
- La classe si occupa dei files temporanei creando una cartella dentro a tmp del progetto,
- per ovviare al problema di duplicazioni dei nomi, viene generata una nuova cartella con
- timestamp univoco per ogni file.
-
- Estende Tempfile,
- la root della struttura è quella di Rails.root
- e di default la classe scrive dentro a tmp della root di rails.
-
- Non c'è bisogno di preoccuparsi di svuotare la cartella tmp contenente i file temporanei dato che la classe
- avrà l'onere di controllare e ripulire eventuali files dopo 1.day di default.
-
-=== Utilizzo:
- tmp = KonoUtils::TmpFile.new('nomefile.ext')
- tmp.path -> path completa
- tmp.write(valore_da_scrivere_dentro_a_file)
- tmp.original_filename -> restituisce il nome inizialmente passato alla classe
- tmp.unique_filename   -> restoituisce il nome univoco del file
- tmp.path              -> restituisce la path del file
-
-
-
-== Encoder
- Classe che si occupa di decodificare una qualsiasi stringa in formato utf8,
- cercando di trovare l'encoding iniziale a tentativi.
- Ha anche a disposizione una funzione per la rimozione dei caratteri BOM dalla stringa(http://en.wikipedia.org/wiki/Byte_order_mark)
-
-=== Utilizzo
- str="stringa di un encoding sconosciuto"
- en = KonoUtils::Encoder.new(str)
- en.string_encoder  -> normale tentativo di encoding restituendo stringa in utf8
- en.remove_bom      -> rimozione del carattere BOM e encoding con la funzione precedente
-
-== Percentage
- Classe che si occupa di rappresentare un numero in percentuale.
- Per maggiori info sulle funzionalità controllare la documentazione sulla classe
-
-=== Utilizzo
- p = KonoUtils::Percentage.new(100,20)
- p.percentage -> ritorna il valore percentuale float
- p.to_i -> ritorna percentuale intera con relativi arrotondamenti
- p.to_percentage -> si comporta come l'helper number_to_percentage
-
-== Params Hash Array
-
- Si occupa di trasformare un hash con elementi che sono chiramente array in un hash con elementi array:
-
- {"DatiOrdineAcquisto"=>{"0"=>{"RiferimentoNumeroLinea"=>{"0"=>""}, "IdDocumento"=>"", "Data"=>"", "NumItem"=>"", "CodiceCommessaConvenzione"=>"", "CodiceCUP"=>"", "CodiceCIG"=>""}}}
- {"DatiOrdineAcquisto"=>[{"RiferimentoNumeroLinea"=>[""], "IdDocumento"=>"", "Data"=>"", "NumItem"=>"", "CodiceCommessaConvenzione"=>"", "CodiceCUP"=>"", "CodiceCIG"=>""}]}
-
-=== Utilizzo
- includere nel controller o dove si vuole utilizzare il concern
- include KonoUtils::ParamsHashArray
-
- e richiamare la funzione:
- elaborate_params_to_hash_array(params)
-
-== Virtual Model
- Server per avere un modello virtuale in Rails
-
-=== Utilizzo
-  Praticamente è come avere un active record ma senza avere una tabella
-
-  class Session < KonoUtils::VirtualModel
-
-    attr_accessor :username, :password, :token
-
-
-    validates :token,:presence=>true
-
-  end
-
-  Session.new(:username=>'ciao',:password=>'pippo').valid? => false
-
 == BaseSearch
     Classe per semplificare il sistema di organizzazione dei modelli di ricerca, unendo anche la
     configurazione della form di ricerca utilizzando l'helper search_form

data/app/assets/javascripts/kono_utils/core.coffee

@@ -0,0 +1,477 @@
+#= require underscore/underscore
+##= require wolfy87-eventemitter/EventEmitter
+
+@Kono = @Kono || {};
+
+@Kn = @Kono
+
+##
+# http://stackoverflow.com/questions/8730859/classes-within-coffeescript-namespace
+# Funzione che si occupa di costruire il namespace se non presente e passarlo come risultato
+# la funzione si aspetta una stringa divisa da punti che identificano i vari livelli di namespace
+# Es: @Kn.ns 'Kn.admin.iseeprices', (exports)->
+#         exports.Form = Form
+#         exports.attributi_vari = 'ciao'
+# ovviamente senza cancellare i precedenti livelli
+
+@Kn.ns = (target, name, block) ->
+  if arguments.length < 3
+    tmp = (if typeof exports isnt 'undefined' then exports else window)
+    [target, name, block] = [tmp, arguments...]
+  top = target
+  target = target[item] or= {} for item in name.split '.'
+  block target, top
+
+
+###
+  Si occupa di eseguire il blocco nel caso in cui siamo nel namespace di vista,
+  o che sia presente tale namespace.
+  eseguo ovviamente il tutto all'interno di un $-> per essere sicuro che la pagina sia caricata
+  Viene attaccanto anche un evento per ascoltare i possibili eventi di hashchange di jquery ui
+  per ascoltare se una nuova pagina viene inserita.
+  ES:
+    @Kn.view_ns '.Alim.Admin.IseepricesController.edit', (namespace)->
+      fai qualcosa solo se esiste tale namespace
+
+###
+@Kn.view_ns = (selector, block) ->
+#funzione da lanciare per il reload della pagina
+  esecutore = _.debounce(->
+#se abbiamo il selettore allora lancio il blocco
+    if $(selector).length > 0
+      block(selector)
+  , 10, true)
+  #on ready
+  $ ->
+    esecutore()
+
+  #attacco ascoltatore event haschanged
+  $(window).on 'hashchange', esecutore
+
+  #Attacco evento anche per turbolinks
+  document.addEventListener("turbolinks:load", esecutore)
+
+
+###
+  Singleton per avere una modal da utilizzare
+   funziona attraverso helper bootstrap_please_wait
+###
+#@Kn.show_wait = ->
+#  $('#processing_wait').modal()
+#
+#@Kn.hide_wait = ->
+#  $('#processing_wait').modal('hide')
+#  #forzo eliminazione di tutti i fade
+#  $('.modal-backdrop.fade.in').remove()
+
+
+##
+# A tutte le form aggiungo l'autocomplete ad off
+#$ ->
+#  $('form').prop('autocomplete', 'off')
+#
+
+##
+# picker = new Kn.utilities.DateTimePicker(
+#    selector: _.map(view_namespace, (cls)-> "#{cls} #date_time_picker_documents_search_data").join(",")
+#    server_format: "YYYY-MM-DDTHH:mm:ss+Z"
+#  )
+#  picker.initialize()
+#
+#class DateTimePicker
+#
+#  defaults = server_format: "YYYY-MM-DD HH:mm:ss Z",
+#  format: 'DD/MM/YYYY',
+#  server_match: /^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2} .$/,
+#  locale: 'it'
+#
+#  constructor: (options = {}) ->
+#    {@selector, @server_format, @format, @server_match, @locale} = _.extend defaults, options
+#    @input_date = @parse_input_value()
+#
+#  initialize: ->
+#    if @input_date
+#      val = @input_date
+#      val = @input_date.format(@format) if _.isFunction(@input_date.format)
+#      $(@selector).find("input").val(val)
+#
+#    $(@selector).datetimepicker(@picker_configs())
+#
+#  picker_configs: ->
+#    {
+#      format: @format,
+#      locale: @locale
+#    }
+#
+#  parse_input_value: ->
+#    value = $(@selector).find("input").attr('value')
+#    unless value == '' or _.isUndefined(value)
+#      if @server_match.test(value)
+#        return moment(value, @server_format)
+#      else
+#        return value
+#    false
+
+
+##
+# Definisce l'elemento associato alla data finale di un range di date
+#  set_end: (@end_pick)->
+#    $(@selector).data("DateTimePicker").maxDate(@end_pick.input_date) if @end_pick.input_date
+#
+#    $("#{@end_pick.selector}").on "dp.change", (e) =>
+#      $(@selector).data("DateTimePicker").maxDate(e.date)
+#
+## Definisce l'elemento associato alla data iniziale di un range di date
+#  set_start: (@start_pick)->
+#    $(@selector).data("DateTimePicker").minDate(@start_pick.input_date) if @start_pick.input_date
+#
+#    $("#{@start_pick.selector}").on "dp.change", (e) =>
+#      $(@selector).data("DateTimePicker").minDate(e.date)
+
+
+
+
+#@Kn.ns 'Kn.utilities', (exports)->
+#  exports.DateTimePicker = DateTimePicker
+
+#class TimePicker extends DateTimePicker
+#  defaults = server_format: "HH:mm",
+#  format: 'HH:mm',
+#  server_match: /[0-9]{2}:[0-9]{2} .$/
+#
+#  picker_configs: ->
+#    _.extend super(), {format: 'HH:mm'}
+#
+#
+#@Kn.ns 'Kn.utilities', (exports)->
+#  exports.TimePicker = TimePicker
+
+
+##
+# Eventi generali Jquery
+#$ ->
+#  $('.collapse_search').click (e) ->
+#    e.preventDefault();
+#    $('.search_panel .collapsible_panel').slideToggle()
+#  $('.search_panel .collapsible_panel').slideUp() unless $('.search_panel .collapsible_panel.uncollapsed').length > 0
+#
+
+## Trasformare form bootstrap da label posizionate sopra a input a sinistra
+# Default:
+# label_cls: 'col-sm-2'
+# wrapp_cls: 'col-sm-10'
+#$.fn.extend
+#  bs3_form_inline: (options)->
+#    settings =
+#      label_cls: 'col-sm-2'
+#      wrapp_cls: 'col-sm-10'
+#
+#    settings = $.extend settings, options
+#    return @each () ->
+#      $(this).find('.form-group .form-label').addClass settings.label_cls
+#      $(this).find('.form-group .form-wrapper').addClass settings.wrapp_cls
+
+
+#duplicate_button_toggle = (btn)->
+#  if $(btn.parentNode).find('.remove_row,.add_one_more').length == 1
+#    if $(btn.parentNode).find('.remove_row').length == 0
+#      rem_class = 'add_one_more'
+#      add_class = 'remove_row'
+#      ico_rem_class = 'fa-plus'
+#      ico_add_class = 'fa-minus'
+#    if $(btn.parentNode).find('.add_one_more').length == 0
+#      rem_class = 'remove_row'
+#      add_class = 'add_one_more'
+#      ico_rem_class = 'fa-minus'
+#      ico_add_class = 'fa-plus'
+#
+#    $(btn).clone().appendTo(btn.parentNode).
+#    removeClass(rem_class).
+#    addClass(add_class).
+#    find('.fa').
+#    removeClass(ico_rem_class).
+#    addClass(ico_add_class)
+
+#elaborate_buttons = (tabella)->
+##  numero_elementi = $(tabella).find('.add_one_more').length
+#  $(tabella).find('.add_one_more').each (index, ele)->
+#    duplicate_button_toggle(ele)
+#  if $(tabella).find('tr:not(.multiple_table_remove_row) .remove_row').length == 1
+#    $(tabella).find('tr:not(.multiple_table_remove_row) .remove_row').first().remove()
+
+
+## Gestione elementi multipli
+# Eventi sulla tabella:
+# - row_append  : lanciato quando viene appeso una nuova riga, parametri: tabella,riga appena aggiunta
+# - row_removed : lanciato quando viene rimossa una nuova riga, parametri: tabella,riga appena rimossa
+#$.fn.extend
+#  multiple_table: (options) ->
+##    settings =
+##      label: ".form-label"
+##      content: ".form-wrapper"
+##
+##    settings = $.extend settings, options
+#    return @each () ->
+#      tabella = @
+#      elaborate_buttons(tabella)
+#
+#
+#      $(tabella).on 'click', '.remove_row', (e)->
+#        e.preventDefault()
+#        row = $(@).closest('tr')
+#        row.hide().addClass('multiple_table_remove_row')
+#        $(@).find('[type="hidden"]').val('true')
+#        elaborate_buttons(tabella)
+#        $(tabella).trigger("row_removed", [tabella, row]);
+#
+#      $(tabella).on 'click', '.add_one_more', (e)->
+#        e.preventDefault()
+#        row = $(@).closest('tr').clone(false, true)
+#        uid = $(@).closest('tbody').find('tr').length
+#        $(row).find('input,select').val('').each ->
+#          name = $(@).attr('name').replace(/\[[0-9]+\]/, "[#{uid}]")
+#          $(@).attr('name', name)
+#          $(@).removeAttr('disabled')
+#
+#        datapicker_containers= $(row).find(".tk_date_time_picker")
+#        $(datapicker_containers).each (index,val) =>
+#          new_id= $(val).attr("id").concat( new Date().getTime())
+#          $(val).attr("id",new_id)
+#
+#          script = $(val).siblings("script")[0]
+#          script_text = $(script).text();
+#          new_script_text = script_text.replace(/'#.*'/,"'#"+new_id+"'")
+#          script_parent= $(script).parent()
+#          $(script).replaceWith('<script type=\'text/javascript\'>'+new_script_text+'</script>');
+#
+#        row.appendTo($(@).closest('tbody'))
+#        elaborate_buttons(tabella)
+#        $(tabella).trigger("row_append", [tabella, row]);
+
+##fine
+
+## Gestione bottone di cancellazione
+# Precedentemente alla rimozione dell'elemento viene
+# lanciato un evento che notifica tale cancellazione "component_removed"
+#$.fn.extend
+#  kono_delete_button: ()->
+#    return @each () ->
+#      $(this).on 'submit', (e) ->
+#        e.preventDefault()
+#        form = $(this)
+#        form.closest('.modal').modal('hide')
+#        $.ajax
+#          url: form.prop('action')
+#          data: form.serialize()
+#          method: 'DELETE'
+#          success: (data)->
+#            $('.modal-backdrop').remove() #rimuovo la modal
+#            $('body').removeClass('modal-open') #rimuovo la classe che blocca
+#            if data.success
+#              base_component = $(form.data('callbackRemove'))
+#              base_component.trigger('component_removed', [form.data('callbackRemove'), data]);
+#              base_component.hide('fast').remove()
+
+
+##
+# Classe per la gestione delle form Modal
+#
+# Eventi:
+#   close_modal             -> self
+#   rescue_invalid_content  -> self,response,jquery(dom modal)
+#   success                 -> ajax_response
+
+#class ModalForm extends EventEmitter
+#
+#  defaults = {success: (->)}
+#
+#  constructor: (@modal, options = {}) ->
+#    super
+#    {@success} = _.extend defaults, options
+#    @form = $(@modal).find('form').get(0)
+#    @modal_id = $(@modal).attr('id')
+#    @initialize_callbacks()
+#
+#  inject_format: (format = 'json')->
+#    $(@form).append("<input type='hidden' value='#{format}' name='format'>")
+#
+#  close_modal: ->
+#    $(@modal).modal('hide')
+#    $('.modal-backdrop').remove()
+#    $('body').removeClass('modal-open')
+#    $(@form).get(0).reset()
+#    @emitEvent('close_modal', [@]);
+#
+#  rescue_invalid_content: (response)->
+## ricevendo in risposta la modal sostituirò la modal attuale,
+## attacco tutte le opzioni di questa classe.
+#    @close_modal()
+#    mod = $(response.partial).appendTo($('body'))
+#    id = Date.now()
+#    $(mod).prop('id', id).modal('show')
+#    modal = new @.__proto__.constructor(mod)
+#    @propagate_events_on_child(modal)
+#    @emitEvent('rescue_invalid_content', [@, response, modal])
+#    return {response: response, modal: modal}
+#
+#
+## Si occupa di propagare gli eventi attaccati sul padre pannello sui vari figli
+#  propagate_events_on_child: (child)->
+#    events = @_getEvents()
+#    _.each events, (v, k) =>
+#      child.on k, =>
+#        @emitEvent(k, arguments)
+#
+#
+#  initialize_callbacks: ->
+#    @inject_format()
+#    $(@form).on 'submit', (e) =>
+#      Kn.show_wait()
+#      e.preventDefault()
+#      $.ajax
+#        url: $(@form).prop('action')
+#        method: $(@form).prop('method')
+#        data: $(@form).serialize()
+#        success: =>
+#          @_on_success(arguments)
+#        error: (xhr) =>
+#          @_on_error(xhr)
+#
+###
+## funzione privata eseguita al success
+#  _on_success: (args)->
+#    @close_modal()
+#    Kn.hide_wait()
+#    @emitEvent('success', args);
+#
+#  _on_error: (xhr)->
+#    Kn.hide_wait()
+#    switch parseInt(xhr.status/100)*100
+#      when 400 then @rescue_invalid_content(xhr.responseJSON)
+#      when 500 then alert("Attenzione, problemi nello svolgimento dell'operazione contattare amministratore")
+#
+#
+#@Kn.ns 'Kn.utilities', (exports)->
+#  exports.ModalForm = ModalForm
+#
+#
+#class ModalNewButton extends ModalForm
+#
+#  ##
+#  # Funzione per ricaricare la modal
+#  # Esegue un'ajax alla pagina corrente, ricercando l'elemento con l'id uguale a quello di se stesso,
+#  # rimpiazza quindi la precedente modal di creazione e riattacca tutti gli eventi al modal appena creato.
+#  # sucessivamente rimuove l'elemento iniziale e lancia l'evento "self_reloaded" per poter far eventualemnte ulteriori
+#  # modifiche sul modal appena generato
+#  self_reload: ()->
+#    @_self_reload(@)
+#
+#  _self_reload: ()->
+#    Kn.show_wait()
+#    id = "tmp#{(new Date()).getTime()}"
+#    $('body').append("<div id='#{id}'></div>")
+#    $("##{id}").load "#{window.location.href} ##{@modal_id}", ()=>
+#      ele = $("##{id}>*")
+#      $(ele).attr('generated_id', id)
+#      pre_modal = $("##{@modal_id}")
+#      pre_modal.after(ele)
+#      modal = new @__proto__.constructor(ele)
+#      @propagate_events_on_child(modal)
+#      @emitEvent('self_reloaded', [modal, @])
+#      pre_modal.remove()
+#      Kn.hide_wait()
+#
+#
+#@Kn.ns 'Kn.utilities', (exports)->
+#  exports.ModalNewButton = ModalNewButton
+#
+#
+####
+#Classe che gestisce la UI per il bottone edit
+#
+####
+#class ModalEditButton extends ModalForm
+#
+#  constructor: (@btn_blk, options = {}) ->
+#    @updatable_content = $(@btn_blk).data('updatableContent')
+#    if $(@btn_blk).hasClass('kono_modal_form')
+#      super(@btn_blk, options)
+#    else
+#      super($(@btn_blk).find('.kono_modal_form').get(0), options)
+#
+#  _on_success: (args)->
+#    super
+#    data = args[0]
+#    if @updatable_content
+#      $(@updatable_content).replaceWith(data.partial)
+#      #seleziono il nuovo pannello
+#      panel = $(@updatable_content)
+#      panel.find('.kono_edit_button').each (index,ele) =>
+#        new_panel = new @.__proto__.constructor(ele)
+#        new_panel.modal.updatable_content = @updatable_content
+#        #rillacciamo gli eventi del vecchio pannello su quello nuovo
+#        @propagate_events_on_child(new_panel)
+#        @emitEvent('rendered', [@, panel, new_panel])
+#
+#  rescue_invalid_content: (response)->
+#    res = super
+#    res.modal.updatable_content = @updatable_content
+#
+#
+#  initial_classes: ->
+#    _.reduce _.compact($(@btn_blk).prop('class').split(' ')), (memo, str)->
+#      "#{memo}.#{str}"
+#    , ''
+#
+#
+#@Kn.ns 'Kn.utilities', (exports)->
+#  exports.ModalEditButton = ModalEditButton
+#
+#
+#class BasePannel
+#
+#  form_inline_settings:
+#    label_cls: 'col-xs-12 col-sm-4',
+#    wrapp_cls: 'col-xs-12 col-sm-8'
+#
+#  constructor: (@blk) ->
+#    $(@blk).bs3_form_inline @form_inline_settings
+#    @initialize_events()
+#
+#  initialize_events: ->
+#    ele = $(@blk).find('.kono_edit_button').get(0)
+#    if(ele)
+#      panel = new Kn.utilities.ModalEditButton ele
+#      panel.on 'rendered', (button, panel)->
+#        $(panel).bs3_form_inline @form_inline_settings
+#      panel.on 'rescue_invalid_content', (a, b, c)->
+#        $(c.modal).bs3_form_inline @form_inline_settings
+#
+#@Kn.ns 'Kn.utilities', (exports)->
+#  exports.BasePannel = BasePannel
+#
+### Gestione Generazione Mappa google per Input LocationPicker
+##
+#$.fn.extend
+#  kono_util_location_picker: (options)->
+#    settings =
+#      center: {lat: 42.908, lng: 12.303}
+#      selector_field_lat: 'input[name="lat"]'
+#      selector_field_lng: 'input[name="lat"]'
+#      zoom_level: 5
+#
+#    settings = $.extend settings, options
+#
+#    return @each () ->
+#      map = new google.maps.Map(@, {
+#        zoom: settings.zoom_level,
+#        center: settings.center
+#      })
+#      marker = new google.maps.Marker({
+#        position: settings.center,
+#        draggable: true,
+#        map: map
+#      })
+#      marker.addListener 'drag', (data) ->
+#        $(settings.selector_field_lat).val(data.latLng.lat())
+#        $(settings.selector_field_lng).val(data.latLng.lng())