Что такое формат файла KGL?
Файл .kgl - это скомпилированная библиотека для языка программирования KAGSA, интерпретируемого языка, построенного на Python и распространяемого под лицензией MIT. Разработчики пишут код Kagsa в исходных файлах .kg и упаковывают переиспользуемые функции в библиотеку .kgl, чтобы другие программы могли их вызывать.
По сути, файл .kgl - это архив .zip, которому присвоено другое расширение. Он всегда содержит как минимум два файла Python: main.py (скомпилированная точка входа) и __memory__.py (хранит данные пространства имен библиотеки). Любые дополнительные вспомогательные модули упаковываются вместе с ними. Поскольку контейнером является стандартный ZIP, файл начинается со знакомой сигнатуры PK.
Безопасность и защита
РИСК: MEDIUMA .kgl is a ZIP archive containing executable Python code that the Kagsa interpreter runs when the library is imported. Extracting the archive is safe, but importing or running a library from an untrusted source executes its code, so only use .kgl files you trust.
Детали формата
в двух словахПОЛНОЕ НАЗВАНИЕKagsa Libraryтакже известен как Kagsa compiled library, KAGSA library archive
РАЗРАБОТЧИКKagsa (KAGSA project)с 2022
КАТЕГОРИЯФайлы разработчика
MIME-ТИПapplication/zip
ТИПCompiled library archive (ZIP container)
Это расширение также используется в…
- kglab / kgl (Python graph library) - The 'kgl' name is also used by DerwenAI's kglab knowledge-graph package, but it does not define a .kgl file type.
- kgl.exe (generic executable) - Various unrelated Windows programs ship an executable named kgl.exe; unrelated to the Kagsa library format.
MAGIC BYTES · СИГНАТУРА ФАЙЛА
СМЕЩЕНИЕ
00010203
HEX
504B0304
ASCII
PK··
A .kgl file is a renamed ZIP archive, so it carries the standard ZIP local-file-header signature PK\x03\x04. Empty or spanned archives use PK\x05\x06 or PK\x07\x08.
Программы, открывающие файлы KGL
Windows3 apps
WinRAR
Платно Point WinRAR at the file (rename to .zip if needed) to browse and unpack the ZIP contents of the library. 
7-Zip
Открытый код Open the .kgl directly or rename a copy to .zip, then extract main.py and __memory__.py to read the packaged Python code. 
Kagsa
Открытый код Install Kagsa, then import the library from a .kg program or inspect it with the interpreter; this is the native tool for running .kgl code. 
macOS2 apps
The Unarchiver
Бесплатно Rename a copy to .zip and open it to extract the bundled .py files for inspection.
Kagsa
Открытый код Install via pip install kagsa and use the interpreter to import and run the library in your Kagsa project. 
Linux2 apps
unzip
Открытый код Run unzip lib.kgl (or copy to lib.zip first) to list and extract main.py and __memory__.py.
Kagsa
Открытый код Install with pip install kagsa or the official Linux installer, then reference the library from a .kg source file. 
Android1 app
Kagsa on Termux
Открытый код Install Kagsa inside Termux and run or import the library from the command line on Android. Технические подробности
глубокая спецификация| Encoding | Binary (ZIP archive) |
| Byte order | Little-endian (ZIP fields) |
| Container | ZIP archive with the .kgl extension instead of .zip |
| Compression | Standard ZIP compression (DEFLATE or stored), inherited from the ZIP container |
| Encryption | None by default; a KGL is a plain archive with no built-in encryption |
| Typical size | A few kilobytes to a few hundred kilobytes, depending on the amount of compiled code |
| Structure | A ZIP archive holding the Python files produced when a Kagsa source library is compiled. It always contains main.py (the compiled library entry point) and __memory__.py (the library's stored state/namespace data), plus any additional helper .py files. |
| Integrity | CRC-32 per entry, provided by the ZIP format |
| Platforms | Windows, Linux, Termux (Android), macOS |
| Notes | Generated by the Kagsa interpreter with the command kagsa -l lib.kg -o lib.kgl. The input must be a .kg source file and the output name must end in .kgl. Because it is just a renamed ZIP, renaming a copy to .zip lets any archiver inspect the contents. |
| Produced By | kagsa command-line interpreter |
| Consumed By | Kagsa runtime when a .kg program imports the library |
| Выпущен | 2022 |
| Последняя версия | Kagsa 1.2.0 (2023) |
| Спецификация | www.kagsa.org |
Конвертации KGL
Возможно
Вопросы и ответы сообщества
спрошено пользователямиВопросов пока нет - станьте первым, кто спросит о файлах KGL.
Часто задаваемые вопросы
Что такое файл .kgl?
Это скомпилированная библиотека для языка программирования KAGSA. Она упаковывает файлы Python (main.py и __memory__.py) в ZIP-архив, чтобы программа Kagsa могла вызывать функции библиотеки.
Как открыть файл .kgl?
Установите бесплатный интерпретатор Kagsa для использования в проекте или переименуйте копию в .zip и откройте с помощью 7-Zip, WinRAR или unzip, чтобы увидеть файлы .py внутри.
Как создать библиотеку .kgl?
Скомпилируйте исходный файл Kagsa командой kagsa -l lib.kg -o lib.kgl. Входной файл должен иметь расширение .kg, а выходной - .kgl.
Является ли файл .kgl обычным ZIP-файлом?
Да. Он использует стандартное сжатие ZIP и сигнатуру PK; отличается только расширение. Поэтому архиваторы могут открыть его после переименования в .zip.
Что находится внутри файла .kgl?
Как минимум main.py (точка входа скомпилированной библиотеки) и __memory__.py (данные состояния/пространства имен библиотеки), а также любые дополнительные вспомогательные файлы Python.
Можно ли конвертировать .kgl обратно в исходный код Kagsa?
Нет. В архиве хранится скомпилированный Python, а не оригинальный исходный код .kg, поэтому восстановить читаемый код Kagsa невозможно.
Ссылки
1KAGSA on GitHubgithub.com
2KAGSA official documentationwww.kagsa.org
