Metadata-Version: 2.4
Name: logsimulator
Version: 0.6.0
Summary: Generate realistic fake terminal activity.
Author: Kalinka
License-Expression: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# LogSimulator

> Fill your terminal with realistic fake logs, progress bars, and system activity.

LogSimulator is a lightweight Python CLI that simulates convincing terminal output. It generates infrastructure-style logs, progress bars, node health snapshots, connection attempts, alerts, and other activity to make your terminal appear busy.

Perfect for:

* Livestreams
* Recordings and demos
* Screenshots
* Conference presentations
* Harmless office humor

> **Note:** LogSimulator does **not** execute any real commands or perform any system operations. All output is randomly generated.

---

## Features

* Realistic timestamped log entries
* Progress bars
* Animated spinners
* Node health snapshots
* Connection and handshake simulations
* Random INFO/WARN alerts
* Colored status messages (PASSED/FAILED)
* Automatic screen clearing to simulate continuous activity
* Lightweight with no external dependencies

---

## Installation

### Using pipx (Recommended)

```bash
pipx run logsimulator
```

### Using pip

```bash
pip install logsimulator
```

Run:

```bash
logsimulator
```

### Using Docker

Run:

```bash
docker run --rm -it kalinkadev/logsimulator
```

---

## Example Output

```text
[14:03:12] Compiling modules... 37%
[14:03:13] INFO: Cache warmed
[14:03:14] Synchronizing cluster: [##########----------] 54%
[14:03:16] NODE HEALTH SNAPSHOT
node      cpu   mem   latency
api-01     31%   58%   23ms
db-02      77%   82%  131ms
worker-05  14%   40%   15ms

[14:03:18] Opening secure channel to cache-04
Handshake PASSED
```

---

## Requirements

* Python 3.9+
* Linux, macOS, or Windows
* ANSI-compatible terminal recommended for colored output

---

## Contributing

Issues, feature requests, and pull requests are welcome.

If you have ideas for additional fake terminal effects, feel free to open an issue or submit a PR.

---

## License

This project is licensed under the MIT License.
