snapshot of https://github.com/espocrm/espocrm.git (master, 2026-09-18; blobs > 131072B omitted)

tests/unit/Espo/Tools/WorkingTime/CalendarUtilityTest.php

@@ -0,0 +1,284 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace tests\unit\Espo\Tools\WorkingTime;
+
+use Espo\Core\Field\DateTime;
+use Espo\Tools\WorkingTime\Calendar;
+use Espo\Tools\WorkingTime\CalendarUtility;
+use Espo\Tools\WorkingTime\Extractor;
+use PHPUnit\Framework\TestCase;
+use RuntimeException;
+
+class CalendarUtilityTest extends TestCase
+{
+    protected Calendar $calendar;
+    protected Extractor $extractor;
+    protected CalendarUtility $calendarUtility;
+
+    protected function setUp(): void
+    {
+        $this->calendar = $this->createMock(Calendar::class);
+        $this->extractor = $this->createMock(Extractor::class);
+        $this->calendarUtility = new CalendarUtility($this->calendar, $this->extractor);
+    }
+
+    public function testHasWorkingDay1(): void
+    {
+        $time = DateTime::fromString('2023-01-01 01:01:01');
+
+        $from = DateTime::fromString('2023-01-01 00:00:00');
+        $to = DateTime::fromString('2023-01-01 00:00:00');
+
+        $this->extractor
+            ->expects($this->any())
+            ->method('extractAllDay')
+            ->with($this->calendar, $from, $to)
+            ->willReturn([
+                [
+                    $from,
+                    $to
+                ]
+            ]);
+
+        $this->assertTrue($this->calendarUtility->isWorkingDay($time));
+    }
+
+    public function testHasWorkingTime1(): void
+    {
+        $from = DateTime::fromString('2023-01-01 00:00:00');
+        $to = DateTime::fromString('2023-01-02 00:00:00');
+
+        $this->extractor
+            ->expects($this->any())
+            ->method('extract')
+            ->with($this->calendar, $from, $to)
+            ->willReturn([
+                [
+                    DateTime::fromString('2023-01-01 05:00:00'),
+                    DateTime::fromString('2023-01-01 06:00:00')
+                ]
+            ]);
+
+        $this->assertTrue($this->calendarUtility->hasWorkingTime($from, $to));
+    }
+
+    public function testHasWorkingTime2(): void
+    {
+        $from = DateTime::fromString('2023-01-01 00:00:00');
+        $to = DateTime::fromString('2023-01-02 00:00:00');
+
+        $this->extractor
+            ->expects($this->any())
+            ->method('extract')
+            ->with($this->calendar, $from, $to)
+            ->willReturn([]);
+
+        $this->assertFalse($this->calendarUtility->hasWorkingTime($from, $to));
+    }
+
+    public function testGetSummedWorkingHours1(): void
+    {
+        $from = DateTime::fromString('2023-01-01 00:00:00');
+        $to = DateTime::fromString('2023-01-02 00:00:00');
+
+        $this->extractor
+            ->expects($this->any())
+            ->method('extract')
+            ->with($this->calendar, $from, $to)
+            ->willReturn([
+                [
+                    DateTime::fromString('2023-01-01 05:00:00'),
+                    DateTime::fromString('2023-01-01 06:00:00')
+                ],
+                [
+                    DateTime::fromString('2023-01-01 07:00:00'),
+                    DateTime::fromString('2023-01-01 08:00:00')
+                ]
+            ]);
+
+        $this->assertEquals(2.0, $this->calendarUtility->getSummedWorkingHours($from, $to));
+    }
+
+    public function testGetWorkingDays1(): void
+    {
+        $from = DateTime::fromString('2023-01-01 00:00:00');
+        $to = DateTime::fromString('2023-01-07 00:00:00');
+
+        $this->extractor
+            ->expects($this->any())
+            ->method('extractAllDay')
+            ->with($this->calendar, $from, $to)
+            ->willReturn([
+                [
+                    DateTime::fromString('2023-01-01 00:00:00'),
+                    DateTime::fromString('2023-01-02 00:00:00')
+                ],
+                [
+                    DateTime::fromString('2023-01-04 00:00:00'),
+                    DateTime::fromString('2023-01-05 00:00:00')
+                ]
+            ]);
+
+        $this->assertEquals(2, $this->calendarUtility->getWorkingDays($from, $to));
+    }
+
+    public function testFindClosestWorkingTime1(): void
+    {
+        $point = DateTime::fromString('2023-01-01 00:00:00');
+
+        $invokedCount = $this->exactly(2);
+
+        $this->extractor
+            ->expects($invokedCount)
+            ->method('extract')
+            ->willReturnCallback(function ($calendar, $a, $b) use ($invokedCount, $point) {
+                if ($invokedCount->numberOfInvocations() === 1) {
+                    $this->assertEquals($this->calendar, $calendar);
+                    $this->assertEquals($point, $a);
+                    $this->assertEquals($point->modify('+10 days'), $b);
+
+                    return [];
+                }
+
+                if ($invokedCount->numberOfInvocations() === 2) {
+                    $this->assertEquals($this->calendar, $calendar);
+                    $this->assertEquals($point->modify('+10 days'), $a);
+                    $this->assertEquals($point->modify('+20 days'), $b);
+
+                    return [
+                        [
+                            DateTime::fromString('2023-01-11 01:00:00'),
+                            DateTime::fromString('2023-01-11 02:00:00')
+                        ],
+                    ];
+                }
+
+                throw new RuntimeException();
+            });
+
+
+
+        $found = $this->calendarUtility->findClosestWorkingTime($point);
+
+        $this->assertEquals(DateTime::fromString('2023-01-11 01:00:00'), $found);
+    }
+
+    public function testFindClosestWorkingTime2(): void
+    {
+        $time = DateTime::fromString('2023-01-01 00:00:00');
+
+        $this->extractor
+            ->expects($this->exactly(20))
+            ->method('extract')
+            ->willReturn([]);
+
+        $found = $this->calendarUtility->findClosestWorkingTime($time);
+
+        $this->assertEquals(null, $found);
+    }
+
+    public function testAddWorkingDays1(): void
+    {
+        $time = DateTime::fromString('2023-01-01 01:00:00');
+
+        $point = $time->withTime(0, 0, 0)->modify('+1 day');
+
+        $invokedCount = $this->exactly(2);
+
+        $this->extractor
+            ->expects($invokedCount)
+            ->method('extractAllDay')
+            ->willReturnCallback(function ($calendar, $a, $b) use ($invokedCount, $point) {
+                if ($invokedCount->numberOfInvocations() === 1) {
+                    $this->assertEquals($this->calendar, $calendar);
+                    $this->assertEquals($point, $a);
+                    $this->assertEquals($point->modify('+30 days'), $b);
+
+                    return [];
+                }
+
+                if ($invokedCount->numberOfInvocations() === 2) {
+                    $this->assertEquals($this->calendar, $calendar);
+                    $this->assertEquals($point->modify('+30 days'), $a);
+                    $this->assertEquals($point->modify('+60 days'), $b);
+
+                    return [
+                        [
+                            DateTime::fromString('2023-04-01 00:00:00'),
+                            DateTime::fromString('2023-04-01 00:00:00')
+                        ],
+                    ];
+                }
+
+                throw new RuntimeException();
+            });
+
+        $found = $this->calendarUtility->addWorkingDays($time, 1);
+
+        $this->assertEquals(DateTime::fromString('2023-04-01 00:00:00'), $found);
+    }
+
+    public function testAddWorkingDays2(): void
+    {
+        $time = DateTime::fromString('2023-01-01 01:00:00');
+
+        $point = $time->withTime(0, 0, 0)->modify('+1 day');
+
+        $invokedCount = $this->exactly(1);
+
+        $this->extractor
+            ->expects($invokedCount)
+            ->method('extractAllDay')
+            ->willReturnCallback(function ($calendar, $a, $b) use ($invokedCount, $point) {
+                if ($invokedCount->numberOfInvocations() === 1) {
+                    $this->assertEquals($this->calendar, $calendar);
+                    $this->assertEquals($point, $a);
+                    $this->assertEquals($point->modify('+30 days'), $b);
+
+                    return                 [
+                        [
+                            DateTime::fromString('2023-01-02 00:00:00'),
+                            DateTime::fromString('2023-01-03 00:00:00')
+                        ],
+                        [
+                            DateTime::fromString('2023-01-03 00:00:00'),
+                            DateTime::fromString('2023-01-04 00:00:00')
+                        ],
+                    ];
+                }
+
+                throw new RuntimeException();
+            });
+
+        $found = $this->calendarUtility->addWorkingDays($time, 2);
+
+        $this->assertEquals(DateTime::fromString('2023-01-03 00:00:00'), $found);
+    }
+}

