baza 0.0.14 → 0.0.15

data/include/model.rb

@@ -5,27 +5,27 @@
 #  user = ob.get(:User, 1) #=> <Models::User> that extends <Baza::Datarow>
 class Baza::Model
   @@refs = {}
-  
+
   #Returns the Baza::ModelHandler which handels this model.
   def ob
     return self.class.ob
   end
-  
+
   #Returns the Baza::Db which handels this model.
   def db
     return self.class.db
   end
-  
+
   #Returns the 'Baza::ModelHandler'-object that handels this class.
   def self.ob
     return @ob
   end
-  
+
   #Returns the 'Baza::Db'-object that handels this class.
   def self.db
     return @db
   end
-  
+
   #This is used by 'Baza::ModelHandler' to find out what data is required for this class. Returns the array that tells about required data.
   #===Examples
   #When adding a new user, this can fail if the ':group_id' is not given, or the ':group_id' doesnt refer to a valid group-row in the db.
@@ -38,7 +38,7 @@ class Baza::Model
     @required_data = [] if !@required_data
     return @required_data
   end
-  
+
   #This is used by 'Baza::ModelHandler' to find out what other objects this class depends on. Returns the array that tells about depending data.
   #===Examples
   #This will tell Baza::ModelHandler that files depends on users. It can prevent the user from being deleted, if any files depend on it.
@@ -50,13 +50,13 @@ class Baza::Model
   def self.depending_data
     return @depending_data
   end
-  
+
   #Returns true if this class has been initialized.
   def self.initialized?
     return false if !@columns_sqlhelper_args
     return true
   end
-  
+
   #This is used by 'Baza::ModelHandler' to find out which other objects should be deleted when an object of this class is deleted automatically. Returns the array that tells about autodelete data.
   #===Examples
   #This will trigger Baza::ModelHandler to automatically delete all the users pictures, when deleting the current user.
@@ -68,19 +68,19 @@ class Baza::Model
   def self.autodelete_data
     return @autodelete_data
   end
-  
+
   #Returns the autozero-data (if any).
   def self.autozero_data
     return @autozero_data
   end
-  
+
   #This helps various parts of the framework determine if this is a datarow class without requiring it.
   #===Examples
   #  print "This is a knj-object." if obj.respond_to?("is_knj?")
   def is_knj?
     return true
   end
-  
+
   #This tests if a certain string is a date-null-stamp.
   #===Examples
   #  time_str = dbrow[:date]
@@ -89,7 +89,7 @@ class Baza::Model
     return true if !stamp or stamp == "0000-00-00 00:00:00" or stamp == "0000-00-00"
     return false
   end
-  
+
   #This is used to define datarows that this object can have a lot of.
   #===Examples
   #This will define the method "pictures" on 'Models::User' that will return all pictures for the users and take possible Objects-sql-arguments. It will also enabling joining pictures when doing Objects-sql-lookups.
@@ -105,7 +105,7 @@ class Baza::Model
         classname, colname, methodname = *val
       elsif val.is_a?(Hash)
         classname, colname, methodname = nil, nil, nil
-        
+
         val.each do |hkey, hval|
           case hkey
             when :class
@@ -120,9 +120,9 @@ class Baza::Model
               raise "Invalid key for 'has_many': '#{hkey}'."
           end
         end
-        
+
         colname = "#{self.name.to_s.split("::").last.to_s.downcase}_id".to_sym if colname.to_s.empty?
-        
+
         if val[:depends]
           @depending_data = [] if !@depending_data
           @depending_data << {
@@ -130,7 +130,7 @@ class Baza::Model
             :classname => classname
           }
         end
-        
+
         if val[:autodelete]
           @autodelete_data = [] if !@autodelete_data
           @autodelete_data << {
@@ -138,7 +138,7 @@ class Baza::Model
             :classname => classname
           }
         end
