Getting a random integer in Python is a common task for simulations, games, and data experiments. The standard library provides clear tools so you can generate numbers quickly and reliably.
Whether you need a single value or a reproducible sequence, the language design makes it straightforward to control range and distribution.
| Function | Module | Description | Typical Use Case |
|---|---|---|---|
| randint | random | Returns both endpoints, inclusive | Dice rolls, small bounded choices |
| randrange | random | Supports step, excludes stop | Skipping values, custom increments |
| choice | random | Picks a random element from a sequence | Selecting items from lists |
| SystemRandom | random | Security-sensitive tokens or keys |
Understanding the random Module
The random module is part of the Python standard library, so no external installation is required. It uses a Mersenne Twister generator that is sufficient for modeling, testing, and non-cryptographic tasks.
Before generating numbers, you often create a generator instance or rely on the module-level functions that use a hidden shared instance. This keeps code simple while allowing advanced control when needed.
Using randint for Inclusive Range Selection
Syntax and Parameters
randint(a, b) accepts two integers and returns a value N such that a
Common Use Cases
Use randint when every value in the range must be possible, such as simulating dice, card ranks, or quick prototyping of randomized decisions. Each call produces a new independent sample from the uniform distribution.
Controlling Steps with randrange
Skipping and Striding
randrange lets you define start, stop, and step, mirroring slice behavior. The stop value is still excluded, which gives finer control over allowed outcomes.
Performance Considerations
For very large ranges, randrange is efficient because it computes an index mathematically instead of building a list. It avoids unnecessary memory use while keeping the interface familiar.
Secure and Non-Deterministic Options
SystemRandom for Cryptography
SystemRandom draws from operating system entropy and is suitable for tokens, session IDs, or lottery-style selection where predictability must be minimized.
Seeding for Reproducibility
Calling seed with a fixed integer ensures the same sequence of random numbers across runs. This is invaluable for debugging, testing, and sharing experiments with colleagues.
Best Practices and Recommendations
- Pick the right tool: randint for inclusive ranges, randrange for steps and exclusion of the upper bound.
- Use SystemRandom when unpredictability matters, such as for cryptographic keys or session identifiers.
- Set a fixed seed only for testing; avoid it in production to preserve randomness.
- Prefer a dedicated Random instance instead of the global state when your program has multiple random generators.
- Remember that random outputs are not suitable for security, simulations requiring high-quality entropy, or financial modeling without additional safeguards.
FAQ
Reader questions
How do I generate a random integer between 1 and 10 in Python?
Import random and call random.randint(1, 10), which includes both 1 and 10 as possible results.
What is the difference between randint and randrange?
randint includes the stop value, while randrange excludes the stop and supports a step parameter for custom increments.
Can I create a random number generator without affecting the global state?
Yes, instantiate random.Random() to get an independent generator object and call its methods instead of the module-level functions.
How do I pick a secure random integer for security tokens?
Use random.SystemRandom().randint(a, b) to draw from OS-level entropy rather than the deterministic Mersenne Twister.