dLinkedList 0.1.0

data/lib/dLinkedList.rb

@@ -0,0 +1,6 @@
+require "dLinkedList/version"
+require "dLinkedList/dLinkedList"
+
+module DLinkedList
+  # Your code goes here...
+end

data/lib/dLinkedList/dLinkedList.rb

@@ -0,0 +1,313 @@
+# encoding: utf-8
+
+# Lista de referencias bibliográficas.
+module DLinkedList
+    
+    # Referencia bibliográfica básica.
+	class Referencia
+	
+		# Para manipulación de fechas
+		require "date"		
+		
+		# Incluye Comparable
+		include Comparable
+		
+		# Array de autores.
+		attr_reader :autores
+		# Título de la obra.
+		attr_reader :titulo
+		# Fecha de publicación.
+		attr_reader :fecha_publicacion
+		
+		# Inicializa la referencia usando el DSL especificado en el bloque _block_.
+		def initialize(&block)
+			instance_eval &block
+			raise ArgumentError, "Debe haber al menos un autor" unless @autores.length > 0
+		end
+		
+		# Añade un autor a la lista de autores.
+		def autor(autorhash)
+			@autores = [] if @autores.nil?
+			@autores.push(autorhash)
+		end
+		
+		# Establece el título.
+		def tit(titulo)
+			@titulo = titulo
+		end
+		
+		# Establece la fecha de publicación.
+		def fecha(fecha_publicacion)
+			@fecha_publicacion = Date.strptime(fecha_publicacion, '%d/%m/%Y')
+		end
+		
+		# Devuelve una cadena con el contenido de la referencia en formato APA.
+		#
+		# Formato: Apellidos_Autor, Nombre_Autor [& Apellidos_Autor, Nombre_Autor...] (Fecha de publicación). Título.
+		def to_s			
+			s = ''
+			s << autores_to_s
+			s << "(#{@fecha_publicacion.strftime('%-d/%-m/%Y')}). #{@titulo}."
+			return s
+		end		
+		
+		# Comparación de referencias según los criterios del formato APA.
+		def <=>(c_ref)			
+			ref_ord = @autores[0][:apellidos] <=> c_ref.autores[0][:apellidos]
+			if ref_ord == 0 # Primer autor con el mismo apellido				
+				ref_ord = @autores[0][:nombre] <=> c_ref.autores[0][:nombre]
+				if ref_ord == 0 # Mismo primer autor
+					ref_ord = autores_to_s <=> c_ref.autores_to_s
+					if ref_ord == 0 # Mismos autores
+						ref_ord = @fecha_publicacion.year <=> c_ref.fecha_publicacion.year
+						if ref_ord == 0 # Mismos autores y año de publicación
+							ref_ord = @titulo <=> c_ref.titulo
+						end
+					end
+				end				
+			end
+			
+			return ref_ord
+		end
+		
+		# Devuelve la lista de autores como cadena.
+		def autores_to_s
+			s = ''
+			@autores.each() { |a| s << a[:apellidos].capitalize << ', ' << a[:nombre][0].capitalize << ". & "}
+			return s.chomp("& ")
+		end
+		
+		protected :autor, :tit, :fecha, :autores_to_s
+		
+	end
+	
+	# Referencia de un libro.
+	class Libro < Referencia
+	
+		# Nº de edición.
+		attr_reader :edicion
+		# Lugar de publicación.
+		attr_reader :lugar_publicacion
+		# Editorial.
+		attr_reader :editorial
+		
+		# Inicializa la referencia al libro usando el DSL especificado en el bloque _block_.
+		def initialize(&block)
+			instance_eval &block
+			raise ArgumentError, "Debe haber al menos un autor" unless @autores.length > 0
+		end
+		
+		# Establece el nº de edición.
+		def ed(edicion)
+			@edicion = edicion
+		end
+		
+		# Establece el lugar de publicación.
+		def lugar(lugar_publicacion)
+			@lugar_publicacion = lugar_publicacion
+		end
+		
+		# Establece la editorial.
+		def editor(editorial)
+			@editorial = editorial
+		end		
+
+		# Devuelve una cadena con el contenido de la referencia al libro en formato APA.
+		#
+		# Formato: Apellidos_Autor, Nombre_Autor [& Apellidos_Autor, Nombre_Autor...] (Fecha de publicación). Título. (edicion) Lugar de publicación: Editorial.
+		def to_s			
+			return super << " (#{@edicion}ª edición) #{@lugar_publicacion}: #{@editorial}."
+		end
+		
+		protected :ed, :lugar, :editor
+	
+	end
+	
+	# Referencia de un artículo.
+	class Articulo < Referencia
+	
+		# Título de la publicación.
+		attr_reader :titulo_publicacion
+		# Nº de las páginas donde está ubicado el artículo.
+		attr_reader :paginas
+				
+		# Inicializa la referencia al artículo usando el DSL especificado en el bloque _block_.
+		def initialize(&block)
+			instance_eval &block
+			raise ArgumentError, "Debe haber al menos un autor" unless @autores.length > 0
+		end
+		
+		# Establece el título de la publicación.
+		def tit_publi(titulo_publicacion)
+			@titulo_publicacion = titulo_publicacion
+		end
+		
+		# Establece los nº de las páginas donde está ubicado el artículo.
+		def pags(paginas)
+			@paginas = paginas
+		end		
+
+		# Devuelve una cadena con el contenido de la referencia al artículo en formato APA.
+		#
+		# Formato: Apellidos_Autor, Nombre_Autor [& Apellidos_Autor, Nombre_Autor...] (Fecha de publicación). Título. Título publicación, páginas.
+		def to_s			
+			return super << " #{@titulo_publicacion}, p. #{@paginas}."
+		end
+		
+		protected :tit_publi, :pags
+	
+	end
+	
+	# Referencia de un documento electrónico.
+	class EDocumento < Referencia
+	
+		# Fecha de recuperación del documento.
+		attr_reader :fecha_recuperacion
+		# URL de descarga del documento.
+		attr_reader :dURL
+		
+		# Inicializa la referencia al documento electrónico usando el DSL especificado en el bloque _block_.
+		def initialize(&block)
+			instance_eval &block
+			raise ArgumentError, "Debe haber al menos un autor" unless @autores.length > 0
+		end
+		
+		# Establece la fecha de recuperación del documento.
+		def fecha_recup(fecha_recuperacion)
+			@fecha_recuperacion = Date.strptime(fecha_recuperacion, '%d/%m/%Y')
+		end
+		
+		# Establece la URL de descarga del documento.
+		def URL_descarga(dURL)
+			@dURL = dURL
+		end
+		
+		# Devuelve una cadena con el contenido de la referencia al documento electrónico en formato APA.
+		#
+		# Formato: Apellidos_Autor, Nombre_Autor [& Apellidos_Autor, Nombre_Autor...] (Fecha de publicación). Título. Fecha de recuperación, URL.
+		def to_s			
+			return super << " Recuperado el #{@fecha_recuperacion.strftime('%-d/%-m/%Y')}, de #{@dURL}."
+		end
+		
+		protected :fecha_recup, :URL_descarga
+	
+	end
+	
+	# Nodo que contiene una referencia bibliográfica de cualquier tipo.
+	class Node
+
+		# Valor del nodo (referencia bibliográfica).
+		attr_accessor :value
+		# Enlace al siguiente nodo de la lista de referencias bibliográficas.
+		attr_accessor :next_node
+		# Enlace al anterior nodo de la lista de referencias bibliográficas.
+		attr_accessor :prev_node
+  
+    	# Inicializa el nodo con el valor _value_. Si se especifican también inicializa los enlaces al siguiente y anterior nodo de la lista.
+    	def initialize(value, next_node = nil, prev_node = nil)
+	        @value = value
+	        @next_node = next_node
+	        @prev_node = prev_node
+    	end
+    
+	end
+	
+	# Lista de referencias bibliográficas.
+	class List
+		
+		# Incluye Enumerable
+		include Enumerable
+		
+		# Nodo cabeza de la lista.
+		attr_reader :head
+		# Nodo cola de la lista.
+		attr_reader :tail
+		# Tamaño de la lista.
+		attr_reader :size
+		
+		# Inicializa la lista vacía.
+		def initialize()
+			@head = nil
+			@tail = nil
+			@size = 0
+		end
+		
+		# Devuelve si la lista está vacía.
+		def empty?()
+			return (@head == nil)
+		end
+		
+		# Inserta una referencia en la lista vacía.
+		def push_empty(ref)
+			
+			raise RuntimeError, "[List.push_empty]: Lista no vacía" unless empty?()
+			
+			nodo = Node.new(ref)
+			@head = nodo
+			@tail = nodo
+			@size += 1
+			
+			return self
+			
+		end
+		
+		# Inserta la referencia _ref_ al final de la lista.
+		def push(ref)
+			if empty?()
+				return push_empty(ref)
+			else
+				nodo = Node.new(ref, nil, @tail)
+				@tail.next_node = nodo
+				@tail = nodo
+				@size += 1
+				return self
+			end
+		end
+		
+		# Inserta múltiples elementos al final de la lista.
+		def push_multi(*refs)
+			refs.each { |ref| push(ref)}
+		end
+		
+		# Extrae y devuelve la referencia del principio de la lista.
+		def pop()
+			
+			raise RuntimeError, "[List.pop]: No se puede extraer elementos de una lista vacía" if empty?()
+			
+			nodo = @head
+			if @head.equal?(@tail)
+				@head = nil
+				@tail = nil
+			else
+				@head = @head.next_node
+				@head.prev_node = nil
+			end
+			
+			@size -= 1
+			
+			return nodo.value
+			
+		end
+		
+		# Itera la lista, ejecutando el bloque pasado pasándole como parámetro el valor de cada nodo.
+		def each
+			
+			nodo = @head
+			until nodo.nil?
+				yield nodo.value
+				nodo = nodo.next_node
+			end
+			
+		end
+		
+		# Devuelve la lista de referencias ordenadas en líneas distintas como cadena.
+		def to_s
+			s_arr = self.sort()
+			return s_arr.join("\n")
+		end
+		
+		private :push_empty
+		
+	end
+    
+end

