biblio-refs 0.1.1

data/lib/biblio_refs.rb

@@ -0,0 +1,9 @@
+require "biblio_refs/version"
+require "biblio_refs/referencia"
+require "biblio_refs/list"
+require "biblio_refs/publicaciones_periodicas"
+require "biblio_refs/articulo_revista"
+require "biblio_refs/articulo_periodico"
+require "biblio_refs/documento_electronico"
+require "biblio_refs/lista_apa"
+require "biblio_refs/libro"

data/lib/biblio_refs/articulo_periodico.rb

@@ -0,0 +1,32 @@
+module BiblioRefs
+  #Clase para representar referencias bibliográficas de un artículo de periódico.
+  #Hereda de PublicacionesPeriodicas.
+  class ArticuloPeriodico < PublicacionesPeriodicas
+
+    attr_accessor :nombre_periodico, :num_paginas
+
+    #Constructor de la clase ArticuloPeriodico.
+    def initialize(autores, fecha_publicacion, titulo, nombre_periodico, num_paginas)
+      @autores = autores
+      @fecha_publicacion = fecha_publicacion
+      @titulo = titulo
+      @nombre_periodico = nombre_periodico
+      @num_paginas = num_paginas
+    end
+
+    #Método para asignar valores a los atributos nombre_periodico y
+    #num_paginas cuando se crean los objetos mediante el DSL.
+    def periodico(periodico = {})
+      @nombre_periodico = periodico[:nombre_periodico]
+      @num_paginas = periodico[:num_paginas]
+    end
+
+    #Método to_s de la clase que agrupa el resto de métodos 'to_s' declarados.
+    def to_s
+      final = autores_to_s + " (" + fecha_publicacion_to_s + "). "
+      final += "\n\t" + titulo_to_s + ". " + nombre_periodico.to_s + ", pp. "
+      final += num_paginas.to_s + "."
+    end
+
+  end
+end

data/lib/biblio_refs/articulo_revista.rb

@@ -0,0 +1,60 @@
+module BiblioRefs
+  #Clase para representar referencias bibliográficas de un artículo.
+  #Hereda de PublicacionesPeriodicas.
+  class ArticuloRevista < PublicacionesPeriodicas
+
+    attr_accessor :titulo_obra, :paginas, :volumen, :eds
+
+    #Constructor de la clase ArticuloRevista
+    def initialize(autores, titulo, titulo_obra, editorial, num_edicion, fecha_publicacion, volumen, paginas, eds)
+      @autores = autores
+      @titulo = titulo
+      @titulo_obra = titulo_obra
+      @editorial = editorial
+      @num_edicion = num_edicion
+      @fecha_publicacion = fecha_publicacion
+      @volumen = volumen
+      @paginas = paginas
+      @eds = eds
+    end
+
+    #Método para asignar valores a los atributos titulo_obra, paginas, volumen y
+    #eds cuando se crean los objetos mediante el DSL.
+    def articulo(articulo = {})
+      @titulo_obra = articulo[:titulo_obra]
+      @paginas = articulo[:paginas]
+      @volumen = articulo[:volumen]
+      @eds = articulo[:eds]
+    end
+
+    #Método para devolver un String con la fecha_publicacion correctamente formateada
+    def fecha_publicacion_to_s
+      "(" + fecha_publicacion.year.to_s + "). "
+    end
+
+    #Método para devolver un String con los editores correctamente formateados
+    def eds_to_s
+      final = ""
+      if eds.kind_of?(Array)
+        eds.each do |ed|
+          final += ed
+          final += " & "
+        end
+        final[-1] = ""
+      else
+        final += eds
+        final += "  "
+      end
+      final.chop
+    end
+
+    #Método to_s de la clase que agrupa el resto de métodos 'to_s' declarados.
+    def to_s
+      final = autores_to_s + " " + fecha_publicacion_to_s
+      final += "\n\t" + titulo_to_s + ". En " + eds_to_s + "(Eds.), "
+      final += titulo_obra.to_s + " (" + paginas.to_s + ") " + "(" + num_edicion_to_s + ") "
+      final += "(" + volumen.to_s + "). Lugar de publicación: " + editorial_to_s
+    end
+
+  end
+end

data/lib/biblio_refs/documento_electronico.rb

