AppInfo::getVideo() - Code Metrics - Inspection of "Merge branch 'release/0.0.1'" - Ne-Lexa/google-play-scraper - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 45165d...5e44c4 )

by Alexey

created 2020-02-13 14:17 UTC

AppInfo::getVideo() A

↳ Parent: AppInfo

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes

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

<?php

declare(strict_types=1);

/**
 * @author   Ne-Lexa
 * @license  MIT
 *
 * @see      https://github.com/Ne-Lexa/google-play-scraper
 */

namespace Nelexa\GPlay\Model;

use Nelexa\GPlay\GPlayApps;
use Nelexa\GPlay\Model\Builder\AppBuilder;

/**
 * Contains detailed information about the application from the Google Play store.
 *
 * @see App Basic information about the application from the Google Play store.
 * @see GPlayApps::getAppInfo() Returns detailed information about the Android
 *     application from the Google Play store.
 * @see GPlayApps::getAppsInfo() Returns detailed information about many android packages.
 * @see GPlayApps::getAppInLocales() Returns detailed information about an application
 *     from the Google Play store for an array of locales.
 * @see GPlayApps::getAppInfoForAvailableLocales() Returns detailed information about the
 *     application in all available locales.
 */
final class AppInfo extends App
{
    /** @var string Default currency. */
    private const DEFAULT_CURRENCY = 'USD';

    /** @var string Application description. */
    private $description;

    /**
     * Locale (language) of the original description. Google automatically translates
     * the description of the application if the developer has not added it to the
     * Play Console in the "Add your own translation text" section. If a translation
     * is added, the value will be null.
     *
     * @var string|null locale of the original description or null
     *
     * @see https://support.google.com/googleplay/android-developer/answer/3125566
     */
    private $translatedFromLocale;

    /** @var GoogleImage|null Cover image. */
    private $cover;

    /** @var GoogleImage[] Screenshots of the application. */
    private $screenshots;

    /** @var Category Application category. */
    private $category;

    /** @var Category|null Family category or null/ */
    private $categoryFamily;

    /** @var Video|null Promo video or null. */
    private $video;

    /** @var string|null Recent changes. */
    private $recentChanges;

    /** @var bool Editors' choice. */
    private $editorsChoice;

    /** @var int Number of application installations. */
    private $installs;

    /** @var HistogramRating Histogram rating. */
    private $histogramRating;

    /** @var float Price of the application in the Google Play store. */
    private $price;

    /** @var string $currency Currency price of the application. */
    private $currency;

    /** @var string|null In-App Purchase price. */
    private $offersIAPCost;

    /** @var bool Application contains ads. */
    private $containsAds;

    /** @var string|null Application size, null if the size depends on the device. */
    private $size;

    /** @var string|null Application version, null if the application version depends on the device. */
    private $appVersion;

    /** @var string|null Android version, null if android version depends on the device. */
    private $androidVersion;

    /** @var string|null Minimum android version, null if android version depends on the device. */
    private $minAndroidVersion;

    /** @var string|null Content rating. */
    private $contentRating;

    /** @var string|null Privacy policy URL. */
    private $privacyPoliceUrl;

    /** @var \DateTimeInterface|null Release date if known. */
    private $released;

    /** @var \DateTimeInterface|null Update date or null. */
    private $updated;

    /** @var int Number of voters. */
    private $numberVoters;

    /** @var int Number of reviews. */
    private $numberReviews;

    /** @var Review[] Some useful reviews. */
    private $reviews;

