Metadata-Version: 2.4
Name: byxlozax
Version: 1.0.0
Summary: Byxlozax Python tool license, live-control client, and local control server
Author: Byxlozax
Project-URL: Homepage, https://byxlozax.local
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Requires-Dist: fastapi>=0.111.0
Requires-Dist: uvicorn[standard]>=0.30.0
Requires-Dist: SQLAlchemy>=2.0.30
Requires-Dist: pydantic>=2.7.0
Requires-Dist: alembic>=1.13.2
Provides-Extra: dev
Requires-Dist: pytest<8.0.0,>=7.4.0; extra == "dev"
Requires-Dist: httpx>=0.27.0; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.1.0; extra == "dev"

# byxlozax

Byxlozax, Python tool projelerine tek `run()` çağrısı ile lisans doğrulama,
canlı oturum kontrolü, HWID, kaynak kod yedekleme, logout ve yerel kontrol
merkezi ekler.

## Quick Start

PowerShell:

```powershell
cd C:\Users\serhat\Desktop\Byxlozax
.\.venv\Scripts\activate
python -m byxlozax_server.cli run-api
```

Byxlozax Control adresi:

```text
http://127.0.0.1:8000
```

Yerel giriş:

```text
Username : admin2
Password : 123456
```

## Install

```powershell
pip install -e ".[dev]"
```

## Python Modül Kullanımı

```python
import byxlozax

byxlozax.run(
    tool_name="Checker Tool",
    version="1.0.0",
    owner_key="DEV-XXXX",
)

print("Korumalı tool kodu burada başlar.")
```

## Yerel Test Tool

Prompt olmadan hızlı test:

```powershell
python examples\test_api_tool.py
```

Etkileşimli örnek:

```powershell
python examples\example_tool.py
```

Sorulunca:

```text
Telegram: @xlozax
Key: DEMO-KEY-123
```

## Client API Endpointleri

- `POST /api/v1/auth`
- `POST /api/v1/ping`
- `POST /api/v1/logout`
- `POST /api/v1/source-backup`

Başarılı cevap:

```json
{"status": "ok", "allowed": true}
```

Kapatma cevabı:

```json
{"status": "close", "allowed": false, "reason": "session_killed", "message": ""}
```

## Byxlozax Control

Yerel kontrol merkezi FastAPI içinden servis edilir. Normal lokal kullanımda
ayrı npm süreci gerekmez.

```text
http://127.0.0.1:8000
```

## Telegram Worker

Bot token, aktif durum ve bot bilgi metni Byxlozax Control içinden kaydedilir.
`run-api` çalışınca yerel API arka planda Telegram worker başlatır. Aktif bot
config yoksa worker pasif bekler.

```powershell
python -m byxlozax_server.cli run-telegram-worker
```

Bağımsız worker komutu ayrı süreç için kullanılabilir.

Bot buttons:

- `Bilgi Al`
- `Modul Istiyorum`

`Modul Istiyorum` kullanıcıyı `@xlozax` hesabına yönlendirir.

## Yayın Hazırlığı

```powershell
python -m pytest -q
python -m build
python -m twine check dist/*
```

TestPyPI:

```powershell
python -m twine upload --repository testpypi dist/*
```

PyPI:

```powershell
python -m twine upload dist/*
```

## Supported Close Reasons

- `key_expired`
- `session_killed`
- `tool_disabled`
- `maintenance`
- `key_disabled`
- `version_blocked`
- `owner_inactive`
- `hwid_blocked`
- `device_limit`
- `ip_blocked`
- `server_error`

## Tests

```powershell
python -m pytest -q
```
