ProductPromotion
Logo

Ruby

made by https://0x3d.site

GitHub - ffaker/ffaker: Faker refactored.
Faker refactored. Contribute to ffaker/ffaker development by creating an account on GitHub.
Visit Site

GitHub - ffaker/ffaker: Faker refactored.

GitHub - ffaker/ffaker: Faker refactored.

Build Status Code Climate Reviewed by Hound

ffaker

Gitter

ffaker is a rewrite of faker.

Usage

require 'ffaker'

FFaker::Name.name       #=> "Christophe Bartell"
FFaker::Internet.email  #=> "[email protected]"

See more →

ffaker vs faker

The faker and ffaker APIs are mostly the same, although the API on ffaker keeps diverging with its users additions. In general, the only difference is that you need to:

gem install ffaker

and then

require 'ffaker'

Rails

  1. If using rails then add the gem to your development and test environments:
group :development, :test do
  gem 'ffaker'
end
  1. and then run bundle install in your terminal/BASH/command line.

Why ffaker?

ffaker is a fork of faker, and was initially written in an effort to speed up a slow spec suite. Since those days faker has also been rewritten and the "speed" factor is probably irrelevant now. Bear in mind, if your spec suite is slow, chances are the generation of random data will probably not account for much of the run time.

Nowadays the code bases have diverged enough to make the two projects truly different: since ffaker creation, a lot of new API methods have been added through the generous contributions of people all over the world.

Hopefully some day faker and ffaker will join forces!

Contributors

A lot of people have contributed to ffaker. Check this list.

If you want to add new modules or localization data, use one of the directories for data files (or create a new one!).

const_missing is overriden for Faker modules, so if you try to use a constant that is not defined in the module, the override will look for a data file matching the name of the constant. E.G.: the first time someone accesses FFaker::Name::FIRST_NAMES, a const of that name will be set with data from ffaker/data/name/first_names.

Using the same random seed as your tests

To get repeatable results in Minitest or Rspec, follow these instructions.

Unique values

You can ensure unique values are generated using the unique method. ffaker will retry the generation until an unique value if found.

Example:

FFaker::Name.unique.name # ensures an unique value is returned for FFaker::Name

If an unique value cannot be generated within a maximum limit of retries for a generator a FFaker::UniqueUtils::RetryLimitExceeded error will be raised.

You can prevent exceeding the limit by clearing the record of used values (e.g. between tests):

FFaker::Name.unique.clear # clears the used values for FFaker::Name
FFaker::UniqueUtils.clear # clears the used values for all generators

TODO

  • Even though the API is pretty simple, better rdoc documentation would not hurt.
  • Put all modules under their respective languages (E.G. EducationUS instead of just Education)

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
    • To run all the tests: rake test
    • To run a single test: rake test TEST=test/test_lorem_br.rb
  • Commit, do not mess with rakefile, version, or history. (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)
  • Send me a pull request. Bonus points for topic branches.

Release

  • Bump version in lib/version.rb.
  • Update Changelog.md.
  • Tag with v<major>.<minor>.<patch>.
  • Push it.

Copyright

Copyright (c) 2013 Emmanuel Oga. See LICENSE for details. Copyright (c) 2007 Benjamin Curtis

More Resources
to explore the angular.

mail [email protected] to add your project or resources here 🔥.

Related Articles
to learn about angular.

FAQ's
to learn more about Angular JS.

mail [email protected] to add more queries here 🔍.

More Sites
to check out once you're finished browsing here.

0x3d
https://www.0x3d.site/
0x3d is designed for aggregating information.
NodeJS
https://nodejs.0x3d.site/
NodeJS Online Directory
Cross Platform
https://cross-platform.0x3d.site/
Cross Platform Online Directory
Open Source
https://open-source.0x3d.site/
Open Source Online Directory
Analytics
https://analytics.0x3d.site/
Analytics Online Directory
JavaScript
https://javascript.0x3d.site/
JavaScript Online Directory
GoLang
https://golang.0x3d.site/
GoLang Online Directory
Python
https://python.0x3d.site/
Python Online Directory
Swift
https://swift.0x3d.site/
Swift Online Directory
Rust
https://rust.0x3d.site/
Rust Online Directory
Scala
https://scala.0x3d.site/
Scala Online Directory
Ruby
https://ruby.0x3d.site/
Ruby Online Directory
Clojure
https://clojure.0x3d.site/
Clojure Online Directory
Elixir
https://elixir.0x3d.site/
Elixir Online Directory
Elm
https://elm.0x3d.site/
Elm Online Directory
Lua
https://lua.0x3d.site/
Lua Online Directory
C Programming
https://c-programming.0x3d.site/
C Programming Online Directory
C++ Programming
https://cpp-programming.0x3d.site/
C++ Programming Online Directory
R Programming
https://r-programming.0x3d.site/
R Programming Online Directory
Perl
https://perl.0x3d.site/
Perl Online Directory
Java
https://java.0x3d.site/
Java Online Directory
Kotlin
https://kotlin.0x3d.site/
Kotlin Online Directory
PHP
https://php.0x3d.site/
PHP Online Directory
React JS
https://react.0x3d.site/
React JS Online Directory
Angular
https://angular.0x3d.site/
Angular JS Online Directory