{ "info": { "author": "DaRealFreak", "author_email": "steffen.keuper@web.de", "bugtrack_url": null, "classifiers": [], "description": "# SauceNAO\n[![Build Status](https://travis-ci.org/DaRealFreak/saucenao.svg?branch=master)](https://travis-ci.org/DaRealFreak/saucenao)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/DaRealFreak/saucenao/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/DaRealFreak/saucenao/?branch=master)\n[![Coverage Status](https://coveralls.io/repos/github/DaRealFreak/saucenao/badge.svg?branch=master)](https://coveralls.io/github/DaRealFreak/saucenao?branch=master) \nunofficial python module to make working with [SauceNAO](https://www.saucenao.com) in projects easier\n\n### Installing\nThis script runs with [Python 3](https://www.python.org). \nThere is a currently working [Python 2 branch](https://github.com/DaRealFreak/saucenao/tree/Python-2.x), but I'm not going to update it anymore. \nDownload this repository and run the setup.py to install all necessary dependencies\n\n### Dependencies\nRequired:\n* [BeautifulSoup](https://www.crummy.com/software/BeautifulSoup) - html parser\n* [requests](https://github.com/requests/requests) - http library\n\nOptional:\n* [Pillow](https://python-pillow.org) - Python Imaging Library, used to generate images for unittests\n* [python-dotenv](https://github.com/theskumar/python-dotenv) - .env file loader used for unittests\n* [requests-mock](https://pypi.python.org/pypi/requests-mock) - requests mock responses used for unittests\n\n### Usage\nYou can run SauceNAO either as module:\n```\nimport logging\nfrom saucenao import SauceNao\n\nsaucenao = SauceNao(directory='directory', databases=999, minimum_similarity=65, combine_api_types=False, api_key='',\n exclude_categories='', move_to_categories=False, use_author_as_category=False,\n output_type=SauceNao.API_HTML_TYPE, start_file='', log_level=logging.ERROR,\n title_minimum_similarity=90)\n```\nor as application:\n```\npython usage.py --dir [--databases] [--minimum-similarity] [--combine-api-types] [--api-key] [--exclude-categories] [--move-to-categories] [--use-author-as-category] [--output-type] [--start-file] [--log-level] [--filter-creation-date] [--filter-modified-date] [--title-minimum-similarity]\n```\nyou can also use it to get the gathered information for your own script:\n```\nfiltered_results = saucenao.check_file(file_name='test.jpg')\n```\nor get a generator object for a bulk of files using the worker class, all parameters work here too:\n```\nfrom saucenao import Worker\n\nresults = Worker(directory='directory', files=('test.jpg', 'test2.jpg')).run()\n```\n\n## Running the tests\nIn the tests folder you can run each unittest individually. \nThe test cases should be self-explanatory.\n\n## Development\nWant to contribute? Great! \nI'm always glad hearing about bugs or pull requests.\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE) file for details\n\n## Thanks\nA big thanks to [SauceNAO](https://www.saucenao.com) who are indexing all the images and compare them. \nThis script would be completely useless without them.\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/DaRealFreak/saucenao", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "SauceNAO", "package_url": "https://pypi.org/project/SauceNAO/", "platform": "", "project_url": "https://pypi.org/project/SauceNAO/", "project_urls": { "Homepage": "https://github.com/DaRealFreak/saucenao" }, "release_url": "https://pypi.org/project/SauceNAO/1.0.2/", "requires_dist": [ "bs4 (>=0.0.1)", "requests (>=2.18.4)", "titlesearch (>=0.0.1) ; extra == 'titlesearch'" ], "requires_python": "", "summary": "Small module to work with SauceNAO locally", "version": "1.0.2" }, "last_serial": 5900495, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "5f2d484a80d06aa91ab27312096e0989", "sha256": "dcdc9ef7450a1c8c2a964d361a83d928eb373080b4bd33c5e30a6c055f75dae3" }, "downloads": -1, "filename": "SauceNAO-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "5f2d484a80d06aa91ab27312096e0989", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 21918, "upload_time": "2018-10-29T23:10:59", "url": "https://files.pythonhosted.org/packages/f0/3f/dc3dafa00e2cbdc2d91aa055ada52ac0ba4bb4695dd50eb495914cc4abd8/SauceNAO-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "58777cb410af4604a2101971bdcf66af", "sha256": "de6d544659a593925ee01a33c6b499cf0d8d987f94905f138ff9f39799dc2674" }, "downloads": -1, "filename": "SauceNAO-1.0.0.tar.gz", "has_sig": false, "md5_digest": "58777cb410af4604a2101971bdcf66af", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14459, "upload_time": "2018-10-29T23:11:00", "url": "https://files.pythonhosted.org/packages/d0/80/d4fb769885e7b05b28871bc8a4d651da76768749bed50d8832bfface8d91/SauceNAO-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "04b48baeb44a6d302cba853524dc217e", "sha256": "90f4879fd753928210d7febce4646f525241e3250d39634bf84da263984a203f" }, "downloads": -1, "filename": "SauceNAO-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "04b48baeb44a6d302cba853524dc217e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22387, "upload_time": "2018-10-29T23:13:32", "url": "https://files.pythonhosted.org/packages/59/93/c3ca33394ea0b60deaab2dd52259a6dc1a65db8bae2d091ab1b4e2d85ba4/SauceNAO-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "34a6aea055fb4e42c945b35613a2b34a", "sha256": "62f81b81c6cd178fc51570e40e68671fb03f6a774d2cdbe0df6b521143e832bc" }, "downloads": -1, "filename": "SauceNAO-1.0.1.tar.gz", "has_sig": false, "md5_digest": "34a6aea055fb4e42c945b35613a2b34a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14805, "upload_time": "2018-10-29T23:13:34", "url": "https://files.pythonhosted.org/packages/ce/a3/8a71a820bd51e1b33111578e35d39b7c8dc60df7e43b983c88494165f053/SauceNAO-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "794341905a2088ddfbbe56504cc37b42", "sha256": "e63d9ca86c3b516a1c3ee440c7c2c31e9746aed5de34805a07bd7c91c9f1e139" }, "downloads": -1, "filename": "SauceNAO-1.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "794341905a2088ddfbbe56504cc37b42", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22427, "upload_time": "2019-09-28T19:45:01", "url": "https://files.pythonhosted.org/packages/9e/d0/4ddc6d7c5ee2bb8a20c455883eec7275503665a81cd241e92f2e29e8cc94/SauceNAO-1.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4b0251a274ff29dbb5d472f6031411a1", "sha256": "f5b5c43faddb59824b580c416423cd0afc6f7f8b79661785833daad42e7906f5" }, "downloads": -1, "filename": "SauceNAO-1.0.2.tar.gz", "has_sig": false, "md5_digest": "4b0251a274ff29dbb5d472f6031411a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14879, "upload_time": "2019-09-28T19:45:05", "url": "https://files.pythonhosted.org/packages/03/7c/4c00a5d965e87a2dd80c048a9ccc8b12fbf995a38de1387a4dbf0ebb5db7/SauceNAO-1.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "794341905a2088ddfbbe56504cc37b42", "sha256": "e63d9ca86c3b516a1c3ee440c7c2c31e9746aed5de34805a07bd7c91c9f1e139" }, "downloads": -1, "filename": "SauceNAO-1.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "794341905a2088ddfbbe56504cc37b42", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22427, "upload_time": "2019-09-28T19:45:01", "url": "https://files.pythonhosted.org/packages/9e/d0/4ddc6d7c5ee2bb8a20c455883eec7275503665a81cd241e92f2e29e8cc94/SauceNAO-1.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4b0251a274ff29dbb5d472f6031411a1", "sha256": "f5b5c43faddb59824b580c416423cd0afc6f7f8b79661785833daad42e7906f5" }, "downloads": -1, "filename": "SauceNAO-1.0.2.tar.gz", "has_sig": false, "md5_digest": "4b0251a274ff29dbb5d472f6031411a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14879, "upload_time": "2019-09-28T19:45:05", "url": "https://files.pythonhosted.org/packages/03/7c/4c00a5d965e87a2dd80c048a9ccc8b12fbf995a38de1387a4dbf0ebb5db7/SauceNAO-1.0.2.tar.gz" } ] }