Metadata-Version: 2.4
Name: desklab
Version: 0.1.4
Summary: Simple and easy to use interface package
Author: Jonatas Cortes
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pygame==2.6.1
Requires-Dist: pynput==1.8.1
Requires-Dist: pyobjc-core==12.1; sys_platform == "darwin"
Requires-Dist: pyobjc-framework-ApplicationServices==12.1; sys_platform == "darwin"
Requires-Dist: pyobjc-framework-Cocoa==12.1; sys_platform == "darwin"
Requires-Dist: pyobjc-framework-CoreText==12.1; sys_platform == "darwin"
Requires-Dist: pyobjc-framework-Quartz==12.1; sys_platform == "darwin"
Requires-Dist: pyperclip==1.11.0
Requires-Dist: six==1.17.0

![DeskLab-banner](./desklab_banner.png)

DeskLab is a Python interface library designed for small projects that prioritize fast development over extensive customization.

It simulates the web development programing style, with separation of responsibilities and reusable components.

## 🛠️ Installation & Development Setup

If you want to clone this repository to contribute to the code, run tests, or develop features locally, follow the steps below using **`uv`**, a fast Python package installer and environment manager.


### Windows

Open **PowerShell** and run:

```powershell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```

Alternative:

```powershell
winget install astral-sh.uv
```

---

### Linux / macOS

Open a terminal and run:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Alternative on macOS using Homebrew:

```bash
brew install uv
```

Alternative on Linux using pip:

```bash
pip install uv
```

After installation, restart your terminal so the `uv` command becomes available.

Verify installation:

```bash
uv --version
```

---

### Clone the Repository

Clone the project and enter its directory:

```bash
git clone https://github.com/your-username/desklab.git
cd desklab
```

---

### Install Dependencies & Create Environment

You do **not** need to manually create a virtual environment or run `pip install`.

Simply execute:

```bash
uv sync
```

This command automatically:

- Creates a local virtual environment (`.venv/`)
- Installs all project dependencies
- Installs desklab in editable mode
- Synchronizes dependencies from `pyproject.toml`

---

### Running the Project

Run your application inside the managed environment:

```bash
uv run <your_file>.py
```

This guarantees execution inside the project's environment and avoids dependency conflicts.

---
