fakes-gen

This program is faker by random-select and support multi locale. Now, support Japan only. So, if you want to support other locale, please pull request data of the locale. You can generate formatted dummy data as xxxx. When it is String, formatter is "xxxx". When it is not String, formatter is xxxx.

License

MIT

install

as Library

// Cargo.toml
fakes-gen = "version"

as CLI for latest version

cargo install --git https://github.com/ogata-k/fakes-gen-cli --branch master

or get from crates.io

cargo install fakes-gen

As Library

support fake option

Fixed user data

// s is user data quated by ".
FixedString(s)
FixedNotString(s)

Select from user data

// list is user data such the formed: ["s1", "s2", "s3"]
SelectString(list)
SelectNotString(list)

Lorem

// unsigned integer n satisfied with from<=n<=to, 
// you can generate dummy as joined n-data by space. 
Word
Words(from, to)
Sentence
Sentences(from, to)
Paragraph
Paragraphs(from, to)

Name

// When use with_furigana, you set true to furigana parameter.
FirstName(with_furigana)
FirstNameFurigana
LastName(with_furigana)
LastNameFurigana
FullName(with_furigana)
FullNameFurigana

Primitive

// You can use from and to paramator such as Lorem.
// They are all not-String whithout Ascii.
Integer
IntegerRange(from, to)
Float
FloatRange(from, to)
// Ascii chars without space
Ascii(from, to)
Boolean

Internet

// You can use from and to paramator such as Lorem. 
// Their data is sensitive, so I pay attention dummy data to be as possible as safety.
Email
UserName
Password(from, to)
CreditCard
URL
IPv4
IPv6
RGB
RGBA
UserAgent
StatusCode

Company

CompanySuffix
CompanyName
Industry

Address

Building
StreetName
CityName
StateName
CountryCode
CountryName
TimeZone
Address
// When you use number formatted as xxx-xxxx-xxx, set true to hyphen parameter.
ZipCode(hyphen)
DomesticPhoneNumber(hyphen)
Latitude
Longitude

DateTime

// format-str: https://docs.rs/chrono/0.4.9/chrono/format/strftime/index.html
// String is format. default is "%Y-%m-%d %H:%I:%M"'s sub-format.
// But, When Time(Date, DateTime), use only Time(Date, Time/Date)-formatter.
// ex. "219-11-02 21:09:31"
Time(format)
Date(format)
DateTime(format)

FileSystem

FileName
Extension

examples

As CLI

usage

 fakes-gen [FLAGS] [OPTIONS] [option]...

[FLAGS] and [OPTIONS]

// help message from fakes-gen -h 
FLAGS:
    -b, --bnf         show Backus-Naur Form and detail format for options
    -f, --fullform    flag for generating as fullform such as body with header
    -h, --help        Print this message
    -u, --usable      show list of all usable options for faker
    -V, --version     Prints version information

OPTIONS:
    -c, --converter <converter>    converter for output [default: csv]  [possible values: csv, tsv, json]
    -l, --locale <locale>          3-char's country code. [default: jpn]  [possible values: jpn]
    -s, --size <size>              data size. If 1, generate as record. If over 1, generate as data_set. [default: 1]

usable format of [option]

