amplify-excel-migrator 1.1.5__py3-none-any.whl

amplify_excel_migrator-1.1.5.dist-info/METADATA

@@ -0,0 +1,219 @@
+Metadata-Version: 2.4
+Name: amplify-excel-migrator
+Version: 1.1.5
+Summary: A CLI tool to migrate Excel data to AWS Amplify
+Home-page: https://github.com/EyalPoly/amplify-excel-migrator
+Author: Eyal Politansky
+Author-email: 10eyal10@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: requests>=2.26.0
+Requires-Dist: boto3>=1.18.0
+Requires-Dist: pycognito>=2023.5.0
+Requires-Dist: PyJWT>=2.0.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: openpyxl>=3.0.0
+Requires-Dist: inflect>=7.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: setuptools>=80.0.0; extra == "dev"
+Requires-Dist: wheel>=0.40.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Amplify Excel Migrator
+
+[![PyPI version](https://badge.fury.io/py/amplify-excel-migrator.svg)](https://badge.fury.io/py/amplify-excel-migrator)
+[![Python versions](https://img.shields.io/pypi/pyversions/amplify-excel-migrator.svg)](https://pypi.org/project/amplify-excel-migrator/)
+[![Downloads](https://pepy.tech/badge/amplify-excel-migrator)](https://pepy.tech/project/amplify-excel-migrator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A CLI tool to migrate data from Excel files to AWS Amplify GraphQL API.
+Developed for the MECO project - https://github.com/sworgkh/meco-observations-amplify
+
+## Installation
+
+### From PyPI (Recommended)
+
+Install the latest stable version from PyPI:
+
+```bash
+pip install amplify-excel-migrator
+```
+
+### From GitHub
+
+Install directly from GitHub:
+
+```bash
+pip install git+https://github.com/EyalPoly/amplify-excel-migrator.git
+```
+
+### From Source
+
+Clone the repository and install:
+
+```bash
+git clone https://github.com/EyalPoly/amplify-excel-migrator.git
+cd amplify-excel-migrator
+pip install .
+```
+
+### For Development
+
+Install with development dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+This installs the package in editable mode with pytest and other development tools.
+
+## Usage
+
+The tool has three subcommands:
+
+### 1. Configure (First Time Setup)
+
+Save your AWS Amplify configuration:
+
+```bash
+amplify-migrator config
+```
+
+This will prompt you for:
+- Excel file path
+- AWS Amplify API endpoint
+- AWS Region
+- Cognito User Pool ID
+- Cognito Client ID
+- Admin username
+
+Configuration is saved to `~/.amplify-migrator/config.json` (passwords are never saved).
+
+### 2. Show Configuration
+
+View your current saved configuration:
+
+```bash
+amplify-migrator show
+```
+
+### 3. Run Migration
+
+Run the migration using your saved configuration:
+
+```bash
+amplify-migrator migrate
+```
+
+You'll only be prompted for your password (for security, passwords are never cached).
+
+### Quick Start
+
+```bash
+# First time: configure the tool
+amplify-migrator config
+
+# View current configuration
+amplify-migrator show
+
+# Run migration (uses saved config)
+amplify-migrator migrate
+
+# View help
+amplify-migrator --help
+```
+
+### Example: Configuration
+
+```
+╔════════════════════════════════════════════════════╗
+║        Amplify Migrator - Configuration Setup      ║
+╚════════════════════════════════════════════════════╝
+
+📋 Configuration Setup:
+------------------------------------------------------
+Excel file path [data.xlsx]: my-data.xlsx
+AWS Amplify API endpoint: https://xxx.appsync-api.us-east-1.amazonaws.com/graphql
+AWS Region [us-east-1]:
+Cognito User Pool ID: us-east-1_xxxxx
+Cognito Client ID: your-client-id
+Admin Username: admin@example.com
+
+✅ Configuration saved successfully!
+💡 You can now run 'amplify-migrator migrate' to start the migration.
+```
+
+### Example: Migration
+
+```
+╔════════════════════════════════════════════════════╗
+║             Migrator Tool for Amplify              ║
+╠════════════════════════════════════════════════════╣
+║   This tool requires admin privileges to execute   ║
+╚════════════════════════════════════════════════════╝
+
+🔐 Authentication:
+------------------------------------------------------
+Admin Password: ********
+```
+
+## Requirements
+
+- Python 3.8+
+- AWS Amplify GraphQL API
+- AWS Cognito User Pool
+- Admin access to the Cognito User Pool
+
+## Features
+
+- **Configuration caching** - Save your setup, reuse it for multiple migrations
+- **Interactive prompts** - Easy step-by-step configuration
+- **Custom types and enums** - Full support for Amplify custom types
+- **Duplicate detection** - Automatically skips existing records
+- **Async uploads** - Fast parallel uploads for better performance
+- **MFA support** - Works with multi-factor authentication
+- **Automatic type parsing** - Smart field type detection and conversion
+
+## Excel File Format
+
+The Excel file should have:
+- One sheet per Amplify model (sheet name must match model name)
+- Column names matching the model field names
+- First row as headers
+
+### Example Excel Structure
+
+**Sheet: User**
+| name | email | age |
+|------|-------|-----|
+| John | john@example.com | 30 |
+| Jane | jane@example.com | 25 |
+
+**Sheet: Post**
+| title | content | userId |
+|-------|---------|--------|
+| First Post | Hello World | john@example.com |
+
+## License
+
+MIT

amplify_excel_migrator-1.1.5.dist-info/RECORD

@@ -0,0 +1,9 @@
+amplify_client.py,sha256=NjX3aICsMdHHwh-i5zGNIr2Cl95Bv87faYBcjVYI8nM,35633
+migrator.py,sha256=6MhxR280-J7g2EqgMsevXEvxZRgZ0re92G-rajmDO_0,17203
+model_field_parser.py,sha256=e4CUo0v3SvKq2VkkLgAPPD-LA3syYoPCQC81WI2QL9Y,11841
+amplify_excel_migrator-1.1.5.dist-info/licenses/LICENSE,sha256=i8Sf8mXscGI9l-HTQ5RLQkAJU6Iv5hPYctJksPY70U0,1071
+amplify_excel_migrator-1.1.5.dist-info/METADATA,sha256=-25R9Cc_qZpr998NazevvJvpwsfa8VhkmqnXM1uxCWI,6239
+amplify_excel_migrator-1.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+amplify_excel_migrator-1.1.5.dist-info/entry_points.txt,sha256=Ifd7YnV4lNbjFbbnjsmlHWiIAfIpiC5POgJtxfSlDT4,51
+amplify_excel_migrator-1.1.5.dist-info/top_level.txt,sha256=C-ffRe3F26GYiM7f6xy-pPvbwnh7Wnieyt-jS-cbdTU,43
+amplify_excel_migrator-1.1.5.dist-info/RECORD,,

amplify_excel_migrator-1.1.5.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

amplify_excel_migrator-1.1.5.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+amplify-migrator = migrator:main

amplify_excel_migrator-1.1.5.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eyal Politansky
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

amplify_excel_migrator-1.1.5.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+amplify_client
+migrator
+model_field_parser