Subscription::getCollectionMethod() - Code Metrics - Inspection of "Add new method to create a card" - shapintv/stripe - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( ba6533...24d46d )

by Olivier

created 2019-10-23 10:32 UTC

Subscription::getCollectionMethod() A

↳ Parent: Subscription

Complexity

Conditions	1
Paths	1

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes

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

<?php

declare(strict_types=1);

/*
 * This software may be modified and distributed under the terms
 * of the MIT license. See the LICENSE file for details.
 */

namespace Shapin\Stripe\Model\Subscription;

use Shapin\Stripe\Model\ContainsMetadata;
use Shapin\Stripe\Model\CreatableFromArray;
use Shapin\Stripe\Model\Discount\Discount;
use Shapin\Stripe\Model\LivemodeTrait;
use Shapin\Stripe\Model\MetadataTrait;
use Shapin\Stripe\Model\MetadataCollection;
use Shapin\Stripe\Model\Plan\Plan;

final class Subscription implements CreatableFromArray, ContainsMetadata
{
    use LivemodeTrait;
    use MetadataTrait;

    const BILLING_CHARGE_AUTOMATICALLY = 'charge_automatically';
    const BILLING_SEND_INVOICE = 'send_invoice';

    const STATUS_EXPIRED = 'incomplete_expired';
    const STATUS_INCOMPLETE = 'incomplete';
    const STATUS_TRIALING = 'trialing';
    const STATUS_ACTIVE = 'active';
    const STATUS_PAST_DUE = 'past_due';
    const STATUS_CANCELED = 'canceled';
    const STATUS_UNPAID = 'unpaid';

    /**
     * @var string
     */
    private $id;

    /**
     * @var ?float
     */
    private $applicationFeePercent;

    /**
     * @var string
     */
    private $collectionMethod;

    /**
     * @var mixed
     */
    private $billingCycleAnchor;

    /**
     * @var bool
     */
    private $cancelAtPeriodEnd;

    /**
     * @var ?\DateTimeImmutable
     */
    private $canceledAt;

    /**
     * @var \DateTimeImmutable
     */
    private $createdAt;

    /**
     * @var \DateTimeImmutable
     */
    private $currentPeriodEndAt;

    /**
     * @var \DateTimeImmutable
     */
    private $currentPeriodStartAt;

    /**
     * @var string
     */
    private $customer;

    /**
     * @var ?int
     */
    private $daysUntilDue;

    /**
     * @var ?string
     */
    private $defaultSource;

    /**
     * @var array
     */
    private $defaultTaxRates;

    /**
     * @var ?Discount
     */
    private $discount;

    /**
     * @var ?\DateTimeImmutable
     */
    private $endedAt;

    /**
     * @var ItemCollection
     */
    private $items;

    /**
     * @var ?string
     */
    private $latestInvoiceId;

    /**
     * @var ?string
     */
    private $pendingSetupIntentId;

    /**
     * @var Plan
     */
    private $plan;

    /**
     * @var int
     */
    private $quantity;

    /**
     * @var \DateTimeImmutable
     */
    private $startAt;

    /**
     * @var string
     */
    private $status;

    /**
     * @var ?\DateTimeImmutable
     */
    private $trialEndAt;

    /**
     * @var ?\DateTimeImmutable
     */
    private $trialStartAt;

    public static function createFromArray(array $data): self
    {
        $model = new self();
        $model->id = $data['id'];
        $model->applicationFeePercent = null !== $data['application_fee_percent'] ? (float) $data['application_fee_percent'] : null;
        $model->collectionMethod = $data['collection_method'];
        $model->billingCycleAnchor = $data['billing_cycle_anchor'];
        $model->cancelAtPeriodEnd = (bool) $data['cancel_at_period_end'];
        $model->canceledAt = null !== $data['canceled_at'] ? new \DateTimeImmutable('@'.$data['canceled_at']) : null;
        $model->createdAt = new \DateTimeImmutable('@'.$data['created']);
        $model->currentPeriodEndAt = new \DateTimeImmutable('@'.$data['current_period_end']);
        $model->currentPeriodStartAt = new \DateTimeImmutable('@'.$data['current_period_start']);
        $model->customer = $data['customer'];
        $model->daysUntilDue = null !== $data['days_until_due'] ? (int) $data['days_until_due'] : null;
        $model->defaultSource = $data['default_source'] ?? null;
        $model->defaultTaxRates = $data['default_tax_rates'];
        $model->discount = isset($data['discount']) ? Discount::createFromArray($data['discount']) : null;
        $model->endedAt = null !== $data['ended_at'] ? new \DateTimeImmutable('@'.$data['ended_at']) : null;
        $model->items = ItemCollection::createFromArray($data['items']);

        $model->latestInvoiceId = $data['latest_invoice'];
        $model->live = $data['livemode'];
        $model->metadata = MetadataCollection::createFromArray($data['metadata']);

        $model->pendingSetupIntentId = $data['pending_setup_intent'] ?? null;
        $model->plan = Plan::createFromArray($data['plan']);

        $model->quantity = (int) $data['quantity'];
        $model->startAt = new \DateTimeImmutable('@'.$data['start_date']);
        $model->status = $data['status'];
        $model->trialEndAt = null !== $data['trial_end'] ? new \DateTimeImmutable('@'.$data['trial_end']) : null;
        $model->trialStartAt = null !== $data['trial_start'] ? new \DateTimeImmutable('@'.$data['trial_start']) : null;

        return $model;
    }

