{ "info": { "author": "Dennis Hedlund", "author_email": "dennishedlund@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 2" ], "description": "# Fileutility\n\nFile utility is a helper module for locating files on the local file system. It provides functionality to find files based on recursion, min-mtime, max-mtime, file suffix and timestamped filenames with regexp. \n\n## At a Glance\nInstallation using pip:\n\n```python\npip install fileutility\n```\n\n### Example usages of fileutility:\n\n#### Locate all .txt files\n```python\nimport fileutility\n\nfound_files = fileutility.find_files(path='/', file_suffix='.txt')\n```\n\n#### Locate all files last modified between 2017-11-30 and 2018-11-30\n\n```python\nimport fileutility\nfrom datetime import datetime\n\nfound_files = fileutility.find_files(\n path='/', \n minimum_file_age=datetime(2018,11,30), \n maximum_file_age=datetime(2017,11,30)\n)\n```\n\n#### Locate all .txt files with dates in filename from 2017-11-30 to 2018-11-30\n\n```python\nimport fileutility\nfrom datetime import datetime\n\nfound_files = fileutility.find_datetime_named_files(\n path='/'\n minimum_file_age=datetime(2018,11,30),\n maximum_file_age=datetime(2017,11,30),\n file_suffix='.txt'\n)\n```\n\n#### Locate all files in the local folder only\n\n```python\nimport fileutility\n\nfound_files = fileutility.find_files(\n path='/',\n recursion_depth=0\n)\n```\n\n#### Delete all files in a folder and remove folder\n```python\nimport fileutility\n\nfound_files = fileutility.find_files(\n path='/tmp/test/'\n)\n\ndelete_files(\n files=found_files,\n directory_delete=True\n)\n```\n\n## Requirements\n* Python2.7\n\nWarning. Package has only been tested on Linux and Mac.\n\n\n## Supported date in filename filters from out of the box:\n* yyyy(-.\\_)mm(-.\\_)dd\n* yy(-.\\_)Mon(-.\\_)dd\n* yyyy(-.\\_)Mon(-.\\_)dd\n* yy(-.\\_)mon(-.\\_)dd\n* yyyy(-.\\_)mon(-.\\_)dd\n* yyyy(-.\\_)Mon(-.\\_)dd\n* yy(-.\\_)Mon(-.\\_)dd\n* yyyy(-.\\_)mon(-.\\_)dd\n* yy(-.\\_)mon(-.\\_)dd\n* yyyy-mm-ddTHH:MM:SS\n\nIf none of the above regexps provide the filter or isn't specific enough you need to apply you can always write your own:\n\n```python\nimport fileutility\n\nfound_files = fileutility.find_datetime_named_files(\n path='/'\n minimum_file_age=datetime(2018,11,30),\n maximum_file_age=datetime(2017,11,30),\n file_suffix='.txt',\n regexp=r'^myfilename-[a-z]{4,10}([0-9]{2})\\@([a-z]{3})\\@([0-9]{2})'\n)\n\n```\n\n## Unit tests status\n```bash\ntest_find_all (__main__.TestFindDatetimeFiles) ... ok\ntest_find_all_suffix (__main__.TestFindDatetimeFiles) ... ok\ntest_find_older (__main__.TestFindDatetimeFiles) ... ok\ntest_find_older_younger (__main__.TestFindDatetimeFiles) ... ok\ntest_find_older_younger_suffix (__main__.TestFindDatetimeFiles) ... ok\ntest_find_regexp (__main__.TestFindDatetimeFiles) ... ok\ntest_find_regexp_suffix (__main__.TestFindDatetimeFiles) ... ok\ntest_find_regexp_suffix_no_recursion (__main__.TestFindDatetimeFiles) ... ok\ntest_find_root (__main__.TestFindDatetimeFiles) ... ok\ntest_find_subdir (__main__.TestFindDatetimeFiles) ... ok\ntest_find_younger (__main__.TestFindDatetimeFiles) ... ok\ntest_delete_files (__main__.TestFindFiles) ... ok\ntest_delete_files_and_directory (__main__.TestFindFiles) ... ok\ntest_find_all (__main__.TestFindFiles) ... ok\ntest_find_all_suffix (__main__.TestFindFiles) ... ok\ntest_find_older (__main__.TestFindFiles) ... ok\ntest_find_older_younger (__main__.TestFindFiles) ... ok\ntest_find_older_younger_suffix (__main__.TestFindFiles) ... ok\ntest_find_root (__main__.TestFindFiles) ... ok\ntest_find_subdir (__main__.TestFindFiles) ... ok\ntest_find_younger (__main__.TestFindFiles) ... ok\n\n----------------------------------------------------------------------\nRan 21 tests in 0.075s\n\nOK\n```\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Pixxle/fileutility", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "fileutility", "package_url": "https://pypi.org/project/fileutility/", "platform": "", "project_url": "https://pypi.org/project/fileutility/", "project_urls": { "Homepage": "https://github.com/Pixxle/fileutility" }, "release_url": "https://pypi.org/project/fileutility/0.6/", "requires_dist": null, "requires_python": "", "summary": "Helper module for locating and deleting files and folders.", "version": "0.6" }, "last_serial": 4547531, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "9c851e9c11286385c52b2b97b3959898", "sha256": "781f27dbfde8fceb1dcd3a416f5a26457d3148c7e353205fb126603a68f1141c" }, "downloads": -1, "filename": "fileutility-0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "9c851e9c11286385c52b2b97b3959898", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 5625, "upload_time": "2018-11-30T13:58:11", "url": "https://files.pythonhosted.org/packages/11/2d/9d03917c5a75b29b7df9fcb84dd78238eff50599986f0668d35ffff6776b/fileutility-0.2-py2-none-any.whl" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "f7b7b693d79b14864eced35efa8f50bd", "sha256": "7f94087ac3e6d213ed0c9c40e47422afdf0aa3fb3e9d28e4fd40383fb4febddd" }, "downloads": -1, "filename": "fileutility-0.3-py2-none-any.whl", "has_sig": false, "md5_digest": "f7b7b693d79b14864eced35efa8f50bd", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6591, "upload_time": "2018-11-30T14:02:08", "url": "https://files.pythonhosted.org/packages/21/29/7f373f1ff1d824d552026381b1feca4fd87b06508775bd818222a954f0ea/fileutility-0.3-py2-none-any.whl" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "3687ba81ffbcc55e92f713a135dde9a7", "sha256": "1fab5e78207fd9e3e5a79986300675d591bf0571d1ed424033a64ba50a19d6a2" }, "downloads": -1, "filename": "fileutility-0.4-py2-none-any.whl", "has_sig": false, "md5_digest": "3687ba81ffbcc55e92f713a135dde9a7", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6451, "upload_time": "2018-11-30T14:45:28", "url": "https://files.pythonhosted.org/packages/7c/4e/fa10820636290d1b39deae585aec5e8ca3b86a476594af11489fad1e901e/fileutility-0.4-py2-none-any.whl" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "ebc9c237f545bb8fff273ccb1b0c1008", "sha256": "e18bd68d1eba1cead12ff33403caf1d1281ea34e88d4c696231459fe6bc11fbc" }, "downloads": -1, "filename": "fileutility-0.5.tar.gz", "has_sig": false, "md5_digest": "ebc9c237f545bb8fff273ccb1b0c1008", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5540, "upload_time": "2018-11-30T15:11:44", "url": "https://files.pythonhosted.org/packages/7a/73/2c9ac0a0ec4c4d6a17b7cef19dce85f203b12579d179290f27369bea6984/fileutility-0.5.tar.gz" } ], "0.6": [ { "comment_text": "", "digests": { "md5": "d7dcf78baeb160384582d6a1f35db674", "sha256": "13f0a46b74f88866365c43b10e5b380e6e3b7fe12f772e1446106bcfc19221aa" }, "downloads": -1, "filename": "fileutility-0.6-py2-none-any.whl", "has_sig": false, "md5_digest": "d7dcf78baeb160384582d6a1f35db674", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6602, "upload_time": "2018-11-30T15:17:02", "url": "https://files.pythonhosted.org/packages/3f/f5/b958b0f06fcf2ca5c5da56586e5d01c72c9a6c6b695ef2fde81c0c796e13/fileutility-0.6-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d6ada74f8f2fa39b9492f8746f97c5f9", "sha256": "ec3059bb095be2dded43757e531c278bff057b48704a6247f5fab67ab57c7e2a" }, "downloads": -1, "filename": "fileutility-0.6.tar.gz", "has_sig": false, "md5_digest": "d6ada74f8f2fa39b9492f8746f97c5f9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5543, "upload_time": "2018-11-30T15:17:03", "url": "https://files.pythonhosted.org/packages/28/e1/5a624527e3f1a961edc150724b8aba6e367bf7b07c8f24c48811308068ee/fileutility-0.6.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d7dcf78baeb160384582d6a1f35db674", "sha256": "13f0a46b74f88866365c43b10e5b380e6e3b7fe12f772e1446106bcfc19221aa" }, "downloads": -1, "filename": "fileutility-0.6-py2-none-any.whl", "has_sig": false, "md5_digest": "d7dcf78baeb160384582d6a1f35db674", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6602, "upload_time": "2018-11-30T15:17:02", "url": "https://files.pythonhosted.org/packages/3f/f5/b958b0f06fcf2ca5c5da56586e5d01c72c9a6c6b695ef2fde81c0c796e13/fileutility-0.6-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d6ada74f8f2fa39b9492f8746f97c5f9", "sha256": "ec3059bb095be2dded43757e531c278bff057b48704a6247f5fab67ab57c7e2a" }, "downloads": -1, "filename": "fileutility-0.6.tar.gz", "has_sig": false, "md5_digest": "d6ada74f8f2fa39b9492f8746f97c5f9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5543, "upload_time": "2018-11-30T15:17:03", "url": "https://files.pythonhosted.org/packages/28/e1/5a624527e3f1a961edc150724b8aba6e367bf7b07c8f24c48811308068ee/fileutility-0.6.tar.gz" } ] }