## One-line code snippet (for quick gist):

for email in emails: print(email) </code></pre> <h3>CLI mode</h3> <pre><code class="language-bash">python generate.py --email johnsmith@gmail.com --count 15 --output emails.txt </code></pre> <h2>Example Output</h2> <pre><code>johnsmith+shop1@gmail.com john.smith+test42@gmail.com j.o.h.n.smith+newsletter@gmail.com johnsmith+temp_2025@gmail.com ... </code></pre> <h2>Use Cases</h2> <ul> <li>Testing email sign-up flows</li> <li>Avoiding spam on forums/trials</li> <li>Organizing incoming mail by plus-tag</li> <li>Load testing email systems</li> </ul> <h2>Limitations</h2> <ul> <li>Only works with <strong>@gmail.com</strong> addresses</li> <li>Some websites block plus-addressed emails</li> <li>Not a true "disposable email" service (inbox remains same)</li> </ul> <h2>License</h2> <p>MIT</p> <pre><code> ---

# Generate 20 unique emails emails = gen.generate(count=20, use_plus=True, use_dots=True)

emails = [f"{base}+{tag}{random.randint(1,99)}{domain}" for tag in tags] print("\n".join(emails)) </code></pre> <hr>

gen = GmailGenerator("johnsmith@gmail.com")

```python import random, string base = "johnsmith" domain = "@gmail.com" tags = ["test", "temp", "news", "shop", "work"]