Русский

⚙️ MyStemSharpness: Высокопроизводительная библиотека для работы с MyStem на C#

Добро пожаловать в MyStemSharpness! Этот проект представляет собой тщательно разработанную .NET-библиотеку на языке C#, предназначенную для обеспечения эффективного и удобного взаимодействия с мощным лингвистическим инструментом MyStem. Мы понимаем, насколько важно иметь надежный и быстрый способ интеграции возможностей MyStem в ваши приложения, и именно поэтому создали эту библиотеку.

⚠️ Внимание: Многопоточность не рекомендуется!

Классы MyStem и FastMyStem не предназначены для одновременного использования из разных потоков в рамках одного экземпляра. Если вам необходимо выполнять анализ в многопоточной среде, настоятельно рекомендуется создавать отдельные экземпляры классов MyStem или FastMyStem для каждого потока.

🚀 Начало работы

Если вы готовы погрузиться в мир лингвистического анализа с MyStemSharpness, вот первые шаги:

1. Установка: На данный момент библиотека находится на стадии разработки и может быть установлена непосредственно из исходного кода. После публикации на NuGet, вы сможете добавить ее в свой проект Visual Studio Code или другой .NET-проект с помощью следующей команды в консоли NuGet Package Manager:

   dotnet add package MyStemSharpness

2. Добавление пространства имен: В файлах, где вы планируете использовать MyStemSharpness, добавьте следующую строку в начало:

   using MyStem;

3. Зависимость от MyStem: Для работы библиотеки необходимо, чтобы на целевой машине был установлен исполняемый файл mystem.exe. Убедитесь, что он доступен по указанному пути.

🛠️ Примеры использования

Чтобы вы могли быстро оценить возможности MyStemSharpness, мы подготовили несколько примеров использования для различных сценариев.

💡 Однопоточный анализ (MyStem)

Для задач, где не требуется высокая степень параллелизма или обработка выполняется последовательно, вы можете использовать класс MyStem.

using MyStem;
using System;
using System.IO;

public class SingleThreadedExample
{
    public static void Main(string[] args)
    {
        // Укажите путь к исполняемому файлу MyStem, если он отличается от "mystem.exe"
        MyStem.PathToMyStem = "path/to/mystem.exe";

        // Создайте экземпляр класса
        using var myStem = new MyStem();
        myStem.Initialize(); // Инициализация процесса MyStem

        string textToAnalyze = "Это простой пример текста для анализа.";
        try
        {
            string result = myStem.Analysis(textToAnalyze);
            Console.WriteLine($"Результат анализа: {result}");
        }
        catch (FileNotFoundException ex)
        {
            Console.WriteLine($"Ошибка: {ex.Message}");
        }
        catch (FormatException ex)
        {
            Console.WriteLine($"Ошибка во время анализа: {ex.Message}");
        }
    }
}

⚡ Быстрый анализ (FastMyStem)

Для приложений, где важна высокая производительность, используйте класс FastMyStem.

using MyStem;
using System;
using System.IO;

public class FastMyStemExample
{
    public static void Main(string[] args)
    {
        // Укажите путь к исполняемому файлу MyStem, если он отличается от "mystem.exe"
        FastMyStem.PathToMyStem = "path/to/mystem.exe";

        // Создайте экземпляр класса
        using var myStem = new FastMyStem();

        string textToAnalyze = "Этот текст будет обработан с использованием FastMyStem.";
        try
        {
            string result = myStem.MultiAnalysis(textToAnalyze);
            Console.WriteLine($"Результат быстрого анализа: {result}");
        }
        catch (FileNotFoundException ex)
        {
            Console.WriteLine($"Ошибка: {ex.Message}");
        }
        catch (FormatException ex)
        {
            Console.WriteLine($"Ошибка во время анализа: {ex.Message}");
        }
    }
}

⚙️ Настройка параметров MyStem

Библиотека предоставляет класс MyStemOptions для гибкой настройки параметров запуска MyStem.

using MyStem;
using System;
using System.IO;

