Протокол

[kemal]

В этой теме будет публиковаться протокол для централизации репозитория и для настольной версии. Разработка тут же.

Текущая версия: показать

Пока пусто

[kemal]

Очевидно, что это будет что-то поверх http. Можно, конечно, "в лучших традициях веб-разработок" использовать xml-rpc, да какой-то гдамоздкий он... По мне так можно вообще в бинарном виде, тем более при разборе файлов всё равно всё бинарное. С другой стороны, стандарт открытый, так что надо бы пожалеть сторонних разработчиков. Вобщем, кто что думает?
Что на данный момент предполагается включить в протокол:

• Авторизация (для возможности аплоада прямо из проги)
• Запрос списка авторов (для "индексации" центральным посиковиком)
• Скачивание ассета
• Загрузка ассета (сборка и разборка cdp предполагается на стороне клиента)

[CПЕKTP]

Клиент собственно - своя программа или можно КМП доработать рашпилем?

[kemal]

В cmp лезть ну ОЧЕНЬ не охота, так что это будет своя прога. Но с интеграцией через trainzutil.

[CПЕKTP]

Хм, это как?

[kemal]

Для тех, кто ещё не в теме:

Код: Выделить всё

C:Documents and SettingskemalРабочий стол>D:TS2010binTrainzUtil.exe
Welcome to the Trainz Util Tool!
This is a simple command line tool to perform several content management functions to install/delete/modify assets.
----------------------------------------------------------
TrainzUtil help - Display this help text.
TrainzUtil version - Display the TrainzUtil build version.
TrainzUtil echo <text> - Echo the supplied text.
TrainzUtil setlanguage <langCode> - Set the Trainz language to the language code supplied (eg. US, FR, RU, etc).
TrainzUtil installCDP <PATH> - Install an asset from a CDP file.
TrainzUtil installfrompath <PATH> - Install an asset from a directory.
TrainzUtil installfromdls <KUID> - Install an asset from the Auran Download Station.
TrainzUtil edit <KUID> - Open an asset for editing.
TrainzUtil printconfig <KUID> - Print a config file to stdout.
TrainzUtil backupkeywords - Backup all the keywords of your assets.
TrainzUtil importkeywords - Import keywords into the Trainz Asset Database.
TrainzUtil commit <KUID> - Commit any edits that have been made to the specified asset.
TrainzUtil revert <KUID> - Discard any edits that have been made to the specified asset.
TrainzUtil delete <KUID> - Delete the specified asset from disk.
TrainzUtil generateKUID - Generate a new KUID number in the local user's KUID range.
TrainzUtil createCDP <Output Filename.cdp> <kuid1> <kuid2> <kuidX> ... - Export assets to a CDP file.
TrainzUtil repairdatabase - Repairs the Trainz Asset Database.
TrainzUtil authors - List of all the authorIDs that have content in the game.
TrainzUtil searchbycategory [-a] <CatgoryList>  - List all the local assets with a category set in this format, "CMP;MESH|BD;-ACTV|VE|SCEN". Use the -a parameter if you want to search the download station as well.
TrainzUtil importconsists <PATH> - Import an old style Surveyor consist list, creating consist assets for any unknown entries.
TrainzUtil status <KUID> - Print the status of the specified asset.
   This will output <KUID> : <Flags> : <category> : <username> where flags are a series of letters with case indicating boolean state. (Capital letters are flagged true and lowercase are flagged false.)
   Ee - The asset is open for edit.
   Ii - The asset is installed locally.
   Aa - The asset is archived.
   Dd - The asset is on the download station.
   Ll - The asset is locally modified.
   Mm - The asset has missing dependencies.
   Ff - The asset is faulty.
TrainzUtil validate <KUID> - Perform validation and display any errors or warnings relating to this asset.
TrainzUtil compile <PATH> - Compile a script file.
   <-d>       Display gamescript documentation.
   <-s>       Silent mode.
   <-bPATH>   Specify a filepath for the compile log.
   <-pPATH>   Specify the output directory.
   <-oPATH>   Specify the output library filename.
   <PATH>     Input source file.
   <-iPATH>   Additional include path.
TrainzUtil encrypt <PATH> - Encrypt a script file (gs --> gse).
TrainzUtil listbuilds <PATH> - Print the list of installed build numbers to a fileTrainzUtil @<file.txt> - Batch-execute a series of commands from the specified text file (every argument must be between double quotes.) Every line of that text file will be processed like a separate call to TrainzUtil.


И вообще, есть у кого какие мысли по протоколу? Прогу будем в отдельной теме обсуждать, когда до неё руки дойдут...

[CПЕKTP]

Хм, я даже не подозревал о свойствах сей утилиты)
Прога, кстати, на сях будет?

[kemal]

До неё ещё дожить надо! Но да, с высокой вероятностью на сях. (если меня опять ностальгия не замучает и я не засяду за делфи...)

[kemal]

имхо, если делать протокол бинарным, то есть смысл его структуру сделать аналогичной структуре файла cdp.

[CПЕKTP]

СДП неплохо ужимает объем, я думаю, стоит попробовать!