Чистый неподкупный рабочий код 2-й лабораторной

bogdanov_dmitry_lab_2/README.md

@@ -0,0 +1,41 @@
+# Лабораторная работа №2
+
+## Богданов Дмитрий ПИбд-42
+
+### Для выполнения была проделана следующая работа:
+Были написаны и развернуты 3 сервиса: генератор файлов, 2 приложения для работы с этими файлами по вариантам 2 и 1 соответственно:
+
+Вариант 2 (для первого приложения):
+
+```Формирует файл /var/result/data.txt из первых строк всех файлов каталога /var/data.```
+
+Вариант 1 (для второго приложения):
+
+```Формирует файл /var/result/data.txt из первых строк всех файлов каталога /var/data.```
+
+Приложения работают совместно, используя общий монтированный том как источник информации:
+```
+    volumes:
+      - ./data:/var/data
+```
+```    
+    volumes:
+      - ./data:/var/data
+      - ./result:/var/result 
+```
+```
+    volumes:
+      - ./result:/var/result
+```
+
+
+### Запуск лабораторной:
+Необходимо перейти в папку с файлом docker-compose.yaml и ввести следующую команду:
+```
+docker compose up --build
+```
+Сервис генератора сгенерирует папки data и result, где будут сгенерированы входные файлы и файл-результат их обработки соответственно.
+
+## Видео с результатом запуска: 
+
+Видео-демонстрацию работы можно посмотреть по данной [ссылке](https://drive.google.com/file/d/1CmVZjJuMStqNFFKbsMLjw4ihTiMnR7it/view).

bogdanov_dmitry_lab_2/app-1/app.py

@@ -1,21 +1,29 @@
 import os
 
-# Variant 2
+# Вариант 2 - Формирует файл /var/result/data.txt из первых строк всех файлов каталога /var/data.
 def solve(dir_files, dir_result, filename_result):
+    # Получаем список файлов в директории
     filenames = os.listdir(dir_files)
     result = ''
+    # Проходим через каждый файл
     for filename in filenames:
         filepath = os.path.join(dir_files, filename)
         file = open(filepath, "r")
+        # Читаем первую строку, добавляем к результату
         result += f"{file.readline()}"
         file.close()
 
+    # Если директории для сохранения результата нет - создаём
     if not os.path.exists(dir_result):
         os.makedirs(dir_result)
+    # Если директория с результатом не пустая - завершаем работу
     if os.listdir(dir_result):
         return
-    result_file = open(os.path.join(dir_result, filename_result), "w")
+    # Пишем результат в файл
+    filepath_result = os.path.join(dir_result, filename_result)
+    result_file = open(filepath_result, "w")
     result_file.write(result)
+    print(f"Результат записан в файл {filepath_result}")
     result_file.close()
 
 if __name__ == "__main__":

bogdanov_dmitry_lab_2/app-2/app.py

@@ -1,14 +1,20 @@
 import os
 
-# Variant 1
+# Вариант 1 - Ищет набольшее число из файла /var/data/data.txt и сохраняет его вторую степень в /var/result/result.txt.
 def solve(dir_input, dir_result, filename_result):
     file_input = open(os.path.join(dir_input, 'data.txt'))
-
+    # Считываем все числа из файла
     inputs = [int(line) for line in file_input.readlines()]
     if inputs:
+        # Максимальное число
+        max_num = max(inputs)
+        print(f"Наибольшее число: {max_num}")
+        # Возводим во 2 степень
         result = max(inputs) ** 2
         file_result = open(os.path.join(dir_result, filename_result), "w")
+        # Пишем результат в файл
         file_result.write(str(result))
+        print(f"Получен результат {result}")
         file_result.close()
 
 if __name__ == "__main__":

bogdanov_dmitry_lab_2/app-generator/generator.py

@@ -2,22 +2,26 @@ import os
 import random as rnd
 import string
 
-
+# Генератор названий файлов
 def generate_filename(l):
     return ''.join(rnd.choices(string.ascii_lowercase + string.digits, k=l)) + '.txt'
 
 def generate_files(dir, num_files, num_lines):
+    # Если директории для сохранения файлов нет - создаём
     if not os.path.exists(dir):
         os.makedirs(dir)
 
+    # Если директория для сохранения файлов не пустая - завершаем работу
     if os.listdir(dir):
         return
 
+    # Создание файлов
     for i in range(num_files):
         filename = generate_filename(20)
         filepath = os.path.join(dir, filename)
 
         file = open(filepath, "w")
+        # Запись строк в файл
         for j in range(num_lines):
             file.write(f"{rnd.randint(-1000, 1000)}\n")
         file.close()

bogdanov_dmitry_lab_2/docker-compose.yaml

@@ -1,20 +1,23 @@
 services:
+  # Генератор файлов
   generator:
     build:
-      context: ./app-generator
+      context: ./app-generator # Путь к контексту (докер файл + скрипт)
     volumes:
-      - ./data:/var/data
+      - ./data:/var/data # Папка контейнера : папка локальная
-    entrypoint: python generator.py
+    entrypoint: python generator.py # Точка входа
 
+  # Первое приложение
   app1:
     build:
-      context: ./app-1
+      context: ./app-1 # Путь к контексту
     volumes:
-      - ./data:/var/data
+      - ./data:/var/data # Монтирование папок
       - ./result:/var/result
     depends_on:
-      - generator
+      - generator # Указываем, что запускается только после успешной работы сервиса generator
 
+  # Второе приложение, настройка аналогична сервисам выше
   app2:
     build:
       context: ./app-2