Logger::manuallyConfirmRequest() - Code Metrics - Inspection of "Introduce manual confirmation" - enwikipedia-acc/waca - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Pull Request — new-search (#753)

by Matthew

created 2022-08-05 22:01 UTC

Logger::manuallyConfirmRequest() A

↳ Parent: Logger

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes

Metric	Value
eloc	1
c	0
b	0
f	0
dl	0
loc	3
ccs	0
cts	3
cp	0
rs	10
cc	1
nc	1
nop	2
crap	2

<?php
/******************************************************************************
 * Wikipedia Account Creation Assistance tool                                 *
 *                                                                            *
 * All code in this file is released into the public domain by the ACC        *
 * Development Team. Please see team.json for a list of contributors.         *
 ******************************************************************************/

namespace Waca\Helpers;

use Exception;
use Waca\DataObject;
use Waca\DataObjects\Ban;
use Waca\DataObjects\Comment;
use Waca\DataObjects\Domain;
use Waca\DataObjects\EmailTemplate;
use Waca\DataObjects\JobQueue;
use Waca\DataObjects\Log;
use Waca\DataObjects\Request;
use Waca\DataObjects\RequestQueue;
use Waca\DataObjects\SiteNotice;
use Waca\DataObjects\User;
use Waca\DataObjects\WelcomeTemplate;
use Waca\PdoDatabase;

/**
 * Helper class for creating log entries
 *
 * Logger description.
 *
 * @version 1.0
 * @author  stwalkerster
 */
class Logger
{
    /**
     * @param PdoDatabase $database
     * @param Request     $object
     */
    public static function emailConfirmed(PdoDatabase $database, Request $object)
    {
        self::createLogEntry($database, $object, "Email Confirmed", null, User::getCommunity());
    }

    /**
     * @param PdoDatabase $database
     * @param DataObject  $object
     * @param string      $logAction
     * @param null|string $comment
     * @param User        $user
     *
     * @throws Exception
     */
    private static function createLogEntry(
        PdoDatabase $database,
        DataObject $object,
        $logAction,
        $comment = null,
        $user = null
    ) {
        if ($user == null) {
            $user = User::getCurrent($database);
        }

        $objectType = get_class($object);
        if (strpos($objectType, 'Waca\\DataObjects\\') !== false) {
            $objectType = str_replace('Waca\\DataObjects\\', '', $objectType);
        }

        $log = new Log();
        $log->setDatabase($database);
        $log->setAction($logAction);
        $log->setObjectId($object->getId());
        $log->setObjectType($objectType);
        $log->setUser($user);
        $log->setComment($comment);
        $log->save();
    }

    #region Users

    /**
     * @param PdoDatabase $database
     * @param User        $user
     */
    public static function newUser(PdoDatabase $database, User $user)
    {
        self::createLogEntry($database, $user, 'Registered', null, User::getCommunity());
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     */
    public static function approvedUser(PdoDatabase $database, User $object)
    {
        self::createLogEntry($database, $object, "Approved");
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     * @param string      $comment
     */
    public static function declinedUser(PdoDatabase $database, User $object, $comment)
    {
        self::createLogEntry($database, $object, "Declined", $comment);
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     * @param string      $comment
     */
    public static function suspendedUser(PdoDatabase $database, User $object, $comment)
    {
        self::createLogEntry($database, $object, "Suspended", $comment);
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     * @param string      $comment
     */
    public static function demotedUser(PdoDatabase $database, User $object, $comment)
    {
        self::createLogEntry($database, $object, "Demoted", $comment);
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     */
    public static function promotedUser(PdoDatabase $database, User $object)
    {
        self::createLogEntry($database, $object, "Promoted");
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     * @param string      $comment
     */
    public static function renamedUser(PdoDatabase $database, User $object, $comment)
    {
        self::createLogEntry($database, $object, "Renamed", $comment);
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     */
    public static function userPreferencesChange(PdoDatabase $database, User $object)
    {
        self::createLogEntry($database, $object, "Prefchange");
    }

    /**
     * @param PdoDatabase $database
     * @param User        $object
     * @param string      $reason
     * @param array       $added
     * @param array       $removed
     */
    public static function userRolesEdited(PdoDatabase $database, User $object, $reason, $added, $removed)
    {
        $logData = serialize(array(
            'added'   => $added,
            'removed' => $removed,
            'reason'  => $reason,
        ));

        self::createLogEntry($database, $object, "RoleChange", $logData);
    }

    #endregion

    /**
     * @param PdoDatabase $database
     * @param SiteNotice  $object
     */
    public static function siteNoticeEdited(PdoDatabase $database, SiteNotice $object)
    {
        self::createLogEntry($database, $object, "Edited");
    }

    #region Welcome Templates

    /**
     * @param PdoDatabase     $database
     * @param WelcomeTemplate $object
     */
    public static function welcomeTemplateCreated(PdoDatabase $database, WelcomeTemplate $object)
    {
        self::createLogEntry($database, $object, "CreatedTemplate");
    }

    /**
     * @param PdoDatabase     $database
     * @param WelcomeTemplate $object
     */
    public static function welcomeTemplateEdited(PdoDatabase $database, WelcomeTemplate $object)
    {
        self::createLogEntry($database, $object, "EditedTemplate");
    }

    /**
     * @param PdoDatabase     $database
     * @param WelcomeTemplate $object
     */
    public static function welcomeTemplateDeleted(PdoDatabase $database, WelcomeTemplate $object)
    {
        self::createLogEntry($database, $object, "DeletedTemplate");
    }

    #endregion

    #region Bans

    /**
     * @param PdoDatabase $database
     * @param Ban         $object
     * @param string      $reason
     */
    public static function banned(PdoDatabase $database, Ban $object, $reason)
    {
        self::createLogEntry($database, $object, "Banned", $reason);
    }

    /**
     * @param PdoDatabase $database
     * @param Ban         $object
     * @param string      $reason
     */
    public static function unbanned(PdoDatabase $database, Ban $object, $reason)
    {
        self::createLogEntry($database, $object, "Unbanned", $reason);
    }

    #endregion

    #region Requests

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     * @param string      $target
     */
    public static function deferRequest(PdoDatabase $database, Request $object, $target)
    {
        self::createLogEntry($database, $object, "Deferred to $target");
    }

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     * @param integer     $target
     * @param string      $comment
     * @param User|null   $logUser
     */
    public static function closeRequest(PdoDatabase $database, Request $object, $target, $comment, User $logUser = null)
    {
        self::createLogEntry($database, $object, "Closed $target", $comment, $logUser);
    }

    public static function manuallyConfirmRequest(PdoDatabase $database, Request $object)
    {
        self::createLogEntry($database, $object, "Manually Confirmed");
    }

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     */
    public static function reserve(PdoDatabase $database, Request $object)
    {
        self::createLogEntry($database, $object, "Reserved");
    }

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     */
    public static function breakReserve(PdoDatabase $database, Request $object)
    {
        self::createLogEntry($database, $object, "BreakReserve");
    }

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     */
    public static function unreserve(PdoDatabase $database, Request $object)
    {
        self::createLogEntry($database, $object, "Unreserved");
    }

    /**
     * @param PdoDatabase $database
     * @param Comment     $object
     * @param Request     $request
     */
    public static function editComment(PdoDatabase $database, Comment $object, Request $request)
    {
        self::createLogEntry($database, $request, "EditComment-r");
        self::createLogEntry($database, $object, "EditComment-c");
    }

    /**
     * @param PdoDatabase $database
     * @param Comment     $object
     */
    public static function flaggedComment(PdoDatabase $database, Comment $object)
    {
        self::createLogEntry($database, $object, "FlaggedComment");
    }

    /**
     * @param PdoDatabase $database
     * @param Comment     $object
     */
    public static function unflaggedComment(PdoDatabase $database, Comment $object)
    {
        self::createLogEntry($database, $object, "UnflaggedComment");
    }

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     * @param User        $target
     */
    public static function sendReservation(PdoDatabase $database, Request $object, User $target)
    {
        self::createLogEntry($database, $object, "SendReserved");
        self::createLogEntry($database, $object, "ReceiveReserved", null, $target);
    }

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     * @param string      $comment
     */
    public static function sentMail(PdoDatabase $database, Request $object, $comment)
    {
        self::createLogEntry($database, $object, "SentMail", $comment);
    }

    /**
     * @param PdoDatabase $database
     * @param Request     $object
     */
    public static function enqueuedJobQueue(PdoDatabase $database, Request $object)
    {
        self::createLogEntry($database, $object, 'EnqueuedJobQueue');
    }

    public static function hospitalised(PdoDatabase $database, Request $object)
    {
        self::createLogEntry($database, $object, 'Hospitalised');
    }
    #endregion

    #region Email templates

    /**
     * @param PdoDatabase   $database
     * @param EmailTemplate $object
     */
    public static function createEmail(PdoDatabase $database, EmailTemplate $object)
    {
        self::createLogEntry($database, $object, "CreatedEmail");
    }

    /**
     * @param PdoDatabase   $database
     * @param EmailTemplate $object
     */
    public static function editedEmail(PdoDatabase $database, EmailTemplate $object)
    {
        self::createLogEntry($database, $object, "EditedEmail");
    }

    #endregion

    #region Display

    #endregion

    #region Automation

    public static function backgroundJobComplete(PdoDatabase $database, JobQueue $job)
    {
        self::createLogEntry($database, $job, 'JobCompleted', null, User::getCommunity());
    }

    public static function backgroundJobIssue(PdoDatabase $database, JobQueue $job)
    {
        $data = array('status' => $job->getStatus(), 'error' => $job->getError());
        self::createLogEntry($database, $job, 'JobIssue', serialize($data), User::getCommunity());
    }

    public static function backgroundJobCancelled(PdoDatabase $database, JobQueue $job)
    {
        self::createLogEntry($database, $job, 'JobCancelled', $job->getError());
    }

    public static function backgroundJobRequeued(PdoDatabase $database, JobQueue $job)
    {
        self::createLogEntry($database, $job, 'JobRequeued');
    }

    public static function backgroundJobAcknowledged(PdoDatabase $database, JobQueue $job, $comment = null)
    {
        self::createLogEntry($database, $job, 'JobAcknowledged', $comment);
    }
    #endregion

    #region Request Queues
    public static function requestQueueCreated(PdoDatabase $database, RequestQueue $queue)
    {
        self::createLogEntry($database, $queue, 'QueueCreated');
    }

    public static function requestQueueEdited(PdoDatabase $database, RequestQueue $queue)
    {
        self::createLogEntry($database, $queue, 'QueueEdited');
    }
    #endregion
    #region Domains
    public static function domainCreated(PdoDatabase $database, Domain $domain)
    {
        self::createLogEntry($database, $domain, 'DomainCreated');
    }

    public static function domainEdited(PdoDatabase $database, Domain $domain)
    {
        self::createLogEntry($database, $domain, 'DomainEdited');
    }
    #endregion
}


1			<?php
2			/******************************************************************************
3			* Wikipedia Account Creation Assistance tool *
4			* *
5			* All code in this file is released into the public domain by the ACC *
6			* Development Team. Please see team.json for a list of contributors. *
7			******************************************************************************/
8
9			namespace Waca\Helpers;
10
11			use Exception;
12			use Waca\DataObject;
13			use Waca\DataObjects\Ban;
14			use Waca\DataObjects\Comment;
15			use Waca\DataObjects\Domain;
16			use Waca\DataObjects\EmailTemplate;
17			use Waca\DataObjects\JobQueue;
18			use Waca\DataObjects\Log;
19			use Waca\DataObjects\Request;
20			use Waca\DataObjects\RequestQueue;
21			use Waca\DataObjects\SiteNotice;
22			use Waca\DataObjects\User;
23			use Waca\DataObjects\WelcomeTemplate;
24			use Waca\PdoDatabase;
25
26			/**
27			* Helper class for creating log entries
28			*
29			* Logger description.
30			*
31			* @version 1.0
32			* @author stwalkerster
33			*/
34			class Logger
35			{
36			/**
37			* @param PdoDatabase $database
38			* @param Request $object
39			*/
40			public static function emailConfirmed(PdoDatabase $database, Request $object)
41			{
42			self::createLogEntry($database, $object, "Email Confirmed", null, User::getCommunity());
43			}
44
45			/**
46			* @param PdoDatabase $database
47			* @param DataObject $object
48			* @param string $logAction
49			* @param null\|string $comment
50			* @param User $user
51			*
52			* @throws Exception
53			*/
54			private static function createLogEntry(
55			PdoDatabase $database,
56			DataObject $object,
57			$logAction,
58			$comment = null,
59			$user = null
60			) {
61			if ($user == null) {
62			$user = User::getCurrent($database);
63			}
64
65			$objectType = get_class($object);
66			if (strpos($objectType, 'Waca\\DataObjects\\') !== false) {
67			$objectType = str_replace('Waca\\DataObjects\\', '', $objectType);
68			}
69
70			$log = new Log();
71			$log->setDatabase($database);
72			$log->setAction($logAction);
73			$log->setObjectId($object->getId());
74			$log->setObjectType($objectType);
75			$log->setUser($user);
76			$log->setComment($comment);
77			$log->save();
78			}
79
80			#region Users
81
82			/**
83			* @param PdoDatabase $database
84			* @param User $user
85			*/
86			public static function newUser(PdoDatabase $database, User $user)
87			{
88			self::createLogEntry($database, $user, 'Registered', null, User::getCommunity());
89			}
90
91			/**
92			* @param PdoDatabase $database
93			* @param User $object
94			*/
95			public static function approvedUser(PdoDatabase $database, User $object)
96			{
97			self::createLogEntry($database, $object, "Approved");
98			}
99
100			/**
101			* @param PdoDatabase $database
102			* @param User $object
103			* @param string $comment
104			*/
105			public static function declinedUser(PdoDatabase $database, User $object, $comment)
106			{
107			self::createLogEntry($database, $object, "Declined", $comment);
108			}
109
110			/**
111			* @param PdoDatabase $database
112			* @param User $object
113			* @param string $comment
114			*/
115			public static function suspendedUser(PdoDatabase $database, User $object, $comment)
116			{
117			self::createLogEntry($database, $object, "Suspended", $comment);
118			}
119
120			/**
121			* @param PdoDatabase $database
122			* @param User $object
123			* @param string $comment
124			*/
125			public static function demotedUser(PdoDatabase $database, User $object, $comment)
126			{
127			self::createLogEntry($database, $object, "Demoted", $comment);
128			}
129
130			/**
131			* @param PdoDatabase $database
132			* @param User $object
133			*/
134			public static function promotedUser(PdoDatabase $database, User $object)
135			{
136			self::createLogEntry($database, $object, "Promoted");
137			}
138
139			/**
140			* @param PdoDatabase $database
141			* @param User $object
142			* @param string $comment
143			*/
144			public static function renamedUser(PdoDatabase $database, User $object, $comment)
145			{
146			self::createLogEntry($database, $object, "Renamed", $comment);
147			}
148
149			/**
150			* @param PdoDatabase $database
151			* @param User $object
152			*/
153			public static function userPreferencesChange(PdoDatabase $database, User $object)
154			{
155			self::createLogEntry($database, $object, "Prefchange");
156			}
157
158			/**
159			* @param PdoDatabase $database
160			* @param User $object
161			* @param string $reason
162			* @param array $added
163			* @param array $removed
164			*/
165			public static function userRolesEdited(PdoDatabase $database, User $object, $reason, $added, $removed)
166			{
167			$logData = serialize(array(
168			'added' => $added,
169			'removed' => $removed,
170			'reason' => $reason,
171			));
172
173			self::createLogEntry($database, $object, "RoleChange", $logData);
174			}
175
176			#endregion
177
178			/**
179			* @param PdoDatabase $database
180			* @param SiteNotice $object
181			*/
182			public static function siteNoticeEdited(PdoDatabase $database, SiteNotice $object)
183			{
184			self::createLogEntry($database, $object, "Edited");
185			}
186
187			#region Welcome Templates
188
189			/**
190			* @param PdoDatabase $database
191			* @param WelcomeTemplate $object
192			*/
193			public static function welcomeTemplateCreated(PdoDatabase $database, WelcomeTemplate $object)
194			{
195			self::createLogEntry($database, $object, "CreatedTemplate");
196			}
197
198			/**
199			* @param PdoDatabase $database
200			* @param WelcomeTemplate $object
201			*/
202			public static function welcomeTemplateEdited(PdoDatabase $database, WelcomeTemplate $object)
203			{
204			self::createLogEntry($database, $object, "EditedTemplate");
205			}
206
207			/**
208			* @param PdoDatabase $database
209			* @param WelcomeTemplate $object
210			*/
211			public static function welcomeTemplateDeleted(PdoDatabase $database, WelcomeTemplate $object)
212			{
213			self::createLogEntry($database, $object, "DeletedTemplate");
214			}
215
216			#endregion
217
218			#region Bans
219
220			/**
221			* @param PdoDatabase $database
222			* @param Ban $object
223			* @param string $reason
224			*/
225			public static function banned(PdoDatabase $database, Ban $object, $reason)
226			{
227			self::createLogEntry($database, $object, "Banned", $reason);
228			}
229
230			/**
231			* @param PdoDatabase $database
232			* @param Ban $object
233			* @param string $reason
234			*/
235			public static function unbanned(PdoDatabase $database, Ban $object, $reason)
236			{
237			self::createLogEntry($database, $object, "Unbanned", $reason);
238			}
239
240			#endregion
241
242			#region Requests
243
244			/**
245			* @param PdoDatabase $database
246			* @param Request $object
247			* @param string $target
248			*/
249			public static function deferRequest(PdoDatabase $database, Request $object, $target)
250			{
251			self::createLogEntry($database, $object, "Deferred to $target");
252			}
253
254			/**
255			* @param PdoDatabase $database
256			* @param Request $object
257			* @param integer $target
258			* @param string $comment
259			* @param User\|null $logUser
260			*/
261			public static function closeRequest(PdoDatabase $database, Request $object, $target, $comment, User $logUser = null)
262			{
263			self::createLogEntry($database, $object, "Closed $target", $comment, $logUser);
264			}
265
266			public static function manuallyConfirmRequest(PdoDatabase $database, Request $object)
267			{
268			self::createLogEntry($database, $object, "Manually Confirmed");
269			}
270
271			/**
272			* @param PdoDatabase $database
273			* @param Request $object
274			*/
275			public static function reserve(PdoDatabase $database, Request $object)
276			{
277			self::createLogEntry($database, $object, "Reserved");
278			}
279
280			/**
281			* @param PdoDatabase $database
282			* @param Request $object
283			*/
284			public static function breakReserve(PdoDatabase $database, Request $object)
285			{
286			self::createLogEntry($database, $object, "BreakReserve");
287			}
288
289			/**
290			* @param PdoDatabase $database
291			* @param Request $object
292			*/
293			public static function unreserve(PdoDatabase $database, Request $object)
294			{
295			self::createLogEntry($database, $object, "Unreserved");
296			}
297
298			/**
299			* @param PdoDatabase $database
300			* @param Comment $object
301			* @param Request $request
302			*/
303			public static function editComment(PdoDatabase $database, Comment $object, Request $request)
304			{
305			self::createLogEntry($database, $request, "EditComment-r");
306			self::createLogEntry($database, $object, "EditComment-c");
307			}
308
309			/**
310			* @param PdoDatabase $database
311			* @param Comment $object
312			*/
313			public static function flaggedComment(PdoDatabase $database, Comment $object)
314			{
315			self::createLogEntry($database, $object, "FlaggedComment");
316			}
317
318			/**
319			* @param PdoDatabase $database
320			* @param Comment $object
321			*/
322			public static function unflaggedComment(PdoDatabase $database, Comment $object)
323			{
324			self::createLogEntry($database, $object, "UnflaggedComment");
325			}
326
327			/**
328			* @param PdoDatabase $database
329			* @param Request $object
330			* @param User $target
331			*/
332			public static function sendReservation(PdoDatabase $database, Request $object, User $target)
333			{
334			self::createLogEntry($database, $object, "SendReserved");
335			self::createLogEntry($database, $object, "ReceiveReserved", null, $target);
336			}
337
338			/**
339			* @param PdoDatabase $database
340			* @param Request $object
341			* @param string $comment
342			*/
343			public static function sentMail(PdoDatabase $database, Request $object, $comment)
344			{
345			self::createLogEntry($database, $object, "SentMail", $comment);
346			}
347
348			/**
349			* @param PdoDatabase $database
350			* @param Request $object
351			*/
352			public static function enqueuedJobQueue(PdoDatabase $database, Request $object)
353			{
354			self::createLogEntry($database, $object, 'EnqueuedJobQueue');
355			}
356
357			public static function hospitalised(PdoDatabase $database, Request $object)
358			{
359			self::createLogEntry($database, $object, 'Hospitalised');
360			}
361			#endregion
362
363			#region Email templates
364
365			/**
366			* @param PdoDatabase $database
367			* @param EmailTemplate $object
368			*/
369			public static function createEmail(PdoDatabase $database, EmailTemplate $object)
370			{
371			self::createLogEntry($database, $object, "CreatedEmail");
372			}
373
374			/**
375			* @param PdoDatabase $database
376			* @param EmailTemplate $object
377			*/
378			public static function editedEmail(PdoDatabase $database, EmailTemplate $object)
379			{
380			self::createLogEntry($database, $object, "EditedEmail");
381			}
382
383			#endregion
384
385			#region Display
386
387			#endregion
388
389			#region Automation
390
391			public static function backgroundJobComplete(PdoDatabase $database, JobQueue $job)
392			{
393			self::createLogEntry($database, $job, 'JobCompleted', null, User::getCommunity());
394			}
395
396			public static function backgroundJobIssue(PdoDatabase $database, JobQueue $job)
397			{
398			$data = array('status' => $job->getStatus(), 'error' => $job->getError());
399			self::createLogEntry($database, $job, 'JobIssue', serialize($data), User::getCommunity());
400			}
401
402			public static function backgroundJobCancelled(PdoDatabase $database, JobQueue $job)
403			{
404			self::createLogEntry($database, $job, 'JobCancelled', $job->getError());
405			}
406
407			public static function backgroundJobRequeued(PdoDatabase $database, JobQueue $job)
408			{
409			self::createLogEntry($database, $job, 'JobRequeued');
410			}
411
412			public static function backgroundJobAcknowledged(PdoDatabase $database, JobQueue $job, $comment = null)
413			{
414			self::createLogEntry($database, $job, 'JobAcknowledged', $comment);
415			}
416			#endregion
417
418			#region Request Queues
419			public static function requestQueueCreated(PdoDatabase $database, RequestQueue $queue)
420			{
421			self::createLogEntry($database, $queue, 'QueueCreated');
422			}
423
424			public static function requestQueueEdited(PdoDatabase $database, RequestQueue $queue)
425			{
426			self::createLogEntry($database, $queue, 'QueueEdited');
427			}
428			#endregion
429			#region Domains
430			public static function domainCreated(PdoDatabase $database, Domain $domain)
431			{
432			self::createLogEntry($database, $domain, 'DomainCreated');
433			}
434
435			public static function domainEdited(PdoDatabase $database, Domain $domain)
436			{
437			self::createLogEntry($database, $domain, 'DomainEdited');
438			}
439			#endregion
440			}
441

enwikipedia-acc / waca

Pull Request — new-search (#753)

Logger::manuallyConfirmRequest() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like