    /**
     * Returns an object with detailed information about the application.
     *
     * @param AppBuilder $builder application builder
     *
     * @ignore
     */
    public function __construct(AppBuilder $builder)
    {
        parent::__construct($builder);

        if (empty($builder->getDescription())) {
            throw new \InvalidArgumentException(
                'Application description cannot be null or empty. Solution: $appBuilder->setDescription(...);'
            );
        }

        if (empty($builder->getScreenshots())) {
            throw new \InvalidArgumentException(
                'Screenshots of the application must contain at least one screenshot. Solution: $appBuilder->setScreenshots(...); or $appBuilder->addScreenshot(...);'
            );
        }

        if ($builder->getCategory() === null) {
            throw new \InvalidArgumentException(
                'Application category cannot be null. Solution: $appBuilder->setCategory(...);'
            );
        }

        $this->description = $builder->getDescription();
        $this->translatedFromLocale = $builder->getTranslatedFromLocale();
        $this->cover = $builder->getCover();
        $this->screenshots = $builder->getScreenshots();
        $this->category = $builder->getCategory();
        $this->categoryFamily = $builder->getCategoryFamily();
        $this->privacyPoliceUrl = $builder->getPrivacyPoliceUrl();
        $this->video = $builder->getVideo();
        $this->recentChanges = $builder->getRecentChanges();
        $this->editorsChoice = $builder->isEditorsChoice();
        $this->installs = $builder->getInstalls();
        $this->histogramRating = $builder->getHistogramRating() ??
            new HistogramRating(0, 0, 0, 0, 0);
        $this->price = $builder->getPrice();
        $this->currency = $builder->getCurrency() ?? self::DEFAULT_CURRENCY;
        $this->offersIAPCost = $builder->getOffersIAPCost();
        $this->containsAds = $builder->isContainsAds();
        $this->size = $builder->getSize();
        $this->appVersion = $builder->getAppVersion();
        $this->androidVersion = $builder->getAndroidVersion();
        $this->minAndroidVersion = $builder->getMinAndroidVersion();
        $this->contentRating = $builder->getContentRating();
        $this->released = $builder->getReleased();
        $this->updated = $builder->getUpdated();
        $this->numberVoters = $builder->getNumberVoters();
        $this->numberReviews = $builder->getNumberReviews();
        $this->reviews = $builder->getReviews();
    }

    /**
     * Returns a description of the application.
     *
     * @return string description of the application
     */
    public function getDescription(): string
    {
        return $this->description;
    }

    /**
     * Checks if the class description is automatically translated via Google Translate.
     *
     * @return bool `true` if the description was automatically translated using Google Translate and
     *              `false` if the developer added a description for the locale in the Google Play Console
     */
    public function isAutoTranslatedDescription(): bool
    {
        return $this->translatedFromLocale !== null;
    }

    /**
     * Returns locale (language) of the original description.
     *
     * Google automatically translates the description of the application if the developer
     * has not added it to the Play Console in the "Add your own translation text" section.
     * If a translation is added, the value will be null.
     *
     * @return string|null if the developer added a translation of the description, then the
     *                     value will be `null`, otherwise the original language of the application description
     */
    public function getTranslatedFromLocale(): ?string
    {
        return $this->translatedFromLocale;
    }

    /**
     * Returns cover image.
     *
     * **Where it's displayed**
     * The feature graphic is displayed in front of screenshots of the application and in
     * the list of developer applications. If a promo video is added, a **Play** button
     * will overlay on the feature graphic so users can watch the promo video.
     *
     * Google Play requirements:
     * * JPEG or 24-bit PNG (no alpha)
     * * Dimensions: 1024px by 500px
     *
     * @return GoogleImage|null cover image or `null`
     *
     * @see https://support.google.com/googleplay/android-developer/answer/1078870?hl=en Graphic assets,
     *     screenshots, & video. Section **Feature graphic**.
     */
    public function getCover(): ?GoogleImage
    {
        return $this->cover;
    }

    /**
     * Returns screenshots of the application.
     *
     * The array must contain at least 2 screenshots.
     *
     * Google Play screenshots requirements:
     * * JPEG or 24-bit PNG (no alpha)
     * * Minimum dimension: 320px
     * * Maximum dimension: 3840px
     * * The maximum dimension of the screenshot can't be more than twice as long as the minimum dimension.
     *
     * @return GoogleImage[] array of screenshots
     */
    public function getScreenshots(): array
    {
        return $this->screenshots;
    }

    /**
     * Returns the category of the application.
     *
     * @return Category category of application
     */
    public function getCategory(): Category
    {
        return $this->category;
    }

    /**
     * Returns family category.
     *
     * @return Category|null family category or `null`
     */
    public function getCategoryFamily(): ?Category
    {
        return $this->categoryFamily;
    }

    /**
     * Returns a video about the application.
     *
     * @return Video|null promo video or `null`
     */
    public function getVideo(): ?Video
    {
        return $this->video;
    }