@@ -0,0 +1,42 @@
+module BiblioRefs
+  #Clase para representar referencias bibliográficas de un documento electrónico.
+  #Hereda de PublicacionesPeriodicas.
+  class DocumentoElectronico < PublicacionesPeriodicas
+
+    attr_accessor :tipo_medio, :via, :fecha_acceso
+
+    #Constructor de la clase.
+    def initialize(autores, fecha_publicacion, titulo, num_edicion, tipo_medio, editorial, via, fecha_acceso)
+      @autores = autores
+      @fecha_publicacion = fecha_publicacion
+      @titulo = titulo
+      @num_edicion = num_edicion
+      @tipo_medio = tipo_medio
+      @editorial = editorial
+      @via = via
+      @fecha_acceso = fecha_acceso
+    end
+
+    #Método para asignar valores a los atributos tipo_medio, via y
+    #fecha_acceso cuando se crean los objetos mediante el DSL.
+    def documento(documento = {})
+      @tipo_medio = documento[:tipo_medio]
+      @via = documento[:via]
+      @fecha_acceso = Date.parse(documento[:fecha_acceso])
+    end
+
+    #Método para devolver un String con la fecha_acceso correctamente formateada
+    def fecha_acceso_to_s
+      Date::MONTHNAMES[fecha_publicacion.mon] + " " + fecha_publicacion.day.to_s + ", " + fecha_publicacion.year.to_s
+    end
+
+    #Método to_s de la clase que agrupa el resto de métodos 'to_s' declarados.
+    def to_s
+      final = autores_to_s + " (" + fecha_publicacion_to_s + "). "
+      final += "\n\t" + titulo_to_s + " (" + num_edicion_to_s + "), " + "[" + tipo_medio + "]. "
+      final += "Lugar de publicación: " + editorial_to_s + ". Disponible en: " + via.to_s
+      final += " [" + fecha_acceso_to_s + "]"
+    end
+
+  end
+end

data/lib/biblio_refs/libro.rb

@@ -0,0 +1,37 @@
+module BiblioRefs
+  #Clase para representar referencias bibliográficas de libros.
+  #Hereda de Referencia.
+  class Libro < Referencia
+
+    attr_accessor :volumen
+
+    #Constructor de la clase Libro
+    def initialize(autores, titulo, editorial, num_edicion, fecha_publicacion, volumen)
+      @autores = autores
+      @titulo = titulo
+      @editorial = editorial
+      @num_edicion = num_edicion
+      @fecha_publicacion = fecha_publicacion
+      @volumen = volumen
+    end
+
+    #Método para asignar valores al atributo volumen cuando se crean
+    #los objetos mediante el DSL.
+    def libro(libro = {})
+      @volumen = libro
+    end
+
+    #Método para devolver un String con la fecha_publicacion correctamente formateada
+    def fecha_publicacion_to_s
+      "(" + fecha_publicacion.year.to_s + "). "
+    end
+
+    #Método to_s de la clase que agrupa el resto de métodos 'to_s' declarados.
+    def to_s
+      final = autores_to_s + " " + fecha_publicacion_to_s
+      final += "\n\tTítulo del libro: " + titulo_to_s + " (" + num_edicion_to_s + ") "
+      final += "(" + volumen.to_s + "). " + "Lugar de publicación: " + editorial_to_s + "."
+    end
+
+  end
+end

data/lib/biblio_refs/list.rb

@@ -0,0 +1,61 @@
+#Se crea un Struct para representar un Nodo con :value y :next
+Nodo = Struct.new(:value, :next, :prev)
+
+module BiblioRefs
+	#Clase para representar una lista doblemente enlazada.
+	class List
+		include Enumerable
+
+    attr_accessor :head, :tail
+
+		#Constructor de la clase.
+		#Recibe un número indefinido de nodos y los añade a la lista.
+		def initialize(*nodo)
+      @tail = @head = Nodo.new(nodo[0], nil)
+      if nodo.size > 1
+        nodo.shift
+        push(*nodo)
+      end
+		end
+
+		#Método para hacer la clase Enumerable.
+		#Hace 'yield' a todos los elementos de la lista.
+		def each
+    	aux=@head
+    	while aux[:next]
+    		yield aux[:value]
+    		aux=aux[:next]
+    	end
+    	yield aux[:value]
+		end
+
+		#Método que elimina el elemento a la cabeza de la lista y lo devuelve.
+    def pop
+      nodo = @head
+      @head = @head[:next]
+      nodo[:value]
+    end
+
+		#Método que añade uno o más nodos a la lista.
+    def push(*nodo)
+      aux = @head
+      nodo.each do |n|
+        while aux[:next] do
+          aux = aux[:next]
+        end
+        @tail = aux[:next] = Nodo.new(n, nil, aux)
+      end
+    end
+
+		#Método que muestra todos los elementos de la lista correctamente formateados.
+    def to_s
+      aux = @head
+      string = "Lista: "
+      while aux[:next] do
+        string += "#{aux[:value]}" + " -> "
+        aux = aux[:next]
+      end
+      string += "#{aux[:value]}"
+    end
+	end
+end

