pyOpenSci
[SUBMISSION] OneCite — Universal citation & academic reference toolkit
Submitting Author: (@HzaCode) All current maintainers: (@HzaCode) Package Name: OneCite One-Line Description of Package: Universal citation & academic reference toolkit—multi-source lookup (DOI/PMID/arXiv/ISBN/GitHub/Zenodo/OpenAlex/Crossref/DataCite/Google Books), metadata completion, de-duplication, and multi-style output (BibTeX/APA/MLA); CLI + Python API. Repository Link: https://github.com/HzaCode/OneCite Version submitted: 0.0.12 EiC: TBD Editor: TBD Reviewer 1: TBD Reviewer 2: TBD Archive: TBD JOSS DOI: N/A Version accepted: TBD Date accepted (month/day/year): TBD
Code of Conduct & Commitment to Maintain Package
- [x] I agree to abide by [pyOpenSci's Code of Conduct][PyOpenSciCodeOfConduct] during the review process and in future interactions in spaces supported by pyOpenSci should it be accepted.
- [x] I have read and will commit to package maintenance after the review as per the [pyOpenSci Policies Guidelines][Commitment].
Description
OneCite is a Python library and CLI that parses messy references, queries multiple scholarly databases, completes missing metadata, de-duplicates results, and exports standardized citations in BibTeX/APA/MLA through a templated pipeline (clean → query → validate → format). It supports identifiers and free-text (e.g., DOI, PMID, arXiv, ISBN, GitHub, Zenodo) and includes optional interactive disambiguation.
Scope
Please indicate which category or categories:
- [x] Data retrieval
- [x] Workflow automation
- [x] Citation management and bibliometrics
- [x] Database interoperability
Domain Specific
- [ ] Geospatial
- [x] Education
Community Partnerships
- [ ] Astropy: My package adheres to Astropy community standards
- [ ] Pangeo: My package adheres to the [Pangeo standards listed in the pyOpenSci peer review guidebook][PangeoCollaboration]
For all submissions (brief, 1–2 sentences each):
- Target audience & scientific applications: Researchers, students, librarians, and software authors who need reproducible, standardized references for papers, replication packages, and systematic reviews; OneCite automates multi-source lookup, validation, and formatting.
- Similar packages & how this differs: Existing tools are often source-specific or retrieval-only; OneCite provides a general-purpose, multi-database pipeline with metadata completion, de-duplication, and multi-style outputs via CLI and Python API.
- Pre-submission enquiry: N/A
Technical checks
Confirm each of the following by checking the box. This package:
- [x] does not violate the Terms of Service of any service it interacts with.
- [x] uses an [OSI approved license][OsiApprovedLicense].
- [x] contains a README with instructions for installing the development version.
- [x] includes documentation with examples for all functions.
- [x] contains a tutorial with examples of its essential functions and uses.
- [x] has a test suite.
- [x] has continuous integration setup, such as GitHub Actions CircleCI, and/or others.
Publication Options
- [ ] Do you wish to automatically submit to the [Journal of Open Source Software][JournalOfOpenSourceSoftware]? No.
Are you OK with Reviewers Submitting Issues and/or pull requests to your Repo Directly?
- [x] Yes I am OK with reviewers submitting requested changes as issues to my repo. Reviewers will then link to the issues in their submitted review.
Confirm each of the following by checking the box.
- [x] I have read the [author guide](https://www.pyopensci.org/software-peer-review/how-to/author-guide.html).
- [x] I expect to maintain this package for at least 2 years and can help find a replacement for the maintainer (team) if needed.
