Merge pull request #1158 from jgwong/peruvian-dni

Add Peruvian DNI generator

readme.md

@@ -931,6 +931,15 @@ echo $faker->dni; // '77446565E'
 echo $faker->vat;           // "A35864370"
 ```
 
+### `Faker\Provider\es_PE\Person`
+
+```php
+<?php
+
+// Generates a Peruvian Documento Nacional de Identidad (DNI) number
+echo $faker->dni; // '83367512'
+```
+
 ### `Faker\Provider\fi_FI\Payment`
 
 ```php

src/Faker/Provider/es_PE/Person.php

@@ -87,4 +87,20 @@ public static function suffix()
     {
         return static::randomElement(static::$suffix);
     }
+
+
+    /**
+     * Generate a Documento Nacional de Identidad (DNI) number
+     *
+     * Doesn't include a checksum, as peruvians commonly use only the first
+     * 8 digits.
+     *
+     * @example '83367512'
+     *
+     * @link http://www2.sunat.gob.pe/pdt/pdtModulos/independientes/p695/TipoDoc.htm
+     */
+    public static function dni()
+    {
+        return static::numerify('########');
+    }
 }

test/Faker/Provider/es_PE/PersonTest.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Faker\Test\Provider\es_PE;
+
+use Faker\Generator;
+use Faker\Provider\es_PE\Person;
+
+class PersonTest extends \PHPUnit_Framework_TestCase
+{
+    /**
+     * @var Generator
+     */
+    private $faker;
+
+    public function setUp()
+    {
+        $faker = new Generator();
+        $faker->seed(1);
+        $faker->addProvider(new Person($faker));
+        $this->faker = $faker;
+    }
+
+    public function testDNI()
+    {
+        $dni = $this->faker->dni;
+        $this->assertRegExp('/\A[0-9]{8}\Z/', $dni);
+    }
+}