EOF-413-LGH 1.0.0__tar.gz

eof_413_lgh-1.0.0/EOF_413_LGH.egg-info/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: EOF_413_LGH
+Version: 1.0.0
+Summary: Библиотека для работы с GitHub API.
+Home-page: https://github.com/EOF-413/LibraryGitHub
+Author: EOF-413
+Author-email: org.animea@mail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: EOF_413_LLS>=1.1.0
+Requires-Dist: EOF_413_LH>=1.0.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# LibraryGitHub (LGH)
+
+**LGH** - это библиотека для работы с GitHub API. Позволяет искать репозитории, связанные с основным репозиторием, и скачивать файлы.
+
+## Особенности
+
+- Поиск репозиториев, связанных с основным репозиторием (по ссылке в описании)
+- Получение информации о файлах в корне репозитория
+- Получение ссылки на последний релиз с ZIP-ассетом
+- Интеграция с LibraryHttp (LH)
+- Интеграция с LibraryLogSystem (LLS)
+
+## Установка
+
+```py
+from LGH import Github
+```
+
+## Использование
+
+### Поиск связанных репозиториев
+
+# Поиск репозиториев, связанных с основным
+
+```py
+from LGH import Github
+
+repos = Github.search('https://github.com/owner/main-repo')
+
+# Поиск с ограничением количества
+repos = Github.search('https://github.com/owner/main-repo', per_page=50)
+```
+
+### Скачивание файлов из репозитория
+
+```py
+from LGH import Github
+
+# Скачивание файла из корня репозитория
+file_content = Github.download('owner', 'repo', 'manifest.json')
+
+if file_content:
+    with open('manifest.json', 'wb') as f:
+        f.write(file_content)
+```
+
+### Получение информации о файлах
+
+```py
+from LGH import Github
+
+repos = Github.search('https://github.com/owner/main-repo')
+
+for name, info in repos.items():
+    print(f"Репозиторий: {name}")
+    print(f"Разработчик: {info['DEV']}")
+    print(f"Ссылка: {info['LINK']}")
+    
+    if info['FILES']:
+        print("Файлы:")
+        for key, value in info['FILES'].items():
+            print(f"  {key}: {value}")
+    
+    if info['RELEASE']:
+        print(f"Релиз: {info['RELEASE']}")
+```
+
+## API
+
+### Github.search()
+
+```py
+Github.search(main_repo=None, per_page=100)
+```
+
+Ищет репозитории, связанные с основным репозиторием.
+
+Параметры:
+
+```PY
+- main_repo (str): URL основного репозитория (по умолчанию: None)
+- per_page (int): Количество результатов на страницу (по умолчанию: 100)
+```
+
+Возвращает:
+
+```PY
+- dict: Словарь с информацией о найденных репозиториях
+```
+
+Исключения:
+
+```py
+- GithubError: Ошибка при поиске или загрузке
+```
+
+### Github.download()
+
+```py
+Github.download(owner, repo, filename)
+```
+
+Скачивает файл из корня репозитория.
+
+Параметры:
+
+```py
+- owner (str): Владелец репозитория
+- repo (str): Название репозитория
+- filename (str): Имя файла
+```
+
+Возвращает:
+
+```py
+- bytes: Содержимое файла или None если файл не найден
+```
+
+## Формат возвращаемых данных
+
+```json
+{
+    "NameOfRepo": {
+        "DEV": ["Developer 1", "Developer 2"],
+        "LINK": "https://github.com/owner/NameOfRepo",
+        "FILES": {
+            "EXE": "main.exe",
+            "MAN": "manifest.json",
+            "ICO": "icon.ico"
+        },
+        "RELEASE": "https://github.com/owner/NameOfRepo/releases/download/v1.0/asset.zip"
+    }
+}
+```
+
+## Логирование
+
+Все операции логируются через LLS в logs/GitHub/:
+
+```log
+[25.07.2026 21:59:18] [INFO] [repository.py] [search] [45] -> Найдено репозиториев, связанных с [owner/main-repo]: 5.
+[25.07.2026 21:59:18] [ERROR] [repository.py] [search] [30] -> Не удалось найти репозитории: 404 Not Found
+```
+
+## Структура логов
+
+```text
+logs/
+└── GitHub/
+    ├── debug/
+    ├── info/
+    │   └── 21.59.18_25.07.2026.log
+    ├── warnings/
+    ├── errors/
+    │   └── 21.59.18_25.07.2026.log
+    └── critical/
+```
+
+## Зависимости
+
+[LibraryHttp (LH)](https://github.com/EOF-413/LibraryHttp)
+[LibraryLogSystem (LLS)](https://github.com/EOF-413/LibraryLogSystem)

eof_413_lgh-1.0.0/EOF_413_LGH.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+EOF_413_LGH.egg-info/PKG-INFO
+EOF_413_LGH.egg-info/SOURCES.txt
+EOF_413_LGH.egg-info/dependency_links.txt
+EOF_413_LGH.egg-info/requires.txt
+EOF_413_LGH.egg-info/top_level.txt
+LGH/__init__.py
+LGH/repository.py

eof_413_lgh-1.0.0/EOF_413_LGH.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

eof_413_lgh-1.0.0/EOF_413_LGH.egg-info/requires.txt

@@ -0,0 +1,2 @@
+EOF_413_LLS>=1.1.0
+EOF_413_LH>=1.0.1

eof_413_lgh-1.0.0/EOF_413_LGH.egg-info/top_level.txt

@@ -0,0 +1 @@
+LGH

eof_413_lgh-1.0.0/LGH/__init__.py

@@ -0,0 +1,5 @@
+from .repository import Github
+
+__all__ = [
+    'Github'
+]

eof_413_lgh-1.0.0/LGH/repository.py

@@ -0,0 +1,141 @@
+import json
+import urllib.error
+import urllib.parse
+
+from LH import Http
+from LLS import log_init
+
+log = log_init('modules/GitHub')
+
+API_ROOT = 'https://api.github.com'
+
+
+class GithubError(Exception):
+    pass
+
+
+class Github:
+    """
+    Общая библиотека поиска репозиториев, связанных с главным репозиторием.
+    Связь определяется по ссылке на главный репозиторий в "О нас" - "Иконка настроек" - "Описание".
+
+    Пример "О нас:
+                    AmazingMultiTool - программа, созданная соединить все бот-программы в одно удобное приложение,
+                    Наш основной репозиторий: https://github.com/EOF-413/AmazingMultiTool!"
+    """
+
+    @staticmethod
+    def search(main_repo=None, per_page=100):
+        """
+        Возвращает словарь:
+        {
+            "NameOfRepo": {
+                "DEV": ["DEV 1", "DEV 2", "DEV 3", "..."],
+                "LINK": "https://github.com/owner/NameOfRepo",
+                "FILES": {"EXE": "main.exe", "MAN": "manifest.json", "ICO": "icon.ico"},
+                "RELEASE": "https://.../asset.zip"  # None, если релиза с zip-ассетом нет
+            }
+        }
+        """
+
+        if main_repo is None:
+            raise GithubError('Не был передан основной репозиторий.')
+
+        main_repo = main_repo.rstrip('/').replace('https://github.com/', '')
+
+        query = urllib.parse.quote(f'"https://github.com/{main_repo}" in:description', safe='')
+
+        try:
+            data = Http.get_json(f'{API_ROOT}/search/repositories?q={query}&per_page={per_page}')
+        except urllib.error.HTTPError as e:
+            log.error(f"Не удалось найти репозитории, связанные с [{main_repo}]: {e}")
+            raise GithubError(f'Не удалось загрузить список репозиториев: {e}')
+        except (urllib.error.URLError, json.JSONDecodeError) as e:
+            log.error(f"Не удалось найти репозитории, связанные с [{main_repo}]: {e}")
+            raise GithubError(f'Не удалось загрузить список репозиториев: {e}')
+
+        items = data.get('items', [])
+        count = data.get('total_count', len(items))
+        if count > len(items):
+            log.warning(f"Найдено {count} репозиториев, обработано {len(items)} (ограничение: {per_page}.).")
+
+        dependents = {}
+        for repo in items:
+            owner = repo['owner']['login']
+            name = repo['name']
+
+            dependents[name] = {
+                'DEV': [owner],
+                'LINK': repo.get('html_url', f'https://github.com/{owner}/{name}'),
+                'FILES': Github._scan(owner, name),
+                'RELEASE': Github._latest(owner, name),
+            }
+
+        log.info(f"Найдено репозиториев, связанных с [{main_repo}]: {len(dependents)}.")
+        return dependents
+
+    @staticmethod
+    def download(owner, repo, filename):
+        """Скачивает файл из корня репозитория (ветка по умолчанию). None, если не удалось."""
+        try:
+            data = Http.get_json(f'{API_ROOT}/repos/{owner}/{repo}/contents/{filename}')
+        except urllib.error.HTTPError as e:
+            log.debug(f"Не удалось получить [{filename}] из {owner}/{repo}: {e}")
+            return None
+        except (urllib.error.URLError, json.JSONDecodeError) as e:
+            log.debug(f"Не удалось получить [{filename}] из {owner}/{repo}: {e}")
+            return None
+
+        download_url = data.get('download_url')
+
+        if not download_url:
+            return None
+
+        try:
+            return Http.get(download_url)
+        except urllib.error.URLError as e:
+            log.debug(f"Не удалось скачать [{filename}] из {owner}/{repo}: {e}")
+            return None
+
+    @staticmethod
+    def _scan(owner, repo):
+        try:
+            items = Http.get_json(f'{API_ROOT}/repos/{owner}/{repo}/contents/')
+        except urllib.error.HTTPError as e:
+            log.debug(f"Не удалось получить список файлов {owner}/{repo}: {e}")
+            return {}
+        except (urllib.error.URLError, json.JSONDecodeError) as e:
+            log.debug(f"Не удалось получить список файлов {owner}/{repo}: {e}")
+            return {}
+
+        files = {}
+        for item in items:
+            if item.get('type') != 'file':
+                continue
+            name = item.get('name', '')
+            lower = name.lower()
+            if lower.endswith('.exe') and 'EXE' not in files:
+                files['EXE'] = name
+            elif lower == 'manifest.json':
+                files['MAN'] = name
+            elif lower == 'icon.ico':
+                files['ICO'] = name
+        return files
+
+    @staticmethod
+    def _latest(owner, repo):
+        try:
+            release = Http.get_json(f'{API_ROOT}/repos/{owner}/{repo}/releases/latest')
+        except urllib.error.HTTPError as e:
+            log.debug(f"Нет релизов у {owner}/{repo}: {e}")
+            return None
+        except (urllib.error.URLError, json.JSONDecodeError) as e:
+            log.debug(f"Не удалось получить релиз {owner}/{repo}: {e}")
+            return None
+
+        assets = release.get('assets', [])
+        zip_assets = [a for a in assets if a.get('name', '').lower().endswith('.zip')]
+        if not zip_assets:
+            log.error(f"В последнем релизе {owner}/{repo} нет zip-ассета.")
+            return None
+        return zip_assets[0]['browser_download_url']

eof_413_lgh-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EOF-413
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eof_413_lgh-1.0.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: EOF_413_LGH
+Version: 1.0.0
+Summary: Библиотека для работы с GitHub API.
+Home-page: https://github.com/EOF-413/LibraryGitHub
+Author: EOF-413
+Author-email: org.animea@mail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: EOF_413_LLS>=1.1.0
+Requires-Dist: EOF_413_LH>=1.0.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# LibraryGitHub (LGH)
+
+**LGH** - это библиотека для работы с GitHub API. Позволяет искать репозитории, связанные с основным репозиторием, и скачивать файлы.
+
+## Особенности
+
+- Поиск репозиториев, связанных с основным репозиторием (по ссылке в описании)
+- Получение информации о файлах в корне репозитория
+- Получение ссылки на последний релиз с ZIP-ассетом
+- Интеграция с LibraryHttp (LH)
+- Интеграция с LibraryLogSystem (LLS)
+
+## Установка
+
+```py
+from LGH import Github
+```
+
+## Использование
+
+### Поиск связанных репозиториев
+
+# Поиск репозиториев, связанных с основным
+
+```py
+from LGH import Github
+
+repos = Github.search('https://github.com/owner/main-repo')
+
+# Поиск с ограничением количества
+repos = Github.search('https://github.com/owner/main-repo', per_page=50)
+```
+
+### Скачивание файлов из репозитория
+
+```py
+from LGH import Github
+
+# Скачивание файла из корня репозитория
+file_content = Github.download('owner', 'repo', 'manifest.json')
+
+if file_content:
+    with open('manifest.json', 'wb') as f:
+        f.write(file_content)
+```
+
+### Получение информации о файлах
+
+```py
+from LGH import Github
+
+repos = Github.search('https://github.com/owner/main-repo')
+
+for name, info in repos.items():
+    print(f"Репозиторий: {name}")
+    print(f"Разработчик: {info['DEV']}")
+    print(f"Ссылка: {info['LINK']}")
+    
+    if info['FILES']:
+        print("Файлы:")
+        for key, value in info['FILES'].items():
+            print(f"  {key}: {value}")
+    
+    if info['RELEASE']:
+        print(f"Релиз: {info['RELEASE']}")
+```
+
+## API
+
+### Github.search()
+
+```py
+Github.search(main_repo=None, per_page=100)
+```
+
+Ищет репозитории, связанные с основным репозиторием.
+
+Параметры:
+
+```PY
+- main_repo (str): URL основного репозитория (по умолчанию: None)
+- per_page (int): Количество результатов на страницу (по умолчанию: 100)
+```
+
+Возвращает:
+
+```PY
+- dict: Словарь с информацией о найденных репозиториях
+```
+
+Исключения:
+
+```py
+- GithubError: Ошибка при поиске или загрузке
+```
+
+### Github.download()
+
+```py
+Github.download(owner, repo, filename)
+```
+
+Скачивает файл из корня репозитория.
+
+Параметры:
+
+```py
+- owner (str): Владелец репозитория
+- repo (str): Название репозитория
+- filename (str): Имя файла
+```
+
+Возвращает:
+
+```py
+- bytes: Содержимое файла или None если файл не найден
+```
+
+## Формат возвращаемых данных
+
+```json
+{
+    "NameOfRepo": {
+        "DEV": ["Developer 1", "Developer 2"],
+        "LINK": "https://github.com/owner/NameOfRepo",
+        "FILES": {
+            "EXE": "main.exe",
+            "MAN": "manifest.json",
+            "ICO": "icon.ico"
+        },
+        "RELEASE": "https://github.com/owner/NameOfRepo/releases/download/v1.0/asset.zip"
+    }
+}
+```
+
+## Логирование
+
+Все операции логируются через LLS в logs/GitHub/:
+
+```log
+[25.07.2026 21:59:18] [INFO] [repository.py] [search] [45] -> Найдено репозиториев, связанных с [owner/main-repo]: 5.
+[25.07.2026 21:59:18] [ERROR] [repository.py] [search] [30] -> Не удалось найти репозитории: 404 Not Found
+```
+
+## Структура логов
+
+```text
+logs/
+└── GitHub/
+    ├── debug/
+    ├── info/
+    │   └── 21.59.18_25.07.2026.log
+    ├── warnings/
+    ├── errors/
+    │   └── 21.59.18_25.07.2026.log
+    └── critical/
+```
+
+## Зависимости
+
+[LibraryHttp (LH)](https://github.com/EOF-413/LibraryHttp)
+[LibraryLogSystem (LLS)](https://github.com/EOF-413/LibraryLogSystem)

eof_413_lgh-1.0.0/README.md

@@ -0,0 +1,162 @@
+# LibraryGitHub (LGH)
+
+**LGH** - это библиотека для работы с GitHub API. Позволяет искать репозитории, связанные с основным репозиторием, и скачивать файлы.
+
+## Особенности
+
+- Поиск репозиториев, связанных с основным репозиторием (по ссылке в описании)
+- Получение информации о файлах в корне репозитория
+- Получение ссылки на последний релиз с ZIP-ассетом
+- Интеграция с LibraryHttp (LH)
+- Интеграция с LibraryLogSystem (LLS)
+
+## Установка
+
+```py
+from LGH import Github
+```
+
+## Использование
+
+### Поиск связанных репозиториев
+
+# Поиск репозиториев, связанных с основным
+
+```py
+from LGH import Github
+
+repos = Github.search('https://github.com/owner/main-repo')
+
+# Поиск с ограничением количества
+repos = Github.search('https://github.com/owner/main-repo', per_page=50)
+```
+
+### Скачивание файлов из репозитория
+
+```py
+from LGH import Github
+
+# Скачивание файла из корня репозитория
+file_content = Github.download('owner', 'repo', 'manifest.json')
+
+if file_content:
+    with open('manifest.json', 'wb') as f:
+        f.write(file_content)
+```
+
+### Получение информации о файлах
+
+```py
+from LGH import Github
+
+repos = Github.search('https://github.com/owner/main-repo')
+
+for name, info in repos.items():
+    print(f"Репозиторий: {name}")
+    print(f"Разработчик: {info['DEV']}")
+    print(f"Ссылка: {info['LINK']}")
+    
+    if info['FILES']:
+        print("Файлы:")
+        for key, value in info['FILES'].items():
+            print(f"  {key}: {value}")
+    
+    if info['RELEASE']:
+        print(f"Релиз: {info['RELEASE']}")
+```
+
+## API
+
+### Github.search()
+
+```py
+Github.search(main_repo=None, per_page=100)
+```
+
+Ищет репозитории, связанные с основным репозиторием.
+
+Параметры:
+
+```PY
+- main_repo (str): URL основного репозитория (по умолчанию: None)
+- per_page (int): Количество результатов на страницу (по умолчанию: 100)
+```
+
+Возвращает:
+
+```PY
+- dict: Словарь с информацией о найденных репозиториях
+```
+
+Исключения:
+
+```py
+- GithubError: Ошибка при поиске или загрузке
+```
+
+### Github.download()
+
+```py
+Github.download(owner, repo, filename)
+```
+
+Скачивает файл из корня репозитория.
+
+Параметры:
+
+```py
+- owner (str): Владелец репозитория
+- repo (str): Название репозитория
+- filename (str): Имя файла
+```
+
+Возвращает:
+
+```py
+- bytes: Содержимое файла или None если файл не найден
+```
+
+## Формат возвращаемых данных
+
+```json
+{
+    "NameOfRepo": {
+        "DEV": ["Developer 1", "Developer 2"],
+        "LINK": "https://github.com/owner/NameOfRepo",
+        "FILES": {
+            "EXE": "main.exe",
+            "MAN": "manifest.json",
+            "ICO": "icon.ico"
+        },
+        "RELEASE": "https://github.com/owner/NameOfRepo/releases/download/v1.0/asset.zip"
+    }
+}
+```
+
+## Логирование
+
+Все операции логируются через LLS в logs/GitHub/:
+
+```log
+[25.07.2026 21:59:18] [INFO] [repository.py] [search] [45] -> Найдено репозиториев, связанных с [owner/main-repo]: 5.
+[25.07.2026 21:59:18] [ERROR] [repository.py] [search] [30] -> Не удалось найти репозитории: 404 Not Found
+```
+
+## Структура логов
+
+```text
+logs/
+└── GitHub/
+    ├── debug/
+    ├── info/
+    │   └── 21.59.18_25.07.2026.log
+    ├── warnings/
+    ├── errors/
+    │   └── 21.59.18_25.07.2026.log
+    └── critical/
+```
+
+## Зависимости
+
+[LibraryHttp (LH)](https://github.com/EOF-413/LibraryHttp)
+[LibraryLogSystem (LLS)](https://github.com/EOF-413/LibraryLogSystem)

eof_413_lgh-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

eof_413_lgh-1.0.0/setup.py

@@ -0,0 +1,33 @@
+from setuptools import setup, find_packages
+
+with open('README.md', encoding='utf-8') as f:
+    long_description = f.read()
+
+setup(
+    name='EOF_413_LGH',
+    version='1.0.0',
+    author='EOF-413',
+    author_email='org.animea@mail.com',
+    description='Библиотека для работы с GitHub API.',
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    url='https://github.com/EOF-413/LibraryGitHub',
+    packages=find_packages(),
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Operating System :: OS Independent',
+        'Intended Audience :: Developers',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+    ],
+    python_requires='>=3.6',
+    install_requires=[
+        'EOF_413_LLS>=1.1.0',
+        'EOF_413_LH>=1.0.1'
+    ],
+)