1 files changed, 200 insertions, 0 deletions
diff --git a/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/tests/phpunit/Entity/ParticipantTest.php b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/tests/phpunit/Entity/ParticipantTest.php
new file mode 100644
index 00000000..8236efb0
--- /dev/null
+++ b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/tests/phpunit/Entity/ParticipantTest.php
@@ -0,0 +1,200 @@
+<?php
+
+namespace Civi\Test\Api4\Entity;
+
+use Civi\Api4\Participant;
+use Civi\Test\Api4\UnitTestCase;
+
+/**
+ * @group headless
+ */
+class ParticipantTest extends UnitTestCase {
+
+  public function setUp() {
+    parent::setUp();
+    $cleanup_params = [
+      'tablesToTruncate' => [
+        'civicrm_event',
+        'civicrm_participant',
+      ],
+    ];
+    $this->cleanup($cleanup_params);
+  }
+
+  public function testGetActions() {
+    $result = Participant::getActions()
+      ->setCheckPermissions(FALSE)
+      ->execute()
+      ->indexBy('name');
+
+    $getParams = $result['get']['params'];
+    $whereDescription = 'Criteria for selecting items.';
+
+    $this->assertEquals(TRUE, $getParams['checkPermissions']['default']);
+    $this->assertEquals($whereDescription, $getParams['where']['description']);
+  }
+
+  public function testGet() {
+    $rows = $this->getRowCount('civicrm_participant');
+    if ($rows > 0) {
+      $this->markTestSkipped('Participant table must be empty');
+    }
+
+    // With no records:
+    $result = Participant::get()->setCheckPermissions(FALSE)->execute();
+    $this->assertEquals(0, $result->count(), "count of empty get is not 0");
+
+    // Check that the $result knows what the inputs were
+    $this->assertEquals('Participant', $result->entity);
+    $this->assertEquals('get', $result->action);
+    $this->assertEquals(4, $result->version);
+
+    // Create some test related records before proceeding
+    $participantCount = 20;
+    $contactCount = 7;
+    $eventCount = 5;
+
+    // All events will either have this number or one less because of the
+    // rotating participation creation method.
+    $expectedFirstEventCount = ceil($participantCount / $eventCount);
+
+    $dummy = [
+      'contacts' => $this->createEntity([
+        'type' => 'Individual',
+        'count' => $contactCount,
+        'seq' => 1]),
+      'events' => $this->createEntity([
+        'type' => 'Event',
+        'count' => $eventCount,
+        'seq' => 1]),
+      'sources' => ['Paddington', 'Springfield', 'Central'],
+    ];
+
+    // - create dummy participants record
+    for ($i = 0; $i < $participantCount; $i++) {
+      $dummy['participants'][$i] = $this->sample([
+        'type' => 'Participant',
+        'overrides' => [
+          'event_id' => $dummy['events'][$i % $eventCount]['id'],
+          'contact_id' => $dummy['contacts'][$i % $contactCount]['id'],
+          'source' => $dummy['sources'][$i % 3], // 3 = number of sources
+      ]])['sample_params'];
+
+      Participant::create()
+        ->setValues($dummy['participants'][$i])
+        ->setCheckPermissions(FALSE)
+        ->execute();
+    }
+    $sqlCount = $this->getRowCount('civicrm_participant');
+    $this->assertEquals($participantCount, $sqlCount, "Unexpected count");
+
+    $firstEventId = $dummy['events'][0]['id'];
+    $secondEventId = $dummy['events'][1]['id'];
+    $firstContactId = $dummy['contacts'][0]['id'];
+
+    $firstOnlyResult = Participant::get()
+      ->setCheckPermissions(FALSE)
+      ->addClause('AND', ['event_id', '=', $firstEventId])
+      ->execute();
+
+    $this->assertEquals($expectedFirstEventCount, count($firstOnlyResult),
+      "count of first event is not $expectedFirstEventCount");
+
+    // get first two events using different methods
+    $firstTwo = Participant::get()
+      ->setCheckPermissions(FALSE)
+      ->addWhere('event_id', 'IN', [$firstEventId, $secondEventId])
+      ->execute();
+
+    $firstResult = $result->first();
+
+    // verify counts
+    // count should either twice the first event count or one less
+    $this->assertLessThanOrEqual(
+      $expectedFirstEventCount * 2,
+      count($firstTwo),
+      "count is too high"
+    );
+
+    $this->assertGreaterThanOrEqual(
+      $expectedFirstEventCount * 2 - 1,
+      count($firstTwo),
+      "count is too low"
+    );
+
+    $firstParticipantResult = Participant::get()
+      ->setCheckPermissions(FALSE)
+      ->addWhere('event_id', '=', $firstEventId)
+      ->addWhere('contact_id', '=', $firstContactId)
+      ->execute();
+
+    $this->assertEquals(1, count($firstParticipantResult), "more than one registration");
+
+    $firstParticipantId = $firstParticipantResult->first()['id'];
+
+    // get a result which excludes $first_participant
+    $otherParticipantResult = Participant::get()
+      ->setCheckPermissions(FALSE)
+      ->setSelect(['id'])
+      ->addClause('NOT', [
+          ['event_id', '=', $firstEventId],
+          ['contact_id', '=', $firstContactId],
+        ]
+      )
+      ->execute()
+      ->indexBy('id');
+
+    // check alternate syntax for NOT
+    $otherParticipantResult2 = Participant::get()
+      ->setCheckPermissions(FALSE)
+      ->setSelect(['id'])
+      ->addClause('NOT', 'AND', [
+          ['event_id', '=', $firstEventId],
+          ['contact_id', '=', $firstContactId],
+        ]
+      )
+      ->execute()
+      ->indexBy('id');
+
+    $this->assertEquals($otherParticipantResult, $otherParticipantResult2);
+
+    $this->assertEquals($participantCount - 1,
+      count($otherParticipantResult),
+      "failed to exclude a single record on complex criteria");
+    // check the record we have excluded is the right one:
+
+    $this->assertFalse(
+      $otherParticipantResult->offsetExists($firstParticipantId),
+      'excluded wrong record');
+
+    // retrieve a participant record and update some records
+    $patchRecord = [
+      'source' => "not " . $firstResult['source'],
+    ];
+
+    Participant::update()
+      ->addWhere('event_id', '=', $firstEventId)
+      ->setCheckPermissions(FALSE)
+      ->setLimit(20)
+      ->setValues($patchRecord)
+      ->setCheckPermissions(FALSE)
+      ->execute();
+
+    // - delete some records
+    $secondEventId = $dummy['events'][1]['id'];
+    $deleteResult = Participant::delete()
+      ->addWhere('event_id', '=', $secondEventId)
+      ->setCheckPermissions(FALSE)
+      ->execute();
+    $expectedDeletes = [2, 7, 12, 17];
+    $this->assertEquals($expectedDeletes, (array) $deleteResult,
+      "didn't delete every second record as expected");
+
+    $sqlCount = $this->getRowCount('civicrm_participant');
+    $this->assertEquals(
+      $participantCount - count($expectedDeletes),
+      $sqlCount,
+      "records not gone from database after delete");
+  }
+
+}