PHPackages                             sherifsheremetaj/cars - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. sherifsheremetaj/cars

ActiveLibrary[Utility & Helpers](/categories/utility)

sherifsheremetaj/cars
=====================

Cars information package

v1.6(1y ago)111MITPHP

Since Feb 18Pushed 1y ago1 watchersCompare

[ Source](https://github.com/sherifsheremetaj/cars)[ Packagist](https://packagist.org/packages/sherifsheremetaj/cars)[ RSS](/packages/sherifsheremetaj-cars/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (4)Versions (11)Used By (0)

🚗 Car Manufactures Package
==========================

[](#-car-manufactures-package)

[![GitHub Repo Size](https://camo.githubusercontent.com/a10f816fda55957007f2e7e0b24c29bfac30a7616c80603f08bb2581a72f8289/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7265706f2d73697a652f73686572696673686572656d6574616a2f63617273)](https://camo.githubusercontent.com/a10f816fda55957007f2e7e0b24c29bfac30a7616c80603f08bb2581a72f8289/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7265706f2d73697a652f73686572696673686572656d6574616a2f63617273)[![GitHub License](https://camo.githubusercontent.com/6f3d20286a00774d4bc091da471a0199961d39e7988b113975001704e7a798eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73686572696673686572656d6574616a2f63617273)](https://camo.githubusercontent.com/6f3d20286a00774d4bc091da471a0199961d39e7988b113975001704e7a798eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73686572696673686572656d6574616a2f63617273)[![GitHub Stars](https://camo.githubusercontent.com/d6f22651f723a2c756513445c326b00cacba99beb26f74a3a510cfbb3de0aac6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f73686572696673686572656d6574616a2f636172733f7374796c653d736f6369616c)](https://camo.githubusercontent.com/d6f22651f723a2c756513445c326b00cacba99beb26f74a3a510cfbb3de0aac6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f73686572696673686572656d6574616a2f636172733f7374796c653d736f6369616c)[![GitHub Issues](https://camo.githubusercontent.com/4faa815452f27c10b636b1b0050c86f33009cd5fdaab4c30666c7193a1800020/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f73686572696673686572656d6574616a2f63617273)](https://camo.githubusercontent.com/4faa815452f27c10b636b1b0050c86f33009cd5fdaab4c30666c7193a1800020/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f73686572696673686572656d6574616a2f63617273)

A simple PHP package for managing **car manufacturers' data** in multiple formats (**JSON, CSV, XML**). Supports **data retrieval, conversion, and validation** with robust error handling.

---

📦 **Installation**
------------------

[](#-installation)

Install the package via Composer:

```
composer require sherifsheremetaj/cars
```

---

🚀 **Usage**
-----------

[](#-usage)

### **1️⃣ Retrieve Manufacturers**

[](#1️⃣-retrieve-manufacturers)

```
use SherifSheremetaj\Cars\Enums\DataTypes;
use SherifSheremetaj\Cars\Manufactures;

#JSON data
$manufactures = new Manufactures();
$data = $manufactures->getManufactures(DataTypes::JSON);

echo $data . PHP_EOL;

#CSV data
$manufactures = new Manufactures();
$data = $manufactures->getManufactures(DataTypes::CSV);

echo $data . PHP_EOL;

#XML data
$manufactures = new Manufactures();
$data = $manufactures->getManufactures(DataTypes::XML);

echo $data . PHP_EOL;
```

---

### **1️⃣ Retrieve CarTypes**

[](#1️⃣-retrieve-cartypes)

```
use SherifSheremetaj\Cars\CarTypes;
use SherifSheremetaj\Cars\Enums\DataTypes;

#JSON data
$carTypes = new CarTypes();
$data = $carTypes->getTypes(DataTypes::JSON);

echo $data;

#CSV data
$carTypes = new CarTypes();
$data = $carTypes->getTypes(DataTypes::CSV);

echo $data;

#XML data
$carTypes = new CarTypes();
$data = $carTypes->getTypes(DataTypes::XML);

echo $data;
```

---

🛠 **Configuration**
-------------------

[](#-configuration)

By default, data is loaded from:

```
__DIR__ . '/data/....';
```

---

✅ **Running Tests**
-------------------

[](#-running-tests)

To run the PHPUnit test suite, use:

```
composer install
vendor/bin/phpunit
```

To run lint (Laravel pint), use

```
composer pint
```

---

🔍 **Data Source**
-----------------

[](#-data-source)

Logo images are crawled from Carlogos.org and processed for optimal usage.

📝 **Contributing**
------------------

[](#-contributing)

Pull requests are welcome! To contribute:

1. Fork the repository.
2. Create a new feature branch (`git checkout -b feature-name`).
3. Commit your changes (`git commit -m "Added feature X"`).
4. Push to the branch (`git push origin feature-name`).
5. Open a pull request.

---

📜 **License**
-------------

[](#-license)

This package is licensed under the [MIT License](LICENSE).

---

⭐ **Support & Feedback**
----------------------------

[](#-support--feedback)

If you find this package helpful, please **⭐ star the repository**! For suggestions or issues, open an [issue](https://github.com/sherifsheremetaj/cars/issues).

---

Made with ❤️ by **[Sherif Sheremetaj](https://github.com/sherifsheremetaj)**

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance44

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

9

Last Release

439d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/990b47f0417dd573524d74aa2904daf545b1b2e2c52f7d0eb1f10647a6d4be51?d=identicon)[appkonik](/maintainers/appkonik)

---

Top Contributors

[![sherifsheremetaj](https://avatars.githubusercontent.com/u/24659536?v=4)](https://github.com/sherifsheremetaj "sherifsheremetaj (18 commits)")[![thiiagoms](https://avatars.githubusercontent.com/u/54003589?v=4)](https://github.com/thiiagoms "thiiagoms (2 commits)")

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/sherifsheremetaj-cars/health.svg)

```
[![Health](https://phpackages.com/badges/sherifsheremetaj-cars/health.svg)](https://phpackages.com/packages/sherifsheremetaj-cars)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas

Code Generators for Laravel Applications and Packages

21017.2M158](/packages/orchestra-canvas)[illuminate/pipeline

The Illuminate Pipeline package.

9446.6M213](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10532.5M862](/packages/illuminate-pagination)[spatie/laravel-pjax

A pjax middleware for Laravel 5

513371.8k11](/packages/spatie-laravel-pjax)[spatie/laravel-mix-preload

Add preload and prefetch links based your Mix manifest

169176.0k2](/packages/spatie-laravel-mix-preload)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)