grixu/synchronizer

Tools for sync data from DTO (foreign system) to local DB

6.0.0 2022-07-24 13:19 UTC

README

Simple library for sync data between two data sources (database to database or API to database).

  • ๐Ÿ“ˆ Asynchronous & Scalability: prepared to work async by using Laravel Queues system
  • ๐Ÿ”’ Strict data types: assumes to use DTO objects as input data. Using of spatie/data-transfer-objects is highly recommended.
  • ๐Ÿ”ฉ Adaptable: providing interfaces for customizing loading, parsing, pre-sync & error reporting.
  • ๐Ÿ“‚ Flexibility: library structure allows using just synchronization engine
  • ๐ŸŽ› Configurable: Wide possibilities of configuration for each synchronization separately
  • ๐Ÿ“š Prepared for different scenarios: have 3 different loading-parsing-syncing scenarios on-board.
  • ๐Ÿ“ Loggable: it allows save synchronization' logs to database
  • ๐Ÿ“ฒ Notifiable: it provides Slack notifications after sync is done

Installation

You can install the package via composer:

composer require grixu/synchronizer

Usage

Details will be described in Synchronizer Docs (both in Polish and English)

Testing

Before you start running test, please create .sqlite database which contains example tables from a database you would like to sync. More information about it, you can find in: tests/Helpers/SyncTestCase. Test which extending that SyncTestCase need access to this database.

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email mg@grixu.dev instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.