public class OptionsExample
{
    public static void Main(string[] args)
    {
        // Создайте объект с нужными параметрами
        var options = new MyStemOptions
        {
            LineByLine = true,
            PrintOnlyLemmasAndGrammemes = true,
            Encoding = "utf-8"
        };

        // Укажите путь к исполняемому файлу MyStem
        MyStem.PathToMyStem = "path/to/mystem.exe";

        // Создайте экземпляр класса, передав опции
        using var myStem = new MyStem(options);
        myStem.Initialize(); // Инициализация процесса MyStem

        string textToAnalyze = "Пример текста с настройками.";
        try
        {
            string result = myStem.Analysis(textToAnalyze);
            Console.WriteLine($"Результат анализа с опциями: {result}");
        }
        catch (FileNotFoundException ex)
        {
            Console.WriteLine($"Ошибка: {ex.Message}");
        }
        catch (FormatException ex)
        {
            Console.WriteLine($"Ошибка во время анализа: {ex.Message}");
        }
    }
}

⚠️ Возможные проблемы на стадии разработки

В процессе разработки и использования библиотеки MyStemSharpness могут возникнуть некоторые трудности:

• Кодировка: Неправильная настройка кодировки может привести к некорректному анализу текста. По умолчанию используется UTF-8, но при необходимости вы можете настроить другие кодировки через MyStemOptions.
• Обработка ошибок MyStem: Хотя библиотека старается обрабатывать исключения, ошибки, возникающие непосредственно в процессе MyStem, могут потребовать дополнительной диагностики.
• Ресурсы системы: Запуск внешнего процесса MyStem может потреблять системные ресурсы. При интенсивном использовании в многопоточной среде следите за загрузкой процессора и памяти.

⚡ Гарантия высокой производительности

Несмотря на возможные трудности, MyStemSharpness разработан с акцентом на высокую производительность:

• Эффективное управление процессами: Библиотека переиспользует экземпляры процесса MyStem, минимизируя накладные расходы на запуск новых процессов для каждого запроса.
• Асинхронное чтение (класс FastMyStem): Класс FastMyStem использует асинхронное чтение выходных данных MyStem, что позволяет избежать блокировки вызывающего потока и повышает общую пропускную способность. Пожалуйста, обратите внимание: один и тот же экземпляр FastMyStem не предназначен для безопасного использования в разных потоках одновременно. Для многопоточной обработки рекомендуется создавать отдельные экземпляры класса для каждого потока.
• Оптимизированные буферы: Для чтения выходных данных используются буферы, размер которых динамически оценивается на основе размера входного текста, что снижает количество операций выделения памяти.

🙏 Благодарности и вклад

Мы надеемся, что MyStemSharpness станет ценным инструментом в вашем арсенале. Будем рады вашим отзывам, предложениям и вкладу в развитие проекта. Следите за обновлениями и новыми возможностями!

English

⚙️ MyStemSharpness: High-Performance Library for MyStem Interaction in C#

Welcome to MyStemSharpness! This project is a carefully crafted .NET library in C# designed to provide efficient and convenient interaction with the powerful MyStem linguistic tool. We understand the importance of having a reliable and fast way to integrate MyStem's capabilities into your applications, and that's why we created this library.

⚠️ Warning: Multithreading Not Recommended!

The MyStem and FastMyStem classes are not designed for concurrent use from different threads within the same instance. If you need to perform analysis in a multithreaded environment, it is strongly recommended to create separate instances of the MyStem or FastMyStem classes for each thread.

🚀 Getting Started

If you're ready to dive into the world of linguistic analysis with MyStemSharpness, here are the first steps:

1. Installation: Currently, the library is under development and can be installed directly from the source code. Once published on NuGet, you will be able to add it to your Visual Studio Code or other .NET project using the following command in the NuGet Package Manager console:

   dotnet add package MyStemSharpness

2. Adding Namespace: In the files where you plan to use MyStemSharpness, add the following line at the beginning:

   using MyStem;

3. MyStem Dependency: The library requires the mystem.exe executable to be installed on the target machine. Ensure it is accessible at the specified path.

🛠️ Usage Examples

To help you quickly appreciate the capabilities of MyStemSharpness, we have prepared several usage examples for different scenarios.