Usable format is form such as Xxxx.Yyyy(zzz) or Xxxx.Yyyy(zzz#sub). Xxxx is Category. Usable Category is "Fixed", "Select", "Lorem", "Name", "Primitive", "Internet", "Company", "Address", "DateTime" and "FileSystem". Yyyy is Option for each Category. Usable Option is theirs and zzz is <column_name>. If you use header or fullform, fakes-gen use <column_name>. ``` // modified usable message from fakes-gen -u Category: Fixed // fixed value of user-value. Options: ・Fixed.String(#) // as String format "hoge". ・Fixed.NotString(#) // as not String format hoge. Example: fakes-gen Fixed.String(_#hoge) // "hoge"

Category: Select // select a value from user-values. Options: ・Select.String(#) // as String format "hoge". ・Select.NotString(#) // as not String format hoge. Example: fakes-gen Select.NotString(_#hoge#fuga) // hoge

Category: Lorem // dummy words Options: ・Lorem.Word((#)?) // one word or words of num in the range ・Lorem.Sentence((#)?) // one sentence or sentences of num in the range ・Lorem.Paragraph((#)?) // one paragraph or paragraphs of num in the range Example: fakes-gen Lorem.Word() // "氷山" fakes-gen Lorem.Word(#2#4) // "有向グラフ Haskell Rust"

Category: Name // name Options: ・Name.FirstName() // first name ・Name.FirstNameFurigana() // furigana of first name if exist, first name if not exist ・Name.LastName() // last name ・Name.LastNameFurigana() // furigana of last name if exist, last name if not exist ・Name.FullName() // full name ・Name.FullNameFurigana() // furigana of full name if exist, full name if not exist Example: fakes-gen Name.FullName() Name.LastNameFurigana() Name.FirstNameFurigana(_) // "露木 静男","ツユキ","シズオ"

Category: Primitive // primitive values Options: ・Primitive.Int((#)?) // integer or integer with limit range ・Primitive.Float((#)?) // real num with limit range ・Primitive.Ascii((#)?) // one ascii char or ascii chars of num in the range ・Primitive.Bool() // boolean Example: fakes-gen Primitive.Float() // -32544.35 fakes-gen Primitive.Float(#-1#1) // -0.87

Category: Internet // internet Options: ・Internet.Email() // safe address of email ・Internet.UserName() // name of user account ・Internet.Password(#) // password as length one or num in the range ・Internet.CreditCard() // safe number sequence of credit card ・Internet.URL() // safe url ・Internet.IPv4() // safe ipv4 ・Internet.IPv6() // safe ipv6 ・Internet.RGB() // rgb color such as #12480F ・Internet.RGBA() // rgb with alpha such as #09AF50CB ・Internet.UserAgent() // user agent ・Internet.StatusCode() // status of http request Example: fakes-gen Internet.URL() Internet.StatusCode() // "http://example.com/B/lUVB","6IxT4VL92u"

Category: Company // compnay Options: ・Company.Suffix() // suffix of company such as Corp. ・Company.Name() // name of company ・Company.Industry() // domain of industry Example: fakes-gen Company.Name() Company.Industry() // "フリーダム匿名組合","宿泊業"

Category: Address // address in country Options: ・Address.Building() // name of building ・Address.Street() // street in country ・Address.City() // city in country ・Address.State() // state in country ・Address.CountryCode() // country code of three chars ・Address.CountryName() // name of country ・Address.TimeZone() // time zone ・Address.Address() // address ・Address.ZipCode((#)?) // zipcode with hyphen when not use or set true ・Address.Phone((#)?) // dummy phone number with hyphen when not use or set true ・Address.Latitude() // latitude such as +20.134875,-00.134875 ・Address.Longitude() // logitude +028.672211,-228.672211 Example: fakes-gen Address.Phone(_#true) // "03-357-1407"

Category: DateTime // date time with sub-format of "%Y-%m-%d %H:%I:%M" // If you want to know format, please reference to https://docs.rs/chrono/0.4.9/chrono/format/strftime/index.html#specifiers Options: ・DateTime.Time(#) ・DateTime.Date(#) ・DateTime.DateTime(#) Example: fakes-gen DateTime.Date(#%m/%d) DateTime.Time() // "08/17","18:06:18"

Category: FileSystem // file Options: ・FileSystem.FileName() // name with extension of file ・FileSystem.Extension() // extension Example: fakes-gen FileSystem.FileName(_) // "8yIY6C4Pl.csv" ```

And their option's format is theirs. [option] is \ := .((#)?) := [A-Z][0-9a-zA-Z]* := [A-Z][0-9a-zA-Z]* := := ||||| := ((".")|[.[^\ ]]) := [(#)] := # := -?#-? := [0-9][1-9] := (true)|(false) := If you want to know , please reference to https://docs.rs/chrono/0.4.9/chrono/format/strftime/index.html#specifiers

```

TODO