BPT\types\animation

Complexity

Total Complexity

5

Size/Duplication

Total Lines	77
Duplicated Lines	0 %

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	typedSize()	0	2	1
A	__construct()	0	3	2
A	link()	0	2	1
A	download()	0	2	1

<?php

namespace BPT\types;

use BPT\telegram\telegram;
use BPT\tools\tools;
use stdClass;

/**
 * This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).
 */
class animation extends types {

The type BPT\types\types was not found. Maybe you did not declare it correctly or list all dependencies?

    /** Keep all properties which has sub properties */
    private const subs = ['thumbnail' => 'BPT\types\photoSize'];

    /** Identifier for this file, which can be used to download or reuse the file */
    public string $file_id;

    /**
     * Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be
     * used to download or reuse the file.
     */
    public string $file_unique_id;

    /** Video width as defined by sender */
    public int $width;

    /** Video height as defined by sender */
    public int $height;

    /** Duration of the video in seconds as defined by sender */
    public int $duration;

    /** Optional. Animation thumbnail as defined by sender */
    public null|photoSize $thumbnail = null;

    /** Optional. Original animation filename as defined by sender */
    public null|string $file_name = null;

    /** Optional. MIME type of the file as defined by sender */
    public null|string $mime_type = null;

    /**
     * Optional. File size in bytes. It can be bigger than 2^31 and some programming languages may have
     * difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit
     * integer or double-precision float type are safe for storing this value.
     */
    public null|int $file_size = null;


    public function __construct(stdClass|null $object = null) {
        if ($object != null) {
            parent::__construct($object, self::subs);
        }
    }

    /**
     * download this file and save it in destination
     *
     * if destination doesn't set , it will return the downloaded file(as string)
     *
     * It has 20MB download limit(same as telegram)
     *
     * e.g. => $animation->download();
     *
     * e.g. => $animation->download('test.gif');
     *
     * @param string|null $destination destination for save the file
     *
     * @return bool|string string will be returned when destination doesn't set
     */
    public function download(string|null $destination = null): bool|string {
        return telegram::downloadFile($destination ?? $this->file_name ?? 'unknown.gif',$this->file_id);
    }

    /**
     * Get download link of this file
     *
     * It does not bypass telegram limits(e.g: Download size limit in public bot api)
     *
     * @return string
     */
    public function link(): string {
        return telegram::fileLink($this->file_id);
    }

    public function typedSize (int $precision = 2, bool $space_between = true): string {
        return tools::byteFormat($this->file_id, $precision, $space_between);

$this->file_id of type string is incompatible with the type integer expected by parameter $byte of BPT\tools\tools::byteFormat().

    }
}