    /**
     * Returns recent changes.
     *
     * @return string|null recent changes or null if not provided
     */
    public function getRecentChanges(): ?string
    {
        return $this->recentChanges;
    }

    /**
     * Checks if the application is an editors' choice.
     *
     * @return bool `true` if the application is selected by Google Play editor, otherwise `false`
     */
    public function isEditorsChoice(): bool
    {
        return $this->editorsChoice;
    }

    /**
     * Returns the number of installations of the application.
     *
     * @return int the number of installations of the application
     */
    public function getInstalls(): int
    {
        return $this->installs;
    }

    /**
     * Returns histogram rating.
     *
     * @return HistogramRating histogram rating
     */
    public function getHistogramRating(): HistogramRating
    {
        return $this->histogramRating;
    }

    /**
     * Returns the price of the app in the Google Play store.
     *
     * @return float price or 0.00 if the app is free
     *
     * @see AppInfo::getCurrency() Returns the price currency
     *     of the app in the Google Play store.
     */
    public function getPrice(): float
    {
        return $this->price;
    }

    /**
     * Returns the price currency of the app in the Google Play store.
     *
     * @return string currency price of the application, default USD
     */
    public function getCurrency(): string
    {
        return $this->currency;
    }

    /**
     * Checks if the app contains In-App Purchases (IAP).
     *
     * @return bool `true` if the application contains AIP, and `false` if not contains
     */
    public function isContainsIAP(): bool
    {
        return $this->offersIAPCost !== null;
    }

    /**
     * Returns the cost of In-App Purchases (IAP).
     *
     * @return string|null in-App Purchase price
     */
    public function getOffersIAPCost(): ?string
    {
        return $this->offersIAPCost;
    }

    /**
     * Checks if the app contains ads.
     *
     * @return bool `true` if the application contains ads, and `false` if not contains
     */
    public function isContainsAds(): bool
    {
        return $this->containsAds;
    }

    /**
     * Returns the size of the application.
     *
     * @return string|null application size, `null` if the size depends on the device
     */
    public function getSize(): ?string
    {
        return $this->size;
    }

    /**
     * Returns the version of the application.
     *
     * @return string|null application version, `null` if the application version depends on the device
     */
    public function getAppVersion(): ?string
    {
        return $this->appVersion;
    }

    /**
     * Returns the supported version of Android.
     *
     * @return string|null android version, `null` if android version depends on the device
     */
    public function getAndroidVersion(): ?string
    {
        return $this->androidVersion;
    }

    /**
     * Returns the minimum supported version of Android.
     *
     * @return string|null minimum android version, `null` if android version depends on the device
     */
    public function getMinAndroidVersion(): ?string
    {
        return $this->minAndroidVersion;
    }

    /**
     * Returns the age limit.
     *
     * @return string|null Content rating or `null` if not provided
     */
    public function getContentRating(): ?string
    {
        return $this->contentRating;
    }

    /**
     * Returns privacy policy URL.
     *
     * @return string|null privacy policy URL
     */
    public function getPrivacyPoliceUrl(): ?string
    {
        return $this->privacyPoliceUrl;
    }

    /**
     * Returns the release date.
     *
     * @return \DateTimeInterface|null release date or `null` if not provided
     */
    public function getReleased(): ?\DateTimeInterface
    {
        return $this->released;
    }

    /**
     * Returns the date of the update.
     *
     * @return \DateTimeInterface|null update date or `null` if not provided
     */
    public function getUpdated(): ?\DateTimeInterface
    {
        return $this->updated;
    }

    /**
     * Returns the number of voters.
     *
     * @return int number of voters
     */
    public function getNumberVoters(): int
    {
        return $this->numberVoters;
    }

    /**
     * Returns the number of reviews.
     *
     * @return int number of reviews
     */
    public function getNumberReviews(): int
    {
        return $this->numberReviews;
    }

    /**
     * Returns some useful reviews.
     *
     * @return Review[] some useful reviews
     */
    public function getReviews(): array
    {
        return $this->reviews;
    }

