clueless-community/collegeapi

An API that helps you to fetch colleges and their details.

collegeapi's Issues

Docs

Doc improvements :

• Introduction to collage API
• List endpoints
• Contribution guidelines

Need to dockerize this project.

Comma punctuation mark is not added in allEngineeringColleges.json

Description
I have added a punctuation mark can you have a look through it @nikhil25803
Link : #82 (comment)

Build the endpoint for filtering Medical Colleges by City and State

New endpoints for filtering Medical Colleges by the following:

1. State
2. City

Endpoint to fetch list Universities.

Notes

• This is the list of university data.
• Scrape this data, store it in collegeAPI/data folder.
• Define an endpoint to fetch the data, set the path as /universities
• The response should have the names of the universities along with their city, state, and rank.

Add endpoint to filter colleges by city and state.

Description

• Build endpoints inmain.py to filter colleges by city and state
• This is the data we need to filter out.
• Go through the other filter endpoint and build this one accordingly.

Screenshots

No response

Additional information

No response

Async and Await functionality

What would you like to share?

Description
Can we use async and await functionality in api so that may be error in response will be minimized doesn't matter it takes little extra time to resolve response by traversing through data .
@nikhil25803 can you suggest what is scope of this idea?

Additional information

No response

Endpoint to fetch the list of all management colleges in India.

Note

• This is the list of all the management colleges listed in NIRF.
• Build an endpoint that returns the name of the colleges along with their city and state.
• Set the path as /management_colleges

Endpoint to fetch the details of all the colleges listed in NIRF

Notes

• This is the list of all the participating colleges.
• Scrape this data and store the data in the collegeAPI/data folder in JSON format and the scraper file in the collegeAPI/helpers folder.
• Define an endpoint to fetch the list of the colleges and set the path as /colleges.
• The response must have the name of the colleges along with the name of cities and state.

Buid an endpoint to fetch the participated institutes overall.

Description

Notes

• This is the list of all the participating institutes in NIRF.
• Build an endpoint to fetch this data.
• Set the path as /all

Screenshots

No response

Additional information

No response

Optimization needed and response need to return 1D list instead of 2D list

Description

Before

In the response I have checked that it was returning 2D response and main.py there were some lines in api which were repeated again function is needed.

After

Using extend keyword instead of append keyword inside the api like engineering_colleges/state={state} worked and it returned 1D array as it will be better for further processing and extraction .
can you have a closer look @nikhil25803 ?

Screenshots

Before

After

Also main.py LOC is reduced by adding function colleges_by_state_or_city and passing useful variables for further understanding

Additional information

No response

Changes in filter.py, processing function is not there can i add, please assign me

Description

@nikhil25803 Changes in filter.py, processing function is not there can i add, please assign me
before:-
output = []
for i in range(len(data)):
stateCheck = data[i]['state'].replace(" ", "").lower()
if stateCheck == state:
output.append(data[i])
return output
after:-
return processing(data, 'state', state)

Screenshots

No response

Additional information

No response

Build an UI for this project.

Notes

• Idea is to give this project a user interface on the root / path, as a landing page.
• Create a templates folder and create all the UI-related files in that folder only.
• The template folder must have an index.html file.
• Before asking to get this issue assigned to you, please explain your idea in the comments below explaining the design(you may upload an image for reference) and the tech stack you are going to use.
• Go through the contributing guidelines and make your contribution accordingly.

Redundant raise error was present

Description
Redundant raise error was present at medical /medical_colleges/city={city} endpoint I have made some changes and removed extra raise present in api endpoint to reduce line of code can you go through it @nikhil25803 ?

Link :#65 (comment)

Build the endpoint to fetch all the participating pharmacy college in India.

NOTES

• Scrape the data from this page.
• Set the endpoint as /pharmacy_colleges

Addition of College name

Description
Some colleges near by me were not added I have made some changes to it could you verify it .

• Checked codebase
• visited through various colleges Names
  link : #66 (comment)

