# URL to BibTeX Converter (url2bib)
`url2bib` is a commandline tool for converting URLs of papers into into BibTeX citations. It tries to use the publication information rather than the arXiv url.
## Installation
```bash
pip install url2bib
```
## Using as a Commandline Tool
```bash
url2bib https://arxiv.org/abs/2006.11477
```
## Using as a Library
You can also use `url2bib` as a Python library with several key functions:
```python
from url2bib import url2bibtex, doi2bibtex, isbn2bibtex, parse_bibtex
# Convert a URL to BibTeX
bibtex: str = url2bibtex('https://arxiv.org/abs/2006.11477')
# Convert a DOI to BibTeX
bibtex: str = doi2bibtex('10.1145/3447548.3467160')
# Convert an ISBN to BibTeX
bibtex: str = isbn2bibtex('9780123456789')
# Parse a BibTeX string into a dictionary
bib_dict: dict = parse_bibtex(bibtex)
```
### Additional Library Features
- `set_verbosity(True)`: Enable verbose logging
- `get_dblp_bibtexs(paper_title)`: Search for publications on DBLP
## Features
- Extracts DOIs from URLs and retrieves BibTeX citations for those DOIs.
- Searches for publications of the paper.
- Generates a BibTeX entry with a unified ID in the format `{firstAuthorSurname}_{year}_{titleFirstWord}`.
## Contributing
Contributions to this project are welcome. If you have any suggestions or want to report issues, please open an issue or submit a pull request.
## License
This project is under the [GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0) license.
## Acknowledgments
This script uses the `bibtexparser` library for parsing and generating BibTeX entries.
It also relies on external data sources such as doi.org and dblp.org to fetch BibTeX entries.
## Disclaimer
This script is provided as-is, and the accuracy of the generated BibTeX entries depends on the availability and quality of external data sources. Always double-check and edit citations as needed for your research papers and publications.
Happy citing with `url2bib`!
Raw data
{
"_id": null,
"home_page": "https://github.com/notpaulmartin/url2bib",
"name": "url2bib",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "bibtex, science, scientific-journals, crossref, doi, isbn",
"author": "Paul Martin",
"author_email": "p@ulmartin.com",
"download_url": "https://files.pythonhosted.org/packages/e0/98/f7b80ea8afcf096accc917e313da65979ff985551e0b29e7c612c1b9f6a5/url2bib-0.3.2.tar.gz",
"platform": null,
"description": "# URL to BibTeX Converter (url2bib)\n\n`url2bib` is a commandline tool for converting URLs of papers into into BibTeX citations. It tries to use the publication information rather than the arXiv url.\n\n\n\n## Installation\n```bash\npip install url2bib\n```\n\n## Using as a Commandline Tool\n```bash\nurl2bib https://arxiv.org/abs/2006.11477\n```\n\n## Using as a Library\nYou can also use `url2bib` as a Python library with several key functions:\n\n```python\nfrom url2bib import url2bibtex, doi2bibtex, isbn2bibtex, parse_bibtex\n\n# Convert a URL to BibTeX\nbibtex: str = url2bibtex('https://arxiv.org/abs/2006.11477')\n\n# Convert a DOI to BibTeX\nbibtex: str = doi2bibtex('10.1145/3447548.3467160')\n\n# Convert an ISBN to BibTeX\nbibtex: str = isbn2bibtex('9780123456789')\n\n# Parse a BibTeX string into a dictionary\nbib_dict: dict = parse_bibtex(bibtex)\n```\n\n### Additional Library Features\n- `set_verbosity(True)`: Enable verbose logging\n- `get_dblp_bibtexs(paper_title)`: Search for publications on DBLP\n\n## Features\n- Extracts DOIs from URLs and retrieves BibTeX citations for those DOIs.\n- Searches for publications of the paper.\n- Generates a BibTeX entry with a unified ID in the format `{firstAuthorSurname}_{year}_{titleFirstWord}`.\n\n## Contributing\nContributions to this project are welcome. If you have any suggestions or want to report issues, please open an issue or submit a pull request.\n\n## License\nThis project is under the [GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0) license.\n\n## Acknowledgments\nThis script uses the `bibtexparser` library for parsing and generating BibTeX entries.\nIt also relies on external data sources such as doi.org and dblp.org to fetch BibTeX entries.\n\n## Disclaimer\nThis script is provided as-is, and the accuracy of the generated BibTeX entries depends on the availability and quality of external data sources. Always double-check and edit citations as needed for your research papers and publications.\n\nHappy citing with `url2bib`!\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 (GPLv3)",
"summary": "Convert URLs to BibTeX entries, with support for DOI and ISBN extraction",
"version": "0.3.2",
"project_urls": {
"Homepage": "https://github.com/notpaulmartin/url2bib"
},
"split_keywords": [
"bibtex",
" science",
" scientific-journals",
" crossref",
" doi",
" isbn"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "53686d25113a7de479baed021fbd914caa07547f6da692b709329a31ed40592a",
"md5": "09cbd5a89ed3a44ff5b31cb17388a5a4",
"sha256": "719c351ea0a1e55622cd11dd6c98dbd77da4e64c8dfd72608b3ff32893288e2f"
},
"downloads": -1,
"filename": "url2bib-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "09cbd5a89ed3a44ff5b31cb17388a5a4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 18898,
"upload_time": "2025-01-07T17:23:57",
"upload_time_iso_8601": "2025-01-07T17:23:57.889384Z",
"url": "https://files.pythonhosted.org/packages/53/68/6d25113a7de479baed021fbd914caa07547f6da692b709329a31ed40592a/url2bib-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e098f7b80ea8afcf096accc917e313da65979ff985551e0b29e7c612c1b9f6a5",
"md5": "86f6c7086390a4d61e258f78bde0812f",
"sha256": "395d4666e3fec93f66dc21d4122b7535fdc1d075f6f91d27c62429b099e57e20"
},
"downloads": -1,
"filename": "url2bib-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "86f6c7086390a4d61e258f78bde0812f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 17980,
"upload_time": "2025-01-07T17:24:01",
"upload_time_iso_8601": "2025-01-07T17:24:01.666002Z",
"url": "https://files.pythonhosted.org/packages/e0/98/f7b80ea8afcf096accc917e313da65979ff985551e0b29e7c612c1b9f6a5/url2bib-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-07 17:24:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "notpaulmartin",
"github_project": "url2bib",
"github_not_found": true,
"lcname": "url2bib"
}
JSON
