{"id":13747713,"url":"https://github.com/ffaker/ffaker","last_synced_at":"2026-03-17T21:35:07.594Z","repository":{"id":780809,"uuid":"473155","full_name":"ffaker/ffaker","owner":"ffaker","description":"Faker refactored.","archived":false,"fork":false,"pushed_at":"2025-03-29T11:49:19.000Z","size":5493,"stargazers_count":1563,"open_issues_count":14,"forks_count":559,"subscribers_count":34,"default_branch":"main","last_synced_at":"2025-04-30T07:05:47.928Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/ffaker/ffaker","language":"Ruby","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/ffaker.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE","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":"2010-01-15T06:26:22.000Z","updated_at":"2025-04-14T09:32:31.000Z","dependencies_parsed_at":"2023-07-05T18:18:36.246Z","dependency_job_id":"a417ecf2-f2ee-46ea-94de-eb137e45cb98","html_url":"https://github.com/ffaker/ffaker","commit_stats":{"total_commits":824,"total_committers":229,"mean_commits":"3.5982532751091703","dds":0.883495145631068,"last_synced_commit":"b1f6b6ad20364960827eb20d947e6af994c481dc"},"previous_names":["emmanueloga/ffaker"],"tags_count":63,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffaker%2Fffaker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffaker%2Fffaker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffaker%2Fffaker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffaker%2Fffaker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ffaker","download_url":"https://codeload.github.com/ffaker/ffaker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252264524,"owners_count":21720524,"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":[],"created_at":"2024-08-03T06:01:38.938Z","updated_at":"2025-12-17T07:33:16.994Z","avatar_url":"https://github.com/ffaker.png","language":"Ruby","readme":"[![Build Status](https://github.com/ffaker/ffaker/workflows/Test/badge.svg)](https://github.com/ffaker/ffaker/actions?query=workflow%3ATest)\n[![Code Climate](https://codeclimate.com/github/EmmanuelOga/ffaker/badges/gpa.svg)](https://codeclimate.com/github/EmmanuelOga/ffaker)\n[![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)\n# ffaker\n\n[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ffaker/ffaker?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n[ffaker](http://rubygems.org/gems/ffaker) is a rewrite of [faker](http://rubygems.org/gems/faker).\n\n## Usage\n\n```ruby\nrequire 'ffaker'\n\nFFaker::Name.name       #=\u003e \"Christophe Bartell\"\nFFaker::Internet.email  #=\u003e \"kirsten.greenholt@corkeryfisher.info\"\n```\n\n**[See more →](REFERENCE.md)**\n\n## ffaker vs faker\n\nThe faker and ffaker APIs are mostly the same, although the API on ffaker keeps\ndiverging with its users additions. In general, the only difference is that you\nneed to:\n\n    gem install ffaker\n\nand then\n\n    require 'ffaker'\n\n### Rails\n\n1. If using rails then add the gem to your development and test environments:\n\n```ruby\ngroup :development, :test do\n  gem 'ffaker'\nend\n```\n\n2. and then run `bundle install` in your terminal/BASH/command line.\n\n## Why ffaker?\n\nffaker is a fork of faker, and was initially written in an effort to speed up\na slow spec suite. Since those days faker has also been rewritten and the\n\"speed\" factor is probably irrelevant now. Bear in mind, if your spec suite\nis slow, chances are the generation of random data will probably not account\nfor much of the run time.\n\nNowadays the code bases have diverged enough to make the two projects truly\ndifferent: since ffaker creation, a lot of new API methods have been added\nthrough the generous contributions of people all over the world.\n\nHopefully some day faker and ffaker will join forces!\n\n## Contributors\n\nA lot of people have contributed to ffaker. Check [this list](https://github.com/ffaker/ffaker/graphs/contributors).\n\nIf you want to add new modules or localization data, use one of the\n[directories for data files](https://github.com/ffaker/ffaker/tree/main/lib/ffaker/data)\n(or create a new one!).\n\n**const_missing** is\n[overridden](https://github.com/ffaker/ffaker/blob/main/lib/ffaker/utils/module_utils.rb#L9)\nfor Faker modules, so if you try to use a constant that is not defined\nin the module, the\n[override](https://github.com/ffaker/ffaker/blob/main/lib/ffaker/utils/module_utils.rb#L9)\nwill look for a data file matching the name of the constant. E.G.: the\nfirst time someone accesses `FFaker::Name::FIRST_NAMES`, a const of that\nname will be set with data from `ffaker/data/name/first_names`.\n\n## Using the same random seed as your tests\n\nTo get repeatable results in Minitest or Rspec, follow [these instructions](RANDOM.md#using-the-same-random-seed-as-your-tests).\n\n## Unique values\n\nYou can ensure unique values are generated using the `unique` method. `ffaker` will retry the generation\nuntil an unique value if found.\n\nExample:\n```ruby\nFFaker::Name.unique.name # ensures an unique value is returned for FFaker::Name\n```\n\nIf an unique value cannot be generated within a maximum limit of retries for a generator\na `FFaker::UniqueUtils::RetryLimitExceeded` error will be raised.\n\nYou can prevent exceeding the limit by clearing the record of used values (e.g. between tests):\n```ruby\nFFaker::Name.unique.clear # clears the used values for FFaker::Name\nFFaker::UniqueUtils.clear # clears the used values for all generators\n```\n\n## TODO\n\n* Even though the API is pretty simple, better rdoc documentation would not hurt.\n* Put all modules under their respective languages (E.G. EducationUS instead of just Education)\n\n## Note on Patches/Pull Requests\n\n* Fork the project.\n* Make your feature addition or bug fix.\n* Add tests for it. This is important so I don't break it in a future version unintentionally.\n   * To run all the tests: `rake test`\n   * To run a single test: `rake test TEST=test/test_lorem_br.rb`\n* Commit, do not mess with rakefile, version, or history.\n  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)\n* Send me a pull request. Bonus points for topic branches.\n\n## Release\n\n* Bump version in `lib/version.rb`.\n* Update `Changelog.md`.\n* Tag with `v\u003cmajor\u003e.\u003cminor\u003e.\u003cpatch\u003e`.\n* Push it.\n\n## Copyright\n\nCopyright (c) 2013 Emmanuel Oga. See LICENSE for details.\nCopyright (c) 2007 Benjamin Curtis\n","funding_links":[],"categories":["Ruby","Development","Testing"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fffaker%2Fffaker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fffaker%2Fffaker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fffaker%2Fffaker/lists"}