    public function isBilledAutomatically(): bool
    {
        return self::BILLING_CHARGE_AUTOMATICALLY === $this->collectionMethod;
    }

    public function isIncomplete(): bool
    {
        return self::STATUS_INCOMPLETE === $this->status;
    }

    public function isExpired(): bool
    {
        return self::STATUS_EXPIRED === $this->status;
    }

    public function isTrialing(): bool
    {
        return self::STATUS_TRIALING === $this->status;
    }

    public function isActive(): bool
    {
        return self::STATUS_ACTIVE === $this->status;
    }

    public function isPastDue(): bool
    {
        return self::STATUS_PAST_DUE === $this->status;
    }

    public function isCanceled(): bool
    {
        return self::STATUS_CANCELED === $this->status;
    }

    public function isUnpaid(): bool
    {
        return self::STATUS_UNPAID === $this->status;
    }

    public function hasDefaultSource(): bool
    {
        return null !== $this->defaultSource;
    }

    public function getId(): string
    {
        return $this->id;
    }

    public function getApplicationFeePercent(): ?float
    {
        return $this->applicationFeePercent;
    }

    public function getBilling(): string
    {
        @trigger_error('Calling the method getBilling is deprecated since Stripe API 2019-10-17. Use getCollectionMethod instead.', E_USER_DEPRECATED);
// For example instead of
@mkdir($dir);

// Better use
if (@mkdir($dir) === false) {
    throw new \RuntimeException('The directory '.$dir.' could not be created.');
}

        return $this->collectionMethod;
    }

    public function getCollectionMethod(): string
    {
        return $this->collectionMethod;
    }

    public function getBillingCycleAnchor()
    {
        return $this->billingCycleAnchor;
    }

    public function willBeCanceledAtPeriodEnd(): bool
    {
        return $this->cancelAtPeriodEnd;
    }

    public function getCanceledAt(): ?\DateTimeImmutable
    {
        return $this->canceledAt;
    }

    public function getCreatedAt(): \DateTimeImmutable
    {
        return $this->createdAt;
    }

    public function getCurrentPeriodEndAt(): \DateTimeImmutable
    {
        return $this->currentPeriodEndAt;
    }

    public function getCurrentPeriodStartAt(): \DateTimeImmutable
    {
        return $this->currentPeriodStartAt;
    }

    public function getCustomer(): string
    {
        return $this->customer;
    }

    public function getDaysUntilDue(): ?int
    {
        return $this->daysUntilDue;
    }

    public function getDefaultSource(): ?string
    {
        return $this->defaultSource;
    }

    public function getDefaultTaxRates(): array
    {
        return $this->defaultTaxRates;
    }

    public function getDiscount(): ?Discount
    {
        return $this->discount;
    }

    public function hasDiscount(): bool
    {
        return null !== $this->discount;
    }

    public function hasActiveDiscountForCurrentPeriod(): bool
    {
        if (!$this->hasDiscount()) {
            return false;
        }

        // Discount start after the current period
        if ($this->getCurrentPeriodEndAt() < $this->discount->getStartAt()) {
            return false;
        }

        // Discount has ended before the current period
        $endAt = $this->discount->getEndAt() ?? $this->discount->getStartAt();
        if ($this->getCurrentPeriodStartAt() > $endAt) {
            return false;
        }

        return true;
    }

    public function getEndedAt(): ?\DateTimeImmutable
    {
        return $this->endedAt;
    }