-        
+
         if val[:autozero]
           @autozero_data = [] if !@autozero_data
           @autozero_data << {
@@ -149,19 +149,19 @@ class Baza::Model
       else
         raise "Unknown argument: '#{val.class.name}'."
       end
-      
+
       raise "No classname given." if !classname
       methodname = "#{StringCases.camel_to_snake(classname)}s".to_sym if !methodname
       raise "No column was given for '#{self.name}' regarding has-many-class: '#{classname}'." if !colname
-      
+
       if val.is_a?(Hash) and val.key?(:where)
         where_args = val[:where]
       else
         where_args = nil
       end
-      
+
       self.define_many_methods(classname, methodname, colname, where_args)
-      
+
       self.joined_tables(
         classname => {
           :where => {
@@ -171,26 +171,26 @@ class Baza::Model
       )
     end
   end
-  
+
   #This define is this object has one element of another datarow-class. It define various methods and joins based on that.
   #===Examples
   #  class Models::User < Baza::Datarow
   #    has_one [
   #      #Defines the method 'group', which returns a 'Group'-object by the column 'group_id'.
   #      :Group,
-  #      
+  #
   #      #Defines the method 'type', which returns a 'Type'-object by the column 'type_id'.
   #      {:class => :Type, :col => :type_id, :method => :type}
   #    ]
   #  end
   def self.has_one(arr)
     arr = [arr] if arr.is_a?(Symbol)
-    
+
     arr.each do |val|
       methodname = nil
       colname = nil
       classname = nil
-      
+
       if val.is_a?(Symbol)
         classname = val
         methodname = val.to_s.downcase.to_sym
@@ -199,7 +199,7 @@ class Baza::Model
         classname, colname, methodname = *val
       elsif val.is_a?(Hash)
         classname, colname, methodname = nil, nil, nil
-        
+
         val.each do |hkey, hval|
           case hkey
             when :class
@@ -214,7 +214,7 @@ class Baza::Model
               raise "Invalid key for class '#{self.name}' functionality 'has_many': '#{hkey}'."
           end
         end
-        
+
         if val[:required]
           colname = "#{classname.to_s.downcase}_id".to_sym if !colname
           self.required_data << {
@@ -225,11 +225,11 @@ class Baza::Model
       else
         raise "Unknown argument-type: '#{arr.class.name}'."
       end
-      
+
       methodname = StringCases.camel_to_snake(classname) if !methodname
       colname = "#{classname.to_s.downcase}_id".to_sym if !colname
       self.define_one_methods(classname, methodname, colname)
-      
+
       self.joined_tables(
         classname => {
           :where => {
@@ -239,79 +239,79 @@ class Baza::Model
       )
     end
   end
-  
+
   #This method initializes joins, sets methods to update translations and makes the translations automatically be deleted when the object is deleted.
   #===Examples
   #  class Models::Article < Baza::Datarow
   #    #Defines methods such as: 'title', 'title=', 'content', 'content='. When used with Knjappserver these methods will change what they return and set based on the current language of the session.
   #    has_translation [:title, :content]
   #  end
-  # 
+  #
   #  article = ob.get(:Article, 1)
   #  print "The title in the current language is: '#{article.title}'."
-  #  
+  #
   #  article.title = 'Title in english if the language is english'
   def self.has_translation(arr)
     @translations = [] if !@translations
-    
+
     arr.each do |val|
       @translations << val
-      
+
       val_dc = val.to_s.downcase
       table_name = "Translation_#{val_dc}".to_sym
-      
+
       joined_tables(
         table_name => {
-          :where => {
+          where: {
             "object_class" => self.name,
-            "object_id" => {:type => :col, :name => :id},
+            "object_id" => {type: :col, name: :id},
             "key" => val.to_s,
             "locale" => proc{|d| _session[:locale]}
           },
-          :parent_table => :Translation,
-          :datarow => Knj::Translations::Translation,
-          :ob => @ob
+          parent_table: :Translation,
+          datarow: Knj::Translations::Translation,
+          ob: @ob
         }
       )
-      
-      self.define_translation_methods(:val => val, :val_dc => val_dc)
+
+      self.define_translation_methods(val: val, val_dc: val_dc)
     end
   end
-  
+
   #This returns all translations for this datarow-class.
   def self.translations
     return @translations
   end
-  
+
   #Returns data about joined tables for this class.
   def self.joined_tables(hash)
     @columns_joined_tables = {} if !@columns_joined_tables
     @columns_joined_tables.merge!(hash)
   end
-  
+
   #Returns various data for the objects-sql-helper. This can be used to view various informations about the columns and more.
   def self.columns_sqlhelper_args
     raise "No SQLHelper arguments has been spawned yet." if !@columns_sqlhelper_args
     return @columns_sqlhelper_args
   end
-  
+
   #Called by Baza::ModelHandler to initialize the model and load column-data on-the-fly.
   def self.load_columns(d)
     @ob = d.ob
     @db = d.db
-    
+
     @classname = self.name.split("::").last.to_sym if !@classname
     @table = @classname if !@table
     @mutex = Monitor.new if !@mutex
-    
+
     #Cache these to avoid method-lookups.
     @sep_col = @db.sep_col
     @sep_table = @db.sep_table
     @table_str = "#{@sep_table}#{@db.esc_table(@table)}#{@sep_table}"
-    
+
     @mutex.synchronize do
       inst_methods = self.instance_methods(false)
-      
+
       sqlhelper_args = {
         :db => @db,
         :table => @table,
@@ -322,18 +322,18 @@ class Baza::Model
         :cols_str => [],
         :cols => {}
       }
-      
+
       sqlhelper_args[:table] = @table
-      
+
       @db.tables[table].columns do |col_obj|
         col_name = col_obj.name.to_s
         col_name_sym = col_name.to_sym
         col_type = col_obj.type
         col_type = :int if col_type == :bigint or col_type == :tinyint or col_type == :mediumint or col_type == :smallint
         sqlhelper_args[:cols][col_name] = true
-        
+
         self.define_bool_methods(inst_methods, col_name)
-        
+
         if col_type == :enum and col_obj.maxlength == "'0','1'"
           sqlhelper_args[:cols_bools] << col_name
         elsif col_type == :int and col_name.slice(-3, 3) == "_id"
@@ -346,49 +346,49 @@ class Baza::Model
           sqlhelper_args[:cols_date] << col_name
           self.define_date_methods(inst_methods, col_name_sym)
         end
-        
+
         if col_type == :int or col_type == :decimal
           self.define_numeric_methods(inst_methods, col_name_sym)
         end
-        
+
         if col_type == :int or col_type == :varchar
           self.define_text_methods(inst_methods, col_name_sym)
         end
-        
+
         if col_type == :time
           self.define_time_methods(inst_methods, col_name_sym)
         end
       end
-      
+
       if @columns_joined_tables
         @columns_joined_tables.each do |table_name, table_data|
           table_data[:where].each do |key, val|
             val[:table] = @table if val.is_a?(Hash) and !val.key?(:table) and val[:type].to_sym == :col
           end
-          
+
           table_data[:datarow] = @ob.args[:module].const_get(table_name.to_sym) if !table_data.key?(:datarow)
         end
-        
+
         sqlhelper_args[:joined_tables] = @columns_joined_tables
       end
-      
+
       @columns_sqlhelper_args = sqlhelper_args
     end
-    
+
     self.init_class(d) if self.respond_to?(:init_class)
   end
-  
+
   #This method helps returning objects and supports various arguments. It should be called by Object#list.
   #===Examples
   #  ob.list(:User, {"username_lower" => "john doe"}) do |user|
   #    print user.id
   #  end
-  #  
+  #
   #  array = ob.list(:User, {"id" => 1})
   #  print array.length
   def self.list(d, &block)
     args = d.args
-    
+
     if args["count"]
       count = true
       args.delete("count")
@@ -400,15 +400,15 @@ class Baza::Model
     else
       sql = "SELECT #{@table_str}.*"
     end
-    
+
     qargs = nil
     ret = self.list_helper(d)
-    
+
     sql << " FROM #{@table_str}"
     sql << ret[:sql_joins]
     sql << " WHERE 1=1"
     sql << ret[:sql_where]
-    
+
     args.each do |key, val|
       case key
         when "return_sql"
@@ -419,36 +419,36 @@ class Baza::Model
           raise "Invalid key: '#{key}' for '#{self.name}'. Valid keys are: '#{@columns_sqlhelper_args[:cols].keys.sort}'. Date-keys: '#{@columns_sqlhelper_args[:cols_date]}'."
       end
     end
-    
+
     #The count will bug if there is a group-by-statement.
     grp_shown = false
     if !count and !ret[:sql_groupby]
       sql << " GROUP BY #{@table_str}.#{@sep_col}id#{@sep_col}"
       grp_shown = true
     end
-    
+
     if ret[:sql_groupby]
       if !grp_shown
         sql << " GROUP BY"
       else
         sql << ", "
       end
-      
+
       sql << ret[:sql_groupby]
     end
-    
+
     sql << ret[:sql_order]
     sql << ret[:sql_limit]
-    
+
     return sql.to_s if args["return_sql"]
-    
+
     if select_col_as_array
       enum = Enumerator.new do |yielder|
         @db.q(sql, qargs) do |data|
           yielder << data[:id]
         end
       end
-      
+
       if block
         enum.each(&block)
         return nil
@@ -462,27 +462,27 @@ class Baza::Model
       return ret[:count].to_i if ret
       return 0
     end
-    
+
     return @ob.list_bysql(self.classname, sql, qargs, &block)
   end
-  
+
   #Helps call 'sqlhelper' on Baza::ModelHandler to generate SQL-strings.
   def self.list_helper(d)
     self.load_columns(d) if !@columns_sqlhelper_args
     @columns_sqlhelper_args[:table] = @table
     return @ob.sqlhelper(d.args, @columns_sqlhelper_args)
   end
-  
+
   #Returns the classname of the object without any subclasses.
   def self.classname
     return @classname
   end
-  
+
   #Sets the classname to something specific in order to hack the behaviour.
   def self.classname=(newclassname)
     @classname = newclassname
   end
-  
+
   #Returns the table-name that should be used for this datarow.
   #===Examples
   #  db.query("SELECT * FROM `#{Models::User.table}` WHERE username = 'John Doe'") do |data|
@@ -491,7 +491,7 @@ class Baza::Model
   def self.table
     return @table
   end
-  
+
   #This can be used to manually set the table-name. Useful when meta-programming classes that extends the datarow-class.
   #===Examples
   #  Models::User.table = "prefix_User"
@@ -499,7 +499,7 @@ class Baza::Model
     @table = newtable
     @columns_sqlhelper_args[:table] = @table if @columns_sqlhelper_args.is_a?(Hash)
   end
-  
+
   #Returns the class-name but without having to call the class-table-method. To make code look shorter.
   #===Examples
   #  user = ob.get_by(:User, {:username => 'John Doe'})
@@ -509,7 +509,7 @@ class Baza::Model
   def table
     return self.class.table
   end
-  
+
   #Initializes the object. This should be called from 'Baza::ModelHandler' and not manually.
   #===Examples
   #  user = ob.get(:User, 3)
@@ -519,7 +519,7 @@ class Baza::Model
       @id = @data[:id].to_i
     elsif data
       @id = data.to_i
-      
+
       classname = self.class.classname.to_sym
       if self.class.ob.ids_cache_should.key?(classname)
         #ID caching is enabled for this model - dont reload until first use.
@@ -536,13 +536,13 @@ class Baza::Model
     else
       raise ArgumentError, "Could not figure out the data from '#{data.class.name}'."
     end
-    
+
     if @id.to_i <= 0
       raise "Invalid ID: '#{@id}' from '#{@data}'." if @data
       raise "Invalid ID: '#{@id}'."
     end
   end
-  
+
   #Reloads the data from the database.
   #===Examples
   #  old_username = user[:username]
@@ -553,7 +553,7 @@ class Baza::Model
     raise Errno::ENOENT, "Could not find any data for the object with ID: '#{@id}' in the table '#{self.class.table}'." if !@data
     @should_reload = false
   end
-  
+
   #Tells the object that it should reloads its data because it has changed. It wont reload before it is required though, which may save you a couple of SQL-calls.
   #===Examples
   #  obj = _ob.get(:User, 5)
@@ -562,13 +562,13 @@ class Baza::Model
     @should_reload = true
     @data = nil
   end
-  
+
   #Returns the data-hash that contains all the data from the database.
   def data
     self.reload if @should_reload
     return @data
   end
-  
+
   #Writes/updates new data for the object.
   #===Examples
   #  user.update(:username => 'New username', :date_changed => Time.now)
@@ -577,14 +577,14 @@ class Baza::Model
     self.should_reload
     self.class.ob.call("object" => self, "signal" => "update")
   end
-  
+
   #Forcefully destroys the object. This is done after deleting it and should not be called manually.
   def destroy
     @id = nil
     @data = nil
     @should_reload = nil
   end
-  
+
   #Returns true if that key exists on the object.
   #===Examples
   #  print "Looks like the user has a name." if user.key?(:name)
@@ -593,7 +593,7 @@ class Baza::Model
     return @data.key?(key.to_sym)
   end
   alias has_key? key?
-  
+
   #Returns true if the object has been deleted.
   #===Examples
   #  print "That user is deleted." if user.deleted?
@@ -601,14 +601,14 @@ class Baza::Model
     return true if !@data and !@id
     return false
   end
-  
+
   #Returns true if the given object no longer exists in the database. Also destroys the data on the object and sets it to deleted-status, if it no longer exists.
   #===Examples
   # print "That user is deleted." if user.deleted_from_db?
   def deleted_from_db?
     #Try to avoid db-query if object is already deleted.
     return true if self.deleted?
-    
+
     #Try to reload data. Destroy object and return true if the row is gone from the database.
     begin
       self.reload
@@ -618,7 +618,7 @@ class Baza::Model
       return true
     end
   end
-  
+
   #Returns a specific data from the object by key.
   #  print "Username: #{user[:username]}\n"
   #  print "ID: #{user[:id]}\n"
@@ -631,7 +631,7 @@ class Baza::Model
     return @data[key] if @data.key?(key)
     raise "No such key: '#{key}' on '#{self.class.name}' (#{@data.keys.join(", ")}) (#{@should_reload})."
   end
-  
+
   #Writes/updates a keys value on the object.
   #  user = ob.get_by(:User, {"username" => "John Doe"})
   #  user[:username] = 'New username'
@@ -639,47 +639,47 @@ class Baza::Model
     self.update(key.to_sym => value)
     self.should_reload
   end
-  
+
   #Returns the objects ID.
   def id
     raise Errno::ENOENT, "This object has been deleted." if self.deleted?
     raise "No ID on object." if !@id
     return @id
   end
-  
+
   #This enable Wref to not return the wrong object.
   def __object_unique_id__
     return 0 if self.deleted?
     return self.id
   end
-  
+
   #Tries to figure out, and returns, the possible name or title for the object.
   def name
     self.reload if @should_reload
-    
+
     if @data.key?(:title)
       return @data[:title]
     elsif @data.key?(:name)
       return @data[:name]
     end
-    
+
     obj_methods = self.class.instance_methods(false)
     [:name, :title].each do |method_name|
       return self.method(method_name).call if obj_methods.index(method_name)
     end
-    
+
     raise "Couldnt figure out the title/name of the object on class #{self.class.name}."
   end
-  
+
   #Calls the name-method and returns a HTML-escaped value. Also "[no name]" if the name is empty.
   def name_html
-    name_str = self.name.to_s
-    name_str = "[no name]" if name_str.length <= 0
+    name_str = name.to_s
+    name_str = "[no name]" if name_str.empty?
     return name_str
   end
-  
+
   alias title name
-  
+
   #Loops through the data on the object.
   #===Examples
   #  user = ob.get(:User, 1)
@@ -690,25 +690,25 @@ class Baza::Model
     self.reload if @should_reload
     return @data.each(*args, &block)
   end
-  
+
   #Hash-compatible.
   def to_hash
     self.reload if @should_reload
     return @data.clone
   end
-  
+
   #Returns a default-URL to show the object.
   def url
     cname = self.class.classname.to_s.downcase
     return "?show=#{cname}_show&#{cname}_id=#{self.id}"
   end
-  
+
   #Returns the URL for editting the object.
   def url_edit
     cname = self.class.classname.to_s.downcase
     return "?show=#{cname}_edit&#{cname}_id=#{self.id}"
   end
-  
+
   #Returns the HTML for making a link to the object.
   def html(args = nil)
     if args and args[:edit]
@@ -716,12 +716,12 @@ class Baza::Model
     else
       url = self.url
     end
-    
+
     return "<a href=\"#{Knj::Web.ahref_parse(url)}\">#{self.name_html}</a>"
   end
-  
+
   private
-  
+
   #Various methods to define methods based on the columns for the datarow.
   def self.define_translation_methods(args)
     define_method("#{args[:val_dc]}=") do |newtransval|
@@ -735,7 +735,7 @@ class Baza::Model
         })
       end
     end
-    
+
     define_method("#{args[:val_dc]}") do
       begin
         return _hb.trans(self, args[:val])
@@ -743,22 +743,22 @@ class Baza::Model
         return _kas.trans(self, args[:val])
       end
     end
-    
+
     define_method("#{args[:val_dc]}_html") do
       begin
         str = _hb.trans(self, args[:val])
       rescue NameError
         str = _kas.trans(self, args[:val])
       end
-      
-      if str.to_s.strip.length <= 0
+
+      if str.to_s.strip.empty?
         return "[no translation for #{args[:val]}]"
       end
-      
+
       return str
     end
   end
-  
+
   #Defines the boolean-methods based on enum-columns.
   def self.define_bool_methods(inst_methods, col_name)
     #Spawns a method on the class which returns true if the data is 1.
@@ -769,7 +769,7 @@ class Baza::Model
       end
     end
   end
-  
+
   #Defines date- and time-columns based on datetime- and date-columns.
   def self.define_date_methods(inst_methods, col_name)
     if !inst_methods.include?("#{col_name}_str".to_sym)
@@ -777,11 +777,11 @@ class Baza::Model
         if Datet.is_nullstamp?(self[col_name])
           return self.class.ob.events.call(:no_date, self.class.name)
         end
-        
+
         return Datet.in(self[col_name]).out(*method_args)
       end
     end
-    
+
     if !inst_methods.include?(col_name)
       define_method(col_name) do |*method_args|
         return false if Datet.is_nullstamp?(self[col_name])
@@ -789,7 +789,7 @@ class Baza::Model
       end
     end
   end
-  
+
   #Define various methods based on integer-columns.
   def self.define_numeric_methods(inst_methods, col_name)
     if !inst_methods.include?("#{col_name}_format".to_sym)
@@ -798,7 +798,7 @@ class Baza::Model
       end
     end
   end
-  
+
   #Define methods to look up objects directly.
   #===Examples
   #  user = Models::User.by_username('John Doe')
@@ -810,7 +810,7 @@ class Baza::Model
       end
     end
   end
-  
+
   #Defines dbtime-methods based on time-columns.
   def self.define_time_methods(inst_methods, col_name)
     if !inst_methods.include?("#{col_name}_dbt".to_sym)
@@ -819,52 +819,52 @@ class Baza::Model
       end
     end
   end
-  
+
   #Memory friendly helper method that defines methods for 'has_many'.
   def self.define_many_methods(classname, methodname, colname, where_args)
     define_method(methodname) do |*args, &block|
       if args and args[0]
-        list_args = args[0] 
+        list_args = args[0]
       else
         list_args = {}
       end
-      
+
       list_args.merge!(where_args) if where_args
       list_args[colname.to_s] = self.id
-      
+
       return self.class.ob.list(classname, list_args, &block)
     end
-    
+
     define_method("#{methodname}_count".to_sym) do |*args|
       list_args = args[0] if args and args[0]
       list_args = {} if !list_args
       list_args[colname.to_s] = self.id
       list_args["count"] = true
-      
+
       return self.class.ob.list(classname, list_args)
     end
-    
+
     define_method("#{methodname}_last".to_sym) do |args|
       args = {} if !args
       return self.class.ob.list(classname, {"orderby" => [["id", "desc"]], "limit" => 1}.merge(args))
     end
   end
-  
+
   #Memory friendly helper method that defines methods for 'has_one'.
   def self.define_one_methods(classname, methodname, colname)
     define_method(methodname) do
       return self.class.ob.get_try(self, colname, classname)
     end
-    
+
     methodname_html = "#{methodname}_html".to_sym
     define_method(methodname_html) do |*args|
       obj = self.__send__(methodname)
       return self.class.ob.events.call(:no_html, classname) if !obj
-      
+
       raise "Class '#{classname}' does not have a 'html'-method." if !obj.respond_to?(:html)
       return obj.html(*args)
     end
-    
+
     methodname_name = "#{methodname}_name".to_sym
     define_method(methodname_name) do |*args|
       obj = self.__send__(methodname)
@@ -872,14 +872,14 @@ class Baza::Model
       return obj.name(*args)
     end
   end
-  
+
   #Returns a hash reflection the current ActiveRecord model and its current values (not like .attributes which reflects the old values).
   def self.activerecord_to_hash(model)
     attrs = {}
     model.attribute_names.each do |name|
       attrs[name] = model.__send__(name)
     end
-    
+
     return attrs
   end
 end