Some new endpoints

• Filtering colleges from particular NIRF to another NIRF ( Let's say 10 to 20 colleges)
• Ordering the state colleges by NIRF
• Filtering colleges by multiple states
• Filtering colleges by multiple cities.

Hey!! @nikhil25803 I want to work on some of the endpoints. Check the endpoints which are really useful and please assign to me.

Endpoint to fetch all the law colleges ranked by NIRF.

• This is the list of all the law college ranked by NIRF.
• Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
• Define the endpoint as /law_colleges/nirf
• The response should have the names of the colleges along with their rank, city, and state.

An endpoint to fetch all the NIRF ranked Pharmacy college.

NOTES

• This is the list of all the pharmacy colleges that are ranked by NIRF.
• Scrape this data and set the endpoint as /pharmacy_colleges/nirf

UPDATED "allAgriculture.json"

Description

I Had updated and add a college in " allAgriculture.json"
kindly merge it and mark it as "Hacktoberfest Accepted"

Screenshots

No response

Additional information

No response

In collegeAPI/data/allengineeringcollege.json one College is missing

Description

@nikhil25803 this college is missing
Matoshri College Of Engineering & Research Centre, Eklhare, Nashik

Screenshots

No response

Additional information

No response

Function concept need to implement to reduce line of code and improve optimization in filters.py

I have made some changes in filters.py that is added one processing function to manipulate the task and its line of code is reduced
can you have a look through it @nikhil25803
link : #84 (comment)

Endpoint to fetch the details of all the TamilNadu colleges ranked by NIRF

Description

• This is the list of all the research colleges ranked by nirf.
• Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
• Define the endpoint as /TamilNadu_colleges/nirf
• The response should have the names of the colleges along with their rank.

Screenshots

No response

Additional information

No response

Endpoint to fetch the details of all TamilNadu colleges ranked by NIRF

Description

• This is the list of all the research colleges ranked by nirf.
• Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
• Define the endpoint as /TamilNadu_colleges/nirf
• The response should have the names of the colleges along with their rank.

Screenshots

No response

Additional information

No response

Design a favicon for this project.

Design a favicon(logo) that will be associated with this webpage.

Endpoint to fetch the list of colleges RANKED by NIRF.

Notes

• This is the list of colleges ranked by NIRF.
• Scrape the data, store it in the /data folder and upload the scrapper file too in the /helpers folders.
• Define an endpoint to fetch the list and set the path as /colleges/nirf.
• Please note that the rank is provided for the first 100 colleges only, you need to update the rank by yourself accordingly for the colleges in the rank band 101-200.

Endpoint to fetch the details of all Research colleges ranked by NIRF.

• This is the list of all the research colleges ranked by nirf.
• Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
• Define the endpoint as /research_colleges/nirf
• The response should have the names of the colleges along with their rank, city, and state.

Add colleges from Siliguri into the data

I would like to add the colleges

Some college seems to be missing

I found that some engineering colleges of my city are missing in the list.

Endpoint to fetch the details of all the participated dental institutes.

Notes

• This is the list of all the participated dental colleges.
• Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
• Define the endpoint as /dental_colleges
• The response should have the names of the colleges along with their city, and state.

Add endpoint to filter colleges by city and state.

Description

Notes

• The data of all the colleges is stored in the data folder.
• Use that data to filter colleges by city and state.
• Define two endpoints colleges/city={city_name} to filter colleges by city and /colleges/state={states_name} to filter colleges by state.
• User must be able to pass multiple cities and states.

Screenshots

No response

Additional information

No response

Changes required in filter.py preprocessing function is wrongly defined please assign me this task

Description

@nikhil25803 here is the bug
Before:-
output = []
for i in range(len(data)):
cityCheck = data[i]['city'].lower()
if cityCheck == city:
output.append(data[i])

return output

After:-
return processing(data,'city',city)

Screenshots

No response

Additional information

No response

Deploy the end points

You can try deploying the endpoints so that people can see the results and test the API out. And you can add a limit of request/user. @nikhil25803

Build the endpoint to fetch all the NIRF ranked medical colleges in India.

Note

• This is the list of all the medical colleges in India that are ranked by NIRF.
• Set the path as /medical_colleges/nirf
• The response should have the name of the colleges along with their city, state, and NIRF rankings.

Endpoint to fetch the details of research colleges

• This is the list of all the research colleges.
• Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
• Define the endpoint as /research_colleges
• The response should have the names of the colleges along with their rank, city, and state.

Build endpoint to fetch all the participated law institutes .

Description

Notes

• This is the list of all the NIRF-ranked law colleges.
• Build an endpoint to fetch this list
• Set the path as /law_colleges/nirf

Screenshots

No response

Additional information

No response

Endpoint to fetch the details of all the participated architecture colleges.

I want to work on this :

1. I would like to add the list of all the participated architecture colleges.
2. Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
3. Define the endpoint as /architecture_colleges
4. I will make sure that the response should have the names of the colleges along with their city, and state.

Update the new endpoints in the README.md

Build an endpoint to fetch all the NIRF ranked Dental college.

Notes

• This is the list of all the dental colleges ranked by NIRF.
• Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
• Define the endpoint as /dental_colleges/nirf
• The response should have the names of the colleges along with their rank, city, and state.

Build endpoints to filter Pharmacy colleges by city and state.

Description

Notes

• The data of all the pharmacy colleges is stored in the data folder.
• Build two endpoints, one to filter data by city and the second to filter data by state.
• One endpoint is pharmacy_colleges/state={states_name} and pharmacy_colleges/city={cities_name}

Screenshots

No response

Additional information

No response

Endpoint to fetch all the Architecture colleges ranked by NIRF.

I would like to work on this :

1. I will fetch the list of all the Architecture college ranked by NIRF.
2. Store the scrapped data in data folder in JSON format and the scrapper in the helpers folder.
3. Define the endpoint as /architecture_colleges/nirf
4. I will make the response such that it should have the names of the colleges along with their rank, city, and state.

Indentation of output variable in main.py is changed at some endpoint

Description
output variable in main.py inside the /dental_colleges/nirf,/law_colleges/nirf is changed should I put it in outer indent block or leave it as it is @nikhil25803 .

Add an endpoint to fetch the overall ranked colleges by NIRF.

Description

Notes

• This is the list of overall colleges ranked by NIRF.
• Build an endpoint to fetch this data.
• Set the path as /all/nirf

Screenshots

No response

Additional information

No response

feat: Add pull request template and issue templates

Description

There are currently no issue templates and the pull request template. I would like to add these so that it'll help folks contributing to the project by giving a structured way to describe the problem.

Build an endpoint to fetch the list of NIRF ranked management colleges.

Note

• You have to list all the management colleges in India that are ranked by NIRF
• You can find the list of colleges on NIRF official website
• Set the path as management_colleges/nirf
• The output should have the name of all the colleges along with their rank, city and state.

Build the endpoints to fetch all the medical colleges.

Note :

• This is the list of all the Participated Institutes Medical.
• Set the path as /medical_colleges/
• The response should return the name of the college along with the city and state.

Update Readme

Description

• Update the endpoints in the README.md
• Add Nikhil Raj as the maintainer in the readme, for reference, you may check this one.

Screenshots

No response

Additional information

No response

Optimize code to reduce latency in filtering the data.

Build enpoints filter Dental colleges by city and state.

What would you like to share?

Notes

• Data of dental colleges is stored in the data folder.
• Build two endpoints, that gives response as filtered data by the cities and states entered by the user.

Additional information

• Set the path as /dental_colleges/city={} and /dental_colleges/state={}.
• User must be able to pass multiple city and state in the URL.

Enpoint to fecth NIRF ranked research institutions.

Notes

• This is the data of research institutions.
• Scrape this data and store it in data folder and the corresponding python file in helpers folder.
• Set the endpoint as /research_institutes