Metadata-Version: 2.1
Name: RateMyProfessorAPI
Version: 1.0.1
Summary: Python web scraper to get professor ratings from ratemyprofessor.com website.
Home-page: https://github.com/Nobelz/RateMyProfessorAPI
Author: Nobel Zhou
Author-email: nxz157@case.edu
License: UNKNOWN
Project-URL: Issue Tracker, https://github.com/Nobelz/RateMyProfessorAPI/issues
Description: # RateMyProfessorAPI
        
        
        ## Setup
        **Please note that this has only been tested on Python 3.9.1. If this doesn't work for older versions, open up an Issue.**
        
        Install the package using the following command:
        ```
        python -m pip install RateMyProfessorAPI 
        ```
        
        To update the package, use the following command:
        ```
        python -m pip install RateMyProfessorAPI --upgrade
        ```
        
        To use the package in your program, please import the package:
        ```py
        import ratemyprofessor
        ```
        
        ## Uninstallation
        To uninstall the package, use the following command:
        ```
        python -m pip uninstall RateMyProfessorAPI
        ```
        
        ## Usage
        As of version 1.0.0, there are limited ways to retrieve professor ratings. 
        Only ratings, difficulty ratings, and names can be displayed at this time.
        
        To retrieve a list of professors, you have to first specify the school:
        ```python
        ratemyprofessor.get_school_by_name("School Name here")
        ```
        This will return `None` if no school is found corresponding with that name. 
        Alternatively, to search for multiple schools, use
        ```python
        ratemyprofessor.get_schools_by_name("School Name here")
        ```
        This will return a list of `School`s.
        
        Using the `School` object obtained from the previous commands, you can use that to find the professor:
        ```python
        ratemyprofessor.get_professor_by_school_and_name(school, "Professor Name") 
        ```
        where school refers to a `School` object.
        Alternatively, to search for multiple professors, use
        ```python
        ratemyprofessor.get_professor_by_schools_and_name(school, "Professor Name") 
        ```
        This will return a list of `Professor`s.
        
        Each `Professor` object has a `rating`, `difficulty`, `id`, and `name`.
        
        Each `School` object has a 'id' and 'name'.
        
        ## Example
        ```python
        import ratemyprofessor
        
        professor = ratemyprofessor.get_professor_by_school_and_name(
            ratemyprofessor.get_school_by_name("Case Western Reserve University"), "Connamacher")
        print(f"Professor name: {professor.name}")
        print(f"Professor rating: {professor.rating} / 5.0")
        print(f"Professor difficulty: {professor.difficulty} / 5.0")
        ```
        
        **Output:**
        ```
        Professor name: Harold Connamacher
        Professor rating: 4.7 / 5.0
        Professor difficulty: 3.8 / 5.0
        ```
        See `examples` for more examples.
        
        ## Acknowledgements and License
        This can be seen as a continuation of the [RateMyProfessorPyAPI](https://pypi.org/project/RateMyProfessorPyAPI/) project that can also be found on GitHub [here](https://github.com/remiliacn/RateMyProfessorPy).
        A lot of the code is reused in this package.
        As such, this project is also licensed under the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0). See LICENSE for more details.
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3
Description-Content-Type: text/markdown
