{ "info": { "author": "Kade Robertson", "author_email": "kade@kaderobertson.pw", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.0", "Programming Language :: Python :: 3.1", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy" ], "description": "universities\n============\n\n|PyPI|\n\nPython package to search for basic university information. This packages\nobtains information from\n`Hipo/university-domains-list `__\\ \u2019s\ndatabase. It is fully compatible with Python 2.6 and up.\n\nInstallation\n------------\n\nYour preference should be to use PyPi: ``pip install universities``\n\nSource and wheel distributions are available in the releases tab as\nwell.\n\nUsage\n-----\n\n.. code:: python\n\n import universities\n\n uni = universities.API() # can specify encoding for use in Python 2\n\n canadian = uni.search(country = \"Canada\")\n only_mit = uni.search(domain = \"mit.edu\")\n all_data = uni.get_all()\n waterloo = uni.lucky(name = \"Waterloo\") # As in \"I'm feeling lucky\"\n\nAvailable Functions\n-------------------\n\n- ``universities.search`` searches the entire database for universities\n matching the specified critera. You may filter by ``name``,\n ``domain`` or ``country`` as arguments to ``search``. This returns a\n list of ``universities.models.University`` objects.\n- ``universities.lucky`` is an alias for ``search`` which only returns\n the first result of the search. All the same parameters are\n available, and a single ``universities.models.University`` is\n returned.\n- ``universities.get_all`` returns all of the entries in the database,\n in the same format as ``search``. In fact, this is simply an alias\n for ``search`` that uses no arguments.\n\nAny query which reurns multiple objects will return a Generator.\n\nModels\n------\n\n- ``universities.models.University`` is the basic model returned in all\n requests. It contains six fields:\n\n - ``name``: The name of the university.\n - ``domains``: A list of domain names the university uses (for\n emails, etc).\n - ``web_pages``: A list of web pages associated with the university.\n - ``country_code``: The two-letter ISO-3166 country code where the\n university is located.\n - ``stateprov``: The state or province the university is located.\n This is usually not populated.\n - ``country``: The full country name where the university is\n located.\n\nRequirements\n------------\n\nThe only requirement is ``requests``.\n\nDevelopment\n-----------\n\n1. Clone/fork the git repository.\n2. ``cd`` to the directory and install the requirements if necessary:\n ``pip install -r requirements.txt``\n3. Edit to your heart\u2019s content!\n4. If you wish to contribute, push your changes to GitHub on your own\n fork and make a pull request.\n\nNote: Any contributions should be made following the PEP8 standard.\n\n.. |PyPI| image:: https://img.shields.io/pypi/v/universities.svg?style=flat-square\n :target: https://pypi.python.org/pypi/universities\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/kade-robertson/universities", "keywords": "university data search api", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "universities", "package_url": "https://pypi.org/project/universities/", "platform": "", "project_url": "https://pypi.org/project/universities/", "project_urls": { "Homepage": "https://github.com/kade-robertson/universities" }, "release_url": "https://pypi.org/project/universities/1.0.1/", "requires_dist": [ "requests" ], "requires_python": ">=2.6, <4", "summary": "Search a large university database for basic information.", "version": "1.0.1" }, "last_serial": 3500724, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "6442695a4395bb3b7fe4fe7c428d7b49", "sha256": "0959332749f8373c0d3f79e4208041fa17270a68e0c6dfe6bcd74013db5bd032" }, "downloads": -1, "filename": "universities-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "6442695a4395bb3b7fe4fe7c428d7b49", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.6, <4", "size": 6937, "upload_time": "2018-01-16T15:44:13", "url": "https://files.pythonhosted.org/packages/cf/6b/98b98d73c9edc765f1562071cd0f40a5154839b562ba311cd532ea90b51e/universities-1.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ce2df4246ab363dc039d4382141d513c", "sha256": "8e35cc45521fa4d82715586fb6aac42a629475ff71b511f0d1ecd26b4affcf19" }, "downloads": -1, "filename": "universities-1.0.0.tar.gz", "has_sig": false, "md5_digest": "ce2df4246ab363dc039d4382141d513c", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.6, <4", "size": 4059, "upload_time": "2018-01-16T15:44:14", "url": "https://files.pythonhosted.org/packages/ce/e1/c93db69523b8565bbf5f324476ae9cc120413bb17ca9669d2dac1800f23e/universities-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "442de818b9303cdf153d490c76d6ee59", "sha256": "f90ca0a786ad5f4ef52a82ee0e3ea3504c7e34f30d2e144af648a9e55e33bd4f" }, "downloads": -1, "filename": "universities-1.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "442de818b9303cdf153d490c76d6ee59", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.6, <4", "size": 7175, "upload_time": "2018-01-17T13:04:52", "url": "https://files.pythonhosted.org/packages/55/90/330ff89caeb0a1771a7cc330a1b7d40e5e18b75ceb9ec31f26040a4610d0/universities-1.0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "685b27ffde63af2f9dac1c4d5ccad92b", "sha256": "9c7e38bd86c178b4daee4ccfb7fc1620dd000ec511fdd6b611350458e8c20ea1" }, "downloads": -1, "filename": "universities-1.0.1.tar.gz", "has_sig": false, "md5_digest": "685b27ffde63af2f9dac1c4d5ccad92b", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.6, <4", "size": 4248, "upload_time": "2018-01-17T13:05:06", "url": "https://files.pythonhosted.org/packages/a3/f8/3c04fa94d7e02504518f3d5197c006d423b05e97fc7d14e4a6b9702d032e/universities-1.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "442de818b9303cdf153d490c76d6ee59", "sha256": "f90ca0a786ad5f4ef52a82ee0e3ea3504c7e34f30d2e144af648a9e55e33bd4f" }, "downloads": -1, "filename": "universities-1.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "442de818b9303cdf153d490c76d6ee59", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.6, <4", "size": 7175, "upload_time": "2018-01-17T13:04:52", "url": "https://files.pythonhosted.org/packages/55/90/330ff89caeb0a1771a7cc330a1b7d40e5e18b75ceb9ec31f26040a4610d0/universities-1.0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "685b27ffde63af2f9dac1c4d5ccad92b", "sha256": "9c7e38bd86c178b4daee4ccfb7fc1620dd000ec511fdd6b611350458e8c20ea1" }, "downloads": -1, "filename": "universities-1.0.1.tar.gz", "has_sig": false, "md5_digest": "685b27ffde63af2f9dac1c4d5ccad92b", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.6, <4", "size": 4248, "upload_time": "2018-01-17T13:05:06", "url": "https://files.pythonhosted.org/packages/a3/f8/3c04fa94d7e02504518f3d5197c006d423b05e97fc7d14e4a6b9702d032e/universities-1.0.1.tar.gz" } ] }