Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ashutoshvarma/ggsipu_result
Python module to parse and dump results data from GGSIPU results pdf including students photo
https://github.com/ashutoshvarma/ggsipu_result
cgpa-calculator ggsipu-results pyxpdf
Last synced: 9 days ago
JSON representation
Python module to parse and dump results data from GGSIPU results pdf including students photo
- Host: GitHub
- URL: https://github.com/ashutoshvarma/ggsipu_result
- Owner: ashutoshvarma
- License: gpl-3.0
- Created: 2019-06-27T22:59:22.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T02:32:25.000Z (11 months ago)
- Last Synced: 2024-03-15T06:46:51.595Z (8 months ago)
- Topics: cgpa-calculator, ggsipu-results, pyxpdf
- Language: Python
- Homepage:
- Size: 5.92 MB
- Stars: 8
- Watchers: 3
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ggsipu_result
[](https://travis-ci.com/github/ashutoshvarma/ggsipu_result/)
[](https://github.com/ashutoshvarma/ggsipu_result/blob/master/LICENSE)
[](https://pypi.org/project/ggsipu-result/)
**ggsipu_result** is a A python module for extraction of results from GGSIPU results pdf. It is capable of:-
- Extraction of Results, Subjects details from pdfs.
- Extract Student's photo from pdfs.
- Dumping the extracted data in JSON format.
## Examples
Given code prints top 5 students of 2018 batch:-
```python
from ggsipu_result import iter_pages, has_page_results, iter_results
FILE="Resources/CSE_Result.pdf"
results = []
for page in iter_pages(FILE):
if has_page_results(page):
results = results + [r for r in iter_results(page) if r.batch == 2018]
results.sort(key=lambda x: x.cgpa, reverse=True)
for i, result in enumerate(results[:5]):
print("{i}. {r}".format(i=i+1, r= result))
## PROBABLE OUTPUT
# 1. Result(Sem 1): [41516403218]GAURAV JAIN(2018) [CGPA: 8.92]
# 2. Result(Sem 1): [41016403218]VARDAAN GROVER(2018) [CGPA: 8.77]
# 3. Result(Sem 1): [40316403218]UJJWAL NEGI(2018) [CGPA: 8.73]
# 4. Result(Sem 1): [40116403218]RIGVED ALANKAR(2018) [CGPA: 8.5]
# 5. Result(Sem 1): [01616403218]CHAITANYA GIRI(2018) [CGPA: 8.46]
```
For more examples please see [`Sample_Code`](https://github.com/ashutoshvarma/ggsipu_result/tree/master/Sample_Code) folder
## Install
```
pip install ggsipu-result
```
## Tests
`ggsipu_result` includes a test suite built on the unittest framework. All tests are located in the "Tests" folder.
Tests can be run from the command line by:
```bash
python -m unittest Tests.tests
```
## Changelog
### v0.3.3 (22-09-2020)
- Fix minor typo in `Results` repr
### v0.3.2 (09-07-2020)
- Major improvement in iter_subjects, now more accurate parsing
### v0.3.1 (08-07-2020)
- fix NoneType error while searching for institution code and name in `iter_results`
- API: remove `subject` attribute from `Marks`
- toJSON: now handle case where \_\_dict\_\_ is not present.
- API: add `toDict()` helper method to convert into python dict.
### v0.3 (08-07-2020) [Breaking Changes]
- API: remove unused `Student` class
- API: merge `Student` properties into `Result`.
### v0.2 (04-07-2020)
- add support for extraction of student's photo from pdfs
- API: new function `parse_result_pdf` to parse entire pdf in one go.
### v0.1.1 (05-06-2020)
- fix [#1](https://github.com/ashutoshvarma/ggsipu_result/issues/1): include support for 6 digit paper codes
### v0.1 (initial release)
## License
All files under the repo are licensed under GNU [GPLv3](https://github.com/ashutoshvarma/ggsipu_result/blob/master/LICENSE)