{"id":28092388,"url":"https://github.com/pixelpeter/laravel5-genderize-api-client","last_synced_at":"2025-05-13T13:10:02.167Z","repository":{"id":52421062,"uuid":"59590002","full_name":"pixelpeter/laravel5-genderize-api-client","owner":"pixelpeter","description":"Laravel 5 client for the Genderize.io API","archived":false,"fork":false,"pushed_at":"2025-04-05T16:32:38.000Z","size":54,"stargazers_count":46,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-02T13:22:07.831Z","etag":null,"topics":["api-client","gender","laravel","validation"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pixelpeter.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-05-24T16:29:42.000Z","updated_at":"2025-04-05T16:32:42.000Z","dependencies_parsed_at":"2024-06-21T20:21:24.453Z","dependency_job_id":"47479f06-5ed1-4130-800f-f58da2091b5f","html_url":"https://github.com/pixelpeter/laravel5-genderize-api-client","commit_stats":{"total_commits":32,"total_committers":5,"mean_commits":6.4,"dds":0.1875,"last_synced_commit":"7f0611859291b0412bdb586db6af922901337ed0"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pixelpeter%2Flaravel5-genderize-api-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pixelpeter%2Flaravel5-genderize-api-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pixelpeter%2Flaravel5-genderize-api-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pixelpeter%2Flaravel5-genderize-api-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pixelpeter","download_url":"https://codeload.github.com/pixelpeter/laravel5-genderize-api-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253948436,"owners_count":21988957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","gender","laravel","validation"],"created_at":"2025-05-13T13:08:50.762Z","updated_at":"2025-05-13T13:10:02.150Z","avatar_url":"https://github.com/pixelpeter.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel 5 Genderize.io API Client\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/pixelpeter/laravel5-genderize-api-client.svg?style=flat-square)](https://packagist.org/packages/pixelpeter/laravel5-genderize-api-client)\n[![Total Downloads](https://img.shields.io/packagist/dt/pixelpeter/laravel5-genderize-api-client.svg?style=flat-square)](https://packagist.org/packages/pixelpeter/laravel5-genderize-api-client)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)\n[![Coverage Status](https://coveralls.io/repos/github/pixelpeter/laravel5-genderize-api-client/badge.svg?branch=master)](https://coveralls.io/github/pixelpeter/laravel5-genderize-api-client?branch=master)\n[![Tests](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/run-tests.yml/badge.svg?branch=master)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/run-tests.yml)\n[![Fix PHP code style issues](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/fix-php-code-style-issues.yml)\n[![PHPStan](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/phpstan.yml/badge.svg)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/phpstan.yml)\n[![dependabot-auto-merge](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/dependabot-auto-merge.yml/badge.svg)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/dependabot-auto-merge.yml)\n\nA simple Laravel 5 client for the [Genderize.io API](https://genderize.io/).\nIt provides a fluent interface for easy request building.\n\n## WARNING: This library is deprecated. Please use [https://github.com/pixelpeter/laravel-genderize-api-client](https://github.com/pixelpeter/laravel-genderize-api-client) instead.\n## Version overview\n\n| Laravel | php           | use branch  |\n| ------  | ------------- |-------------|\n| 5.8     | 7.1, 7.2, 7.3 | master      |\n| 5.7     | 7.1, 7.2, 7.3 | 2.0.x       |\n| 5.6     | 7.1, 7.2, 7.3 | 2.0.x       |\n| 5.5     | 7.0, 7.1, 7.2 | 1.1.x/2.0.x |\n\n## Installation\n\n### Step 1: Install Through Composer\n``` bash\ncomposer require pixelpeter/laravel5-genderize-api-client\n```\n\n### Step 2: Add the Service Provider (not needed with v2.x because of auto discovery)\nAdd the service provider in `app/config/app.php`\n```php\n'provider' =\u003e [\n    ...\n    Pixelpeter\\Genderize\\GenderizeServiceProvider::class,\n    ...\n];\n```\n\n### Step 3: Add the Facade\nAdd the alias in `app/config/app.php`\n```php\n'aliases' =\u003e [\n    ...\n    'Genderize' =\u003e Pixelpeter\\Genderize\\Facades\\Genderize::class,\n    ...\n];\n```\n### Step 4: Publish the configuration file\nThis is only needed when you have an API key from Genderize.io\n```php\nphp artisan vendor:publish --provider=\"Pixelpeter\\Genderize\\GenderizeServiceProvider\"\n```\n\n## Examples\n\n### Send requests\n#### Single name\n```php\nuse Genderize;\n\nGenderize::name('Peter')-\u003eget();\n```\n\n#### Multiple names (max. 10)\n```php\nuse Genderize;\n\nGenderize::name(['John', 'Jane'])-\u003eget();\n\n// or for better readability you can use the plural\nGenderize::names(['John', 'Jane'])-\u003eget();\n```\n\n#### Add language and country options\n```php\nuse Genderize;\n\nGenderize::name('John')-\u003ecountry('US')-\u003elang('EN')-\u003eget();\n```\n### Working with the response\n#### For single usage\n```php\nuse Genderize;\n\n$response = Genderize::name('Peter')-\u003eget();\n\nprint $response-\u003eresult-\u003efirst()-\u003egender; // 'male'\nprint $response-\u003eresult-\u003efirst()-\u003ename; // 'Peter'\nprint $response-\u003eresult-\u003efirst()-\u003eprobability; '0.99'\nprint $response-\u003eresult-\u003efirst()-\u003ecount; 144\nprint $response-\u003eresult-\u003efirst()-\u003eisMale(); true\nprint $response-\u003eresult-\u003efirst()-\u003eisFemale(); false\nprint $response-\u003eresult-\u003efirst()-\u003eisNotMale(); false\nprint $response-\u003eresult-\u003efirst()-\u003eisNotFemale(); true\n```\n\n#### For batch usage\n```php\nuse Genderize;\n\n$response = Genderize::names(['John', 'Jane'])-\u003ecountry('US')-\u003elang('EN')-\u003eget();\n\nforeach($response-\u003eresult as $row)\n{\n    print $row-\u003ename;\n}\n```\n\n### Getting information about the request and limits\n```php\nuse Genderize;\n\n$response = Genderize::name('Peter')-\u003eget();\n\nprint $response-\u003emeta-\u003ecode; // 200 - HTTP response code\nprint $response-\u003emeta-\u003elimit; // 1000 - Max number of allowed requests\nprint $response-\u003emeta-\u003eremaining; // 950 - Number of requests left\nprint $response-\u003emeta-\u003ereset-\u003ediffInSeconds(); // Carbon\\Carbon - time left till reset\n```\n\n### More documentation\nRefer to [Genderize.io API Documentation](https://genderize.io/documentation/) for more examples and documentation.\n\n## Testing\nRun the tests with:\n```bash\nvendor/bin/phpunit\n```\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpixelpeter%2Flaravel5-genderize-api-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpixelpeter%2Flaravel5-genderize-api-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpixelpeter%2Flaravel5-genderize-api-client/lists"}