{ "info": { "author": "Assil Taoufik Ksiksi", "author_email": "cyph0nik@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Topic :: Internet :: WWW/HTTP :: Indexing/Search" ], "description": "Introduction\n============\n\n`Dubizzle `_ is an online classifieds website. This project aims to become a simple and complete scraping-based API for Dubizzle.\n\nRepo\n----\n\nhttps://github.com/Cyph0n/dubizzle\n\nPrerequisites\n=============\n\n* `Requests `_\n* `BeautifulSoup `_\n* Python 2.6+\n\nQuickstart\n==========\n\n::\n\n >> import dubizzle\n >> results = dubizzle.search(country='uae', city='dubai', section='motors', num_results=100)\n >> print results\n >>\n [\n {\n 'url': 'test',\n 'image': 'http://...',\n 'price': 10000,\n 'date': datetime.datetime(2013, 07, 20, 0, 0, 0),\n 'features': {\n 'Color': 'black',\n 'Doors': 4,\n 'Kilometers': 35000\n },\n ...\n },\n ...\n ]\n\nExamples\n========\n\n::\n\n # Find average price of year 2007 and above Nissan Altimas in Dubai\n import dubizzle\n\n results = dubizzle.search(keyword='altima', country='uae', city='dubai', section='motors',\n category='cars', make='nissan', min_year=2007, num_results='all')\n\n total_price, result_count = 0, len(results)\n\n for result in results:\n total_price += result['price']\n\n print float(total_price) / result_count # Prints 39239.94\n\n::\n\n # Use the above results to find distribution of post-2007 Altima colors\n from collections import Counter\n\n colors = [result['features']['color'] for result in results]\n distribution = Counter(colors)\n\n print distribution['white'] # Prints 52\n\n::\n\n # Retrieve a single listing from Dubizzle UAE\n import dubizzle\n\n listing = dubizzle.listing('http://dubai.dubizzle.com/motors/used-cars/nissan/tiida/2013/9/25/easy-installment-new-and-used-cars-0563276-2/', country='uae')\n\n print listing\n\nSearch Parameters\n=================\n\nGeneral\n-------\n\n* `country` - string; defaults to 'uae'\n* `keyword` - string\n* `city` - string\n* `section` - string\n* `min_price` and `max_price` - integers\n* `category` - string\n* `added_days` - choices are 0, 3, 7, 14, 30, 90, or 180\n* `num_results` - integer; 'all' fetches all results available\n* `detailed` (not implemented) - if set to `True`, fetches full listing data for each result; slower, obviously\n\nMotors\n------\n\n* `make` - a long list can be found in `regions.py`\n* `min_year` and `max_year` - integers\n* `min_kms` and `max_kms` - integers\n* `seller` - 'dealer' or 'owner'\n* `fuel` - 'gasoline', 'hybrid', 'diesel', or 'electric'\n* `cylinders` - 3, 4, 5, 6, 8, 10, or 12\n* `transmission` - 'automatic' or 'manual'\n\nListing Parameters\n------------------\n\n* `url` - string, **required**\n* `country` - string; defaults to 'uae'\n\nIssues\n------\n\nPlease use the `Issues `_ page for that.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Cyph0n/dubizzle/", "keywords": "dubizzle,scraping,API,search,classifieds", "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "dubizzle", "package_url": "https://pypi.org/project/dubizzle/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/dubizzle/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/Cyph0n/dubizzle/" }, "release_url": "https://pypi.org/project/dubizzle/0.1/", "requires_dist": null, "requires_python": null, "summary": "A scraping-based API for Dubizzle.", "version": "0.1" }, "last_serial": 1413237, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "268d79dfefaa2d75c9c0252b20fe986d", "sha256": "8b1c52a4ecaefa2c7fd2f427128a6c4bf5abd4e8681c8673b0e48fa54754ee0c" }, "downloads": -1, "filename": "dubizzle-0.0.1.tar.gz", "has_sig": false, "md5_digest": "268d79dfefaa2d75c9c0252b20fe986d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7298, "upload_time": "2013-09-29T19:23:46", "url": "https://files.pythonhosted.org/packages/93/5c/9f3748e6e78553b8229376a61b13a6b37543199f6a57b0b6ef72f1c2b6b5/dubizzle-0.0.1.tar.gz" } ], "0.0.1-1": [ { "comment_text": "", "digests": { "md5": "73a991e49917166cdc4653f72d542c7e", "sha256": "9585e17c108420df60d5c409f6352a07eb334ae1305a25a6868109b87bf75f0d" }, "downloads": -1, "filename": "dubizzle-0.0.1-1.tar.gz", "has_sig": false, "md5_digest": "73a991e49917166cdc4653f72d542c7e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7289, "upload_time": "2013-10-03T13:51:08", "url": "https://files.pythonhosted.org/packages/00/d3/0f6efbba59f48028d12604c28339cd1b51309a37df75301ab28438151682/dubizzle-0.0.1-1.tar.gz" } ], "0.1": [ { "comment_text": "", "digests": { "md5": "5040940c25a9afd35d370f235c68f1e6", "sha256": "da22b9b735341cd5b1acbe5d9d22705b8e6d00d6e884c2e47aef041b46244b11" }, "downloads": -1, "filename": "dubizzle-0.1.tar.gz", "has_sig": false, "md5_digest": "5040940c25a9afd35d370f235c68f1e6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7806, "upload_time": "2015-02-06T23:00:31", "url": "https://files.pythonhosted.org/packages/11/2e/b3ccb626d5b11bfdca56bb1cf3fe0ea07ea7cb2bd20a77cffd2730298abb/dubizzle-0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5040940c25a9afd35d370f235c68f1e6", "sha256": "da22b9b735341cd5b1acbe5d9d22705b8e6d00d6e884c2e47aef041b46244b11" }, "downloads": -1, "filename": "dubizzle-0.1.tar.gz", "has_sig": false, "md5_digest": "5040940c25a9afd35d370f235c68f1e6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7806, "upload_time": "2015-02-06T23:00:31", "url": "https://files.pythonhosted.org/packages/11/2e/b3ccb626d5b11bfdca56bb1cf3fe0ea07ea7cb2bd20a77cffd2730298abb/dubizzle-0.1.tar.gz" } ] }