data/lib/dLinkedList/version.rb

@@ -0,0 +1,4 @@
+module DLinkedList
+  # Versión de la gema.
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,210 @@
+--- !ruby/object:Gem::Specification
+name: dLinkedList
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- alu0100221879
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-12-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Gema que guarda una lista de referencias bibliográficas (lista doblemente
+  enlazada).
+email:
+- alu0100221879@ull.edu.es
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- dLinkedList.gemspec
+- html/DLinkedList.html
+- html/DLinkedList/Articulo.html
+- html/DLinkedList/EDocumento.html
+- html/DLinkedList/Libro.html
+- html/DLinkedList/List.html
+- html/DLinkedList/Node.html
+- html/DLinkedList/Referencia.html
+- html/created.rid
+- html/css/fonts.css
+- html/css/rdoc.css
+- html/fonts/Lato-Light.ttf
+- html/fonts/Lato-LightItalic.ttf
+- html/fonts/Lato-Regular.ttf
+- html/fonts/Lato-RegularItalic.ttf
+- html/fonts/SourceCodePro-Bold.ttf
+- html/fonts/SourceCodePro-Regular.ttf
+- html/images/add.png
+- html/images/arrow_up.png
+- html/images/brick.png
+- html/images/brick_link.png
+- html/images/bug.png
+- html/images/bullet_black.png
+- html/images/bullet_toggle_minus.png
+- html/images/bullet_toggle_plus.png
+- html/images/date.png
+- html/images/delete.png
+- html/images/find.png
+- html/images/loadingAnimation.gif
+- html/images/macFFBgHack.png
+- html/images/package.png
+- html/images/page_green.png
+- html/images/page_white_text.png
+- html/images/page_white_width.png
+- html/images/plugin.png
+- html/images/ruby.png
+- html/images/tag_blue.png
+- html/images/tag_green.png
+- html/images/transparent.png
+- html/images/wrench.png
+- html/images/wrench_orange.png
+- html/images/zoom.png
+- html/index.html
+- html/js/darkfish.js
+- html/js/jquery.js
+- html/js/navigation.js
+- html/js/navigation.js.gz
+- html/js/search.js
+- html/js/search_index.js
+- html/js/search_index.js.gz
+- html/js/searcher.js
+- html/js/searcher.js.gz
+- html/table_of_contents.html
+- lib/dLinkedList.rb
+- lib/dLinkedList/dLinkedList.rb
+- lib/dLinkedList/version.rb
+homepage: https://github.com/alu0100221879/prct11
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Gema del módulo DLinkedList.
+test_files: []