Jyahd
Описание
Just yet another hardware database или сокращённо jyahd — сервис по сбору, обработке и предоставлению информации об используемом оборудовании, системном программном обеспечении и используемых настройках для каждого конкретного случая (пробы оборудования). В настоящее время автором сервиса и единственным его разработчиком является Сергей Котляров. Обо всех замеченных недочетах, ошибках, отсутствующих данных, предложениях по улучшению сервиса или по добавлению функционала сообщайте по указанным контактам, можно также сообщить на форум и вконтакте. Отслеживать стараюсь везде, но не всегда это оперативно может получится.
Информация для пользователей систем ALT Linux/BaseALT
Возможности сервиса
В данный момент для пользователей доступны следующие возможности:
1. Загрузка своих данных об оборудовании на сервис (подготовить и отправить данные можно с помощью пока единственной программы клиента hcl-get)
2. Получение информации об оборудовании и комментариях (в том числе и поиск по оборудованию и комментариям)
Информация для потенциальных разработчиков, программистов
Протокол взаимодействия программы клиента с сервером
Формат запросов, используемый сервисом jyahd, представляет из себя часть запрашиваемого url (называемую uri). Ответ сервера будет в большинстве случаев представлять из себя документ html, который, впрочем, может быть и пустым с точки зрения наличия в нём именно запрашиваемого содержимого. В дополнение к html документу как полезной нагрузке сервер также возвращает ответ в виде значений полей Link (соответствует нумерации проб) и Title (соответствует номерам проб, к которым запрашивается комментарий), если запрос касался формата проб и комментариев. Но сначала о формате запросов (uri).
Форматы запросов на получение данных проб и комментариев, а также логов
Для режима работы с данными проб и комментариями предназначен формат запросов типа GET и вида
архитектура_проба~комментарий
где "проба" и "комментарий" — числа, назначенные соответственно запрашиваемой пробе и пробе, к которой запрашивается комментарий, а архитектура соответствует одному из значений arch. В данном запросе номер получаемой пробы и номер пробы, для которой запрашивается комментарий, могут быть различными. Также имеется шаблон для получения содержимого всех проб и/или комментариев. Для этого следует вместо номера (числа) применить дефис (например, получить все пробы и все комментарии "-~-", получить все комментарии "~-" или все пробы "-"). Статистику по пробам и комментариям получить нетрудно, для этого нужно в запросе указать ноль вместо номера ("0" для проб, "~0" для комментариев, "0~0" для проб и комментариев). При этом ответ для запроса статистики придёт в формате, аналогичном запрошенному (к примеру, 57~12, что будет означать 57 проб и 12 комментариев, если запрашивается количество проб или количество комментариев, то ответ будет числом без знака "~").
Для режима работы с содержимым логов предназначен запрос вида
архитектура_проба.лог
где "лог" может отсутствовать и тогда результатом запроса архитектура_проба. будет список реально доступных для запроса лог файлов конкретной пробы.
Для любого из режимов если часть запроса архитектура_ не указана, то по умолчанию подразумевается раздел x86.
Формат ответа сервера на запросы по пробам, комментариям и логам
Как уже было сказано, сервер возвращает html документ, а также сигнализирует заголовками link и title в зависмости от того, с каким форматом из вышеописанных пришёл запрос. Если формат запроса касается содержимого проб и комментариев, а также логов, то заголовки link и title соответственно могут принимать следующие значения:
- f (found) — найдено
- np (not processed) — найдено, но данные не обработаны (находятся в очереди на обработку)
- nr (not requested) — не запрашивалось (для случая запроса, когда в запросе указывается только номер пробы или только номер пробы, для которой запрашивается комментарий)
- nf (not found) — не найдено
- wr (was removed) — было удалено
В настоящее время получить фильтрованный ответ (только информацию по пробе без оформления непосредственно веб страницы с результатом) можно, удалив из ответа всё, что не заключено в теги pre.
Всё, что описано выше, уже позволяет написать простой клиент, который будет получать данные о пробах, комментариях, лог файлах и обработав результат, показывать пользователю.
Формат запросов на поиск данных
Как вы уже наверное догадались, поиск осуществляется путем отправки запроса POST вида what=что_ищем&where=где_ищем. При этом где_ищем может быть одним из трёх: q, qr и qc для базы проб совместно с базой комментариев, только базы проб и только базы комментариев соответственно. В настоящее время получить фильтрованный ответ (только информацию по результатам поиска без оформления непосредственно веб страницы) можно, удалив из ответа всё, что не заключено в теги pre.
Возможности развития системы
1. Несмотря на то, что формат выводимых данных на сегодняшний момент неизменен, это всего лишь кажущееся постоянство. На самом деле формат выводимых данных может быть изменён вплоть до неузнаваемости. Но он не меняется по той простой причине, что нет предложений и запросов на изменение этого формата к виду, который может быть востребован. То есть, формат обсуждается и предложения по нему принимаются: как по форматированию, так и по объёму (по детальности).
2. Система накопления информации об оборудовании не содержит разбиения на категории (как это сделано в других подобных системах). Чтобы это можно было сделать, нужна реальная перспектива востребованности использования данной системы. А пока нет никаких признаков этого — нет и категорий. Другими словами, поиск по выводимой информации и так вам покажет искомый vid или pid в привязке к номерам проб. Для чего нужно разбиение на категории ? Только лишь для того, чтобы быть похожими на очередную базу которых в Сети есть ? Или, быть может, для того, чтобы рисовать диаграммы, показывающие процентовку от всего числа проб, содержащих то или иное конкретное железо ? Нет чётких и понятных критериев, для чего нужно разбиение на категории (и, самое главное, какой категории пользователей системы она нужна).
3. Самое главное, чего не хватает для активного существования имеющейся системы, это живого отклика тех, кому подобная система нужна для реального использования, а не просто затем, чтобы оно было.
4. Серверная часть имеет закрытый код (условно открытый можно сказать, разъяснения по части лицензирования были отправлены mike, как и одна из промежуточных версий исходников), но это связано с тем, что сама серверная часть написана на коленке, требует внимания к себе по части безопасности (с учетом того, что возможности системы по сбору проб не должны пострадать).
5. Разработка ведется старинными методами: код клиента доступен только в виде srpm (автор — чайник и не имеет желания и времени на создание чего-то вроде github аккаунта или нечто подобного), источник srpm - тема на форуме. Планируется доработать данную статью, чтобы из неё был понятен механизм ("протокол") взаимодействия клиента и сервера. Это позволит создать желающим свой клиент на языке программирования, который ближе потенциальному автору такого клиента, причём клиент можно сделать и графическим (я не планирую делать какой-либо графический инструмент, например, для загрузки и подготовки к последующей загрузке проб на сервис как, наверное, самый востребованный среди простых пользователей). Однако, в отсутствии решения по 3-му и 4-му пунктам система рискует остаться невостребованной.
6. Сама концепция сервиса позволяет расширять его функциональность в зависимости от реальных потребностей участников. Например, на базе сервиса можно относительно просто реализовать систему обмена сообщениями между участниками — теми, кто загружал на сервис пробы (фактически, это означает, что они на сервисе зарегистрировались). Возможен к реализации и любой другой функционал, который опирается на тот факт, что отправка пробы по сути есть регистрация на сервисе со всеми вытекающими.