WARNING: it's under development and has major changes around commits (no migrations before release, fabfile.py recreate command
). After release in PIP it will have stable API
Project updates here http://mtr.website
Thank you guys for funding this project at kickstarter
Includes only docstrings from module http://django-mtr-sync.rtfd.org/
- Install package:
pip install git+https://github.com/mtrgroup/django-mtr-sync.git
- Add
mtr.sync
toINSTALLED_APPS
in your settings file - Migrate models
./manage.py migrate
- Configure
Celery
- Create settings for import or export data at
/admin/mtr_sync/settings/
and run actionSync data
to start process.
- Import action: https://www.youtube.com/watch?v=JOgQCFB-leg
- Export action: https://www.youtube.com/watch?v=L4ti1qERSLs
- Import (only creating), export data
- Processor API for supporting other formats
- Uses Celery for background tasks and for processing large volumes of data
- Creates reports about importing and exporting operations
- Auto discovering models for use in package
- Data range settings (start, end cells in table), for example, if you need to import data where there is a header with logo or any other unnecessary information
- Field settings:
- maps model fields with data fields
- adds and removes fields (ability to skip fields on import)
- set start cell of exporting data
- related models import-export by choosing main model
- Supports: CSV(native python3, unicodecsv python2), XLS (using: xlwt-future, xlrd), XLSX (using: openpyxl optimized writer, reader mode, for fast processing of large volumes of data) and ODS(odfpy)
- Saves import, export settings for the processing of data from various sources and for simplicity
- Integration with standart django admin app
- Custom filters (for querysets)
- Modeltransation language activation
- Inline support
- Value processors (convert values before import or export)
- Shortcuts at admin app
- Multilingual (i18n)
- Template integration with django-grapelli
- Action handler for more flexebility (for example not create model but generate source code for it, prepare data for model)
- Supports: Django 1.6-1.8+ Python 2.7, 3.3+
- Documentation
- Replacer model for minimizing dublication content
- Different source input (url)
- Dashboard without admin
- Adding support of JSON, YAML, XML
- Permission control for import settings using django auth, to minimize human errors. For example, this would allow only the manager to choose the settings template for import and to upload files without configuring
- Export templates for (XLS, XLSX, ODS)
- upload custom templates
- Periodic import, export for automatic updates
- Video tutorial how to set up package and use it
- Plugins for editors ckeditor and redactor — insert file from already exported files