https://github.com/paul-wolf/strgen

A Python module for a template language that generates randomized data
https://github.com/paul-wolf/strgen

character-set python random random-generation random-string randomizer regular-expression string-generator template-language

Last synced: 2 months ago
JSON representation

A Python module for a template language that generates randomized data

• Host: GitHub
• URL: https://github.com/paul-wolf/strgen
• Owner: paul-wolf
• License: bsd-3-clause
• Created: 2014-01-01T14:46:58.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2021-03-20T13:26:22.000Z (almost 4 years ago)
• Last Synced: 2024-10-06T18:18:13.360Z (3 months ago)
• Topics: character-set, python, random, random-generation, random-string, randomizer, regular-expression, string-generator, template-language
• Language: Python
• Size: 210 KB
• Stars: 34
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.txt
  • License: LICENSE

Awesome Lists containing this project

README

        
strgen

======

|Python package| |RTD build|

.. image:: https://img.shields.io/pypi/pyversions/StringGenerator?color=brightgreen

   :alt: PyPI - Python Version

.. image:: https://badge.fury.io/py/StringGenerator.svg

    :target: https://badge.fury.io/py/StringGenerator

    :alt: PyPi Version

      

Generate test data, unique ids, passwords, vouchers or other randomized

textual data very quickly using a template language. The template

language is superficially similar to regular expressions but instead of

defining how to match or capture strings, it defines how to generate

randomized strings. A very simple invocation to produce a random string

with word characters of 30 characters length:

.. code:: python

   from strgen import StringGenerator as SG

   SG(r"[\w]{30}").render()

   'wQjLVRIj1sjjslORpqLJyDObaCnDR2'

`Full documentation `__

The current package requires Python 3.6 or higher. Use version 0.3.4 or

earlier if you want to use Python 2.7 or an earlier Python 3 version.

NB: with version 0.4.2, the preferred method for generating a unique

list is ``StringGenerator.render_set()`` instead of ``render_list()``.

Generate 50000 unique secure tokens in a few seconds:

.. code:: python

   secure_tokens = SG("[\p\w]{32}").render_set(50000)

``render_set()`` does not support a progress callback.

There is a rich feature set to randomize strings in situ or include

external data.

The purpose of this module is to save the Python developer from having

to write verbose code around the same pattern every time to generate

passwords, keys, tokens, test data, etc. of this sort:

.. code:: python

   my_secret_key = ''.join(random.choice(string.ascii_uppercase + string.digits) for x in range(30))

that is:

1. Hard to read even at this simplistic level.

2. Hard to safely change quickly. Even modest additions to the

   requirements need unreasonably verbose solutions.

3. Doesn’t use safe encryption standards.

4. Doesn’t provide the implied minimal guarantees of character

   occurance.

5. Hard to track back to requirements (“must be between x and y in

   length and have characters from sets Q, R and S”).

The template uses short forms similar to those of regular expressions.

An example template for generating a strong password:

::

    [\w\p]{20}

will generate something like the following:

::

    P{:45Ec5$3)2!I68x`{6

Guarantee at least two “special” characters in a string:

::

    [\w\p]{10}&[\p]{2}

You can also generate useful test data, like fake emails with plenty of

variation:

::

    [\c]{10}.[\c]{5:10}@[\c]{3:12}.(com|net|org)

Requirements

------------

From version 0.4.0, support for Python 2 is dropped. If you still need

support for Python 2, use version 0.3.4.

There are no dependencies beyond the Python Standard Library.

Installation

------------

Install as standard for Python packages from PyPi:

.. code:: shell

   pip install StringGenerator

License

-------

Released under the BSD license.

Acknowledgements

----------------

Thanks to Robert LeBlanc who caught some important errors in escaping

special characters. Thanks to Andreas Motl for the progress counter.

Original Author: [email protected]

.. |Python package| image:: https://github.com/paul-wolf/strgen/actions/workflows/main.yml/badge.svg

   :target: https://github.com/paul-wolf/strgen/actions/workflows/main.yml

.. |RTD build| image:: https://readthedocs.org/projects/strgen/badge/?version=latest

   :target: https://strgen.readthedocs.io/en/latest/?badge=latest

   :alt: Documentation Status