First Rel

Author: Bhavik MacBook PRO 16

.gitattributes

@@ -0,0 +1,8 @@
+* text=auto
+  
+/.github export-ignore
+/tests export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+.styleci.yml export-ignore
+phpunit.xml export-ignore

.gitignore

@@ -0,0 +1,7 @@
+/.idea
+vendor
+/composer.lock
+composer.phar
+clover.json
+clover.xml
+.phpunit.result.cache

.styleci.yml

@@ -0,0 +1,5 @@
+preset: laravel
+
+disabled:
+  - laravel_phpdoc_alignment
+  - laravel_phpdoc_separation

CHANGELOG.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Mark Walet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE.md

@@ -0,0 +1,100 @@
+# Laravel Packagist
+
+[![Latest Stable Version](https://poser.pugx.org/ingress-it-solutions/laravel-packagist/v/stable)](https://packagist.org/packages/ingress-it-solutions/laravel-packagist)
+[![Total Downloads](https://poser.pugx.org/ingress-it-solutions/laravel-packagist/downloads)](https://packagist.org/packages/ingress-it-solutions/laravel-packagist)
+
+A Laravel wrapper for the [spatie/packagist-api](https://github.com/spatie/packagist-api) package.
+
+## Installation
+You can install this package with composer:
+
+```shell
+composer require ingress-it-solutions/laravel-packagist
+```
+
+Laravel uses Package auto-discovery, so you don't have to register the service provider. If you want to register the service provider manually, add the following line to your `config/app.php` file:
+
+```php
+IngressITSolutions\Packagist\PackagistServiceProvider::class,
+```
+
+## Usage
+
+There are two main ways how you can make Packagist calls:
+
+**Using the application container**
+
+```php
+/** @var \Spatie\Packagist\PackagistClient $client */
+$client = app(\Spatie\Packagist\PackagistClient::class);
+
+$client->getPackage('ingress-it-solutions', 'laravel-packagist');
+```
+
+**Using the facade**
+```php
+Packagist::getPackage('ingress-it-solutions', 'laravel-packagist');
+```
+### Available methods
+
+**List package names**
+```php
+// All packages
+Packagist::getPackagesNames();
+
+// Filter on type.
+Packagist::getPackagesNamesByType('composer-plugin');
+
+// Filter on organization
+Packagist::getPackagesNamesByVendor('ingress-it-solutions');
+```
+
+**Searching for packages**
+```php
+// Search packages by name.
+Packagist::searchPackagesByName('packagist');
+
+// Search packages by tag.
+Packagist::searchPackagesByTags('psr-3');
+
+// Search packages by type.
+Packagist::searchPackagesByType('composer-plugin');
+
+// Combined search.
+Packagist::searchPackages('packagist', ['type' => 'library']);
+```
+
+**Pagination**
+
+Searching for packages returns a paginated result. You can change the pagination settings by adding more parameters.
+
+```php
+// Get the third page, 10 items per page.
+Packagist::searchPackagesByName('packagist', 3, 10);
+```
+
+**Getting package data.**
+```php
+// Using the Composer metadata. (faster, but less data)
+Packagist::getPackageMetadata('ingress-it-solutions/laravel-packagist');
+Packagist::getPackageMetadata('ingress-it-solutions', 'laravel-packagist');
+
+// Using the API. (slower, cached for 12 hours by Packagist.
+Packagist::getPackage('ingress-it-solutions/laravel-packagist');
+Packagist::getPackage('ingress-it-solutions', 'laravel-packagist');
+```
+
+**Get Statistics**
+```php
+$packagist->getStatistics();
+```
+
+## Configuration
+By default, the api url for Packagist is set to `https://packagist.org`. If you want to override that, you can add the following code block to your `config/services.php` file:
+
+```php
+'packagist' => [
+    'base_url' => 'https://packagist.org',
+    'repo_url' => 'https://repo.packagist.org',
+],
+```

README.md

@@ -0,0 +1,48 @@
+{
+  "name": "ingress-it-solutions/laravel-packagist",
+  "description": "A Laravel wrapper for the `spatie/packagist-api` package.",
+  "type": "library",
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Ingress Team",
+      "email": "[email protected]",
+      "homepage": "https://www.ingressit.com",
+      "role": "Owner"
+    }
+  ],
+  "require": {
+    "php": "8.*",
+    "ext-json": "*",
+    "laravel/framework": "8.*|^9.0|^10.0",
+    "phpoption/phpoption": ">=1.8",
+    "spatie/packagist-api": "^2.0"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "~9.3",
+    "orchestra/testbench": "~6.22|7.*|8.*"
+  },
+  "autoload": {
+    "psr-4": {
+      "IngressITSolutions\\Packagist\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "IngressITSolutions\\Packagist\\Tests\\": "tests/"
+    }
+  },
+  "config": {
+    "sort-packages": true
+  },
+  "extra": {
+    "laravel": {
+      "providers": [
+        "IngressITSolutions\\Packagist\\PackagistServiceProvider"
+      ],
+      "aliases": {
+        "Packagist": "IngressITSolutions\\Packagist\\Facades\\Packagist"
+      }
+    }
+  }
+}

composer.json

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         bootstrap="vendor/autoload.php"
+         backupGlobals="false"
+         backupStaticAttributes="false"
+         colors="true"
+         verbose="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd">
+    <coverage includeUncoveredFiles="true" processUncoveredFiles="true">
+        <include>
+            <directory suffix=".php">./src</directory>
+        </include>
+        <exclude>
+            <directory suffix=".php">./src/Exceptions/*</directory>
+        </exclude>
+    </coverage>
+    <testsuites>
+        <testsuite name="Laravel Packagist Test Suite">
+            <directory suffix="Test.php">./tests/</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

phpunit.xml

@@ -0,0 +1,34 @@
+<?php
+
+namespace IngressITSolutions\Packagist\Facades;
+
+use Illuminate\Support\Facades\Facade;
+use Spatie\Packagist\PackagistClient;
+
+/**
+ * Class Packagist.
+ *
+ * @method static array|null getPackagesNames(?string $type = null, ?string $vendor = null)
+ * @method static array|null getPackagesNamesByType(string $type)
+ * @method static array|null getPackagesNamesByVendor(string $vendor)
+ * @method static array|null searchPackages($name = null, array $filters = [], ?int $page = 1, int $perPage = 15)
+ * @method static array|null searchPackagesByName(string $name, ?int $page = 1, int $perPage = 15):
+ * @method static array|null searchPackagesByTags(string $tags, ?string $name = null, ?int $page = 1, int $perPage = 15)
+ * @method static array|null searchPackagesByType(string $type, ?string $name = null, ?int $page = 1, int $perPage = 15)
+ * @method static array|null getPackage(string $vendor, ?string $package = null)
+ * @method static array|null getPackageMetadata(string $vendor, ?string $package = null)
+ * @method static array|null getStatistics()
+ * @see PackagistClient
+ */
+class Packagist extends Facade
+{
+    /**
+     * Get the registered name of the component.
+     *
+     * @return string
+     */
+    protected static function getFacadeAccessor()
+    {
+        return PackagistClient::class;
+    }
+}

src/Facades/Packagist.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace IngressITSolutions\Packagist;
+
+use GuzzleHttp\Client;
+use Illuminate\Config\Repository;
+use Illuminate\Contracts\Foundation\Application;
+use Illuminate\Contracts\Support\DeferrableProvider;
+use Illuminate\Support\ServiceProvider;
+use Spatie\Packagist\PackagistClient;
+use Spatie\Packagist\PackagistUrlGenerator;
+
+class PackagistServiceProvider extends ServiceProvider implements DeferrableProvider
+{
+    /**
+     * Register any application services.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        // Bind manager to application.
+        $this->app->bind(PackagistClient::class, function (Application $app) {
+            $urlGenerator = $app->make(PackagistUrlGenerator::class);
+
+            return new PackagistClient(new Client(), $urlGenerator);
+        });
+
+        $this->app->bind(PackagistUrlGenerator::class, function (Application $app) {
+            /** @var Repository $config */
+            $config = $app['config'];
+
+            return new PackagistUrlGenerator(
+                $config->get('services.packagist.base_url', null),
+                $config->get('services.packagist.repo_url', null)
+            );
+        });
+    }
+
+    /**
+     * Get the services provided by the provider.
+     *
+     * @return array
+     */
+    public function provides()
+    {
+        return [
+            PackagistClient::class,
+            PackagistUrlGenerator::class,
+        ];
+    }
+}