fastrand 3.0.5__cp38-cp38-macosx_10_9_x86_64.whl → 3.0.7__cp38-cp38-macosx_10_9_x86_64.whl

{fastrand-3.0.5.dist-info → fastrand-3.0.7.dist-info}/METADATA

@@ -1,22 +1,40 @@
 Metadata-Version: 2.1
 Name: fastrand
-Version: 3.0.5
+Version: 3.0.7
 Summary: Fast random number generation in Python
-Author: Daniel Lemire
-Author-email: daniel@lemire.me
+Author-email: Daniel Lemire <daniel@lemire.me>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/lemire/fastrand
+Project-URL: Repository, https://github.com/lemire/fastrand
+Project-URL: Issues, https://github.com/lemire/fastrand/issues
+Keywords: random,random-number-generator,pcg,xorshift,performance
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
 # fastrand
 
-Fast random number generation in an interval in Python using PCG: Up to 10x faster than random.randint.
+Fast random number generation in an interval in Python: Up to 10x faster than random.randint.
 
 Blog post: [Ranged random-number generation is slow in Python](https://lemire.me/blog/2016/03/21/ranged-random-number-generation-is-slow-in-python/)
 
 
 
 
-Usage... (don't forget to type the above lines in your shell!)
+Usage... 
 
 ```python
 import fastrand
@@ -27,6 +45,8 @@ print("generate an integer in [100,1000]")
 fastrand.pcg32randint(100,1000) # requires Python 3.7 or better
 print("Generate a random 32-bit integer.")
 fastrand.pcg32()
+print("Generate a number in [0,1).")
+fastrand.pcg32_uniform()
 
 if fastrand.SIXTYFOUR: # support for xorshift128+ is limited to some 64-bit platforms (linux, macos, etc.)
     print("generate an integer in [0,1001)")
@@ -35,8 +55,12 @@ if fastrand.SIXTYFOUR: # support for xorshift128+ is limited to some 64-bit plat
     fastrand.xorshift128plusrandint(100,1000) # requires Python 3.7 or better
     print("Generate a random 64-bit integer.")
     fastrand.xorshift128plus()
+    print("Generate a number in [0,1).")
+    fastrand.xorshift128plus_uniform()
 ```
 
+We also include functions for fast float generation.
+
 It is nearly an order of magnitude faster than the alternatives:
 
 ```
@@ -50,6 +74,7 @@ python3 -m timeit -s 'import fastrand' 'fastrand.pcg32randint(100,1000)'
 python3 -m timeit -s 'import random' 'random.randint(0,1000)'
 1000000 loops, best of 5: 216 nsec per loop
 
+# if you have numpy:
 python3 -m timeit -s 'import numpy' 'numpy.random.randint(0, 1000)'
 500000 loops, best of 5: 955 nsec per loop
 
@@ -59,36 +84,53 @@ The pcg32 generator is a 32-bit generator so it generates values in the interval
 The xorshift128+ generator is a 64-bit generator so that it can generate values in a 64-bit range (up to `2**64-1`).
 
 
+## Installation
+
 If you have Linux, macOS or Windows, you should be able to do just pip install...
 
-```
+```bash
 pip install fastrand
 ```
 
 You may need root access (sudo on macOS and Linux).
 
-It is sometimes useful to install a specific version, you can do so as follows;
+It is sometimes useful to install a specific version, you can do so as follows:
 
-```
+```bash
 pip install fastrand==1.2.4
 ```
 
+### Using uv (recommended)
+
+[uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver.
+
+To add fastrand as a dependency to your project:
+
+```bash
+uv add fastrand
+```
+
+Or to install it directly into your current environment:
 
+```bash
+uv pip install fastrand
+```
 
-Generally, you can build the library as follows (if you have root):
+### Building from source
 
+With uv:
 
 ```bash
-python setup.py build
-python setup.py install 
+uv build
+uv pip install dist/*.whl
 ```
 
-or
+Or with standard tools:
 
 ```bash
-python setup.py build
-python setup.py install --home=$HOME
-export PYTHONPATH=$PYTHONPATH:~/lib/python
+pip install build
+python -m build
+pip install dist/*.whl
 ```
 
 

fastrand-3.0.7.dist-info/RECORD

@@ -0,0 +1,6 @@
+fastrand.cpython-38-darwin.so,sha256=LC2Q7ttalxjYSQyL_IKqkiXdxJ4EjCQtAvskIi79INI,15152
+fastrand-3.0.7.dist-info/LICENSE,sha256=tAkwu8-AdEyGxGoSvJ2gVmQdcicWw3j1ZZueVV74M-E,11357
+fastrand-3.0.7.dist-info/METADATA,sha256=VPHHRYtv-5jM_L9-vOdT5GYDohnY0imPIaV-yCElvkg,4917
+fastrand-3.0.7.dist-info/WHEEL,sha256=Kx6RWhSVfL88-gHgRuuK5c46fDrxzStSDcWbfEAkrVo,108
+fastrand-3.0.7.dist-info/top_level.txt,sha256=hP1UU0jrDjL5G11OfRmlRKfqliLNNwcD51wtEzKsIlU,20
+fastrand-3.0.7.dist-info/RECORD,,

{fastrand-3.0.5.dist-info → fastrand-3.0.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.37.1)
+Generator: setuptools (75.3.2)
 Root-Is-Purelib: false
 Tag: cp38-cp38-macosx_10_9_x86_64
 

fastrand-3.0.7.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+fastrand
+wheelhouse

fastrand-3.0.5.dist-info/RECORD

@@ -1,6 +0,0 @@
-fastrand.cpython-38-darwin.so,sha256=hapTFVg1UEPk9jCKBujdk23yfxOuE-jHHxM1R_Z1LEI,14824
-fastrand-3.0.5.dist-info/LICENSE,sha256=tAkwu8-AdEyGxGoSvJ2gVmQdcicWw3j1ZZueVV74M-E,11357
-fastrand-3.0.5.dist-info/METADATA,sha256=owEgXbHVEfvtUClfdx2yyh7YvC0tm5BSb8gTr_2SYII,3597
-fastrand-3.0.5.dist-info/WHEEL,sha256=pXLpj1wTvqlD6RVUEKOuGQGeFX0NOPyDrsC-9xVDmYU,109
-fastrand-3.0.5.dist-info/top_level.txt,sha256=Z3tGZhQlNI6bOnJeYeHyE5sSKqud1hxYNfa7SX5Bm4U,9
-fastrand-3.0.5.dist-info/RECORD,,

fastrand-3.0.5.dist-info/top_level.txt

@@ -1 +0,0 @@
-fastrand