add tests + README

Author: 3nids

README.rst

@@ -250,6 +250,9 @@ to be serialized as the "geometry". For example:
             # as with a ModelSerializer.
             fields = ('id', 'address', 'city', 'state')
 
+If your model is geometry-less, you can set ``geo_field`` to ``None``
+and a null geometry will be produced.
+
 Using GeometrySerializerMethodField as "geo_field"
 ##################################################
 

tests/django_restframework_gis_tests/models.py

@@ -20,7 +20,6 @@ class BaseModel(models.Model):
     name = models.CharField(max_length=32)
     slug = models.SlugField(max_length=128, unique=True, blank=True)
     timestamp = models.DateTimeField(null=True, blank=True)
-    geometry = models.GeometryField()
 
     class Meta:
         abstract = True
@@ -45,18 +44,18 @@ def save(self, *args, **kwargs):
 
 
 class Location(BaseModel):
-    pass
+    geometry = models.GeometryField()
 
 
-class LocatedFile(BaseModel):
+class LocatedFile(Location):
     file = models.FileField(upload_to='located_files', blank=True, null=True)
 
 
-class BoxedLocation(BaseModel):
+class BoxedLocation(Location):
     bbox_geometry = models.PolygonField()
 
 
-class Nullable(BaseModel):
+class Nullable(Location):
     geometry = models.GeometryField(blank=True, null=True)
 
 

tests/django_restframework_gis_tests/serializers.py

@@ -185,6 +185,12 @@ class Meta:
         fields = ['name', 'slug', 'id']
 
 
+class NoGeoFeatureMethodSerializer(gis_serializers.GeoFeatureModelSerializer):
+    class Meta:
+        model = Location
+        geo_field = None
+        fields = ['name', 'slug', 'id']
+
 class PointSerializer(gis_serializers.GeoFeatureModelSerializer):
     class Meta:
         model = PointModel

tests/django_restframework_gis_tests/tests.py

@@ -634,6 +634,20 @@ def test_geometry_serializer_method_field_none(self):
         self.assertEqual(response.data['properties']['name'], 'None value')
         self.assertEqual(response.data['geometry'], None)
 
+    def test_geometry_serializer_method_field_nogeo(self):
+        location = Location.objects.create(
+            name='No geometry value'
+        )
+        location_loaded = Location.objects.get(pk=location.id)
+        self.assertEqual(
+            location_loaded.name, "No geometry value"
+        )
+        url = reverse('api_geojson_location_details_nogeo', args=[location.id])
+        response = self.client.generic('GET', url, content_type='application/json')
+        self.assertEqual(response.status_code, 200)
+        self.assertEqual(response.data['properties']['name'], 'No geometry value')
+        self.assertEqual(response.data['geometry'], None)
+
     def test_nullable_empty_geometry(self):
         empty = Nullable(name='empty', geometry='POINT EMPTY')
         empty.full_clean()

tests/django_restframework_gis_tests/views.py

@@ -24,6 +24,7 @@
     LocationGeoFeatureWritableIdSerializer,
     LocationGeoSerializer,
     NoneGeoFeatureMethodSerializer,
+    NoGeoFeatureMethodSerializer,
     PaginatedLocationGeoSerializer,
     PolygonModelSerializer,
 )
@@ -166,6 +167,13 @@ class GeojsonLocationDetailsNone(generics.RetrieveUpdateDestroyAPIView):
 
 geojson_location_details_none = GeojsonLocationDetailsNone.as_view()
 
+class GeojsonLocationDetailsNoGeo(generics.RetrieveUpdateDestroyAPIView):
+    model = Location
+    serializer_class = NoGeoFeatureMethodSerializer
+    queryset = Location.objects.all()
+
+
+geojson_location_details_nogeo = GeojsonLocationDetailsNoGeo.as_view()
 
 class GeojsonLocationSlugDetails(generics.RetrieveUpdateDestroyAPIView):
     model = Location