Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 102 lines (72 sloc) 3.314 kB
32dc9fd Initial commit to ffaker.
Emmanuel Oga authored
1 = ffaker
2
52feff4 Release 1.8.0
Emmanuel Oga authored
3 Fast Faker == Faker refactored. http://rubygems.org/gems/ffaker
d5d01a2 major refactor of faker
Emmanuel Oga authored
4
5 = Faker
6
52feff4 Release 1.8.0
Emmanuel Oga authored
7 A port of Perl's Data::Faker library that generates fake data. http://rubygems.org/gems/faker
d5d01a2 major refactor of faker
Emmanuel Oga authored
8
9 == Usage
10
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
11 require 'ffaker'
12 Faker::Name.name => "Christophe Bartell"
13 Faker::Internet.email => "kirsten.greenholt@corkeryfisher.info"
d5d01a2 major refactor of faker
Emmanuel Oga authored
14
ea214ba trying to fix the README.rdoc #trivial
Emmanuel Oga authored
15 == Ffaker / Faker
d5d01a2 major refactor of faker
Emmanuel Oga authored
16
52feff4 Release 1.8.0
Emmanuel Oga authored
17 Faker and Ffaker APIs are mostly the same, although the API on ffaker keeps
18 growing with its users additions. In general, the only difference is that you
19 need to:
d5d01a2 major refactor of faker
Emmanuel Oga authored
20
552f6c9 updated readme
Emmanuel Oga authored
21 gem install ffaker
32dc9fd Initial commit to ffaker.
Emmanuel Oga authored
22
552f6c9 updated readme
Emmanuel Oga authored
23 and then
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
24
552f6c9 updated readme
Emmanuel Oga authored
25 require 'ffaker'
26
27 instead of "faker" with only one f.
28
52feff4 Release 1.8.0
Emmanuel Oga authored
29 == Faster? does it really matter ?
c842029 removing jeweler dependency
Emmanuel Oga authored
30
52feff4 Release 1.8.0
Emmanuel Oga authored
31 Ffaker was initially written in an effort to speed up a slow spec suite. Bear
32 in mind, if your spec suite is slow, chances are the generation of random data
33 will not account for much of the run time.
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
34
52feff4 Release 1.8.0
Emmanuel Oga authored
35 Since then, the original faker gem has become faster (at the moment it did not
36 seem it was mantained). Nevertheless, ffaker is still about 20x faster than
37 faker.
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
38
39 $ cat scripts/benchmark.rb
40
41 # ...
42 N = 10_000
43
44 Benchmark.bm do |rep|
45 rep.report("generating #{ N } names") do
46 N.times do
47 Faker::Name.name
48 end
49 end
50 end
51
52feff4 Release 1.8.0
Emmanuel Oga authored
52 * ruby 1.8.7 (2011-02-18 patchlevel 334) [x86_64-linux], MBARI 0x6770, Ruby Enterprise Edition 2011.03
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
53
52feff4 Release 1.8.0
Emmanuel Oga authored
54 generating 10000 names (faker 0.9.5) 1.500000 0.000000 1.500000 ( 1.506865)
55 generating 10000 names (ffaker 1.5.0) 0.070000 0.000000 0.070000 ( 0.067526)
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
56
52feff4 Release 1.8.0
Emmanuel Oga authored
57 * ruby 1.9.2p180 (2011-02-18 revision 30909) [x86_64-linux]
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
58
52feff4 Release 1.8.0
Emmanuel Oga authored
59 generating 10000 names (faker 0.9.5) 1.030000 0.020000 1.050000 ( 1.046116)
60 generating 10000 names (ffaker 1.7.0) 0.040000 0.000000 0.040000 ( 0.045917)
e924cf4 Version bump to 0.4.0
Emmanuel Oga authored
61
62 == Contributors
63
64 * James Rosen ( http://github.com/jamesarosen/ffaker ).
65 * Rafael Souza ( http://github.com/rafaelss/ffaker ).
8ab7038 updated docs and version
Emmanuel Oga authored
66 * Robert Berry ( https://github.com/bdigital ).
67 * qichunren ( http://github.com/qichunren ).
ae30af4 Release 1.3.0
Emmanuel Oga authored
68 * Kristján Pétursson ( https://github.com/kristjan )
fc090a6 Release 1.4.0
Emmanuel Oga authored
69 * Rico Sta. Cruz ( https://github.com/rstacruz )
59fb6d7 Release 1.5.0
Emmanuel Oga authored
70 * Vsevolod Romashov ( https://github.com/7even )
c74bb56 Release 1.6.0
Emmanuel Oga authored
71 * David Noelte (https://github.com/marvin)
72 * Port 80 Labs (https://github.com/port80labs)
baf4891 Release 1.7.0
Emmanuel Oga authored
73 * Shane Weng (https://github.com/swcool)
52feff4 Release 1.8.0
Emmanuel Oga authored
74 * Chris Bloom (https://github.com/chrisbloom7)
7aa0229 Release 1.9.1
Emmanuel Oga authored
75 * SENE (https://github.com/PapePathe)
76 * kichiro (https://github.com/kichiro)
f95ce56 Release 1.10.1
Emmanuel Oga authored
77 * doctorbh (https://github.com/doctorbh)
b6c0366 @wiseleyb Adding AddressAU and AddressPhoneAU
wiseleyb authored
78 * Ben Wisleey ( https://github.com/wiseleyb )
0a28109 Release 1.12.1
Emmanuel Oga authored
79 * Simon Russel ( https://github.com/simonrussell )
4d84c53 Release 1.13.0
Emmanuel Oga authored
80 * Piotr Usewicz ( https://github.com/pusewicz )
101b9b9 Release 1.14.0
Emmanuel Oga authored
81 * And others... see complete list: https://github.com/EmmanuelOga/ffaker/network/members
0244b55 Release 1.11.0
Emmanuel Oga authored
82
552f6c9 updated readme
Emmanuel Oga authored
83 == TODO
84
85 * Even though the API is pretty simple, better rdoc documentation would not hurt.
4d84c53 Release 1.13.0
Emmanuel Oga authored
86 * Put all modules under its respective language (E.G. EducationUS instead of just Education)
552f6c9 updated readme
Emmanuel Oga authored
87
32dc9fd Initial commit to ffaker.
Emmanuel Oga authored
88 == Note on Patches/Pull Requests
d5d01a2 major refactor of faker
Emmanuel Oga authored
89
32dc9fd Initial commit to ffaker.
Emmanuel Oga authored
90 * Fork the project.
91 * Make your feature addition or bug fix.
92 * Add tests for it. This is important so I don't break it in a
93 future version unintentionally.
94 * Commit, do not mess with rakefile, version, or history.
95 (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)
96 * Send me a pull request. Bonus points for topic branches.
97
98 == Copyright
99
100 Copyright (c) 2010 Emmanuel Oga. See LICENSE for details.
8cf2e0b renamed files to avoid clashing with faker, updated docs and version
Emmanuel Oga authored
101 Copyright (c) 2007 Benjamin Curtis
Something went wrong with that request. Please try again.