    /**
     * Checks for equality of applications.
     *
     * @param AppInfo $otherApp application with which is compared
     *
     * @return bool `true` if the contents of the objects being changed are the same
     *              and `false` if the objects contain different data
     *
     * @internal
     */
    public function equals(self $otherApp): bool
    {
        if ($otherApp->getId() !== $this->getId()) {
            return false;
        }

        if ($otherApp->getName() !== $this->getName()) {
            return false;
        }

        if ($otherApp->description !== $this->description) {
            return false;
        }

        if ($otherApp->recentChanges !== $this->recentChanges) {
            return false;
        }

        if ($otherApp->getIcon()->getOriginalSizeUrl() !== $this->getIcon()->getOriginalSizeUrl()) {
            return false;
        }
        $diff = array_udiff(
            $otherApp->screenshots,
            $this->screenshots,
            static function (GoogleImage $a, GoogleImage $b) {
                return strcmp($a->getOriginalSizeUrl(), $b->getOriginalSizeUrl());
            }
        );

        return empty($diff);
    }

    /**
     * Returns class properties as an array.
     *
     * @return array class properties as an array
     */
    public function asArray(): array
    {
        $array = parent::asArray();
        $array['description'] = $this->description;
        $array['translatedFromLocale'] = $this->translatedFromLocale;
        $array['cover'] = $this->cover !== null ? $this->cover->getUrl() : null;
        $array['screenshots'] = array_map(
            static function (GoogleImage $googleImage) {
                return $googleImage->getUrl();
            },
            $this->screenshots
        );
        $array['category'] = $this->category->asArray();
        $array['categoryFamily'] = $this->categoryFamily !== null ? $this->categoryFamily->asArray() : null;
        $array['video'] = $this->video !== null ? $this->video->asArray() : null;
        $array['privacyPoliceUrl'] = $this->privacyPoliceUrl;
        $array['recentChange'] = $this->recentChanges;
        $array['editorsChoice'] = $this->editorsChoice;
        $array['installs'] = $this->installs;
        $array['numberVoters'] = $this->numberVoters;
        $array['histogramRating'] = $this->histogramRating;
        $array['price'] = $this->price;
        $array['currency'] = $this->currency;
        $array['offersIAP'] = $this->isContainsIAP();
        $array['offersIAPCost'] = $this->offersIAPCost;
        $array['containsAds'] = $this->containsAds;
        $array['size'] = $this->size;
        $array['appVersion'] = $this->appVersion;
        $array['androidVersion'] = $this->androidVersion;
        $array['minAndroidVersion'] = $this->minAndroidVersion;
        $array['contentRating'] = $this->contentRating;
        $array['released'] = $this->released !== null ? $this->released->format(\DateTimeInterface::RFC3339) : null;
        $array['releasedTimestamp'] = $this->released !== null ? $this->released->getTimestamp() : 0;
        $array['updated'] = $this->updated !== null ? $this->updated->format(\DateTimeInterface::RFC3339) : null;
        $array['updatedTimestamp'] = $this->updated !== null ? $this->updated->getTimestamp() : 0;
        $array['numberReviews'] = $this->numberReviews;
        $array['reviews'] = array_map(
            static function (Review $review) {
                return $review->asArray();
            },
            $this->reviews
        );

        return $array;
    }
}


