StringGenerator 0.4.4__tar.gz → 0.5.1__tar.gz

stringgenerator-0.5.1/LICENSE

@@ -0,0 +1,29 @@
+Copyright (c) 2014, Yewleaf Ltd.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+
+* Neither the name of Yewleaf Ltd. nor the names of its contributors
+  may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

stringgenerator-0.5.1/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: StringGenerator
+Version: 0.5.1
+Summary: Generate randomized strings of characters using a template
+Home-page: https://github.com/paul-wolf/strgen
+Author: Paul Wolf
+Author-email: paul.wolf@yewleaf.com
+License: BSD
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+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 <https://strgen.readthedocs.io>`__
+
+The current package requires Python 3.7 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(r"[\p\w]{32}").render_set(50000)
+
+``render_set()`` does not support a progress callback.
+
+Performance and secure generation
+---------------------------------
+
+By default ``StringGenerator`` uses ``random.SystemRandom`` (cryptographically
+secure), which reads from the operating system entropy pool on every draw. That
+is the right default for passwords, keys and tokens, but the per-draw syscall
+makes very large batches slow.
+
+For large batches you have two faster options:
+
+- If you do **not** need cryptographic randomness (e.g. test data), pass a seed
+  or a plain ``random.Random`` to use the much faster Mersenne Twister:
+
+  .. code:: python
+
+     SG(r"[\d]{10}", seed=1).render_set(1_000_000)
+
+- If you **do** need cryptographic randomness, use ``BufferedSecureRandom``. It
+  draws the same ``os.urandom`` entropy as ``SystemRandom`` but reads it in bulk
+  to avoid a syscall per draw, making secure bulk generation many times faster.
+  It is reachable without an extra import:
+
+  .. code:: python
+
+     SG(r"[\w\p]{32}", randomizer=SG.BufferedSecureRandom()).render_set(50000)
+
+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: paul.wolf@yewleaf.com
+
+.. |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
+            

{StringGenerator-0.4.4 → stringgenerator-0.5.1}/README.rst

@@ -26,7 +26,7 @@ with word characters of 30 characters length:
 
 `Full documentation <https://strgen.readthedocs.io>`__
 
-The current package requires Python 3.6 or higher. Use version 0.3.4 or
+The current package requires Python 3.7 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
@@ -35,10 +35,36 @@ Generate 50000 unique secure tokens in a few seconds:
 
 .. code:: python
 
-   secure_tokens = SG("[\p\w]{32}").render_set(50000)
+   secure_tokens = SG(r"[\p\w]{32}").render_set(50000)
 
 ``render_set()`` does not support a progress callback.
 
+Performance and secure generation
+---------------------------------
+
+By default ``StringGenerator`` uses ``random.SystemRandom`` (cryptographically
+secure), which reads from the operating system entropy pool on every draw. That
+is the right default for passwords, keys and tokens, but the per-draw syscall
+makes very large batches slow.
+
+For large batches you have two faster options:
+
+- If you do **not** need cryptographic randomness (e.g. test data), pass a seed
+  or a plain ``random.Random`` to use the much faster Mersenne Twister:
+
+  .. code:: python
+
+     SG(r"[\d]{10}", seed=1).render_set(1_000_000)
+
+- If you **do** need cryptographic randomness, use ``BufferedSecureRandom``. It
+  draws the same ``os.urandom`` entropy as ``SystemRandom`` but reads it in bulk
+  to avoid a syscall per draw, making secure bulk generation many times faster.
+  It is reachable without an extra import:
+
+  .. code:: python
+
+     SG(r"[\w\p]{32}", randomizer=SG.BufferedSecureRandom()).render_set(50000)
+
 There is a rich feature set to randomize strings in situ or include
 external data.
 

stringgenerator-0.5.1/StringGenerator.egg-info/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: StringGenerator
+Version: 0.5.1
+Summary: Generate randomized strings of characters using a template
+Home-page: https://github.com/paul-wolf/strgen
+Author: Paul Wolf
+Author-email: paul.wolf@yewleaf.com
+License: BSD
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+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 <https://strgen.readthedocs.io>`__
+
+The current package requires Python 3.7 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(r"[\p\w]{32}").render_set(50000)
+
+``render_set()`` does not support a progress callback.
+
+Performance and secure generation
+---------------------------------
+
+By default ``StringGenerator`` uses ``random.SystemRandom`` (cryptographically
+secure), which reads from the operating system entropy pool on every draw. That
+is the right default for passwords, keys and tokens, but the per-draw syscall
+makes very large batches slow.
+
+For large batches you have two faster options:
+
+- If you do **not** need cryptographic randomness (e.g. test data), pass a seed
+  or a plain ``random.Random`` to use the much faster Mersenne Twister:
+
+  .. code:: python
+
+     SG(r"[\d]{10}", seed=1).render_set(1_000_000)
+
+- If you **do** need cryptographic randomness, use ``BufferedSecureRandom``. It
+  draws the same ``os.urandom`` entropy as ``SystemRandom`` but reads it in bulk
+  to avoid a syscall per draw, making secure bulk generation many times faster.
+  It is reachable without an extra import:
+
+  .. code:: python
+
+     SG(r"[\w\p]{32}", randomizer=SG.BufferedSecureRandom()).render_set(50000)
+
+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: paul.wolf@yewleaf.com
+
+.. |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
+            

stringgenerator-0.5.1/StringGenerator.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.rst
+pyproject.toml
+setup.py
+StringGenerator.egg-info/PKG-INFO
+StringGenerator.egg-info/SOURCES.txt
+StringGenerator.egg-info/dependency_links.txt
+StringGenerator.egg-info/top_level.txt
+strgen/__init__.py
+strgen/countries.py
+strgen/tests.py

stringgenerator-0.5.1/StringGenerator.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

stringgenerator-0.5.1/StringGenerator.egg-info/top_level.txt

@@ -0,0 +1 @@
+strgen

stringgenerator-0.5.1/pyproject.toml

@@ -0,0 +1,36 @@
+# pyproject.toml
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+norecursedirs = [".venv", ".hypothesis"]
+addopts = "-ra -q"
+testpaths = [
+    "strgen/tests.py",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py37"
+exclude = [
+    ".venv",
+    "docs/_build",
+    "profile",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "B", "C90"]
+ignore = [
+    "E203",
+    "E266",
+    "E501",
+    "F403",
+    "F401",
+    "C901",
+    "E731",
+]
+
+[tool.ruff.lint.mccabe]
+max-complexity = 18

stringgenerator-0.5.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

{StringGenerator-0.4.4 → stringgenerator-0.5.1}/setup.py

@@ -2,7 +2,7 @@
 import io
 import codecs
 import os.path
-from distutils.core import setup
+from setuptools import setup
 
 current_dir = os.path.abspath(os.path.dirname(__file__))
 
@@ -30,6 +30,7 @@ with io.open("README.rst", encoding="utf-8") as file:
 setup(
     name="StringGenerator",
     long_description=long_description,
+    long_description_content_type="text/x-rst",
     description=DESCRIPTION,
     version=VERSION,
     url="https://github.com/paul-wolf/strgen",
@@ -39,15 +40,18 @@ setup(
         "strgen",
     ],
     license="BSD",
+    python_requires=">=3.7",
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
         "License :: OSI Approved :: BSD License",
         "Programming Language :: Python",
-        "Programming Language :: Python :: 3.6",
         "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
         "Topic :: Software Development :: Libraries :: Python Modules",
     ],
 )