Metadata-Version: 2.4
Name: govnoscript
Version: 1.2.1
Summary: A simple scripting language for computer control
License: MIT
Author: dertfin1
Author-email: dertfin@gmail.com
Requires-Python: >=3.11
Classifier: License :: OSI Approved :: MIT License
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-Dist: keyboard (>=0.13.5,<0.14.0)
Requires-Dist: pyautogui (>=0.9.54,<0.10.0)
Description-Content-Type: text/markdown

# GovnoScript
GovnoScript - Python-библиотека для быстрого создания скриптов автоматизации управления компьютером

Установка:
```commandline
pip install govnoscript
```

## Написание скриптов
Чтобы начать писать на GovnoSript, нужно создать файл с расширением `.govno`.
Его можно открыть в текстовом редакторе и начать писать свой скрипт. 

### Синтаксис GovnoScript

`MOVETO x y time` - передвинуть курсор мыши в точку с координатами `(x;y)` за время `time`. Чтобы передвинуть курсор мыши моментально,
укажите 0. Чтобы указать дробное число, используйте точку

`CLICK mouse_button` - нажать на одну из основных кнопок мыши: 
- `LEFT`
- `MIDDLE`
- `RIGHT`

`WRITE delay SOME TEXT` - напечатать текст на клавиатуре. `delay` - время между нажатием каждой клавиши. Текст может содержать пробелы

`WRITE_BY_KEYBOARD delay SOME TEXT` - аналог `WRITE`, который иммитирует нажатие и отпускание каждой клавиши

`WAIT time` - пауза между командами. `time` - время в секундах, может быть дробным числом

`PRESS key` - зажать кнопку `key`. Здесь могут быть специальные клавиши

`RELEASE key` - отпустить зажатую через `PRESS` кнопку `key`

`# Some text` - комментарий. Пишется строго на отдельной строке.

`%var%` - переменная `var`. Задается при запуске

## Запуск скрипта
Есть два способа запустить скрипт - по названию файла или списком из команд:

```python
import govnoscript

govnoscript.run("script.govno", script_vars={
    "var" : "Значение переменной var"
}) # Запускает скрипт, написанный в файле
# script_vars - необязательный параметр
govnoscript.interpret([
    "WAIT 5", # Ждет 5 секунд после запуска
    "WRITE 0 Hello world!" # Моментально напечатает Hello World!
])
```