data/lib/biblio_refs/lista_apa.rb

@@ -0,0 +1,41 @@
+module BiblioRefs
+  #Clase para representar una lista de referencias en el formato APA.
+  class ListaAPA
+    attr_accessor :lista
+
+    #Constructor de la clase.
+    def initialize(lista)
+      @lista = lista
+      ordenar
+    end
+
+    #Método que ordena las referencias de la clase según el criterio del
+    #método '<=>' de la clase madre de la jerarquía.
+    def ordenar
+      array = @lista.sort
+      lista_aux = BiblioRefs::List.new(array[0])
+      array.shift
+      array.each do |ref|
+        lista_aux.push(ref)
+      end
+      @lista = lista_aux
+    end
+
+    #Método que devuelve un String con las referencias de la lista correctamente
+    #formateadas.
+    def to_s
+      class << @lista #Se accede a la eigenclass de @lista para redefinir el método to_s
+        def to_s
+          aux = @head
+          string = ""
+          while aux[:next] do
+            string += "#{aux[:value]}" + "\n\n"
+            aux = aux[:next]
+          end
+          string += "#{aux[:value]}"
+        end
+      end
+      @lista.to_s
+    end
+  end
+end

data/lib/biblio_refs/publicaciones_periodicas.rb

@@ -0,0 +1,10 @@
+module BiblioRefs
+  #Clase para representar PublicacionesPeriodicas.
+  #De ella heredan las clases que representan Publicaciones Periodicas.
+  class PublicacionesPeriodicas < Referencia
+
+    def initialize
+    end
+
+  end
+end

data/lib/biblio_refs/referencia.rb

