mirror of
https://github.com/zoriya/Kyoo.git
synced 2025-05-24 02:02:36 -04:00
101 lines
3.5 KiB
C#
101 lines
3.5 KiB
C#
// Kyoo - A portable and vast media library solution.
|
|
// Copyright (c) Kyoo.
|
|
//
|
|
// See AUTHORS.md and LICENSE file in the project root for full license information.
|
|
//
|
|
// Kyoo is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// any later version.
|
|
//
|
|
// Kyoo is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Diagnostics.CodeAnalysis;
|
|
using System.Threading;
|
|
using Kyoo.Abstractions.Models.Attributes;
|
|
using Kyoo.Abstractions.Models.Exceptions;
|
|
|
|
namespace Kyoo.Abstractions.Controllers
|
|
{
|
|
/// <summary>
|
|
/// A service to handle long running tasks.
|
|
/// </summary>
|
|
/// <remarks>The concurrent number of running tasks is implementation dependent.</remarks>
|
|
public interface ITaskManager
|
|
{
|
|
/// <summary>
|
|
/// Start a new task (or queue it).
|
|
/// </summary>
|
|
/// <param name="taskSlug">
|
|
/// The slug of the task to run.
|
|
/// </param>
|
|
/// <param name="progress">
|
|
/// A progress reporter to know the percentage of completion of the task.
|
|
/// </param>
|
|
/// <param name="arguments">
|
|
/// A list of arguments to pass to the task. An automatic conversion will be made if arguments to not fit.
|
|
/// </param>
|
|
/// <param name="cancellationToken">
|
|
/// A custom cancellation token for the task.
|
|
/// </param>
|
|
/// <exception cref="ArgumentException">
|
|
/// If the number of arguments is invalid, if an argument can't be converted or if the task finds the argument
|
|
/// invalid.
|
|
/// </exception>
|
|
/// <exception cref="ItemNotFoundException">
|
|
/// The task could not be found.
|
|
/// </exception>
|
|
void StartTask(string taskSlug,
|
|
[NotNull] IProgress<float> progress,
|
|
Dictionary<string, object> arguments = null,
|
|
CancellationToken? cancellationToken = null);
|
|
|
|
/// <summary>
|
|
/// Start a new task (or queue it).
|
|
/// </summary>
|
|
/// <param name="progress">
|
|
/// A progress reporter to know the percentage of completion of the task.
|
|
/// </param>
|
|
/// <param name="arguments">
|
|
/// A list of arguments to pass to the task. An automatic conversion will be made if arguments to not fit.
|
|
/// </param>
|
|
/// <typeparam name="T">
|
|
/// The type of the task to start.
|
|
/// </typeparam>
|
|
/// <param name="cancellationToken">
|
|
/// A custom cancellation token for the task.
|
|
/// </param>
|
|
/// <exception cref="ArgumentException">
|
|
/// If the number of arguments is invalid, if an argument can't be converted or if the task finds the argument
|
|
/// invalid.
|
|
/// </exception>
|
|
/// <exception cref="ItemNotFoundException">
|
|
/// The task could not be found.
|
|
/// </exception>
|
|
void StartTask<T>([NotNull] IProgress<float> progress,
|
|
Dictionary<string, object> arguments = null,
|
|
CancellationToken? cancellationToken = null)
|
|
where T : ITask;
|
|
|
|
/// <summary>
|
|
/// Get all currently running tasks
|
|
/// </summary>
|
|
/// <returns>A list of currently running tasks.</returns>
|
|
ICollection<(TaskMetadataAttribute, ITask)> GetRunningTasks();
|
|
|
|
/// <summary>
|
|
/// Get all available tasks
|
|
/// </summary>
|
|
/// <returns>A list of every tasks that this instance know.</returns>
|
|
ICollection<TaskMetadataAttribute> GetAllTasks();
|
|
}
|
|
}
|