semvec/pypi-packages huggingface dataset:
butterrand 0.0.1
Random number generator based on butterfly effect and chaotic maps
License: MIT
Requires Python: >=3.6

# 🦋 ButterRand

**ButterRand** là một thư viện Python sinh số ngẫu nhiên dựa trên **hiệu ứng cánh bướm (Butterfly Effect)** – một hiện tượng trong lý thuyết hỗn loạn, nơi các thay đổi nhỏ ban đầu có thể dẫn đến kết quả hoàn toàn khác biệt.

Thư viện này sử dụng các kỹ thuật như **logistic map**, **sine map** và các hàm gây nhiễu (`sin`, `cos`, `tan`,...) để tạo ra chuỗi số có tính hỗn loạn cao và cực kỳ khó dự đoán – phù hợp cho các mô phỏng phức tạp, các nghiên cứu khoa học, hoặc mục đích giáo dục.

---

## 🚀 Cài đặt

```bash
pip install butterrand
```

---

## 🧠 Ý tưởng phía sau

ButterRand dựa trên lý thuyết hệ động học hỗn loạn, cụ thể là hiệu ứng cánh bướm. Việc áp dụng **logistic map** và các hàm gây nhiễu phi tuyến tính giúp sinh ra chuỗi số không lặp lại theo kiểu cổ điển như các hàm ngẫu nhiên thông thường.

---

## 🔧 Cách sử dụng

```python
from butterrand import ButterflyRandom

# Tạo một đối tượng sinh số ngẫu nhiên
br = ButterflyRandom(
    seed="abc123",            # Chuỗi hoặc số
    mode="logistic",          # Có thể là "logistic" hoặc "sine"
    noise_function="sin",     # "sin", "cos", "tan", ...
    epsilon=1e-8              # Độ nhiễu nhỏ để tạo hỗn loạn
)

print(br.next_float())        # Số thực từ 0.0 đến 1.0
print(br.next_int(1, 100))    # Số nguyên từ 1 đến 99
```

---

## ⚙️ Tham số khởi tạo

| Tham số          | Kiểu dữ liệu       | Mô tả                                                                 |
|------------------|--------------------|----------------------------------------------------------------------|
| `seed`           | str, int, float    | Giá trị khởi tạo, đảm bảo tính nhất quán nếu cần                    |
| `mode`           | str                | `"logistic"` hoặc `"sine"`                                          |
| `noise_function` | str hoặc callable  | Các hàm toán học `"sin"`, `"cos"`, `"tan"` hoặc hàm người dùng tự định nghĩa |
| `epsilon`        | float              | Một số rất nhỏ để tạo ra sự thay đổi không đáng kể nhưng gây hỗn loạn lớn |

---

## 📦 Các hàm chính

| Hàm               | Mô tả                                                |
|------------------|------------------------------------------------------|
| `next_float()`   | Trả về số thực ngẫu nhiên trong khoảng (0.0, 1.0)    |
| `next_int(a, b)` | Trả về số nguyên ngẫu nhiên trong khoảng `[a, b)`    |

---

## 🧪 Ứng dụng

- Mô phỏng hỗn loạn (chaos simulation)
- Sinh dữ liệu mô phỏng (synthetic data)
- Thị giác máy tính, nghệ thuật số
- Giảng dạy và nghiên cứu về hệ động học hỗn loạn

⚠️ **Không nên sử dụng cho bảo mật thực tế.**

---

## 📁 MANIFEST.in

Đảm bảo thêm `README.md` vào gói khi đóng gói:

```text
include README.md
```

---

## 📄 Giấy phép

**MIT License** – miễn phí sử dụng, chia sẻ và sửa đổi.

---

## 👤 Tác giả

Phát triển bởi **Bùi Phong Phú**

---

> 🦋 "Một cái đập cánh của con bướm ở Brazil có thể gây ra cơn lốc xoáy ở Texas."  
> — Edward Lorenz (cha đẻ lý thuyết hỗn loạn)
spotify-cli-client 0.1.0
Simple Spotify Client
License: MIT
Requires Python: >=3.6

# 🎧 Spotify CLI Client

A powerful and interactive command-line interface to control your Spotify playback using Python and [Spotipy](https://spotipy.readthedocs.io/) with a beautiful TUI powered by [InquirerPy](https://github.com/kazhala/InquirerPy).

---

## 🚀 Features

- 🔍 **Search** for any track and play it instantly.
- 📚 View and play songs from your **personal playlists**.
- ⏯️ Full playback controls: `play`, `pause`, `next`, `prev`, `stop`.
- 🎛️ Intelligent **device selection**.
- ➕ Add tracks to **queue** while music is playing.
- 🔄 Option to **play full playlist** or individual tracks.
- 💾 Stores credentials in a local config file (`~/.spotifyclient/config.json`).

---

## 🛠️ Installation

```bash
pip3 install spotify-cli-client
```

---

## 🎹 Setup

Before using the CLI, set up your Spotify API credentials:

1. Go to [Spotify Developer Dashboard](https://developer.spotify.com/dashboard)
2. Create an app and get your `Client ID`, `Client Secret`, and `Redirect URI`.

Then run:

```bash
spt init
```

The CLI will prompt you to enter and save your credentials.

---

## 🧠 Usage

```bash
spt <command>
```

### Available Commands

| Command        | Description                         |
| -------------- | ----------------------------------- |
| `init`         | Interactive menu to access features |
| `my_playlists` | Browse and play from your playlists |
| `search`       | Search for a song and play it       |
| `play`         | Resume current playback             |
| `pause`        | Pause the current song              |
| `next`         | Skip to the next track              |
| `prev`         | Play the previous track             |
| `stop`         | Pause and reset playback            |

---

## 📁 Project Structure

```
spotify_cli_client/
├── __init__.py
├── cli.py              # CLI entry using Click
├── spotifyCLI.py       # Interactive CLI wrapper
└── spotifyClient.py    # Spotify API client logic
```

---

## 💡 Example

```bash
$ spt init

? Select a feature to use:
  ▸ My Playlists
    Search a Song
```

---

## 🤝 Contributing

PRs are welcome! Feel free to fork this repo and submit improvements, bugfixes, or new features.

---

## 📜 License

MIT License © 2025 [Sudharshan V](./LICENSE)

---

## 🔗 Credits

- [Spotipy](https://github.com/plamere/spotipy)
- [InquirerPy](https://github.com/kazhala/InquirerPy)
- [Click](https://click.palletsprojects.com/)