0
0
mirror of https://github.com/nextcloud/server.git synced 2024-12-29 00:18:42 +00:00
nextcloud_server/lib/public/TaskProcessing/IProvider.php
Marcel Klehr 799ee8fd51
feat(TaskProcessing): Implement enums and default values
Signed-off-by: Marcel Klehr <mklehr@gmx.net>
2024-07-25 10:10:31 +02:00

110 lines
2.3 KiB
PHP

<?php
declare(strict_types=1);
/**
* SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
* SPDX-License-Identifier: AGPL-3.0-or-later
*/
namespace OCP\TaskProcessing;
/**
* This is the interface that is implemented by apps that
* implement a task processing provider
* @since 30.0.0
*/
interface IProvider {
/**
* The unique id of this provider
* @since 30.0.0
*/
public function getId(): string;
/**
* The localized name of this provider
* @since 30.0.0
*/
public function getName(): string;
/**
* Returns the task type id of the task type, that this
* provider handles
*
* @since 30.0.0
* @return string
*/
public function getTaskTypeId(): string;
/**
* @return int The expected average runtime of a task in seconds
* @since 30.0.0
*/
public function getExpectedRuntime(): int;
/**
* Returns the shape of optional input parameters
*
* @since 30.0.0
* @psalm-return ShapeDescriptor[]
*/
public function getOptionalInputShape(): array;
/**
* Returns the shape of optional output parameters
*
* @since 30.0.0
* @psalm-return ShapeDescriptor[]
*/
public function getOptionalOutputShape(): array;
/**
* Returns the option list for each input shape ENUM slot
*
* @since 30.0.0
* @psalm-return ShapeEnumValue[][]
*/
public function getInputShapeEnumValues(): array;
/**
* Returns the default values for input shape slots
*
* @since 30.0.0
* @psalm-return array<array-key, string|numeric>
*/
public function getInputShapeDefaults(): array;
/**
* Returns the option list for each optional input shape ENUM slot
*
* @since 30.0.0
* @psalm-return ShapeEnumValue[][]
*/
public function getOptionalInputShapeEnumValues(): array;
/**
* Returns the default values for optional input shape slots
*
* @since 30.0.0
* @psalm-return array<array-key, string|numeric>
*/
public function getOptionalInputShapeDefaults(): array;
/**
* Returns the option list for each output shape ENUM slot
*
* @since 30.0.0
* @psalm-return ShapeEnumValue[][]
*/
public function getOutputShapeEnumValues(): array;
/**
* Returns the option list for each optional output shape ENUM slot
*
* @since 30.0.0
* @psalm-return ShapeEnumValue[][]
*/
public function getOptionalOutputShapeEnumValues(): array;
}