added factory method helpers for simple address

Author: Zack Teska

README.md

@@ -118,6 +118,9 @@ $address = new SimpleAddress('1234 Main St NE', null, 'Minneapolis', 'MN', '5540
 $address->getHash(); // full hash minus zip
 $address->getFullHash(); // full hash including zip
 
+// or do it all with the factory method:
+SimpleAddress::hashFromParts('1234 Main St NE', null, 'Minneapolis', 'MN', '55401');
+
 // CANNOT hash street, since the component parts don't exist
 $address->getStreetHash(); // throws exception
 ```

src/SimpleAddress.php

@@ -45,4 +45,38 @@ public function getStreetHash(string $algo = 'sha1'): string
     {
         throw new AddressNotNormalizedException('Address is not normalized and cannot hash the street.');
     }
+
+    /**
+     * Helper to get an address hash from 5-part address
+     *
+     * @param string $address1
+     * @param string|null $address2
+     * @param string $city
+     * @param string $state
+     * @param string|null $postalCode
+     *
+     * @return string
+     */
+    public static function hashFromParts(string $address1, ?string $address2, string $city, string $state, ?string $postalCode = null): string
+    {
+        $address = new self($address1, $address2, $city, $state, $postalCode);
+        return $address->getHash();
+    }
+
+    /**
+     * Helper to get a full address hash from 5-part address
+     *
+     * @param string $address1
+     * @param string|null $address2
+     * @param string $city
+     * @param string $state
+     * @param string|null $postalCode
+     *
+     * @return string
+     */
+    public static function fullHashFromParts(string $address1, ?string $address2, string $city, string $state, ?string $postalCode = null): string
+    {
+        $address = new self($address1, $address2, $city, $state, $postalCode);
+        return $address->getFullHash();
+    }
 }

tests/SimpleAddressTest.php

@@ -16,7 +16,10 @@ public function testHashesAddress()
         $address = new SimpleAddress('1234 Main St NE', null, 'Minneapolis', 'MN', '55401');
 
         $this->assertEquals('9bdbf17a475a0129c0546fc210ef46cb914338d0', $address->getHash());
+        $this->assertEquals($address->getHash(), SimpleAddress::hashFromParts('1234 Main St NE', null, 'Minneapolis', 'MN', '55401'));
+
         $this->assertEquals('c4ced80b9489911b4a66712470833242597aa032', $address->getFullHash());
+        $this->assertEquals($address->getFullHash(), SimpleAddress::fullHashFromParts('1234 Main St NE', null, 'Minneapolis', 'MN', '55401'));
 
         $this->expectException(AddressNotNormalizedException::class);
         $address->getStreetHash();