@@ -0,0 +1,204 @@
+require 'date'
+
+module BiblioRefs
+  #Clase que representa una referencia bibliográfica estándar y de la que
+  #heredan el resto de clases
+  class Referencia
+    include Comparable
+    attr_accessor :autores, :titulo, :serie, :editorial, :num_edicion, :fecha_publicacion, :isbn
+
+    #Método que crea un objeto de la clase hija que lo llame
+    #Se utiliza para crear un objeto y llamar a los métodos
+    #que asignarán valores a sus atributos.
+    def self.crear(&block)
+      if self == BiblioRefs::Libro
+        nuevo = self.new(nil, nil, nil, nil, nil, nil)
+      elsif self == BiblioRefs::ArticuloRevista
+        nuevo = self.new(nil, nil, nil, nil, nil, nil, nil, nil, nil)
+      elsif self == BiblioRefs::ArticuloPeriodico
+        nuevo = self.new(nil, nil, nil, nil, nil)
+      elsif self == BiblioRefs::DocumentoElectronico
+        nuevo = self.new(nil, nil, nil, nil, nil, nil, nil, nil)
+      else
+        puts "No funciona NADA."
+      end
+      nuevo.instance_eval &block
+      nuevo
+    end
+
+    #Constructor de la clase madre
+    def initialize(autores, titulo, serie = nil, editorial, num_edicion, fecha_publicacion, isbn)
+      @autores = autores
+      @titulo = titulo
+      @serie = serie
+      @editorial = editorial
+      @num_edicion = num_edicion
+      @fecha_publicacion = fecha_publicacion
+      @isbn = isbn
+    end
+
+    #Método para asignar valores al atributo autores cuando se crean los
+    #objetos mediante el DSL.
+    def autor(autor = {})
+      if @autores == nil
+        @autores = "#{autor[:apellido]}, #{autor[:nombre]}"
+      elsif @autores.kind_of?Array
+        @autores << "#{autor[:apellido]}, #{autor[:nombre]}"
+      else
+        autores_array = [@autores]
+        autores_array << "#{autor[:apellido]}, #{autor[:nombre]}"
+        @autores = autores_array
+      end
+    end
+
+    #Método para asignar valores al atributo titulo cuando se crean
+    #los objetos mediante el DSL.
+    def title(titulo = {})
+      @titulo = titulo
+    end
+
+    #Método para asignar valores a los atributos editorial, num_edicion y
+    #fecha_publicacion cuando se crean los objetos mediante el DSL.
+    def info(info = {})
+      @editorial = info[:editorial]
+      @num_edicion = info[:num_edicion]
+      @fecha_publicacion = Date.parse(info[:fecha_publicacion])
+    end
+
+    #Método para devolver un String con los autores correctamente formateados.
+    def autores_to_s
+      final = ""
+      if autores.kind_of?(Array)
+        autores.each do |autor|
+          final += autor
+          final += " & "
+        end
+        final[-2..-1] = ""
+      else
+        final += autores
+        final += " "
+      end
+      final.chop
+    end
+
+    #Método para devolver un String con el título correctamente formateado
+    def titulo_to_s
+      titulo.to_s
+    end
+
+    #Método para devolver un String con la serie correctamente formateada
+    def serie_to_s
+      if serie != nil
+        "(" + serie.to_s + ")"
+      end
+    end
+
+    #Método para devolver un String con la editorial correctamente formateado
+    def editorial_to_s
+      editorial.to_s
+    end
+
+    #Método para devolver un String con el num_edicion correctamente formateado
+    def num_edicion_to_s
+      num_edicion.to_s + " edition"
+    end
+
+    #Método para devolver un String con la fecha_publicacion correctamente formateada
+    def fecha_publicacion_to_s
+      Date::MONTHNAMES[fecha_publicacion.mon] + " " + fecha_publicacion.day.to_s + ", " + fecha_publicacion.year.to_s
+    end
+
+    #Método para devolver un String con el ISBN correctamente formateado
+    def isbn_to_s
+      final = ""
+      if isbn.kind_of?(Array)
+        isbn.each do |num|
+          if num.length > 12
+            final += "ISBN-13: " + num + "\n"
+          else
+            final += "ISBN-10: " + num + "\n"
+          end
+        end
+        final.chop
+      else
+        if isbn.length > 12
+          final += "ISBN-13: " + isbn
+        else
+          final += "ISBN-10: " + isbn
+        end
+      end
+    end
+
+    #Método to_s de la clase que agrupa el resto de métodos 'to_s' declarados.
+    def to_s
+      final = autores_to_s + ".\n" + titulo_to_s + "\n"
+      if serie != nil
+        final += serie_to_s + "\n"
+      end
+      final += editorial_to_s + "; " + num_edicion_to_s + " (" + fecha_publicacion_to_s + ")\n" + isbn_to_s
+    end
+
+    #Método para definir cómo se comparan los objetos de la jerarquía de clases.
+    def <=>(ref)
+      if ref.is_a?BiblioRefs::Referencia
+        if(@autores.kind_of?(Array) && ref.autores.kind_of?(Array))
+          if((@autores[0] <=> ref.autores[0]) == 0)
+            if((@fecha_publicacion <=> ref.fecha_publicacion) == 0)
+              @titulo <=> ref.titulo
+            else
+              @fecha_publicacion <=> ref.fecha_publicacion
+            end
+          else
+            @autores[0] <=> ref.autores[0]
+          end
+        else
+          if(@autores.kind_of?(Array) && !ref.autores.kind_of?(Array))
+            if((@autores[0] <=> ref.autores) == 0)
+              if((@fecha_publicacion <=> ref.fecha_publicacion) == 0)
+                @titulo <=> ref.titulo
+              else
+                @fecha_publicacion <=> ref.fecha_publicacion
+              end
+            else
+              @autores[0] <=> ref.autores
+            end
+          else
+            if(!@autores.kind_of?(Array) && ref.autores.kind_of?(Array))
+              if((@autores <=> ref.autores[0]) == 0)
+                if((@fecha_publicacion <=> ref.fecha_publicacion) == 0)
+                  @titulo <=> ref.titulo
+                else
+                  @fecha_publicacion <=> ref.fecha_publicacion
+                end
+              else
+                @autores <=> ref.autores[0]
+              end
+            else
+              if((@autores <=> ref.autores) == 0)
+                if((@fecha_publicacion <=> ref.fecha_publicacion) == 0)
+                  @titulo <=> ref.titulo
+                else
+                  @fecha_publicacion <=> ref.fecha_publicacion
+                end
+              else
+                @autores <=> ref.autores
+              end
+            end
+          end
+        end
+      else
+        nil
+      end
+    end
+
+    #Método para comprobar si dos objetos de la jerarquía son iguales.
+    def ==(ref)
+      if ref.is_a?Referencia
+        self.to_s == ref.to_s
+      else
+        false
+      end
+    end
+
+  end
+end