1		<?php
2
3		declare(strict_types=1);
4
5		/**
6		* @author Ne-Lexa
7		* @license MIT
8		*
9		* @see https://github.com/Ne-Lexa/google-play-scraper
10		*/
11
12		namespace Nelexa\GPlay\Model;
13
14		use Nelexa\GPlay\GPlayApps;
15		use Nelexa\GPlay\Model\Builder\AppBuilder;
16
17		/**
18		* Contains detailed information about the application from the Google Play store.
19		*
20		* @see App Basic information about the application from the Google Play store.
21		* @see GPlayApps::getAppInfo() Returns detailed information about the Android
22		* application from the Google Play store.
23		* @see GPlayApps::getAppsInfo() Returns detailed information about many android packages.
24		* @see GPlayApps::getAppInLocales() Returns detailed information about an application
25		* from the Google Play store for an array of locales.
26		* @see GPlayApps::getAppInfoForAvailableLocales() Returns detailed information about the
27		* application in all available locales.
28		*/
29		final class AppInfo extends App
30		{
31		/** @var string Default currency. */
32		private const DEFAULT_CURRENCY = 'USD';
33
34		/** @var string Application description. */
35		private $description;
36
37		/**
38		* Locale (language) of the original description. Google automatically translates
39		* the description of the application if the developer has not added it to the
40		* Play Console in the "Add your own translation text" section. If a translation
41		* is added, the value will be null.
42		*
43		* @var string\|null locale of the original description or null
44		*
45		* @see https://support.google.com/googleplay/android-developer/answer/3125566
46		*/
47		private $translatedFromLocale;
48
49		/** @var GoogleImage\|null Cover image. */
50		private $cover;
51
52		/** @var GoogleImage[] Screenshots of the application. */
53		private $screenshots;
54
55		/** @var Category Application category. */
56		private $category;
57
58		/** @var Category\|null Family category or null/ */
59		private $categoryFamily;
60
61		/** @var Video\|null Promo video or null. */
62		private $video;
63
64		/** @var string\|null Recent changes. */
65		private $recentChanges;
66
67		/** @var bool Editors' choice. */
68		private $editorsChoice;
69
70		/** @var int Number of application installations. */
71		private $installs;
72
73		/** @var HistogramRating Histogram rating. */
74		private $histogramRating;
75
76		/** @var float Price of the application in the Google Play store. */
77		private $price;
78
79		/** @var string $currency Currency price of the application. */
80		private $currency;
81
82		/** @var string\|null In-App Purchase price. */
83		private $offersIAPCost;
84
85		/** @var bool Application contains ads. */
86		private $containsAds;
87
88		/** @var string\|null Application size, null if the size depends on the device. */
89		private $size;
90
91		/** @var string\|null Application version, null if the application version depends on the device. */
92		private $appVersion;
93
94		/** @var string\|null Android version, null if android version depends on the device. */
95		private $androidVersion;
96
97		/** @var string\|null Minimum android version, null if android version depends on the device. */
98		private $minAndroidVersion;
99
100		/** @var string\|null Content rating. */
101		private $contentRating;
102
103		/** @var string\|null Privacy policy URL. */
104		private $privacyPoliceUrl;
105
106		/** @var \DateTimeInterface\|null Release date if known. */
107		private $released;
108
109		/** @var \DateTimeInterface\|null Update date or null. */
110		private $updated;
111
112		/** @var int Number of voters. */
113		private $numberVoters;
114
115		/** @var int Number of reviews. */
116		private $numberReviews;
117
118		/** @var Review[] Some useful reviews. */
119		private $reviews;
120
121		/**
122		* Returns an object with detailed information about the application.
123		*
124		* @param AppBuilder $builder application builder
125		*
126		* @ignore
127		*/
128	21	public function __construct(AppBuilder $builder)
129		{
130	21	parent::__construct($builder);
131
132	21	if (empty($builder->getDescription())) {
133	1	throw new \InvalidArgumentException(
134	1	'Application description cannot be null or empty. Solution: $appBuilder->setDescription(...);'
135		);
136		}
137
138	21	if (empty($builder->getScreenshots())) {
139	1	throw new \InvalidArgumentException(
140	1	'Screenshots of the application must contain at least one screenshot. Solution: $appBuilder->setScreenshots(...); or $appBuilder->addScreenshot(...);'
141		);
142		}
143
144	21	if ($builder->getCategory() === null) {
145	1	throw new \InvalidArgumentException(
146	1	'Application category cannot be null. Solution: $appBuilder->setCategory(...);'
147		);
148		}
149
150	21	$this->description = $builder->getDescription();
151	21	$this->translatedFromLocale = $builder->getTranslatedFromLocale();
152	21	$this->cover = $builder->getCover();
153	21	$this->screenshots = $builder->getScreenshots();
154	21	$this->category = $builder->getCategory();
155	21	$this->categoryFamily = $builder->getCategoryFamily();
156	21	$this->privacyPoliceUrl = $builder->getPrivacyPoliceUrl();
157	21	$this->video = $builder->getVideo();
158	21	$this->recentChanges = $builder->getRecentChanges();
159	21	$this->editorsChoice = $builder->isEditorsChoice();
160	21	$this->installs = $builder->getInstalls();
161	21	$this->histogramRating = $builder->getHistogramRating() ??
162	2	new HistogramRating(0, 0, 0, 0, 0);
163	21	$this->price = $builder->getPrice();
164	21	$this->currency = $builder->getCurrency() ?? self::DEFAULT_CURRENCY;
165	21	$this->offersIAPCost = $builder->getOffersIAPCost();
166	21	$this->containsAds = $builder->isContainsAds();
167	21	$this->size = $builder->getSize();
168	21	$this->appVersion = $builder->getAppVersion();
169	21	$this->androidVersion = $builder->getAndroidVersion();
170	21	$this->minAndroidVersion = $builder->getMinAndroidVersion();
171	21	$this->contentRating = $builder->getContentRating();
172	21	$this->released = $builder->getReleased();
173	21	$this->updated = $builder->getUpdated();
174	21	$this->numberVoters = $builder->getNumberVoters();
175	21	$this->numberReviews = $builder->getNumberReviews();
176	21	$this->reviews = $builder->getReviews();
177	21	}
178
179		/**
180		* Returns a description of the application.
181		*
182		* @return string description of the application
183		*/
184	1	public function getDescription(): string
185		{
186	1	return $this->description;
187		}
188
189		/**
190		* Checks if the class description is automatically translated via Google Translate.
191		*
192		* @return bool `true` if the description was automatically translated using Google Translate and
193		* `false` if the developer added a description for the locale in the Google Play Console
194		*/
195	13	public function isAutoTranslatedDescription(): bool
196		{
197	13	return $this->translatedFromLocale !== null;
198		}
199
200		/**
201		* Returns locale (language) of the original description.
202		*
203		* Google automatically translates the description of the application if the developer
204		* has not added it to the Play Console in the "Add your own translation text" section.
205		* If a translation is added, the value will be null.
206		*
207		* @return string\|null if the developer added a translation of the description, then the
208		* value will be `null`, otherwise the original language of the application description
209		*/
210	14	public function getTranslatedFromLocale(): ?string
211		{
212	14	return $this->translatedFromLocale;
213		}
214
215		/**
216		* Returns cover image.
217		*
218		* Where it's displayed
219		* The feature graphic is displayed in front of screenshots of the application and in
220		* the list of developer applications. If a promo video is added, a Play button
221		* will overlay on the feature graphic so users can watch the promo video.
222		*
223		* Google Play requirements:
224		* * JPEG or 24-bit PNG (no alpha)
225		* * Dimensions: 1024px by 500px
226		*
227		* @return GoogleImage\|null cover image or `null`
228		*
229		* @see https://support.google.com/googleplay/android-developer/answer/1078870?hl=en Graphic assets,
230		* screenshots, & video. Section Feature graphic.
231		*/
232	1	public function getCover(): ?GoogleImage
233		{
234	1	return $this->cover;
235		}
236
237		/**
238		* Returns screenshots of the application.
239		*
240		* The array must contain at least 2 screenshots.
241		*
242		* Google Play screenshots requirements:
243		* * JPEG or 24-bit PNG (no alpha)
244		* * Minimum dimension: 320px
245		* * Maximum dimension: 3840px
246		* * The maximum dimension of the screenshot can't be more than twice as long as the minimum dimension.
247		*
248		* @return GoogleImage[] array of screenshots
249		*/
250	2	public function getScreenshots(): array
251		{
252	2	return $this->screenshots;
253		}
254
255		/**
256		* Returns the category of the application.
257		*
258		* @return Category category of application
259		*/
260	1	public function getCategory(): Category
261		{
262	1	return $this->category;
263		}
264
265		/**
266		* Returns family category.
267		*
268		* @return Category\|null family category or `null`
269		*/
270	1	public function getCategoryFamily(): ?Category
271		{
272	1	return $this->categoryFamily;
273		}
274
275		/**
276		* Returns a video about the application.
277		*
278		* @return Video\|null promo video or `null`
279		*/
280	1	public function getVideo(): ?Video
281		{
282	1	return $this->video;
283		}
284
285		/**
286		* Returns recent changes.
287		*
288		* @return string\|null recent changes or null if not provided
289		*/
290	1	public function getRecentChanges(): ?string
291		{
292	1	return $this->recentChanges;
293		}
294
295		/**
296		* Checks if the application is an editors' choice.
297		*
298		* @return bool `true` if the application is selected by Google Play editor, otherwise `false`
299		*/
300	1	public function isEditorsChoice(): bool
301		{
302	1	return $this->editorsChoice;
303		}
304
305		/**
306		* Returns the number of installations of the application.
307		*
308		* @return int the number of installations of the application
309		*/
310	1	public function getInstalls(): int
311		{
312	1	return $this->installs;
313		}
314
315		/**
316		* Returns histogram rating.
317		*
318		* @return HistogramRating histogram rating
319		*/
320	1	public function getHistogramRating(): HistogramRating
321		{
322	1	return $this->histogramRating;
323		}
324
325		/**
326		* Returns the price of the app in the Google Play store.
327		*
328		* @return float price or 0.00 if the app is free
329		*
330		* @see AppInfo::getCurrency() Returns the price currency
331		* of the app in the Google Play store.
332		*/
333	1	public function getPrice(): float
334		{
335	1	return $this->price;
336		}
337
338		/**
339		* Returns the price currency of the app in the Google Play store.
340		*
341		* @return string currency price of the application, default USD
342		*/
343	1	public function getCurrency(): string
344		{
345	1	return $this->currency;
346		}
347
348		/**
349		* Checks if the app contains In-App Purchases (IAP).
350		*
351		* @return bool `true` if the application contains AIP, and `false` if not contains
352		*/
353	1	public function isContainsIAP(): bool
354		{
355	1	return $this->offersIAPCost !== null;
356		}
357
358		/**
359		* Returns the cost of In-App Purchases (IAP).
360		*
361		* @return string\|null in-App Purchase price
362		*/
363	1	public function getOffersIAPCost(): ?string
364		{
365	1	return $this->offersIAPCost;
366		}
367
368		/**
369		* Checks if the app contains ads.
370		*
371		* @return bool `true` if the application contains ads, and `false` if not contains
372		*/
373	1	public function isContainsAds(): bool
374		{
375	1	return $this->containsAds;
376		}
377
378		/**
379		* Returns the size of the application.
380		*
381		* @return string\|null application size, `null` if the size depends on the device
382		*/
383	1	public function getSize(): ?string
384		{
385	1	return $this->size;
386		}
387
388		/**
389		* Returns the version of the application.
390		*
391		* @return string\|null application version, `null` if the application version depends on the device
392		*/
393	1	public function getAppVersion(): ?string
394		{
395	1	return $this->appVersion;
396		}
397
398		/**
399		* Returns the supported version of Android.
400		*
401		* @return string\|null android version, `null` if android version depends on the device
402		*/
403	1	public function getAndroidVersion(): ?string
404		{
405	1	return $this->androidVersion;
406		}
407
408		/**
409		* Returns the minimum supported version of Android.
410		*
411		* @return string\|null minimum android version, `null` if android version depends on the device
412		*/
413	1	public function getMinAndroidVersion(): ?string
414		{
415	1	return $this->minAndroidVersion;
416		}
417
418		/**
419		* Returns the age limit.
420		*
421		* @return string\|null Content rating or `null` if not provided
422		*/
423	1	public function getContentRating(): ?string
424		{
425	1	return $this->contentRating;
426		}
427
428		/**
429		* Returns privacy policy URL.
430		*
431		* @return string\|null privacy policy URL
432		*/
433	1	public function getPrivacyPoliceUrl(): ?string
434		{
435	1	return $this->privacyPoliceUrl;
436		}
437
438		/**
439		* Returns the release date.
440		*
441		* @return \DateTimeInterface\|null release date or `null` if not provided
442		*/
443	13	public function getReleased(): ?\DateTimeInterface
444		{
445	13	return $this->released;
446		}
447
448		/**
449		* Returns the date of the update.
450		*
451		* @return \DateTimeInterface\|null update date or `null` if not provided
452		*/
453	1	public function getUpdated(): ?\DateTimeInterface
454		{
455	1	return $this->updated;
456		}
457
458		/**
459		* Returns the number of voters.
460		*
461		* @return int number of voters
462		*/
463	1	public function getNumberVoters(): int
464		{
465	1	return $this->numberVoters;
466		}
467
468		/**
469		* Returns the number of reviews.
470		*
471		* @return int number of reviews
472		*/
473	1	public function getNumberReviews(): int
474		{
475	1	return $this->numberReviews;
476		}
477
478		/**
479		* Returns some useful reviews.
480		*
481		* @return Review[] some useful reviews
482		*/
483	1	public function getReviews(): array
484		{
485	1	return $this->reviews;
486		}
487
488		/**
489		* Checks for equality of applications.
490		*
491		* @param AppInfo $otherApp application with which is compared
492		*
493		* @return bool `true` if the contents of the objects being changed are the same
494		* and `false` if the objects contain different data
495		*
496		* @internal
497		*/
498	14	public function equals(self $otherApp): bool
499		{
500	14	if ($otherApp->getId() !== $this->getId()) {
501		return false;
502		}
503
504	14	if ($otherApp->getName() !== $this->getName()) {
505	10	return false;
506		}
507
508	14	if ($otherApp->description !== $this->description) {
509	13	return false;
510		}
511
512	11	if ($otherApp->recentChanges !== $this->recentChanges) {
513	1	return false;
514		}
515
516	11	if ($otherApp->getIcon()->getOriginalSizeUrl() !== $this->getIcon()->getOriginalSizeUrl()) {
517	1	return false;
518		}
519	11	$diff = array_udiff(
520	11	$otherApp->screenshots,
521	11	$this->screenshots,
522		static function (GoogleImage $a, GoogleImage $b) {
523	11	return strcmp($a->getOriginalSizeUrl(), $b->getOriginalSizeUrl());
524	11	}
525		);
526
527	11	return empty($diff);
528		}
529
530		/**
531		* Returns class properties as an array.
532		*
533		* @return array class properties as an array
534		*/
535		public function asArray(): array
536		{
537		$array = parent::asArray();
538		$array['description'] = $this->description;
539		$array['translatedFromLocale'] = $this->translatedFromLocale;
540		$array['cover'] = $this->cover !== null ? $this->cover->getUrl() : null;
541		$array['screenshots'] = array_map(
542		static function (GoogleImage $googleImage) {
543		return $googleImage->getUrl();
544		},
545		$this->screenshots
546		);
547		$array['category'] = $this->category->asArray();
548		$array['categoryFamily'] = $this->categoryFamily !== null ? $this->categoryFamily->asArray() : null;
549		$array['video'] = $this->video !== null ? $this->video->asArray() : null;
550		$array['privacyPoliceUrl'] = $this->privacyPoliceUrl;
551		$array['recentChange'] = $this->recentChanges;
552		$array['editorsChoice'] = $this->editorsChoice;
553		$array['installs'] = $this->installs;
554		$array['numberVoters'] = $this->numberVoters;
555		$array['histogramRating'] = $this->histogramRating;
556		$array['price'] = $this->price;
557		$array['currency'] = $this->currency;
558		$array['offersIAP'] = $this->isContainsIAP();
559		$array['offersIAPCost'] = $this->offersIAPCost;
560		$array['containsAds'] = $this->containsAds;
561		$array['size'] = $this->size;
562		$array['appVersion'] = $this->appVersion;
563		$array['androidVersion'] = $this->androidVersion;
564		$array['minAndroidVersion'] = $this->minAndroidVersion;
565		$array['contentRating'] = $this->contentRating;
566		$array['released'] = $this->released !== null ? $this->released->format(\DateTimeInterface::RFC3339) : null;
567		$array['releasedTimestamp'] = $this->released !== null ? $this->released->getTimestamp() : 0;
568		$array['updated'] = $this->updated !== null ? $this->updated->format(\DateTimeInterface::RFC3339) : null;
569		$array['updatedTimestamp'] = $this->updated !== null ? $this->updated->getTimestamp() : 0;
570		$array['numberReviews'] = $this->numberReviews;
571		$array['reviews'] = array_map(
572		static function (Review $review) {
573		return $review->asArray();
574		},
575		$this->reviews
576		);
577
578		return $array;
579		}
580		}
581

Ne-Lexa / google-play-scraper

Push — master ( 45165d...5e44c4 )

AppInfo::getVideo() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like