Как создавал директорию

Создание директорий в контексте автоматизации тестирования

Как QA Engineer с опытом в автоматизации, я рассматриваю создание директорий не как простой технический шаг, а как часть стратегии управления тестовыми артефактами и обеспечения изолированности тестовых окружений. В зависимости от языка, инструментов и целей, подходы различаются.

Основные методы и инструменты

В автоматизации я чаще всего использую следующие методы:

1. Нативные операции файловой системы через стандартные библиотеки языка (например, os в Python, java.nio.file в Java, fs в Node.js).
2. Выполнение shell-команд через команды языка (например, subprocess в Python или Runtime.exec() в Java) — иногда необходимо для сложных операций.
3. Специализированные библиотеки и фреймворки, такие как tempfile для создания временных директорий или методы в pytest для управления тестовыми директориями.

Примеры кода в разных языках

Python (самый частый вариант в моей практике)

import os
import shutil
from pathlib import Path  # Современный и рекомендованный способ

# 1. Старый, но рабочий способ с os.mkdir() и os.makedirs()
def create_dir_old_way(dir_path):
    try:
        os.mkdir(dir_path)  # Создает одну директорию. Если родительской нет — ошибка.
        print(f"Директория '{dir_path}' создана.")
    except FileExistsError:
        print(f"Директория '{dir_path}' уже существует.")
    except PermissionError:
        print(f"Нет прав для создания '{dir_path}'.")

# 2. os.makedirs() — создает всю цепочку директорий рекурсивно
def create_dir_recursive(dir_path):
    os.makedirs(dir_path, exist_ok=True)  # Параметр exist_ok=True предотвращает ошибку, если директория уже есть

# 3. Современный и удобный способ с Path из pathlib (Python 3.4+)
def create_dir_with_pathlib(dir_path):
    path = Path(dir_path)
    path.mkdir(parents=True, exist_ok=True)
    # У Path есть множество полезных методов: .exists(), .is_dir(), .iterdir(), .glob()

# 4. Создание временной директории для теста (очень полезно в QA!)
import tempfile
def create_temp_test_dir():
    temp_dir = tempfile.mkdtemp()  # Создает уникальную временную директорию
    print(f"Временная директория для теста: {temp_dir}")
    # После теста важно удалить ее:
    # shutil.rmtree(temp_dir)
    return temp_dir

Java (для проектов на Java/Selenium)

import java.io.File;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class DirectoryCreator {
    // 1. Старый способ с java.io.File
    public void createDirWithFile(String dirPath) {
        File dir = new File(dirPath);
        if (!dir.exists()) {
            boolean created = dir.mkdir(); // mkdirs() для создания родительских директорий
            if (created) {
                System.out.println("Директория создана: " + dirPath);
            }
        }
    }

    // 2. Современный способ с java.nio.file (Java 7+)
    public void createDirWithNIO(String dirPath) {
        Path path = Paths.get(dirPath);
        try {
            Files.createDirectories(path); // Рекурсивное создание, аналогично os.makedirs()
            System.out.println("Директория (или цепочка) создана: " + path);
        } catch (IOException e) {
            System.err.println("Ошибка создания директории: " + e.getMessage());
        }
    }
}

JavaScript/Node.js (для тестов на Playwright или Cypress)

const fs = require('fs');
const fsPromises = require('fs').promises; // Для асинхронных операций

// 1. Синхронное создание
function createDirectorySync(dirPath) {
    try {
        fs.mkdirSync(dirPath, { recursive: true }); // recursive создает родительские папки
        console.log(`Директория создана: ${dirPath}`);
    } catch (err) {
        console.error(`Ошибка: ${err.message}`);
    }
}

// 2. Асинхронное создание (лучше для производительности)
async function createDirectoryAsync(dirPath) {
    try {
        await fsPromises.mkdir(dirPath, { recursive: true });
        console.log(`Директория создана: ${dirPath}`);
    } catch (err) {
        console.error(`Ошибка: ${err.message}`);
    }
}

Практические сценарии в QA Automation

В своей работе я создавал директории для следующих ключевых целей:

• Хранения тестовых данных и конфигураций: Отдельная директория test_data/ для CSV, JSON, XML файлов, которые используются в тестах.
• Логирования и отчетов: Директория logs/ или reports/ для сохранения результатов выполнения тестов (Allure отчеты, screenshot'ы после падения теста, логи HTTP-трафика).
• Изолированных временных окружений: Создание уникальной временной директории для каждого запуска тестового suite (через tempfile), чтобы обеспечить чистоту данных и избежать конфликтов между параллельными запусками.
• Динамической генерации ресурсов: Например, создание директории для сохранения скриншотов или скачанных файлов во время выполнения теста на веб-приложение.
• Организации проекта: Структурирование проекта по типам тестов (api_tests/, ui_tests/, mobile_tests/) или по модулям приложения.

Важные принципы и best practices

• Обработка ошибок: Всегда обрабатывать исключения (FileExistsError, PermissionError). В тестах неожиданное отсутствие директории может привести к ложным падениям.
• Рекурсивное создание: Использовать параметры recursive: true, parents=True или createDirectories(). Это делает код устойчивым — он создаст всю необходимую цепочку папок.
• Временные директории: Для тестов, которым нужна чистая изолированная среда, предпочительнее использовать временные директории (tempfile) с гарантированным удалением после теста (в хуках @pytest.fixture или @After / @AfterEach).
• Проверка существования: Часто перед созданием нужно проверить os.path.exists() или Path.exists(), но многие современные методы (makedirs(exist_ok=True)) делают это сами.
• Кроссплатформенность: Учитывать различия в пути (/ для Unix, \ для Windows). Использование Pathlib (Python) или Paths.get() (Java) помогает абстрагироваться от этого.

Таким образом, создание директории — это не просто технический вызов, а важная часть построения надежной, поддерживаемой и изолированной тестовой инфраструктуры. Правильный выбор метода и библиотеки напрямую влияет на стабильность тестовых запусков и удобство работы с тестовыми артефактами.