zero-to-prod/omdb-models

Data Models and Factories for the OMDB API

v1.0.7 2025-01-15 21:27 UTC

Requires

• php: >=8.1.0
• ext-json: *
• zero-to-prod/data-model: ^81.7
• zero-to-prod/data-model-factory: ^71.3.2
• zero-to-prod/data-model-helper: ^v81.11.3
• zero-to-prod/omdb-api: ^1.0.1
• zero-to-prod/package-helper: ^1.0
• zero-to-prod/transformable: ^71.0.9

Requires (Dev)

• phpunit/phpunit: ^10.0

Suggests

• zero-to-prod/data-model: Transform Data to Type-Safe DTOs
• zero-to-prod/data-model-helper: Helpers for a DataModel.

MIT

• David Smith

• DataModel
• zero-to-prod
• Open Movie Database
• omdb-models

README

Contents

• Introduction
• Requirements
• Installation
• Usage
• Factories
• Publishing DataModels
• Local Development
• Contributing

Introduction

Data Models and factories for the OMDB API.

This works well when hydrating results from the OmdbApi package.

Requirements

• PHP 8.1 or higher.

Installation

Install Zerotoprod\OmdbModels via Composer:

composer require zero-to-prod/omdb-models

This will add the package to your project’s dependencies and create an autoloader entry for it.

Publishing Files

You can directly import these files into your project like this:

./vendor/bin/omdb-models ./app/OmdbModels

Usage

This package has the following models:

\Zerotoprod\OmdbModels\Error::from();
\Zerotoprod\OmdbModels\Rating::from();
\Zerotoprod\OmdbModels\SearchItem::from();
\Zerotoprod\OmdbModels\SearchResults::from();
\Zerotoprod\OmdbModels\Title::from();

// Enums
\Zerotoprod\OmdbModels\ErrorType::from();
\Zerotoprod\OmdbModels\Type::from();

Factories

This package uses Data Model Factories and has the following factories:

\Zerotoprod\OmdbModels\Factories\ErrorFactory::factory()->setMessage('message')->make();
\Zerotoprod\OmdbModels\Factories\RatingFactory::factory()->setValue('2')->make();
\Zerotoprod\OmdbModels\Factories\SearchItemFactory::factory()->setTitle('Avatar')->make();
\Zerotoprod\OmdbModels\Factories\SearchResultsFactory::factory()->setTotalResults(2)->make();
\Zerotoprod\OmdbModels\Factories\TitleFactory::factory()->setTitle('Avatar')->make();

Publishing DataModels

You can directly import these files into your project like this:

./vendor/bin/omdb-models app/OmdbModels

The first argument is the destination of where the files are copied to.

Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Commit changes (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature-branch).
5. Create a new Pull Request.