Metadata-Version: 2.1
Name: primegenerator
Version: 0.9.5
Summary: Fast primes generator and related functions.
Home-page: https://dev.azure.com/MusicalNinjas/MikesMath/_git/primes
Author: Mike Foster
Author-email: i.am.mike.foster@gmail.com
Project-URL: Info & Requests, https://dev.azure.com/MusicalNinjas/MikesMath
Classifier: Programming Language :: Python :: 3
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENCE

# Introduction 
Fast `primes` generator which caches previous results across instances.  
You usually don't need as many primes as the worst-case - eg for the included `lcm` (lowest common multiplier) function.

Also provides a very fast `sieve` if you wish to pre-calculate a large number of primes.

# Getting Started
Installation: `pip install primegenerator`

##Main usage:
    from primegenerator import primes
    primenums = primes()
    for prime in primenums:
        ... #do something
        if ... #beware this is an infinite generator!
            break

##Preseed - if you know you need all primes up to n:
    from primegenerator import primes
    n = 100 #somebignumber
    primenums = primes.preseed(n)
    for prime in primenums:
        ... #do something
        if ... #beware this is still an infinite generator and will keep going past the seed point!
            break

##Lowest common multiplier:
    from primegenerator import lcm
    numbers = [2,3,4]
    assert lcm(numbers) == 12

##Sieve:
    from primegenerator import primes
    listofprimes = primes.sieve(maxprime)

# Build and Test
Tests are written for pytest in `/tests/test_*.py`  
`pip -r tests/requirements.txt` for additional imports required for some tests.
Tests are available on the ADO repository (see link below)

`/dev` contains some useful stuff for debugging, profiling and further development and is only available on the ADO repository (see link below)

# Contribute
Code repository (ADO): https://dev.azure.com/MusicalNinjas/MikesMath/_git/primes
Homepage: https://dev.azure.com/MusicalNinjas/MikesMath

# Coming soon...
assert 31 in primenums
assert primenums[3] == 5
