Recommend this page to a friend! |
Download |
Info | Files | Install with Composer | Download | Reputation | Support forum | Blog | Links |
Last Updated | Ratings | Unique User Downloads | Download Rankings | |||||
2024-03-14 (7 months ago) | Not enough user ratings | Total: 34 | All time: 11,033 This week: 59 |
Version | License | PHP version | Categories | |||
librariesio 1.1.1 | MIT/X Consortium ... | 8.2.0 | Tools, Libraries, Web services, PHP 8 |
This project was born from the desire to expand my knowledge of API's and GuzzleHttp. My implementation is far from perfect, so I am open to any and all feedback that one may wish to provide.
Install the latest version with:
$ composer require esi/librariesio
Then, within your project (if not already included), include composer's autoload. For example:
<?php
require 'vendor/autoload.php';
?>
For more information see the installation docs.
LibrariesIO splits the different endpoints based on their "component":
* Esi\LibrariesIO\LibrariesIO::platform()
* does not require an $endpoint, though you can pass 'platforms'.
* Esi\LibrariesIO\LibrariesIO::project()
* takes an 'endpoint' parameter to specify which subset you are looking for.
* Current endpoints are:
* contributors
* dependencies
* dependents
* dependent_repositories
* project
* search
* sourceRank
* Esi\LibrariesIO\LibrariesIO::repository()
* takes an 'endpoint' parameter to specify which subset you are looking for.
* Current endpoints are:
* dependencies
* projects
* repository
* Esi\LibrariesIO\LibrariesIO::user()
* takes an 'endpoint' parameter to specify which subset you are looking for.
* Current endpoints are:
* dependencies
* packages
* package_contributions
* repositories
* repository_contributions
* subscriptions
* user
* Esi\LibrariesIO\LibrariesIO::subscription()
* takes an 'endpoint' parameter to specify which subset you are looking for.
* Current endpoints are:
* subscribe
* check
* update
* unsubscribe
Each 'subset' has their own required options. Check the documentation (currently WIP) for more information.
As an example, let's say you want to get a list of the available platforms. To do so:
<?php
use Esi\LibrariesIO\LibrariesIO;
$api = new LibrariesIO('..yourapikey..', \sys_get_temp_dir());
$response = $api->platform();
print_r($api->toArray($response));
/*
Array
(
[0] => Array
(
[name] => NPM
[project_count] => 4079049
[homepage] => https://www.npmjs.com
[color] => #f1e05a
[default_language] => JavaScript
)
[1] => Array
(
[name] => Maven
[project_count] => 588275
[homepage] => http://maven.org
[color] => #b07219
[default_language] => Java
)
[...]
)
*/
?>
For more information see the basic usage docs.
Unit testing is handled by PHPUnit. Given the nature of this library, with it's purpose being to interact with a live API, testing is somewhat limited.
No actual calls are made to the libraries.io API while performing tests. Instead, mock data and mocked class instances are used to test the library is working properly.
The docs/
folder or online here.
Bugs and feature requests are tracked on GitHub
Issues are the quickest way to report a bug. If you find a bug or documentation error, please check the following first:
LibrariesIO accepts contributions of code and documentation from the community. These contributions can be made in the form of Issues or Pull Requests on the LibrariesIO repository.
LibrariesIO is licensed under the MIT license. When submitting new features or patches to LibrariesIO, you are giving permission to license those features or patches under the MIT license.
LibrariesIO tries to adhere to PHPStan level 9 with strict rules and bleeding edge. Please ensure any contributions do as well.
Before we look into how, here are the guidelines. If your Pull Requests fail to pass these guidelines it will be declined, and you will need to re-submit when you?ve made the changes. This might sound a bit tough, but it is required for me to maintain quality of the code-base.
Please ensure all new contributions match the PSR-12 coding style guide. The project is not fully PSR-12 compatible, yet; however, to ensure the easiest transition to the coding guidelines, I would like to go ahead and request that any contributions follow them.
If you change anything that requires a change to documentation then you will need to add it. New methods, parameters, changing default values, adding constants, etc. are all things that will require a change to documentation. The change-log must also be updated for every change. Also, PHPDoc blocks must be maintained.
Please ensure all new contributions adhere to:
* PSR-5 PHPDoc * PSR-19 PHPDoc Tags
When documenting new functions, or changing existing documentation.
One thing at a time: A pull request should only contain one change. That does not mean only one commit, but one change - however many commits it took. The reason for this is that if you change X and Y but send a pull request for both at the same time, we might really want X but disagree with Y, meaning we cannot merge the request. Using the Git-Flow branching model you can create new branches for both of these features and send two requests.
Eric Sizemore - <admin@secondversion.com> - <https://www.secondversion.com>
LibrariesIO is licensed under the MIT License - see the LICENSE.md
file for details
Files (34) |
File | Role | Description | ||
---|---|---|---|---|
.github (2 files, 1 directory) | ||||
docs (12 files) | ||||
src (1 file, 1 directory) | ||||
tests (1 directory) | ||||
.php-cs-fixer.dist.php | Aux. | Auxiliary script | ||
.scrutinizer.yml | Data | Auxiliary data | ||
CHANGELOG.md | Data | Auxiliary data | ||
CODE_OF_CONDUCT.md | Data | Auxiliary data | ||
composer.json | Data | Auxiliary data | ||
composer.lock | Data | Auxiliary data | ||
LICENSE.md | Lic. | License text | ||
mkdocs.yml | Data | Auxiliary data | ||
phpstan.neon | Data | Auxiliary data | ||
phpunit.xml | Data | Auxiliary data | ||
README.md | Doc. | Read me | ||
renovate.json | Data | Auxiliary data | ||
SECURITY.md | Data | Auxiliary data |
Files (34) | / | .github |
File | Role | Description | ||
---|---|---|---|---|
workflows (4 files) | ||||
dependabot.yml | Data | Auxiliary data | ||
FUNDING.yml | Data | Auxiliary data |
Files (34) | / | .github | / | workflows |
Files (34) | / | docs |
File | Role | Description |
---|---|---|
basic-usage.md | Data | Auxiliary data |
changelog.md | Data | Auxiliary data |
code-of-conduct.md | Data | Auxiliary data |
index.md | Doc. | Documentation |
installation.md | Data | Auxiliary data |
license.md | Lic. | License text |
platform.md | Data | Auxiliary data |
project.md | Data | Auxiliary data |
repository.md | Data | Auxiliary data |
security.md | Data | Auxiliary data |
subscription.md | Data | Auxiliary data |
user.md | Data | Auxiliary data |
Files (34) | / | src | / | Exception |
File | Role | Description |
---|---|---|
RateLimitExceededException.php | Class | Class source |
The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page. |
Install with Composer |
Version Control | Unique User Downloads | Download Rankings | |||||||||||||||
100% |
|
|
Applications that use this package |
If you know an application of this package, send a message to the author to add a link here.