# pydparser
```
A simple resume and job description parser used for extracting information from resumes and job descriptions.
It also allows you to compare a set of resumes with a job description.
```
Built with ❤️ by [Justice Arthur](https://github.com/justicea83) and inspired by [Omkar Pathak](https://github.com/OmkarPathak/pydparser)
# Features
- Extract name from resumes
- Extract email from resumes
- Extract mobile numbers from resumes
- Extract skills from resumes
- Extract total experience from resumes
- Extract college name from resumes
- Extract degree from resumes
- Extract designation from resumes
- Extract company names from resumes
- Extract skills from job descriptions
- Extract experience level from job descriptions
- Match resumes with job descriptions and see ranking for scores
# Installation
- You can install this package using
```bash
pip install pydparser
```
- For NLP operations we use spacy and nltk. Install them using below commands:
```bash
# spaCy
python -m spacy download en_core_web_sm
# nltk
python -m nltk.downloader words
python -m nltk.downloader stopwords
```
# Supported File Formats
- PDF and DOCx files are supported on all Operating Systems
- If you want to extract DOC files you can install [textract](https://textract.readthedocs.io/en/stable/installation.html) for your OS (Linux, MacOS)
- Note: You just have to install textract (and nothing else) and doc files will get parsed easily
# Usage
- Import it in your Python project
```python
from pydparser import ResumeParser
data = ResumeParser('/path/to/resume/file').get_extracted_data()
```
```python
from pydparser import JdParser
data = JdParser('/path/to/jd/file').get_extracted_data()
```
```python
from pydparser import MatchingEngine
matcher = MatchingEngine(
'/path/to/jd/file',
[
'/path/to/resume1/file',
'/path/to/resume2/file',
'/path/to/resume3/file',
]
)
# simple matcher
res = matcher.simple_intersection_score()
# similarity score with tfidf vectorizer
res = matcher.cosine_similarity_with_tfidf()
# similarity score with jaccard similarity
res = matcher.jaccard_similarity_score()
```
# CLI
For running the resume extractor you can also use the `cli` provided
```bash
usage: pydparser [-h] [-f FILE] [-d DIRECTORY] [-r REMOTEFILE]
[-re CUSTOM_REGEX] [-sf SKILLSFILE] [-e EXPORT_FORMAT]
optional arguments:
-h, --help show this help message and exit
-f FILE, --file FILE resume file to be extracted
-d DIRECTORY, --directory DIRECTORY
directory containing all the resumes to be extracted
-r REMOTEFILE, --remotefile REMOTEFILE
remote path for resume file to be extracted
-re CUSTOM_REGEX, --custom-regex CUSTOM_REGEX
custom regex for parsing mobile numbers
-sf SKILLSFILE, --skillsfile SKILLSFILE
custom skills CSV file against which skills are
searched for
-e EXPORT_FORMAT, --export-format EXPORT_FORMAT
the information export format (json)
```
# Notes:
- If you are running the app on windows, then you can only extract .docs and .pdf files
# Result
The module would return a list of dictionary objects with result as follows:
```
[
{
'college_name': ['Marathwada Mitra Mandal’s College of Engineering'],
'company_names': None,
'degree': ['B.E. IN COMPUTER ENGINEERING'],
'designation': ['Manager',
'TECHNICAL CONTENT WRITER',
'DATA ENGINEER'],
'email': 'omkarpathak27@gmail.com',
'mobile_number': '8087996634',
'name': 'Omkar Pathak',
'no_of_pages': 3,
'skills': ['Operating systems',
'Linux',
'Github',
'Testing',
'Content',
'Automation',
'Python',
'Css',
'Website',
'Django',
'Opencv',
'Programming',
'C',
...],
'total_experience': 1.83
}
]
```
```
[{'all_skills': [
'building a connected and superior experience for patients',
'PHP',
'Laravel',
'Object - Oriented Programming',
'to mentor and coach',
'contributing to the implementation of',
'mobile experience',
'healthcare platform',
'features',
'contribute to architectural decisions',
'on product excellence',
'building robust',
'PHP',
'Laravel',
'humility',
'celebrating bold thinking',
'HSA',
],
'domain': ['health', 'Public Sector', 'health service', 'mental health'],
'experience': '5 years',
'occupation': 'Senior Software Engineer',
'skills': ['Mobile',
'Budget',
'Technical',
'Distribution',
'Expenses',
'Automation',
'Api',
'Design',
'Health',
'Architectures',
'System',
'Access',
'Communication',
'Programming',
'Php',
'Healthcare',
'Testing',
'Ansible',
'Phpunit']}]
```
# References that helped me get here
- Some of the core concepts behind the algorithm have been taken from [https://github.com/divapriya/Language_Processing](https://github.com/divapriya/Language_Processing) which has been summed up in this blog [https://medium.com/@divalicious.priya/information-extraction-from-cv-acec216c3f48](https://medium.com/@divalicious.priya/information-extraction-from-cv-acec216c3f48). Thanks to Priya for sharing this concept
- [https://www.kaggle.com/nirant/hitchhiker-s-guide-to-nlp-in-spacy](https://www.kaggle.com/nirant/hitchhiker-s-guide-to-nlp-in-spacy)
- [https://www.analyticsvidhya.com/blog/2017/04/natural-language-processing-made-easy-using-spacy-%E2%80%8Bin-python/](https://www.analyticsvidhya.com/blog/2017/04/natural-language-processing-made-easy-using-spacy-%E2%80%8Bin-python/)
- **Special thanks** to dataturks for their [annotated dataset](https://dataturks.com/blog/named-entity-recognition-in-resumes.php)
- **Special thanks** to jjzha for their [tagged dataset](https://huggingface.co/datasets/jjzha/green) which was a research by
```
@inproceedings{green-etal-2022-development,
title = "Development of a Benchmark Corpus to Support Entity Recognition in Job Descriptions",
author = "Green, Thomas and
Maynard, Diana and
Lin, Chenghua",
booktitle = "Proceedings of the Thirteenth Language Resources and Evaluation Conference",
month = jun,
year = "2022",
address = "Marseille, France",
publisher = "European Language Resources Association",
url = "https://aclanthology.org/2022.lrec-1.128",
pages = "1201--1208",
}
```
# Donation
If you find this useful you don't hesitate to leave a start a something small. This encourage us to spend the Christmas creating this 😄.
| PayPal | <a href="https://paypal.me/justicearthur" target="_blank"><img src="https://www.paypalobjects.com/webstatic/mktg/logo/AM_mc_vs_dc_ae.jpg" alt="Donate via PayPal!" title="Donate via PayPal!" /></a> |
|:-------------------------------------------:|:-------------------------------------------------------------:|
Raw data
{
"_id": null,
"home_page": "https://github.com/justicea83/pydparser",
"name": "pydparser",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "python,resume,jd,job description,parser",
"author": "justicea83",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/8b/db/5a30fc338ed6d1cb9a95d9c7b22514f1f183f69795328782d14f5101b4a0/pydparser-1.0.4.tar.gz",
"platform": null,
"description": "\n# pydparser\n\n```\nA simple resume and job description parser used for extracting information from resumes and job descriptions.\nIt also allows you to compare a set of resumes with a job description. \n```\n\nBuilt with \u2764\ufe0f by [Justice Arthur](https://github.com/justicea83) and inspired by [Omkar Pathak](https://github.com/OmkarPathak/pydparser)\n\n\n# Features\n\n- Extract name from resumes\n- Extract email from resumes\n- Extract mobile numbers from resumes\n- Extract skills from resumes\n- Extract total experience from resumes\n- Extract college name from resumes\n- Extract degree from resumes\n- Extract designation from resumes\n- Extract company names from resumes\n- Extract skills from job descriptions\n- Extract experience level from job descriptions\n- Match resumes with job descriptions and see ranking for scores\n\n# Installation\n\n- You can install this package using\n\n```bash\npip install pydparser\n```\n\n- For NLP operations we use spacy and nltk. Install them using below commands:\n\n```bash\n# spaCy\npython -m spacy download en_core_web_sm\n\n# nltk\npython -m nltk.downloader words\npython -m nltk.downloader stopwords\n```\n\n\n# Supported File Formats\n\n- PDF and DOCx files are supported on all Operating Systems\n- If you want to extract DOC files you can install [textract](https://textract.readthedocs.io/en/stable/installation.html) for your OS (Linux, MacOS)\n- Note: You just have to install textract (and nothing else) and doc files will get parsed easily\n\n# Usage\n\n- Import it in your Python project\n\n```python\nfrom pydparser import ResumeParser\ndata = ResumeParser('/path/to/resume/file').get_extracted_data()\n```\n\n```python\nfrom pydparser import JdParser\ndata = JdParser('/path/to/jd/file').get_extracted_data()\n```\n\n```python\nfrom pydparser import MatchingEngine\nmatcher = MatchingEngine(\n '/path/to/jd/file',\n [\n '/path/to/resume1/file',\n '/path/to/resume2/file',\n '/path/to/resume3/file',\n ]\n)\n\n# simple matcher\nres = matcher.simple_intersection_score()\n\n# similarity score with tfidf vectorizer\nres = matcher.cosine_similarity_with_tfidf()\n\n# similarity score with jaccard similarity\nres = matcher.jaccard_similarity_score()\n```\n\n# CLI\n\nFor running the resume extractor you can also use the `cli` provided\n\n```bash\nusage: pydparser [-h] [-f FILE] [-d DIRECTORY] [-r REMOTEFILE]\n [-re CUSTOM_REGEX] [-sf SKILLSFILE] [-e EXPORT_FORMAT]\n\noptional arguments:\n -h, --help show this help message and exit\n -f FILE, --file FILE resume file to be extracted\n -d DIRECTORY, --directory DIRECTORY\n directory containing all the resumes to be extracted\n -r REMOTEFILE, --remotefile REMOTEFILE\n remote path for resume file to be extracted\n -re CUSTOM_REGEX, --custom-regex CUSTOM_REGEX\n custom regex for parsing mobile numbers\n -sf SKILLSFILE, --skillsfile SKILLSFILE\n custom skills CSV file against which skills are\n searched for\n -e EXPORT_FORMAT, --export-format EXPORT_FORMAT\n the information export format (json)\n```\n\n# Notes:\n\n- If you are running the app on windows, then you can only extract .docs and .pdf files\n\n# Result\n\nThe module would return a list of dictionary objects with result as follows:\n\n```\n[\n {\n 'college_name': ['Marathwada Mitra Mandal\u2019s College of Engineering'],\n 'company_names': None,\n 'degree': ['B.E. IN COMPUTER ENGINEERING'],\n 'designation': ['Manager',\n 'TECHNICAL CONTENT WRITER',\n 'DATA ENGINEER'],\n 'email': 'omkarpathak27@gmail.com',\n 'mobile_number': '8087996634',\n 'name': 'Omkar Pathak',\n 'no_of_pages': 3,\n 'skills': ['Operating systems',\n 'Linux',\n 'Github',\n 'Testing',\n 'Content',\n 'Automation',\n 'Python',\n 'Css',\n 'Website',\n 'Django',\n 'Opencv',\n 'Programming',\n 'C',\n ...],\n 'total_experience': 1.83\n }\n]\n```\n\n\n```\n[{'all_skills': [\n 'building a connected and superior experience for patients',\n 'PHP',\n 'Laravel',\n 'Object - Oriented Programming',\n 'to mentor and coach',\n 'contributing to the implementation of',\n 'mobile experience',\n 'healthcare platform',\n 'features',\n 'contribute to architectural decisions',\n 'on product excellence',\n 'building robust',\n 'PHP',\n 'Laravel',\n 'humility',\n 'celebrating bold thinking',\n 'HSA',\n ],\n 'domain': ['health', 'Public Sector', 'health service', 'mental health'],\n 'experience': '5 years',\n 'occupation': 'Senior Software Engineer',\n 'skills': ['Mobile',\n 'Budget',\n 'Technical',\n 'Distribution',\n 'Expenses',\n 'Automation',\n 'Api',\n 'Design',\n 'Health',\n 'Architectures',\n 'System',\n 'Access',\n 'Communication',\n 'Programming',\n 'Php',\n 'Healthcare',\n 'Testing',\n 'Ansible',\n 'Phpunit']}]\n```\n\n# References that helped me get here\n\n- Some of the core concepts behind the algorithm have been taken from [https://github.com/divapriya/Language_Processing](https://github.com/divapriya/Language_Processing) which has been summed up in this blog [https://medium.com/@divalicious.priya/information-extraction-from-cv-acec216c3f48](https://medium.com/@divalicious.priya/information-extraction-from-cv-acec216c3f48). Thanks to Priya for sharing this concept\n\n- [https://www.kaggle.com/nirant/hitchhiker-s-guide-to-nlp-in-spacy](https://www.kaggle.com/nirant/hitchhiker-s-guide-to-nlp-in-spacy)\n\n- [https://www.analyticsvidhya.com/blog/2017/04/natural-language-processing-made-easy-using-spacy-%E2%80%8Bin-python/](https://www.analyticsvidhya.com/blog/2017/04/natural-language-processing-made-easy-using-spacy-%E2%80%8Bin-python/)\n\n- **Special thanks** to dataturks for their [annotated dataset](https://dataturks.com/blog/named-entity-recognition-in-resumes.php)\n- **Special thanks** to jjzha for their [tagged dataset](https://huggingface.co/datasets/jjzha/green) which was a research by\n\n```\n@inproceedings{green-etal-2022-development,\n title = \"Development of a Benchmark Corpus to Support Entity Recognition in Job Descriptions\",\n author = \"Green, Thomas and\n Maynard, Diana and\n Lin, Chenghua\",\n booktitle = \"Proceedings of the Thirteenth Language Resources and Evaluation Conference\",\n month = jun,\n year = \"2022\",\n address = \"Marseille, France\",\n publisher = \"European Language Resources Association\",\n url = \"https://aclanthology.org/2022.lrec-1.128\",\n pages = \"1201--1208\",\n}\n\n```\n\n# Donation\n\nIf you find this useful you don't hesitate to leave a start a something small. This encourage us to spend the Christmas creating this \ud83d\ude04.\n\n| PayPal | <a href=\"https://paypal.me/justicearthur\" target=\"_blank\"><img src=\"https://www.paypalobjects.com/webstatic/mktg/logo/AM_mc_vs_dc_ae.jpg\" alt=\"Donate via PayPal!\" title=\"Donate via PayPal!\" /></a> |\n|:-------------------------------------------:|:-------------------------------------------------------------:|\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple resume and job description parser used for extracting information from resumes and job descriptions and compatible with python 3.10 upwords",
"version": "1.0.4",
"project_urls": {
"Homepage": "https://github.com/justicea83/pydparser"
},
"split_keywords": [
"python",
"resume",
"jd",
"job description",
"parser"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "58c2616fd32fed98c49d3fa5afe2b7967575db10c2781fbf19565b9985f0c0ad",
"md5": "ffef1708ba5129ccf32585dd142ad8e5",
"sha256": "0e8e732500b4c0a46e7b48210b689fa6198ee1e2eadf43cfecf5b21d9332b8e2"
},
"downloads": -1,
"filename": "pydparser-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ffef1708ba5129ccf32585dd142ad8e5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 19216342,
"upload_time": "2023-12-27T04:39:28",
"upload_time_iso_8601": "2023-12-27T04:39:28.270138Z",
"url": "https://files.pythonhosted.org/packages/58/c2/616fd32fed98c49d3fa5afe2b7967575db10c2781fbf19565b9985f0c0ad/pydparser-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8bdb5a30fc338ed6d1cb9a95d9c7b22514f1f183f69795328782d14f5101b4a0",
"md5": "036aef9b4241c320a76472610bded426",
"sha256": "e0b24031726b69d4f61e7c8e666511869de0149f4288e80ce822049dc2ab384a"
},
"downloads": -1,
"filename": "pydparser-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "036aef9b4241c320a76472610bded426",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 19215081,
"upload_time": "2023-12-27T04:39:47",
"upload_time_iso_8601": "2023-12-27T04:39:47.041617Z",
"url": "https://files.pythonhosted.org/packages/8b/db/5a30fc338ed6d1cb9a95d9c7b22514f1f183f69795328782d14f5101b4a0/pydparser-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-27 04:39:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "justicea83",
"github_project": "pydparser",
"github_not_found": true,
"lcname": "pydparser"
}
JSON
