Class: TagList

Inherits:
Array
  • Object
show all
Defined in:
lib/is_taggable/tag_list.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(*args) ⇒ TagList

Returns a new instance of TagList.



5
6
7
 
# File 'lib/is_taggable/tag_list.rb', line 5

def initialize(*args)
  add(*args)
end

Instance Attribute Details

#owner ⇒ Object

Returns the value of attribute owner.



9
10
11
 
# File 'lib/is_taggable/tag_list.rb', line 9

def owner
  @owner
end

Class Method Details

.from(string) ⇒ Object

Returns a new TagList using the given tag string.

tag_list = TagList.from("One , Two,  Three")
tag_list # ["One", "Two", "Three"]



79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/is_taggable/tag_list.rb', line 79

def from(string)
  returning new do |tag_list|
    string = string.to_s.dup

    # Parse the quoted tags
    string.gsub!(/"(.*?)"\s*#{delimiter}?\s*/) { tag_list << $1; "" }
    string.gsub!(/'(.*?)'\s*#{delimiter}?\s*/) { tag_list << $1; "" }

    tag_list.add(string.split(delimiter))
  end
end

.from_owner(owner, *tags) ⇒ Object 



91
92
93
94
95
 
# File 'lib/is_taggable/tag_list.rb', line 91

def from_owner(owner, *tags)
  returning from(*tags) do |taglist|
    taglist.owner = owner
  end
end

.new_from_owner(owner, *tags) ⇒ Object 



97
98
99
100
101
 
# File 'lib/is_taggable/tag_list.rb', line 97

def new_from_owner(owner, *tags)
  returning new(*tags) do |taglist|
    taglist.owner = owner
  end
end

.normalize(tag) ⇒ Object 



103
104
105
 
# File 'lib/is_taggable/tag_list.rb', line 103

def normalize(tag)
  tag.gsub(/\s+/, ' ').to_ascii.downcase.gsub(/[^a-z0-9\-\s]/, '')
end

Instance Method Details

#add(*names) ⇒ Object

Add tags to the tag_list. Duplicate or blank tags will be ignored.

tag_list.add("Fun", "Happy")

Use the :parse option to add an unparsed tag string.

tag_list.add("Fun, Happy", :parse => true)



18
19
20
21
22
23
 
# File 'lib/is_taggable/tag_list.rb', line 18

def add(*names)
  extract_and_apply_options!(names)
  concat(names)
  clean!
  self
end

#normalized ⇒ Object 



51
52
53
 
# File 'lib/is_taggable/tag_list.rb', line 51

def normalized
  TagList.new(collect{ |tag| self.class.normalize(tag) })
end

#remove(*names) ⇒ Object

Remove specific tags from the tag_list.

tag_list.remove("Sad", "Lonely")

Like #add, the :parse option can be used to remove multiple tags in a string.

tag_list.remove("Sad, Lonely", :parse => true)



32
33
34
35
36
 
# File 'lib/is_taggable/tag_list.rb', line 32

def remove(*names)
  extract_and_apply_options!(names)
  delete_if { |name| names.include?(name) }
  self
end

#to_s ⇒ Object

Transform the tag_list into a tag string suitable for edting in a form. The tags are joined with TagList.delimiter and quoted if necessary.

tag_list = TagList.new("Round", "Square,Cube")
tag_list.to_s # 'Round, "Square,Cube"'



43
44
45
46
47
48
49
 
# File 'lib/is_taggable/tag_list.rb', line 43

def to_s
  clean!

  map do |name|
    name.include?(delimiter) ? "\"#{name}\"" : name
  end.join(delimiter.ends_with?(" ") ? delimiter : "#{delimiter} ")
end