Filesystem/src/File.php at develop · Innmind/Filesystem · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
<?php
declare(strict_types = 1);

namespace Innmind\Filesystem;

use Innmind\Filesystem\File\Content;
use Innmind\MediaType\MediaType;

/**
 * @psalm-immutable
 */
final class File
{
    private function __construct(
        private Name $name,
        private Content $content,
        private MediaType $mediaType,
    ) {
    }

    /**
     * @psalm-pure
     */
    #[\NoDiscard]
    public static function of(
        Name $name,
        Content $content,
        ?MediaType $mediaType = null,
    ): self {
        return new self($name, $content, $mediaType ?? MediaType::null());
    }

    /**
     * @psalm-pure
     *
     * @param non-empty-string $name
     */
    #[\NoDiscard]
    public static function named(
        string $name,
        Content $content,
        ?MediaType $mediaType = null,
    ): self {
        return self::of(Name::of($name), $content, $mediaType);
    }

    #[\NoDiscard]
    public function name(): Name
    {
        return $this->name;
    }

    #[\NoDiscard]
    public function content(): Content
    {
        return $this->content;
    }

    #[\NoDiscard]
    public function mediaType(): MediaType
    {
        return $this->mediaType;
    }

    #[\NoDiscard]
    public function rename(Name $name): self
    {
        return new self($name, $this->content, $this->mediaType);
    }

    #[\NoDiscard]
    public function withContent(Content $content, ?MediaType $mediaType = null): self
    {
        return new self(
            $this->name,
            $content,
            $mediaType ?? $this->mediaType,
        );
    }

    /**
     * @param callable(Content): Content $map
     */
    #[\NoDiscard]
    public function mapContent(callable $map): self
    {
        /** @psalm-suppress ImpureFunctionCall */
        return new self(
            $this->name,
            $map($this->content),
            $this->mediaType,
        );
    }
}