Merge pull request #25 from 365Werk/release/2.0.0

Release/2.0.0

composer.json

@@ -1,8 +1,8 @@
 {
     "name": "werk365/identitydocuments",
     "description": "Package to parse identity documents like passports",
-    "license": "MIT",
-    "version": "1.4.0",
+    "license": "GPL-3.0-or-later",
+    "version": "2.0.0",
     "authors": [
         {
             "name": "Hergen Dillema",
@@ -11,9 +11,9 @@
         }
     ],
     "homepage": "https://github.com/werk365/identitydocuments",
-    "keywords": ["Laravel", "IdentityDocuments"],
+    "keywords": ["Laravel", "IdentityDocuments", "MRZ", "Passport"],
     "require": {
-        "google/cloud-vision": "^1.1",
+        "google/cloud-vision": "^1.3",
         "intervention/image": "^2.5",
         "illuminate/support": "~5|~6|~7|~8"
     },
@@ -25,18 +25,18 @@
     },
     "autoload": {
         "psr-4": {
-            "werk365\\IdentityDocuments\\": "src/"
+            "Werk365\\IdentityDocuments\\": "src/"
         }
     },
     "autoload-dev": {
         "psr-4": {
-            "werk365\\IdentityDocuments\\Tests\\": "tests"
+            "Werk365\\IdentityDocuments\\Tests\\": "tests"
         }
     },
     "extra": {
         "laravel": {
             "providers": [
-                "werk365\\IdentityDocuments\\IdentityDocumentsServiceProvider"
+                "Werk365\\IdentityDocuments\\IdentityDocumentsServiceProvider"
             ],
             "aliases": {
                 "IdentityDocuments": "werk365\\IdentityDocuments\\Facades\\IdentityDocuments"

config/countries.php

@@ -0,0 +1,274 @@
+<?php
+
+return [
+    'ABW'=>'Aruba',
+    'AFG'=>'Afghanistan',
+    'AGO'=>'Angola',
+    'AIA'=>'Anguilla',
+    'ALA'=>'Åland Islands',
+    'ALB'=>'Albania',
+    'AND'=>'Andorra',
+    'ARE'=>'United Arab Emirates',
+    'ARG'=>'Argentina',
+    'ARM'=>'Armenia',
+    'ASM'=>'American Samoa',
+    'ATA'=>'Antarctica',
+    'ATF'=>'French Southern Territories',
+    'ATG'=>'Antigua and Barbuda',
+    'AUS'=>'Australia',
+    'AUT'=>'Austria',
+    'AZE'=>'Azerbaijan',
+    'BDI'=>'Burundi',
+    'BEL'=>'Belgium',
+    'BEN'=>'Benin',
+    'BES'=>'Bonaire, Sint Eustatius and Saba',
+    'BFA'=>'Burkina Faso',
+    'BGD'=>'Bangladesh',
+    'BGR'=>'Bulgaria',
+    'BHR'=>'Bahrain',
+    'BHS'=>'Bahamas',
+    'BIH'=>'Bosnia and Herzegovina',
+    'BLM'=>'Saint Barthélemy',
+    'BLR'=>'Belarus',
+    'BLZ'=>'Belize',
+    'BMU'=>'Bermuda',
+    'BOL'=>'Bolivia, Plurinational State of',
+    'BRA'=>'Brazil',
+    'BRB'=>'Barbados',
+    'BRN'=>'Brunei Darussalam',
+    'BTN'=>'Bhutan',
+    'BVT'=>'Bouvet Island',
+    'BWA'=>'Botswana',
+    'CAF'=>'Central African Republic',
+    'CAN'=>'Canada',
+    'CCK'=>'Cocos (Keeling) Islands',
+    'CHE'=>'Switzerland',
+    'CHL'=>'Chile',
+    'CHN'=>'China',
+    'CIV'=>'Côte d\'Ivoire',
+    'CMR'=>'Cameroon',
+    'COD'=>'Congo, the Democratic Republic of the',
+    'COG'=>'Congo',
+    'COK'=>'Cook Islands',
+    'COL'=>'Colombia',
+    'COM'=>'Comoros',
+    'CPV'=>'Cape Verde',
+    'CRI'=>'Costa Rica',
+    'CUB'=>'Cuba',
+    'CUW'=>'Curaçao',
+    'CXR'=>'Christmas Island',
+    'CYM'=>'Cayman Islands',
+    'CYP'=>'Cyprus',
+    'CZE'=>'Czech Republic',
+    'DEU'=>'Germany',
+    'DJI'=>'Djibouti',
+    'DMA'=>'Dominica',
+    'DNK'=>'Denmark',
+    'DOM'=>'Dominican Republic',
+    'DZA'=>'Algeria',
+    'ECU'=>'Ecuador',
+    'EGY'=>'Egypt',
+    'ERI'=>'Eritrea',
+    'ESH'=>'Western Sahara',
+    'ESP'=>'Spain',
+    'EST'=>'Estonia',
+    'ETH'=>'Ethiopia',
+    'FIN'=>'Finland',
+    'FJI'=>'Fiji',
+    'FLK'=>'Falkland Islands (Malvinas)',
+    'FRA'=>'France',
+    'FRO'=>'Faroe Islands',
+    'FSM'=>'Micronesia, Federated States of',
+    'GAB'=>'Gabon',
+    'GBR'=>'United Kingdom',
+    'GEO'=>'Georgia',
+    'GGY'=>'Guernsey',
+    'GHA'=>'Ghana',
+    'GIB'=>'Gibraltar',
+    'GIN'=>'Guinea',
+    'GLP'=>'Guadeloupe',
+    'GMB'=>'Gambia',
+    'GNB'=>'Guinea-Bissau',
+    'GNQ'=>'Equatorial Guinea',
+    'GRC'=>'Greece',
+    'GRD'=>'Grenada',
+    'GRL'=>'Greenland',
+    'GTM'=>'Guatemala',
+    'GUF'=>'French Guiana',
+    'GUM'=>'Guam',
+    'GUY'=>'Guyana',
+    'HKG'=>'Hong Kong',
+    'HMD'=>'Heard Island and McDonald Islands',
+    'HND'=>'Honduras',
+    'HRV'=>'Croatia',
+    'HTI'=>'Haiti',
+    'HUN'=>'Hungary',
+    'IDN'=>'Indonesia',
+    'IMN'=>'Isle of Man',
+    'IND'=>'India',
+    'IOT'=>'British Indian Ocean Territory',
+    'IRL'=>'Ireland',
+    'IRN'=>'Iran, Islamic Republic of',
+    'IRQ'=>'Iraq',
+    'ISL'=>'Iceland',
+    'ISR'=>'Israel',
+    'ITA'=>'Italy',
+    'JAM'=>'Jamaica',
+    'JEY'=>'Jersey',
+    'JOR'=>'Jordan',
+    'JPN'=>'Japan',
+    'KAZ'=>'Kazakhstan',
+    'KEN'=>'Kenya',
+    'KGZ'=>'Kyrgyzstan',
+    'KHM'=>'Cambodia',
+    'KIR'=>'Kiribati',
+    'KNA'=>'Saint Kitts and Nevis',
+    'KOR'=>'Korea, Republic of',
+    'KWT'=>'Kuwait',
+    'LAO'=>'Lao People\'s Democratic Republic',
+    'LBN'=>'Lebanon',
+    'LBR'=>'Liberia',
+    'LBY'=>'Libya',
+    'LCA'=>'Saint Lucia',
+    'LIE'=>'Liechtenstein',
+    'LKA'=>'Sri Lanka',
+    'LSO'=>'Lesotho',
+    'LTU'=>'Lithuania',
+    'LUX'=>'Luxembourg',
+    'LVA'=>'Latvia',
+    'MAC'=>'Macao',
+    'MAF'=>'Saint Martin (French part)',
+    'MAR'=>'Morocco',
+    'MCO'=>'Monaco',
+    'MDA'=>'Moldova, Republic of',
+    'MDG'=>'Madagascar',
+    'MDV'=>'Maldives',
+    'MEX'=>'Mexico',
+    'MHL'=>'Marshall Islands',
+    'MKD'=>'Macedonia, the former Yugoslav Republic of',
+    'MLI'=>'Mali',
+    'MLT'=>'Malta',
+    'MMR'=>'Myanmar',
+    'MNE'=>'Montenegro',
+    'MNG'=>'Mongolia',
+    'MNP'=>'Northern Mariana Islands',
+    'MOZ'=>'Mozambique',
+    'MRT'=>'Mauritania',
+    'MSR'=>'Montserrat',
+    'MTQ'=>'Martinique',
+    'MUS'=>'Mauritius',
+    'MWI'=>'Malawi',
+    'MYS'=>'Malaysia',
+    'MYT'=>'Mayotte',
+    'NAM'=>'Namibia',
+    'NCL'=>'New Caledonia',
+    'NER'=>'Niger',
+    'NFK'=>'Norfolk Island',
+    'NGA'=>'Nigeria',
+    'NIC'=>'Nicaragua',
+    'NIU'=>'Niue',
+    'NLD'=>'Netherlands',
+    'NOR'=>'Norway',
+    'NPL'=>'Nepal',
+    'NRU'=>'Nauru',
+    'NZL'=>'New Zealand',
+    'OMN'=>'Oman',
+    'PAK'=>'Pakistan',
+    'PAN'=>'Panama',
+    'PCN'=>'Pitcairn',
+    'PER'=>'Peru',
+    'PHL'=>'Philippines',
+    'PLW'=>'Palau',
+    'PNG'=>'Papua New Guinea',
+    'POL'=>'Poland',
+    'PRI'=>'Puerto Rico',
+    'PRK'=>'Korea, Democratic People\'s Republic of',
+    'PRT'=>'Portugal',
+    'PRY'=>'Paraguay',
+    'PSE'=>'Palestinian Territory, Occupied',
+    'PYF'=>'French Polynesia',
+    'QAT'=>'Qatar',
+    'REU'=>'Réunion',
+    'ROU'=>'Romania',
+    'RUS'=>'Russian Federation',
+    'RWA'=>'Rwanda',
+    'SAU'=>'Saudi Arabia',
+    'SDN'=>'Sudan',
+    'SEN'=>'Senegal',
+    'SGP'=>'Singapore',
+    'SGS'=>'South Georgia and the South Sandwich Islands',
+    'SHN'=>'Saint Helena, Ascension and Tristan da Cunha',
+    'SJM'=>'Svalbard and Jan Mayen',
+    'SLB'=>'Solomon Islands',
+    'SLE'=>'Sierra Leone',
+    'SLV'=>'El Salvador',
+    'SMR'=>'San Marino',
+    'SOM'=>'Somalia',
+    'SPM'=>'Saint Pierre and Miquelon',
+    'SRB'=>'Serbia',
+    'SSD'=>'South Sudan',
+    'STP'=>'Sao Tome and Principe',
+    'SUR'=>'Suriname',
+    'SVK'=>'Slovakia',
+    'SVN'=>'Slovenia',
+    'SWE'=>'Sweden',
+    'SWZ'=>'Swaziland',
+    'SXM'=>'Sint Maarten (Dutch part)',
+    'SYC'=>'Seychelles',
+    'SYR'=>'Syrian Arab Republic',
+    'TCA'=>'Turks and Caicos Islands',
+    'TCD'=>'Chad',
+    'TGO'=>'Togo',
+    'THA'=>'Thailand',
+    'TJK'=>'Tajikistan',
+    'TKL'=>'Tokelau',
+    'TKM'=>'Turkmenistan',
+    'TLS'=>'Timor-Leste',
+    'TON'=>'Tonga',
+    'TTO'=>'Trinidad and Tobago',
+    'TUN'=>'Tunisia',
+    'TUR'=>'Turkey',
+    'TUV'=>'Tuvalu',
+    'TWN'=>'Taiwan, Province of China',
+    'TZA'=>'Tanzania, United Republic of',
+    'UGA'=>'Uganda',
+    'UKR'=>'Ukraine',
+    'UMI'=>'United States Minor Outlying Islands',
+    'URY'=>'Uruguay',
+    'USA'=>'United States',
+    'UZB'=>'Uzbekistan',
+    'VAT'=>'Holy See (Vatican City State)',
+    'VCT'=>'Saint Vincent and the Grenadines',
+    'VEN'=>'Venezuela, Bolivarian Republic of',
+    'VGB'=>'Virgin Islands, British',
+    'VIR'=>'Virgin Islands, U.S.',
+    'VNM'=>'Viet Nam',
+    'VUT'=>'Vanuatu',
+    'WLF'=>'Wallis and Futuna',
+    'WSM'=>'Samoa',
+    'YEM'=>'Yemen',
+    'ZAF'=>'South Africa',
+    'ZMB'=>'Zambia',
+    'ZWE'=>'Zimbabwe',
+    'D' => 'Germany',
+    'EUE' => 'European Union',
+    'GBD' => 'British Overseas Territories Citizen',
+    'GBN' => 'British National (Overseas)',
+    'GBO' => 'British Overseas Citizen',
+    'GBP' => 'British Protected Person',
+    'GBS' => 'British Subject',
+    'UNA' => 'specialized agency of the United Nations',
+    'UNK' => 'Resident of Kosovo',
+    'UNO' => 'United Nations organization',
+    'XBA' => 'African Development Bank',
+    'XIM' => 'African Export–Import Bank',
+    'XCC' => 'Caribbean Community or one of its emissaries',
+    'XCO' => 'Common Market for Eastern and Southern Africa',
+    'XEC' => 'Economic Community of West African States',
+    'XPO' => 'International Criminal Police Organization',
+    'XOM' => 'Sovereign Military Order of Malta',
+    'XXA' => 'Stateless person',
+    'XXB' => 'Refugee',
+    'XXC' => 'Refugee',
+    'XXX' => 'Unspecified nationality',
+];

config/identitydocuments.php

@@ -1,8 +1,9 @@
 <?php
 
+use Werk365\IdentityDocuments\Services\Google;
+
 return [
-    'return_all' => false,
-    'countries_convert_o_to_zero' => [
-        'NLD',
-    ],
+    'ocrService' => Google::class,
+    'faceDetectionService' => Google::class,
+    'mergeImages' => false, // bool
 ];

contributing.md

@@ -6,8 +6,7 @@ Contributions are accepted via Pull Requests on [Github](https://github.com/werk
 
 # Things you could do
 If you want to contribute but do not know where to start, this list provides some starting points.
-- Set up TravisCI, StyleCI, ScrutinizerCI
-- Write a comprehensive ReadMe
+- Update this file
 
 ## Pull Requests