{ "info": { "author": "Daniel Hillier", "author_email": "daniel.hillier@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Web Environment", "Framework :: Django", "Framework :: Django :: 1.10", "Framework :: Django :: 1.11", "Framework :: Django :: 1.8", "Framework :: Django :: 1.9", "Framework :: Django :: 2.0", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5" ], "description": "\nDjango Override Storage\n=======================\n\nStop filling up your disk with test files or your code with file system mocks!\n\nThis project provides tools to help you reduce the side effects of using\nFileFields during tests.\n\n\nInstallation\n------------\n\n.. code-block:: bash\n\n pip install django-override-storage\n\n\nSimple Usage\n------------\nCalling ``override_storage()`` without any arguments will patch all\n``FileField`` fields to store the contents of the file in an in-memory cache\nand returns the fields to their previous storages when leaving its context. The\nstorage cache is deleted at the end of each test or when exiting the context\nmanager depending on how it is called.\n\nIt can be used similarly to ``django.test.utils.override_settings``: as a class\ndecorator, a method decorator or a context manager.\n\n.. code-block:: python\n\n from django.core.files.base import ContentFile\n from django.test import TestCase\n\n from override_storage import override_storage\n from override_storage.storage import LocMemStorage\n\n from .models import SimpleModel\n\n class OverrideStorageTestCase(TestCase):\n\n def test_context_manager(self):\n with override_storage():\n # By default, all files saved to in memory cache.\n obj = SimpleModel()\n obj.upload_file.save('test.txt', ContentFile('content'))\n\n # Get your file back!\n content = obj.upload_file.read()\n\n @override_storage(storage=LocMemStorage())\n def test_method_decorator(self):\n # You can also specify to replace all storage backends with a\n # storage instance of your choosing. Depending on the storage type,\n # this could mean all writes will persist for the life of the\n # instance. This does not really matter if you wanted to pass in a\n # FileSystemStorage instance as those writes will be persisted\n # regardless.\n ...\n\n @override_storage(storage=LocMemStorage)\n def test_method_decorator(self):\n # Passing in a class will create a new instance for every test.\n\n @override_storage()\n def test_method_decorator(self):\n # Used as a method decorator.\n ...\n\n\n @override_storage()\n class OverrideStorageClassTestCase(TestCase):\n # You can also wrap classes.\n ...\n\n\nIt can also be used globally through a custom test runner. This can be achieved\nby setting the ``TEST_RUNNER`` setting in your settings file or however else\nyou may choose to define the Django test runner.\n\n**Warning**\n\n``TEST_RUNNER`` only sets up the replacement storage once at the start of the\ntests as there are no hooks into the ``setUp`` / ``tearDown`` methods of the\ntest class. Using ``override_storage.LocMemStorageDiscoverRunner`` will share a\nsingle in memory cache across all tests. While this shouldn't affect your\ntests, if you write a lot of big files, you may run out of memory.\n\n.. code-block:: python\n\n TEST_RUNNER = 'override_storage.LocMemStorageDiscoverRunner'\n\n\nStorage information\n-------------------\n\nLike ``override_storage``, ``locmem_stats_override_storage`` patches all\n``FileField`` fields to store the contents of the file in an in-memory cache\nand returns the fields to their previous storages when leaving its context.\n\nIn addition to the normal functionality, it returns an object with information\nabout the calls to the ``_open`` and ``_save`` methods of the test storage. In\ngeneral it records which fields have had files read from or written to them and\nthe names of the files are recorded.\n\n.. code-block:: python\n\n from django.core.files.base import ContentFile\n from django.test import TestCase\n\n from override_storage import locmem_stats_override_storage\n\n from .models import SimpleModel\n\n class OverrideStorageTestCase(TestCase):\n\n def test_context_manager(self):\n with locmem_stats_override_storage() as storage_stats:\n # All files saved to in memory cache.\n obj = SimpleModel()\n obj.upload_file.save('test.txt', ContentFile('content'))\n\n # Check how many files have been saved\n self.storage_stats.save_cnt\n\n # Check which fields were read or saved\n self.storage_stats.fields_saved\n self.storage_stats.fields_read\n\n # Get a list of names, by field, which have been saved or read.\n self.storage_stats.reads_by_field\n self.storage_stats.saves_by_field\n\n # Get your file back!\n content = obj.upload_file.read()\n\n @locmem_stats_override_storage(name='storage_stats')\n def test_method_decorator(self, storage_stats):\n # access to storage stats by specifying `name` which is the name of\n # the kwarg to be used in the function signature.\n ...\n\n\n @locmem_stats_override_storage(name='storage_stats')\n class OverrideStorageClassTestCase(TestCase):\n storage_stats = None\n\n # access to storage stats by specifying attr_name\n ...\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/danifus/django-override-storage", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "django-override-storage", "package_url": "https://pypi.org/project/django-override-storage/", "platform": "", "project_url": "https://pypi.org/project/django-override-storage/", "project_urls": { "Homepage": "https://github.com/danifus/django-override-storage" }, "release_url": "https://pypi.org/project/django-override-storage/0.1.6/", "requires_dist": null, "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "summary": "Django test helpers to manage file storage side effects.", "version": "0.1.6" }, "last_serial": 3871174, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "8a1d7065337940ce7e72484e08e7d115", "sha256": "a52b0c1ac90e0fa28d224ead1d8dee7aa19f4c5a152eb86897650681e33a818e" }, "downloads": -1, "filename": "django-override-storage-0.1.0.tar.gz", "has_sig": false, "md5_digest": "8a1d7065337940ce7e72484e08e7d115", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9402, "upload_time": "2017-06-02T15:17:24", "url": "https://files.pythonhosted.org/packages/b1/90/a85eb015dea666b8db1d94d02b5eec3be1ba2b338e7fb123674906d8ce48/django-override-storage-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "ce68cabc50cb2f4305c22e1f23fc0959", "sha256": "54c069941895a1af942c3af27395a2729b6b37a3bdae144a11ad65e0a87ca27e" }, "downloads": -1, "filename": "django-override-storage-0.1.1.tar.gz", "has_sig": false, "md5_digest": "ce68cabc50cb2f4305c22e1f23fc0959", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9216, "upload_time": "2017-06-04T00:12:34", "url": "https://files.pythonhosted.org/packages/66/cb/d659462a1908955207e4b253ff4585cc590f0099f4380d17921e117f6d43/django-override-storage-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "2ca7cb9296981ce7592717284ee76358", "sha256": "6631a5e7c64e24b4eebcc9c52ea3990811ccb8b7aad5886fc6071c78cce6509f" }, "downloads": -1, "filename": "django_override_storage-0.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "2ca7cb9296981ce7592717284ee76358", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 13092, "upload_time": "2017-12-07T14:32:17", "url": "https://files.pythonhosted.org/packages/39/f4/ffbc47398c6c78c048feecc4a59c99c99cbbb0ed31dc444e805071230d7c/django_override_storage-0.1.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "20ae0761dccf066926d8349b9083bd2b", "sha256": "5253ca8e0408cb758e44550561b51b81209a56f18f870449e0e2d1390a154e4a" }, "downloads": -1, "filename": "django-override-storage-0.1.2.tar.gz", "has_sig": false, "md5_digest": "20ae0761dccf066926d8349b9083bd2b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10336, "upload_time": "2017-12-07T14:32:18", "url": "https://files.pythonhosted.org/packages/c3/ee/afe1a93eec90233c728ad15549679b040f87edb2956ad480e043f5f62966/django-override-storage-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "19c4ad065fbb1eaf672bc45d608f75f3", "sha256": "1b5cf41b5e868844cfac265ec503d75b5cf5a6d77c0bb96535314d2c31cac713" }, "downloads": -1, "filename": "django_override_storage-0.1.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "19c4ad065fbb1eaf672bc45d608f75f3", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 12173, "upload_time": "2018-03-25T11:09:21", "url": "https://files.pythonhosted.org/packages/c4/e8/4cada54226d0b59c45ea9df4d150cd2a0b0fc5235df38085023d9379f66a/django_override_storage-0.1.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4b801423ea1f427fb4516c8e648c68a3", "sha256": "52aa85814e151936853dbd33a4742b21c7937c558159d695b9fdbffcd9c9542c" }, "downloads": -1, "filename": "django-override-storage-0.1.3.tar.gz", "has_sig": false, "md5_digest": "4b801423ea1f427fb4516c8e648c68a3", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 11560, "upload_time": "2018-03-25T11:09:22", "url": "https://files.pythonhosted.org/packages/02/2d/31a859851003a15f726700a5c342724a040259f13d5add9aad61e25b9284/django-override-storage-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "a63df94cfbcd65580fcc22f0152c77cd", "sha256": "f3dbb33a533d4a03afc3ce2ac0e9fff99b5776f1bf4d42b94c7f3d6cc27be838" }, "downloads": -1, "filename": "django_override_storage-0.1.4-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "a63df94cfbcd65580fcc22f0152c77cd", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 12144, "upload_time": "2018-03-25T11:59:13", "url": "https://files.pythonhosted.org/packages/37/74/5485af145e4bc708302052e0d132ee30c15729a9b91e1fb87ddbe1c38783/django_override_storage-0.1.4-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4b9a0f9ba86faa4640707e7b9e2c67a4", "sha256": "fd9427851ced9f60cbddeacf57ea8b925a1fdd57223ff1ff0a0b590f600d1f6b" }, "downloads": -1, "filename": "django-override-storage-0.1.4.tar.gz", "has_sig": false, "md5_digest": "4b9a0f9ba86faa4640707e7b9e2c67a4", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 11452, "upload_time": "2018-03-25T11:59:15", "url": "https://files.pythonhosted.org/packages/72/b9/7a655ef8e4140675b291f23a0548657558d575b3c85ef693254f31c53b5d/django-override-storage-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "8079ef49342fe6b54e1917d71c01f2bd", "sha256": "4b85eb5322e15f2b8c555ccaf0f5e8fd59d225323010c7c886c957a60fc05bda" }, "downloads": -1, "filename": "django_override_storage-0.1.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "8079ef49342fe6b54e1917d71c01f2bd", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 12156, "upload_time": "2018-05-16T03:27:51", "url": "https://files.pythonhosted.org/packages/ce/16/5f291b67a13e9195d3dd33aa886cd44029ccaff2f59ff056880305981a5a/django_override_storage-0.1.5-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "52bd4b98afc1a0c33378e44cf89aafde", "sha256": "a7702dfc1341213e706b9b33308604a265dfb0cb061ed74fc438024b81c2d6b6" }, "downloads": -1, "filename": "django-override-storage-0.1.5.tar.gz", "has_sig": false, "md5_digest": "52bd4b98afc1a0c33378e44cf89aafde", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 11457, "upload_time": "2018-05-16T03:27:54", "url": "https://files.pythonhosted.org/packages/32/02/c7aae4089df21529da85182b514002746e5aab38942313771810b2a1b752/django-override-storage-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "5bd44bb6191a17ee1053536343241819", "sha256": "d4b6a8290adff46c894f4c87e6843595ee2dda4b4cdc3e8094ca7b1ced5b4e54" }, "downloads": -1, "filename": "django_override_storage-0.1.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5bd44bb6191a17ee1053536343241819", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 12291, "upload_time": "2018-05-17T06:33:10", "url": "https://files.pythonhosted.org/packages/6a/98/058fbcef48fc1d898959f4e246aef995ddaaa4a7a1e839bd4f2d1878640e/django_override_storage-0.1.6-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "37430f6917efa7c70393dacf7f034088", "sha256": "3b5e0e622845d940a2507724ab6da34d4438fdb46e7364a7f7d4764a12ce4a08" }, "downloads": -1, "filename": "django-override-storage-0.1.6.tar.gz", "has_sig": false, "md5_digest": "37430f6917efa7c70393dacf7f034088", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 11660, "upload_time": "2018-05-17T06:33:11", "url": "https://files.pythonhosted.org/packages/14/6c/420d29dd57525123df9351039335426477ae75f7eee7b2e19f598f4f32a4/django-override-storage-0.1.6.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5bd44bb6191a17ee1053536343241819", "sha256": "d4b6a8290adff46c894f4c87e6843595ee2dda4b4cdc3e8094ca7b1ced5b4e54" }, "downloads": -1, "filename": "django_override_storage-0.1.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5bd44bb6191a17ee1053536343241819", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 12291, "upload_time": "2018-05-17T06:33:10", "url": "https://files.pythonhosted.org/packages/6a/98/058fbcef48fc1d898959f4e246aef995ddaaa4a7a1e839bd4f2d1878640e/django_override_storage-0.1.6-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "37430f6917efa7c70393dacf7f034088", "sha256": "3b5e0e622845d940a2507724ab6da34d4438fdb46e7364a7f7d4764a12ce4a08" }, "downloads": -1, "filename": "django-override-storage-0.1.6.tar.gz", "has_sig": false, "md5_digest": "37430f6917efa7c70393dacf7f034088", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*", "size": 11660, "upload_time": "2018-05-17T06:33:11", "url": "https://files.pythonhosted.org/packages/14/6c/420d29dd57525123df9351039335426477ae75f7eee7b2e19f598f4f32a4/django-override-storage-0.1.6.tar.gz" } ] }