tests/unit/Espo/Tools/WorkingTime/ExtractorTest.php

@@ -0,0 +1,267 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace tests\unit\Espo\Tools\WorkingTime;
+
+use Espo\Tools\WorkingTime\Calendar;
+use Espo\Tools\WorkingTime\Calendar\Time;
+use Espo\Tools\WorkingTime\Calendar\TimeRange;
+use Espo\Tools\WorkingTime\Calendar\WorkingDate;
+use Espo\Tools\WorkingTime\Calendar\WorkingWeekday;
+use Espo\Tools\WorkingTime\Extractor;
+
+use Espo\Core\Field\DateTime;
+use Espo\Core\Field\Date;
+
+use DateTimeZone;
+
+class ExtractorTest extends \PHPUnit\Framework\TestCase
+{
+    protected Calendar $calendar;
+
+    protected function setUp(): void
+    {
+        $this->calendar = $this->createMock(Calendar::class);
+    }
+
+    private function initCalendar1(): void
+    {
+        $this->calendar
+            ->expects($this->any())
+            ->method('getTimeZone')
+            ->willReturn(new DateTimeZone('UTC'));
+
+        $ranges = [
+            new TimeRange(new Time(9, 0), new Time(13, 0)),
+            new TimeRange(new Time(14, 0), new Time(17, 0)),
+        ];
+
+        $this->calendar
+            ->expects($this->any())
+            ->method('getWorkingDates')
+            ->willReturn([
+                new WorkingDate(
+                    new Date('2022-01-05'),
+                    [
+                        new TimeRange(new Time(10, 30), new Time(15, 30)),
+                    ]
+                ),
+                new WorkingDate(
+                    new Date('2022-01-09'),
+                    [
+                        new TimeRange(new Time(10, 30), new Time(15, 30)),
+                    ]
+                )
+            ]);
+
+        $this->calendar
+            ->expects($this->any())
+            ->method('getNonWorkingDates')
+            ->willReturn([
+                new WorkingDate(new Date('2022-01-06')),
+                new WorkingDate(new Date('2022-01-10')),
+            ]);
+
+        $this->calendar
+            ->expects($this->any())
+            ->method('getWorkingWeekdays')
+            ->willReturn([
+                new WorkingWeekday(1, $ranges),
+                new WorkingWeekday(2, $ranges),
+                new WorkingWeekday(3, $ranges),
+                new WorkingWeekday(4, $ranges),
+                new WorkingWeekday(5, $ranges),
+            ]);
+    }
+
+    public function testExtract1(): void
+    {
+        $this->initCalendar1();
+        $extractor = new Extractor();
+
+        $list = $extractor->extract(
+            $this->calendar,
+            DateTime::fromString('2022-01-02 00:00:00'), // sun
+            DateTime::fromString('2022-01-17 00:00:00') // sun
+        );
+
+        // mon
+        $this->assertEquals('2022-01-03 09:00:00', $list[0][0]->getString());
+        $this->assertEquals('2022-01-03 13:00:00', $list[0][1]->getString());
+
+        $this->assertEquals('2022-01-03 14:00:00', $list[1][0]->getString());
+        $this->assertEquals('2022-01-03 17:00:00', $list[1][1]->getString());
+
+        // tue
+        $this->assertEquals('2022-01-04 09:00:00', $list[2][0]->getString());
+        $this->assertEquals('2022-01-04 13:00:00', $list[2][1]->getString());
+
+        $this->assertEquals('2022-01-04 14:00:00', $list[3][0]->getString());
+        $this->assertEquals('2022-01-04 17:00:00', $list[3][1]->getString());
+
+        // wed working-date
+        $this->assertEquals('2022-01-05 10:30:00', $list[4][0]->getString());
+        $this->assertEquals('2022-01-05 15:30:00', $list[4][1]->getString());
+
+        // thu non-working-date
+
+        // fri
+        $this->assertEquals('2022-01-07 09:00:00', $list[5][0]->getString());
+        $this->assertEquals('2022-01-07 13:00:00', $list[5][1]->getString());
+
+        $this->assertEquals('2022-01-07 14:00:00', $list[6][0]->getString());
+        $this->assertEquals('2022-01-07 17:00:00', $list[6][1]->getString());
+
+        // sat
+
+        // sun working-day
+        $this->assertEquals('2022-01-09 10:30:00', $list[7][0]->getString());
+        $this->assertEquals('2022-01-09 15:30:00', $list[7][1]->getString());
+
+        // mon non-working-day
+
+        // tue
+        $this->assertEquals('2022-01-11 09:00:00', $list[8][0]->getString());
+        $this->assertEquals('2022-01-11 13:00:00', $list[8][1]->getString());
+
+        $this->assertEquals('2022-01-11 14:00:00', $list[9][0]->getString());
+        $this->assertEquals('2022-01-11 17:00:00', $list[9][1]->getString());
+    }
+
+    public function testExtractInversion1(): void
+    {
+        $this->initCalendar1();
+        $extractor = new Extractor();
+
+        $listInversion = $extractor->extractInversion(
+            $this->calendar,
+            DateTime::fromString('2022-01-02 00:00:00'), // sun
+            DateTime::fromString('2022-01-17 00:00:00') // sun
+        );
+
+        $this->assertEquals('2022-01-02 00:00:00', $listInversion[0][0]->getString());
+        $this->assertEquals('2022-01-03 09:00:00', $listInversion[0][1]->getString());
+
+        $this->assertEquals('2022-01-14 13:00:00', $listInversion[15][0]->getString());
+        $this->assertEquals('2022-01-14 14:00:00', $listInversion[15][1]->getString());
+
+        $this->assertEquals('2022-01-14 17:00:00', $listInversion[16][0]->getString());
+        $this->assertEquals('2022-01-17 00:00:00', $listInversion[16][1]->getString());
+
+
+        $listAllDayInversion = $extractor->extractAllDayInversion(
+            $this->calendar,
+            DateTime::fromString('2022-01-02 00:00:00'), // sun
+            DateTime::fromString('2022-01-17 00:00:00') // sun
+        );
+
+        $this->assertEquals('2022-01-02 00:00:00', $listAllDayInversion[0][0]->getString());
+        $this->assertEquals('2022-01-03 00:00:00', $listAllDayInversion[0][1]->getString());
+
+        $this->assertEquals('2022-01-14 00:00:00', $listAllDayInversion[8][0]->getString());
+        $this->assertEquals('2022-01-14 00:00:00', $listAllDayInversion[8][1]->getString());
+
+        $this->assertEquals('2022-01-15 00:00:00', $listAllDayInversion[9][0]->getString());
+        $this->assertEquals('2022-01-17 00:00:00', $listAllDayInversion[9][1]->getString());
+    }
+
+    public function testExtractAllDay1(): void
+    {
+        $this->initCalendar1();
+        $extractor = new Extractor();
+
+        $listAllDay = $extractor->extractAllDay(
+            $this->calendar,
+            DateTime::fromString('2022-01-02 00:00:00'), // sun
+            DateTime::fromString('2022-01-17 00:00:00') // sun
+        );
+
+        // mon
+        $this->assertEquals('2022-01-03 00:00:00', $listAllDay[0][0]->getString());
+        $this->assertEquals('2022-01-04 00:00:00', $listAllDay[0][1]->getString());
+
+        // tue
+        $this->assertEquals('2022-01-04 00:00:00', $listAllDay[1][0]->getString());
+        $this->assertEquals('2022-01-05 00:00:00', $listAllDay[1][1]->getString());
+
+        // wed
+        $this->assertEquals('2022-01-05 00:00:00', $listAllDay[2][0]->getString());
+        $this->assertEquals('2022-01-06 00:00:00', $listAllDay[2][1]->getString());
+
+        // thu non-working-date
+
+        // fri
+        $this->assertEquals('2022-01-07 00:00:00', $listAllDay[3][0]->getString());
+        $this->assertEquals('2022-01-08 00:00:00', $listAllDay[3][1]->getString());
+
+        // sat
+
+        // sun working-day
+        $this->assertEquals('2022-01-09 00:00:00', $listAllDay[4][0]->getString());
+        $this->assertEquals('2022-01-10 00:00:00', $listAllDay[4][1]->getString());
+
+        // mon non-working-day
+
+        // tue
+        $this->assertEquals('2022-01-11 00:00:00', $listAllDay[5][0]->getString());
+        $this->assertEquals('2022-01-12 00:00:00', $listAllDay[5][1]->getString());
+    }
+
+    public function testExtract2(): void
+    {
+        $this->initCalendar1();
+        $extractor = new Extractor();
+
+        $list = $extractor->extract(
+            $this->calendar,
+            DateTime::fromString('2022-01-03 10:00:00'),
+            DateTime::fromString('2022-01-14 15:00:00')
+        );
+
+        $this->assertEquals('2022-01-03 10:00:00', $list[0][0]->getString());
+        $this->assertEquals('2022-01-14 15:00:00', $list[count($list) - 1][1]->getString());
+    }
+
+    public function testExtract3(): void
+    {
+        $this->initCalendar1();
+        $extractor = new Extractor();
+
+        $list = $extractor->extract(
+            $this->calendar,
+            DateTime::fromString('2022-01-03 16:00:00'),
+            DateTime::fromString('2022-01-14 15:00:00')
+        );
+
+        $this->assertEquals('2022-01-03 16:00:00', $list[0][0]->getString());
+        $this->assertEquals('2022-01-03 17:00:00', $list[0][1]->getString());
+
+        $this->assertEquals('2022-01-14 15:00:00', $list[count($list) - 1][1]->getString());
+    }
+}