💡 Single-Threaded Analysis (MyStem)

For tasks where a high degree of parallelism is not required or processing is performed sequentially, you can use the MyStem class.

using MyStem;
using System;
using System.IO;

public class SingleThreadedExample
{
    public static void Main(string[] args)
    {
        // Specify the path to the MyStem executable if it's different from "mystem.exe"
        MyStem.PathToMyStem = "path/to/mystem.exe";

        // Create an instance of the class
        using var myStem = new MyStem();
        myStem.Initialize(); // Initialize the MyStem process

        string textToAnalyze = "Это простой пример текста для анализа.";
        try
        {
            string result = myStem.Analysis(textToAnalyze);
            Console.WriteLine($"Analysis Result: {result}");
        }
        catch (FileNotFoundException ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        catch (FormatException ex)
        {
            Console.WriteLine($"Error during analysis: {ex.Message}");
        }
    }
}

⚡ Fast Analysis (FastMyStem)

For applications where high performance is important, use the FastMyStem class.

using MyStem;
using System;
using System.IO;

public class FastMyStemExample
{
    public static void Main(string[] args)
    {
        // Specify the path to the MyStem executable if it's different from "mystem.exe"
        FastMyStem.PathToMyStem = "path/to/mystem.exe";

        // Create an instance of the class
        using var myStem = new FastMyStem();

        string textToAnalyze = "This text will be processed using FastMyStem.";
        try
        {
            string result = myStem.MultiAnalysis(textToAnalyze);
            Console.WriteLine($"Fast Analysis Result: {result}");
        }
        catch (FileNotFoundException ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        catch (FormatException ex)
        {
            Console.WriteLine($"Error during analysis: {ex.Message}");
        }
    }
}

⚙️ Configuring MyStem Parameters

The library provides the MyStemOptions class for flexible configuration of MyStem's launch parameters.

using MyStem;
using System;
using System.IO;

public class OptionsExample
{
    public static void Main(string[] args)
    {
        // Create an object with the desired options
        var options = new MyStemOptions
        {
            LineByLine = true,
            PrintOnlyLemmasAndGrammemes = true,
            Encoding = "utf-8"
        };

        // Specify the path to the MyStem executable
        MyStem.PathToMyStem = "path/to/mystem.exe";

        // Create an instance of the class, passing the options
        using var myStem = new MyStem(options);
        myStem.Initialize(); // Initialize the MyStem process

        string textToAnalyze = "Пример текста с настройками.";
        try
        {
            string result = myStem.Analysis(textToAnalyze);
            Console.WriteLine($"Analysis Result with Options: {result}");
        }
        catch (FileNotFoundException ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        catch (FormatException ex)
        {
            Console.WriteLine($"Error during analysis: {ex.Message}");
        }
    }
}

⚠️ Potential Development Issues

During the development and use of the MyStemSharpness library, some difficulties may arise:

• Encoding: Incorrect encoding settings can lead to incorrect text analysis. UTF-8 is used by default, but you can configure other encodings via MyStemOptions if needed.
• MyStem Error Handling: While the library tries to handle exceptions, errors originating directly from the MyStem process might require additional diagnostics.
• System Resources: Running the external MyStem process can consume system resources. With intensive use in a multi-threaded environment, monitor CPU and memory usage.

⚡ High-Performance Guarantee

Despite potential difficulties, MyStemSharpness is designed with a focus on high performance:

• Efficient Process Management: The library reuses MyStem process instances, minimizing the overhead of starting new processes for each request.
• Asynchronous Reading (Class FastMyStem): The FastMyStem class uses asynchronous reading of MyStem's output, which prevents blocking the calling thread and increases overall throughput. Please note: the same instance of FastMyStem is not intended for safe use in different threads simultaneously. For multithreaded processing, it is recommended to create separate instances of the class for each thread.
• Optimized Buffers: Buffers are used for reading output data, and their size is dynamically estimated based on the input text size, reducing the number of memory allocation operations.

🙏 Acknowledgments and Contributions

We hope that MyStemSharpness will become a valuable tool in your arsenal. We welcome your feedback, suggestions, and contributions to the project's development. Stay tuned for updates and new features!