random-sum-generator 0.2.1

Generate random numbers that sum to a total with min/max bounds per part.

Random Sum Generator (RSG)

A hybrid Python module + Streamlit app that generates random integers or floats summing to a target value — with per-part constraints and visual output.

---

📦 Install from PyPI (coming soon)

pip install random_sum_generator

🧪 Example Usage

from random_sum_generator import RandomSumGenerator

gen = RandomSumGenerator()
print(gen.generate(total=100, parts=4, min_val=5, max_val=30, mode='int'))
print(gen.generate(100, 4, min_val=[10, 0, 5, 15], max_val=[30, 50, 25, 40], mode='float'))

🌐 Run the Streamlit App Locally

streamlit run streamlit_app.py

💡 Features

• Integer or float output
• Exact sum guarantee
• Per-part min/max control
• Safe resampling
• Debug logging

⚠️ Bound Constraints — Important Notes

To ensure generation is possible, these conditions must be met:

• parts * min_val ≤ total ≤ parts * max_val
• It's recommended that max_val > total / parts
• Very tight max values (like max_val = total / parts) will likely fail due to rounding and scaling

Example of what might fail:

gen.generate(total=100, parts=4, min_val=5, max_val=25)  # may fail due to tight upper bound

To fix:

gen.generate(total=100, parts=4, min_val=5, max_val=27)  # allows more flexibility