Merge pull request #137 from maxmind/markf/user_count

add support for user_counts trait

Author: oschwald

src/Record/Traits.php

@@ -66,6 +66,10 @@
  * @property-read string|null $organization The name of the organization associated
  * with the IP address. This attribute is only available from the City and
  * Insights web services and the GeoIP2 Enterprise database.
+ * @property-read int|null $userCount The estimated number of users sharing
+ * the IP/network during the past 24 hours. For IPv4, the count is for the
+ * individual IP. For IPv6, the count is for the /64 network. This property is
+ * only available from GeoIP2 Precision Insights.
  * @property-read string|null $userType <p>The user type associated with the IP
  *  address. This can be one of the following values:</p>
  *  <ul>
@@ -111,6 +115,7 @@ class Traits extends AbstractRecord
         'isSatelliteProvider',
         'isTorExitNode',
         'organization',
+        'userCount',
         'userType',
     ];
 }

tests/GeoIp2/Test/Model/InsightsTest.php

@@ -73,6 +73,7 @@ public function testFull()
                 'is_tor_exit_node' => true,
                 'isp' => 'Comcast',
                 'organization' => 'Blorg',
+                'user_count' => 2,
                 'user_type' => 'college',
             ],
         ];
@@ -191,6 +192,12 @@ public function testFull()
             $model->raw,
             'raw method returns raw input'
         );
+
+        $this->assertSame(
+            2,
+            $model->traits->userCount,
+            'userCount is correct'
+        );
     }
 
     public function testEmptyObjects()

tests/GeoIp2/Test/WebService/ClientTest.php

@@ -27,8 +27,23 @@ class ClientTest extends \PHPUnit_Framework_TestCase
             ],
     ];
 
-    private function getResponse($ipAddress)
+    private function getResponse($service, $ipAddress)
     {
+        if ($service === 'Insights') {
+            $insights = unserialize(serialize($this->country));
+            $insights['traits']['user_count'] = 2;
+
+            $responses = [
+                '1.2.3.4' => $this->response(
+                    'insights',
+                    200,
+                    $insights
+                ),
+            ];
+
+            return $responses[$ipAddress];
+        }
+
         $responses = [
             '1.2.3.4' => $this->response(
                 'country',
@@ -223,6 +238,12 @@ public function testInsights()
             $record->continent->geonameId,
             'continent geoname_id is 42'
         );
+
+        $this->assertSame(
+            2,
+            $record->traits->userCount,
+            'user_count is 2'
+        );
     }
 
     public function testCity()
@@ -444,7 +465,7 @@ private function makeRequest(
         $licenseKey = 'abcdef123456';
 
         list($statusCode, $headers, $responseBody)
-            = $this->getResponse($ipAddress);
+            = $this->getResponse($service, $ipAddress);
 
         $stub = $this->getMockForAbstractClass(
             'MaxMind\\WebService\\Http\\Request'