Skip to content

Latest commit

 

History

History
81 lines (50 loc) · 4.36 KB

README.md

File metadata and controls

81 lines (50 loc) · 4.36 KB

DataMigrator

🚧 Alpha version - Use with care. 🚧

Features

  • 💎 The Rosetta Stone for Data. Convert data schemas with ease
  • 🚀 Portable Data. Move data from Anywhere. starting with CSV & Appwrite
  • 🧑‍💻 Multiplatform. macOS, Linux, and Windows
  • Asynchronous. A parallel data pipeline
  • 🍭 Feature rich. Type conversion adapters, create & edit schemas, upload data etc
  • 🤲 Open source. Everything is open source and free forever!

DataMigrator can do much more (and we are just getting started)

If you want to say thank you, star us on GitHub 🙌💙

Quickstart

The purpose of DataMigrator is to provide a universal translator for data by being portable, diverse, and efficient in migrating and converting data across discrete schemas.

Right now, it is only developed against macOS & Windows (Linux will be officially developed against soon). It shouldn't be too hard to get it running on Linux though.

To get it running on macOS or Windows, install Flutter, make sure to add the flutter tool to your path, and follow the other steps outlined to in the Flutter guide.

If on macoS, make sure to run flutter config --enable-macos-desktop to enable the macOS target.

Clone this repo, navigate to the directory in terminal, execute git submodule init to pull the appwrite console sdk repo, and execute flutter run to run the app. Choose macOS/Windows for the target if it prompts you.

Architecture

DataMigrator provides powerful and flexible tooling in the form of 3 categories of code:

  1. Schema Representation
  2. A Conversion Pipeline
  3. Diverse Toolchain of Data Origins

Schema Representation

DataMigrator represents schemas in a flexible manner that supports flat schema data stores like tabular data (csv & sql) and schema-less deep data stores like JSON.

A Conversion Pipeline

The conversion pipeline is meant to be asyncronous as it handles packets of data that are streamed through the conversion type adapters. DataMigrator is built to have a diverse and extendable toolchain of adapters to convert any data type to another.

It is even designed to handle source fields that can hold several data types being converted to a destination with several completely different data types. It handles this by generating, creating, and editing the conversion type adapters where you can define exactly what source data type gets converted to which destination data type for each individual field.

Diverse Toolchain of Data Origins

DataMigrator uses adapters called DataOrigins that handle all the responsibilities of the source and destination of the data. The provide configuration, data stream, data sink, and schema validation interfaces.

For DataOrigins that involve schema-less data stores, they are responsible for generating a schema for the data. In the case of CSV tabular data, the data types are not stored in the built-in schema, so the CSV DataOrigin will scan the data to generate the data types that fit in each field.

Right now, DataMigrator is focusing on developing the CSV and Appwrite DataOrigins. After the main features have been built out and tested, the next DataOrigin will be Firebase.

License

Copyright 2022 Tanner Meade

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.