From 01781f727f1af85177446327c5f82fd1b3394d85 Mon Sep 17 00:00:00 2001 From: Vladimir Hodakov Date: Thu, 17 Apr 2025 14:14:36 +0400 Subject: [PATCH] Open source the tool --- LICENSE | 25 +++++++++++++++++++++---- USAGE.md | 48 +++++++++++++++++++++++++----------------------- go.mod | 2 +- 3 files changed, 47 insertions(+), 28 deletions(-) diff --git a/LICENSE b/LICENSE index e3c1309..577e4e1 100644 --- a/LICENSE +++ b/LICENSE @@ -1,4 +1,21 @@ -Copyright (c) 2012-2022 Vladimir "fat0troll" Hodakov -All Rights Reserved. -Unauthorized copying of this file, via any medium is strictly prohibited. -Proprietary and confidential. +MIT License + +Copyright (c) 2012-2025 Vladimir Hodakov + +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. diff --git a/USAGE.md b/USAGE.md index 239652c..1424aa1 100644 --- a/USAGE.md +++ b/USAGE.md @@ -1,12 +1,12 @@ # NNM-Club Uploaders Tools -Данная программа предназначена для загрузки торрент-файлов из разделов форума NNM-Club. Использование этой программы -разрешено только действующим участникам релиз-группы Uploaders. Если вы не принадлежите к их числу, удалите программу -немедленно! +Данная программа предназначена для загрузки торрент-файлов из разделов форума NNM-Club. +Использование данной программы разрешено только при соблюдении правил торрент-трекера, и автор не несёт ответственнои за +нецелевое или вредоносное использование данного исходного кода! ## Как использовать GUI-версию -GUI для данной программы пока отсутствует, но планируется до конца года. +GUI для данной программы отсутстует. ## Как использовать консольную версию @@ -14,9 +14,9 @@ GUI для данной программы пока отсутствует, но архитектуре процессора в папку, в которой вы планируете запускать программу, после чего откройте программу командной строки. -* Для Windows это может быть cmd.exe, Windows PowerShell или Windows Terminal -* Для Linux — терминал из поставки вашего DE, или же просто голая консоль -* Для macOS — Terminal.app или iTerm2 +- Для Windows это может быть cmd.exe, Windows PowerShell или Windows Terminal +- Для Linux — терминал из поставки вашего DE, или же просто голая консоль +- Для macOS — Terminal.app или iTerm2 Перейдите в папку, в которой у вас появился файл `massdl` (или `massdl.exe` в случае Windows). Обычно для перехода в папку нужно выполнить команду `cd /путь/к/папке/` (или `cd буква_диска:\путь\к\папке` в случае Windows). @@ -30,9 +30,9 @@ GUI для данной программы пока отсутствует, но Приложение попросит вас последовательно ввести следующие данные: -* Домен NNM-Club: текущий домен, на котором работает форум. -* Имя пользователя: ваше имя пользователя. -* Пароль: ваш пароль. +- Домен NNM-Club: текущий домен, на котором работает форум. +- Имя пользователя: ваше имя пользователя. +- Пароль: ваш пароль. После ввода всех данных приложение попробует авторизоваться на сайте, и сообщит, смогло ли оно это сделать. Если оно не смогло войти на сайт — повторите запуск `./massdl -auth`, убедившись, что вы вводите правильный пароль, а сервер форума @@ -43,13 +43,13 @@ GUI для данной программы пока отсутствует, но ### Скачивание торрентов Для скачивания торрентов запустите команду `./massdl -forum <номер_форума>`, в которой `<номер_форума>` — число без -кавычек, которое видно в адресной строке, если открыть этот форум. К примеру, для форума "Native *Nix Games", чей +кавычек, которое видно в адресной строке, если открыть этот форум. К примеру, для форума "Native \*Nix Games", чей адрес https://nnmclub.ro/forum/viewforum.php?f=1193, номер форума равен 1193. Расширенная опция `-outputDir` позволяет указать конкретную папку, в которой будет создана папка с торрент-файлами. По умолчанию папка с торрент-файлами создаётся рядом с файлом `massdl`/`massdl.exe`. -Пример: чтобы скачать форум "Native *Nix Games", а торрент-файлы из него появились на рабочем столе в Windows, программу +Пример: чтобы скачать форум "Native \*Nix Games", а торрент-файлы из него появились на рабочем столе в Windows, программу следует вызвать следующим образом: ```sh @@ -60,18 +60,18 @@ GUI для данной программы пока отсутствует, но Для любой версии этой программы верны следующие особенности: -* Программа работает по методу best effort: к сожалению, так как в её основе парсинг HTML, нет 100% гарантии, что будут +- Программа работает по методу best effort: к сожалению, так как в её основе парсинг HTML, нет 100% гарантии, что будут скачаны все торрент-файлы. Однако, даётся гарантия, что будут обнаружены все топики указанного форума, и в логах можно будет посмотреть, с какими из них возникли проблемы. -* При сетевых ошибках программа пытается повторить запрос 5 раз, после чего прекращает попытки. -* Вне зависимости от указанного пути сохранения торрентов будет создана поддиректория с названием, равным номеру форума, +- При сетевых ошибках программа пытается повторить запрос 5 раз, после чего прекращает попытки. +- Вне зависимости от указанного пути сохранения торрентов будет создана поддиректория с названием, равным номеру форума, в которой будут лежать все торренты. -* Торренты в директории сортируются по дате последнего обновления. -* Топики, не проверенные модераторами, игнорируются. -* Подфорумы игнорируются — для них следует запускать программу ещё раз с номером подфорума. -* Скачивание нескольких форумов за раз не поддерживается. -* К сожалению, пока что логи не сохраняются на диск. -* В конце работы показывается суммарный объём свободного места на жёстком диске, который необходим для скачивания всех +- Торренты в директории сортируются по дате последнего обновления. +- Топики, не проверенные модераторами, игнорируются. +- Подфорумы игнорируются — для них следует запускать программу ещё раз с номером подфорума. +- Скачивание нескольких форумов за раз не поддерживается. +- К сожалению, пока что логи не сохраняются на диск. +- В конце работы показывается суммарный объём свободного места на жёстком диске, который необходим для скачивания всех торрентов, полученных в ходе сеанса работы программы. Указанные выше особенности могут быть исправлены/пересмотрены в будущем. @@ -79,5 +79,7 @@ GUI для данной программы пока отсутствует, но ## Багрепортинг и фичреквестинг Единственное место, где принимаются сообщения об ошибках в программе и пожелания по её улучшению — топик на форуме -NNM-Club. Подобные запросы в личные сообщения форума будут игнорироваться, а за пределами форума — приводить к потере -возможности коммуницировать с автором. Автор обязуется обрабатывать сообщения в теме форума хотя бы раз в месяц. +NNM-Club. Подобные запросы в личные сообщения форума, в трекер Issues исходного кода и так далее будут игнорироваться, а за пределами форума — приводить к потере +возможности коммуницировать с автором. + +На данный момент поддержка тулзы осуществляется по методу best effort и не гарантируется. diff --git a/go.mod b/go.mod index f002b10..9218f71 100644 --- a/go.mod +++ b/go.mod @@ -1,6 +1,6 @@ module lab.hodakov.me/fat0troll/uploader_tools -go 1.17 +go 1.24 require ( github.com/PuerkitoBio/goquery v1.5.0