oomol-v2ex-lottery

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

oomol-v2ex-lottery

★ 7 Open GitHub ↗

V2EX Lottery in OOMOL Studio(https://oomol.com/)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align=center>
  <h1>V2EX Lottery Block</h1>
  <p>
    <a href="https://github.com/BlackHole1/oomol-v2ex-lottery/blob/main/LICENSE" target="_blank"><img src="https://img.shields.io/github/license/BlackHole1/oomol-v2ex-lottery" alt="license" /></a>
  </p>
  <p><a href="https://hub.oomol.com/package/v2ex-lottery?open=true" target="_blank"><img src="https://static.oomol.com/assets/button.svg" alt="Open in OOMOL Studio" /></a></p>
</div>

A powerful and easy-to-use lottery block for V2EX community posts. Perfect for conducting fair and transparent giveaways, contests, or random selections from V2EX post replies.

## ✨ What This Block Does

The V2EX Lottery block automatically:
- 📥 **Fetches all replies** from any V2EX post using the post ID
- 🔍 **Removes duplicates** - each user can only win once, even if they replied multiple times
- 🚫 **Excludes specific users** - easily filter out specific usernames if needed
- 🎲 **Randomly selects winners** using a fair shuffling algorithm (shuffled 10 times for better randomness)
- 📋 **Returns a clean list** of winner usernames

![](https://raw.githubusercontent.com/BlackHole1/oomol-v2ex-lottery/main/statics/example-result.png)

## 🚀 How to Use

### Quick Start
1. **Get your V2EX token**: Visit [V2EX Settings → Tokens](https://v2ex.com/settings/tokens) to generate your personal access token
2. **Find the post ID**: The number in the V2EX post URL (e.g., `https://v2ex.com/t/123456` → ID is `123456`)
3. **Use the block**: Add it to your workflow and configure the parameters

### Block Parameters

| Parameter | Type | Description | Required | Example |
|-----------|------|-------------|----------|---------|
| **topicID** | Integer | The ID number of the V2EX post | ✅ Yes | `123456` |
| **excludes** | Array of Strings | Usernames to exclude from the lottery | ❌ Optional | `["admin", "moderator"]` |
| **count** | Integer | Number of winners to select | ✅ Yes | `3` |
| **token** | Secret | Your V2EX personal access token | ✅ Yes | `your_secret_token` |

### Output
- **output**: `Array<String>` - A list of winning usernames

## 📝 Example Scenarios

### Scenario 1: Simple Giveaway
You posted a giveaway on V2EX and want to randomly pick 5 winners:
- **topicID**: `987654` (your post ID)
- **excludes**: `[]` (empty - include everyone)
- **count**: `5`
- **token**: Your V2EX token

### Scenario 2: Contest with Exclusions  
You want to pick 3 winners but exclude yourself and moderators:
- **topicID**: `987654`
- **excludes**: `["YourUsername", "moderator1", "admin"]`
- **count**: `3`
- **token**: Your V2EX token

## 🎯 Key Features

- **Fair & Transparent**: Uses proven shuffling algorithms for truly random selection
- **Duplicate Protection**: Automatically removes duplicate entries from the same user
- **Flexible Exclusions**: Easily exclude specific users (organizers, sponsors, etc.)
- **Progress Tracking**: Shows real-time progress while fetching replies
- **Error Handling**: Robust error handling for network issues or invalid tokens
- **Visual Results**: Displays winners in an easy-to-read format

## 🔐 Security & Privacy

- **API-Based**: Uses official V2EX REST API - no scraping or unauthorized access
- **Token Security**: Your V2EX token is stored securely as a secret
- **Read-Only**: Only reads public post data - never modifies or posts anything
- **Rate Limited**: Respects V2EX API limits with controlled request rates

## 🛠 Technical Details

- **Runtime**: Node.js/TypeScript
- **Dependencies**: Minimal - only uses `p-limit` for controlled concurrency
- **Timeout**: 12 seconds maximum execution time
- **Concurrency**: Limited to 10 concurrent requests to respect API limits
- **Randomization**: Fisher-Yates shuffle algorithm applied 10 times

## 📱 Integration

### Available Workflows

#### Lottery Flow
![](https://raw.githubusercontent.com/BlackHole1/oomol-v2ex-lottery/main/statics/flow-lottery.png)

A complete workflow that includes:
- Input collection for post ID, exclusions, and winner count
- V2EX Lottery block execution
- Results display

Perfect for one-click lottery execution with customizable parameters.

## 🤝 Contributing

This is an open-source project. Feel free to contribute improvements, report issues, or suggest new features on GitHub.

## 📄 License

This project is licensed under the terms specified in the LICENSE file.

---

**Ready to run your first V2EX lottery?** 
[Open in OOMOL Studio](https://hub.oomol.com/package/v2ex-lottery?open=true) and get started in seconds!

oomol-v2ex-lottery

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README