Skip to main content

Random data generator for the command line

Project description

https://beerpay.io/l-x/fakr/badge.svg?style=beer https://badges.gitter.im/random-data-fakrs/Lobby.svg https://travis-ci.org/l-x/fakr.svg?branch=master https://codecov.io/gh/l-x/fakr/branch/master/graph/badge.svg

Random data, fakrs!

fakr reads a Jinja2 Template from stdin, renders it using a vocabulary and writes the result to stdout. It’s as simple as that…

Installation

$ pip install fakr

Basic Usage

$ fakr --help

Examples

Generate a simple csv file with 100k rows

$ echo "{{row}},{{row%100}},{{firstname}},{{lastname}},{{email}}" \
  | fakr --count 100000``

Use a file for complex template

$ cat examples/templates/vcard.tpl \
  | fakr --count 1000

Make a http request using curl:

$ echo "company={{company|urlencode}}&city={{city|urlencode}}"  \
  | fakr -c1 \
  | curl httpbin.org/post -d @-

Write data to a redis server:

$ echo 'firstname \"{{firstname}}\" lastname \"{{lastname}}\" email \"{{email}}\"' \
  | fakr \
  | xargs -i redis-cli HMSET {}``

Templates

The templates you use for data generation are plain Jinja2 Templates. See their reference for detailed information.

There are a few custom filters, functions and variables for use with fakr:

Custom filters:

  • ascii: Converts the value to ascii (using Unidecode) (i. e. {{lastname|ascii}})

  • shuffle: Shuffles the value randomly (i. e. {{lastname|shuffle}})

  • chance: Gives the value a chance from 0.0 to 1.0 to be returned (i. e. {{firstname|chance(0.9)}} - firstname will be 90% returned, 10% empty)

  • rjust: Right-justifies the value to the given with (i. e. {{company|rjust(40)}})

  • ljust: Left-justifies the value to the given with (i. e. {{company|ljust(40)}})

  • center: Centers the value in width (i. e. {{company|center(40)}})

Custom functions:

  • translate

  • uuid4: Returns a new UUIDv4 on every call (i. e. {{uuid4()}})

  • unixtime: Returns a the current unixtime as float in seconds, (i. e. {{unixtime()}})

Fixed (vocabulary independent) variables:

  • row: The row (starting from 0) of the current dataset

  • id: The id or sequence number of the current dataset

  • guid: The representation of the id in a uuid-like fashion

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fakr-0.0.10.tar.gz (78.7 kB view details)

Uploaded Source

Built Distribution

fakr-0.0.10-py3-none-any.whl (78.6 kB view details)

Uploaded Python 3

File details

Details for the file fakr-0.0.10.tar.gz.

File metadata

  • Download URL: fakr-0.0.10.tar.gz
  • Upload date:
  • Size: 78.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for fakr-0.0.10.tar.gz
Algorithm Hash digest
SHA256 92f7b657232dc1ebce5a513382d01d231a2c5b7ab36c79c799ed46c60a6efd1b
MD5 a7801e549cf9acede3c0edfb0a548b96
BLAKE2b-256 fb1726b93ed726e1f78fafb93b43b5d9d6126117affad6b592d571a33c6f61a3

See more details on using hashes here.

File details

Details for the file fakr-0.0.10-py3-none-any.whl.

File metadata

File hashes

Hashes for fakr-0.0.10-py3-none-any.whl
Algorithm Hash digest
SHA256 1c3eaaae64cd32a9721f174f80238de2b70831258b261d397c0af52ad6147bce
MD5 a0012b00558fc868b8f1973666d31f33
BLAKE2b-256 fd988b5079392032184dd47b262b952aa9b0f4ae48cfae09cf528cf94f3899d8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page