    public function getItems(): ItemCollection
    {
        return $this->items;
    }

    public function getLatestInvoiceId(): ?string
    {
        return $this->latestInvoiceId;
    }

    public function getPendingSetupIntentId(): ?string
    {
        return $this->pendingSetupIntentId;
    }

    public function getPlan(): Plan
    {
        return $this->plan;
    }

    public function getQuantity(): int
    {
        return $this->quantity;
    }

    public function getStartAt(): \DateTimeImmutable
    {
        return $this->startAt;
    }

    public function getStatus(): string
    {
        return $this->status;
    }

    public function getTrialEndAt(): ?\DateTimeImmutable
    {
        return $this->trialEndAt;
    }

    public function getTrialStartAt(): ?\DateTimeImmutable
    {
        return $this->trialStartAt;
    }
}


1		<?php
2
3		declare(strict_types=1);
4
5		/*
6		* This software may be modified and distributed under the terms
7		* of the MIT license. See the LICENSE file for details.
8		*/
9
10		namespace Shapin\Stripe\Model\Subscription;
11
12		use Shapin\Stripe\Model\ContainsMetadata;
13		use Shapin\Stripe\Model\CreatableFromArray;
14		use Shapin\Stripe\Model\Discount\Discount;
15		use Shapin\Stripe\Model\LivemodeTrait;
16		use Shapin\Stripe\Model\MetadataTrait;
17		use Shapin\Stripe\Model\MetadataCollection;
18		use Shapin\Stripe\Model\Plan\Plan;
19
20		final class Subscription implements CreatableFromArray, ContainsMetadata
21		{
22		use LivemodeTrait;
23		use MetadataTrait;
24
25		const BILLING_CHARGE_AUTOMATICALLY = 'charge_automatically';
26		const BILLING_SEND_INVOICE = 'send_invoice';
27
28		const STATUS_EXPIRED = 'incomplete_expired';
29		const STATUS_INCOMPLETE = 'incomplete';
30		const STATUS_TRIALING = 'trialing';
31		const STATUS_ACTIVE = 'active';
32		const STATUS_PAST_DUE = 'past_due';
33		const STATUS_CANCELED = 'canceled';
34		const STATUS_UNPAID = 'unpaid';
35
36		/**
37		* @var string
38		*/
39		private $id;
40
41		/**
42		* @var ?float
43		*/
44		private $applicationFeePercent;
45
46		/**
47		* @var string
48		*/
49		private $collectionMethod;
50
51		/**
52		* @var mixed
53		*/
54		private $billingCycleAnchor;
55
56		/**
57		* @var bool
58		*/
59		private $cancelAtPeriodEnd;
60
61		/**
62		* @var ?\DateTimeImmutable
63		*/
64		private $canceledAt;
65
66		/**
67		* @var \DateTimeImmutable
68		*/
69		private $createdAt;
70
71		/**
72		* @var \DateTimeImmutable
73		*/
74		private $currentPeriodEndAt;
75
76		/**
77		* @var \DateTimeImmutable
78		*/
79		private $currentPeriodStartAt;
80
81		/**
82		* @var string
83		*/
84		private $customer;
85
86		/**
87		* @var ?int
88		*/
89		private $daysUntilDue;
90
91		/**
92		* @var ?string
93		*/
94		private $defaultSource;
95
96		/**
97		* @var array
98		*/
99		private $defaultTaxRates;
100
101		/**
102		* @var ?Discount
103		*/
104		private $discount;
105
106		/**
107		* @var ?\DateTimeImmutable
108		*/
109		private $endedAt;
110
111		/**
112		* @var ItemCollection
113		*/
114		private $items;
115
116		/**
117		* @var ?string
118		*/
119		private $latestInvoiceId;
120
121		/**
122		* @var ?string
123		*/
124		private $pendingSetupIntentId;
125
126		/**
127		* @var Plan
128		*/
129		private $plan;
130
131		/**
132		* @var int
133		*/
134		private $quantity;
135
136		/**
137		* @var \DateTimeImmutable
138		*/
139		private $startAt;
140
141		/**
142		* @var string
143		*/
144		private $status;
145
146		/**
147		* @var ?\DateTimeImmutable
148		*/
149		private $trialEndAt;
150
151		/**
152		* @var ?\DateTimeImmutable
153		*/
154		private $trialStartAt;
155
156	8	public static function createFromArray(array $data): self
157		{
158	8	$model = new self();
159	8	$model->id = $data['id'];
160	8	$model->applicationFeePercent = null !== $data['application_fee_percent'] ? (float) $data['application_fee_percent'] : null;
161	8	$model->collectionMethod = $data['collection_method'];
162	8	$model->billingCycleAnchor = $data['billing_cycle_anchor'];
163	8	$model->cancelAtPeriodEnd = (bool) $data['cancel_at_period_end'];
164	8	$model->canceledAt = null !== $data['canceled_at'] ? new \DateTimeImmutable('@'.$data['canceled_at']) : null;
165	8	$model->createdAt = new \DateTimeImmutable('@'.$data['created']);
166	8	$model->currentPeriodEndAt = new \DateTimeImmutable('@'.$data['current_period_end']);
167	8	$model->currentPeriodStartAt = new \DateTimeImmutable('@'.$data['current_period_start']);
168	8	$model->customer = $data['customer'];
169	8	$model->daysUntilDue = null !== $data['days_until_due'] ? (int) $data['days_until_due'] : null;
170	8	$model->defaultSource = $data['default_source'] ?? null;
171	8	$model->defaultTaxRates = $data['default_tax_rates'];
172	8	$model->discount = isset($data['discount']) ? Discount::createFromArray($data['discount']) : null;
173	8	$model->endedAt = null !== $data['ended_at'] ? new \DateTimeImmutable('@'.$data['ended_at']) : null;
174	8	$model->items = ItemCollection::createFromArray($data['items']);
		0 ignored issues – show Documentation Bug introduced 2019-02-07 11:52 UTC by Report Bug Copy Issue Report It seems like `\Shapin\Stripe\Model\Sub...omArray($data['items'])` of type `object<self>` is incompatible with the declared type `object<Shapin\Stripe\Mod...ription\ItemCollection>` of property `$items`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history...
175	8	$model->latestInvoiceId = $data['latest_invoice'];
176	8	$model->live = $data['livemode'];
177	8	$model->metadata = MetadataCollection::createFromArray($data['metadata']);
		0 ignored issues – show Documentation Bug introduced 2019-06-18 09:02 UTC by Report Bug Copy Issue Report It seems like `\Shapin\Stripe\Model\Met...rray($data['metadata'])` of type `object<self>` is incompatible with the declared type `object<Shapin\Stripe\Model\MetadataCollection>` of property `$metadata`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history...
178	8	$model->pendingSetupIntentId = $data['pending_setup_intent'] ?? null;
179	8	$model->plan = Plan::createFromArray($data['plan']);
		0 ignored issues – show Documentation Bug introduced 2019-02-07 11:52 UTC by Report Bug Copy Issue Report It seems like `\Shapin\Stripe\Model\Pla...romArray($data['plan'])` of type `object<self>` is incompatible with the declared type `object<Shapin\Stripe\Model\Plan\Plan>` of property `$plan`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history...
180	8	$model->quantity = (int) $data['quantity'];
181	8	$model->startAt = new \DateTimeImmutable('@'.$data['start_date']);
182	8	$model->status = $data['status'];
183	8	$model->trialEndAt = null !== $data['trial_end'] ? new \DateTimeImmutable('@'.$data['trial_end']) : null;
184	8	$model->trialStartAt = null !== $data['trial_start'] ? new \DateTimeImmutable('@'.$data['trial_start']) : null;
185
186	8	return $model;
187		}
188
189	1	public function isBilledAutomatically(): bool
190		{
191	1	return self::BILLING_CHARGE_AUTOMATICALLY === $this->collectionMethod;
192		}
193
194		public function isIncomplete(): bool
195		{
196		return self::STATUS_INCOMPLETE === $this->status;
197		}
198
199		public function isExpired(): bool
200		{
201		return self::STATUS_EXPIRED === $this->status;
202		}
203
204		public function isTrialing(): bool
205		{
206		return self::STATUS_TRIALING === $this->status;
207		}
208
209		public function isActive(): bool
210		{
211		return self::STATUS_ACTIVE === $this->status;
212		}
213
214		public function isPastDue(): bool
215		{
216		return self::STATUS_PAST_DUE === $this->status;
217		}
218
219		public function isCanceled(): bool
220		{
221		return self::STATUS_CANCELED === $this->status;
222		}
223
224		public function isUnpaid(): bool
225		{
226		return self::STATUS_UNPAID === $this->status;
227		}
228
229		public function hasDefaultSource(): bool
230		{
231		return null !== $this->defaultSource;
232		}
233
234	1	public function getId(): string
235		{
236	1	return $this->id;
237		}
238
239	1	public function getApplicationFeePercent(): ?float
240		{
241	1	return $this->applicationFeePercent;
242		}
243
244		public function getBilling(): string
245		{
246		@trigger_error('Calling the method getBilling is deprecated since Stripe API 2019-10-17. Use getCollectionMethod instead.', E_USER_DEPRECATED);
		0 ignored issues – show Security Best Practice introduced 2019-10-23 10:34 UTC by Report Bug Copy Issue Report It seems like you do not handle an error condition here. This can introduce security issues, and is generally not recommended. If you suppress an error, we recommend checking for the error condition explicitly: // For example instead of @mkdir($dir); // Better use if (@mkdir($dir) === false) { throw new \RuntimeException('The directory '.$dir.' could not be created.'); } Loading history...
247
248		return $this->collectionMethod;
249		}
250
251	1	public function getCollectionMethod(): string
252		{
253	1	return $this->collectionMethod;
254		}
255
256	1	public function getBillingCycleAnchor()
257		{
258	1	return $this->billingCycleAnchor;
259		}
260
261	1	public function willBeCanceledAtPeriodEnd(): bool
262		{
263	1	return $this->cancelAtPeriodEnd;
264		}
265
266	1	public function getCanceledAt(): ?\DateTimeImmutable
267		{
268	1	return $this->canceledAt;
269		}
270
271	1	public function getCreatedAt(): \DateTimeImmutable
272		{
273	1	return $this->createdAt;
274		}
275
276	1	public function getCurrentPeriodEndAt(): \DateTimeImmutable
277		{
278	1	return $this->currentPeriodEndAt;
279		}
280
281	1	public function getCurrentPeriodStartAt(): \DateTimeImmutable
282		{
283	1	return $this->currentPeriodStartAt;
284		}
285
286	1	public function getCustomer(): string
287		{
288	1	return $this->customer;
289		}
290
291	1	public function getDaysUntilDue(): ?int
292		{
293	1	return $this->daysUntilDue;
294		}
295
296	1	public function getDefaultSource(): ?string
297		{
298	1	return $this->defaultSource;
299		}
300
301	1	public function getDefaultTaxRates(): array
302		{
303	1	return $this->defaultTaxRates;
304		}
305
306	1	public function getDiscount(): ?Discount
307		{
308	1	return $this->discount;
309		}
310
311	1	public function hasDiscount(): bool
312		{
313	1	return null !== $this->discount;
314		}
315
316	1	public function hasActiveDiscountForCurrentPeriod(): bool
317		{
318	1	if (!$this->hasDiscount()) {
319	1	return false;
320		}
321
322		// Discount start after the current period
323		if ($this->getCurrentPeriodEndAt() < $this->discount->getStartAt()) {
324		return false;
325		}
326
327		// Discount has ended before the current period
328		$endAt = $this->discount->getEndAt() ?? $this->discount->getStartAt();
329		if ($this->getCurrentPeriodStartAt() > $endAt) {
330		return false;
331		}
332
333		return true;
334		}
335
336	1	public function getEndedAt(): ?\DateTimeImmutable
337		{
338	1	return $this->endedAt;
339		}
340
341	1	public function getItems(): ItemCollection
342		{
343	1	return $this->items;
344		}
345
346	1	public function getLatestInvoiceId(): ?string
347		{
348	1	return $this->latestInvoiceId;
349		}
350
351	1	public function getPendingSetupIntentId(): ?string
352		{
353	1	return $this->pendingSetupIntentId;
354		}
355
356		public function getPlan(): Plan
357		{
358		return $this->plan;
359		}
360
361	1	public function getQuantity(): int
362		{
363	1	return $this->quantity;
364		}
365
366	1	public function getStartAt(): \DateTimeImmutable
367		{
368	1	return $this->startAt;
369		}
370
371	1	public function getStatus(): string
372		{
373	1	return $this->status;
374		}
375
376	1	public function getTrialEndAt(): ?\DateTimeImmutable
377		{
378	1	return $this->trialEndAt;
379		}
380
381	1	public function getTrialStartAt(): ?\DateTimeImmutable
382		{
383	1	return $this->trialStartAt;
384		}
385		}
386

shapintv / stripe

Push — master ( ba6533...24d46d )

Subscription::getCollectionMethod() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like