Added names() method to _TaggableManager

docs/api.txt

@@ -54,6 +54,16 @@ playing around with the API.
         model with its own tagging through table, only other instances of the
         model with its own tagging through table, only other instances of the
         same model will be returned.
         same model will be returned.
 
 
+    .. method:: names()
+    
+        Convenience method, returning a ``ValuesListQuerySet`` (basically
+        just an iterable) containing the name of each tag as a string::
+
+            >>> apple.tags.names()
+            [u'green', u'red']
+            >>> 'green' in apple.tags.names()
+            True
+
 Filtering
 Filtering
 ~~~~~~~~~
 ~~~~~~~~~
 
 

taggit/managers.py

@@ -172,6 +172,10 @@ class _TaggableManager(models.Manager):
             self.through.objects.get_or_create(tag=tag, **self._lookup_kwargs())
             self.through.objects.get_or_create(tag=tag, **self._lookup_kwargs())
 
 
     @require_instance_manager
     @require_instance_manager
+    def names(self):
+        return self.get_query_set().values_list('name', flat=True)
+
+    @require_instance_manager
     def set(self, *tags):
     def set(self, *tags):
         self.clear()
         self.clear()
         self.add(*tags)
         self.add(*tags)
@@ -247,4 +251,4 @@ def _get_subclasses(model):
 # is not supported by Django 1.4
 # is not supported by Django 1.4
 if six.PY3:
 if six.PY3:
     from django.utils.functional import total_ordering
     from django.utils.functional import total_ordering
-    TaggableManager = total_ordering(TaggableManager)
+    TaggableManager = total_ordering(TaggableManager)
\ No newline at end of file

tests/tests.py

@@ -313,6 +313,12 @@ class TaggableManagerTestCase(BaseTaggingTestCase):
         self.assertTrue(hasattr(field, 'related'))
         self.assertTrue(hasattr(field, 'related'))
         self.assertEqual(self.food_model, field.related.model)
         self.assertEqual(self.food_model, field.related.model)
 
 
+    def test_names_method(self):
+        apple = self.food_model.objects.create(name="apple")
+        apple.tags.add('green')
+        apple.tags.add('red')
+        self.assertEqual(list(apple.tags.names()), ['green', 'red'])
+
 
 
 class TaggableManagerDirectTestCase(TaggableManagerTestCase):
 class TaggableManagerDirectTestCase(TaggableManagerTestCase):
     food_model = DirectFood
     food_model = DirectFood