Metadata-Version: 2.1
Name: django-media-fixtures
Version: 1.0.0
Summary: Simple project to copy media files (intended for fixtures loads), pretty much as Django staticfiles does
Home-page: https://github.com/adrianoveiga/django-media-fixtures.git
Author: Adriano Veiga
Author-email: profpardal.88@gmail.com
License: MIT
Description: |badge1| |badge2| |badge3| |badge4| |badge5|
        
        .. |badge1| image:: https://travis-ci.org/adrianoveiga/django-media-fixtures.svg?branch=master
            :target: https://travis-ci.org/adrianoveiga/django-media-fixtures
            :alt: Build Status
        
        .. |badge2| image:: https://coveralls.io/repos/github/adrianoveiga/django-media-fixtures/badge.svg?branch=master
            :target: https://coveralls.io/github/adrianoveiga/django-media-fixtures?branch=master
            :alt: Coverage
        
        .. |badge3| image:: https://img.shields.io/pypi/v/django-media-fixtures.svg
            :target: https://pypi.org/project/django-media-fixtures/
            :alt: PyPI Version
        
        .. |badge4| image:: https://img.shields.io/pypi/pyversions/django-media-fixtures.svg
            :target: https://pypi.org/project/django-media-fixtures/
            :alt: Python Versions
        
        .. |badge5| image:: https://img.shields.io/pypi/l/django-media-fixtures.svg
            :target: https://pypi.org/project/django-media-fixtures/
            :alt: License
        
        django-media-fixtures
        ------------------------
        
        Simple project to copy media files (intended for fixtures loads), pretty much as staticfiles does.
        
        
        Dependencies
        ------------
        
        - Python 3.5+
        - Django 1.8+
        
        **Note**: The version (v1.x.x) dropped support of Python2! If you still need Python2, please check the last version of `v0.1.x series <https://github.com/adrianoveiga/django-media-fixtures/tree/version/0.1.x>`_
        
        
        Installation
        ------------
        
        .. code-block:: python
        
           pip install django-media-fixtures==1.0.0
        
        Then, put 'django_media_fixtures' on your INSTALLED_APPS (on settings.py), just below 'django.contrib.staticfiles'.
        
        
        Usage
        -----
        
        Just call manage command 'collectmedia', same as you do with collectstatic:
        
        .. code-block:: python
        
            python manage.py collectmedia
        
        And then all files on 'media_fixtures' folder in-apps will be copied to your MEDIA_ROOT.
        
        So, when you create your fixture (for any ways, even through shell), put your file path matching the same tree folder view as your media file.
        
        For instance,
        
        .. code-block:: python
        
            YourModel.objects.get_or_create(image="uploads/yourmodel/img/example.jpg")
        
        Where the file 'example.jpg' is on: yourappfolder/media_fixtures/uploads/yourmodel/img/example.jpg
        
        
        Configurations
        --------------
        
        - MEDIA_FIXTURE_FOLDERNAME
            You can change the media fixtures folder's name on your apps, just putting this variable on settings.py. 
        
            .. code-block:: python
                
                MEDIA_FIXTURE_FOLDERNAME='my_media_fixtures_folder'
        
        - MEDIA_FIXTURES_FILES_FINDERS
            You can change the media fixtures finders, to search media files on other folders not in-app, for instance. 
            
            .. code-block:: python
                
                MEDIA_FIXTURES_FILES_FINDERS = (
                        'django_media_fixtures.finders.FileSystemFinder',      # combined with MEDIA_FIXTURES_FILES_DIRS, choose specific folders
                        'django_media_fixtures.finders.AppDirectoriesFinder',  # default (if you do not set MEDIA_FIXTURES_FILES_FINDERS)
                )
        
        - MEDIA_FIXTURES_FILES_DIRS
            You can list specific media folders that you want to include on search.
        
            .. code-block:: python
        
                MEDIA_FIXTURES_FILES_DIRS = [
                    "/home/user/myproject/mediafiles",
                    "/opt/webfiles/common/",
                ]
        
Keywords: django collectmedia mediafiles mediafixtures fixtures media
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.5
Provides-Extra: dev
Provides-Extra: test
