biblioaudit 2.2.0__py3-none-any.whl

biblioaudit-2.2.0.dist-info/METADATA

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: biblioaudit
+Version: 2.2.0
+Summary: Automated reference integrity and citation verification tool
+Author-email: Satyam Tiwari <satyam.tiwari@doctoral.uj.edu.pl>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Official-Satyam-Tiwari/Reference-Architect
+Project-URL: Bug Tracker, https://github.com/Official-Satyam-Tiwari/Reference-Architect/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bibtexparser
+Requires-Dist: aiohttp
+Requires-Dist: pandas
+Requires-Dist: xmltodict
+Requires-Dist: doi2bib
+Dynamic: license-file
+
+# BiblioAudit
+
+[![DOI](https://zenodo.org/badge/1128307082.svg)](https://doi.org/10.5281/zenodo.18155557)
+[![CI](https://github.com/Official-Satyam-Tiwari/Reference-Architect/actions/workflows/ci.yml/badge.svg)](https://github.com/Official-Satyam-Tiwari/Reference-Architect/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+
+BiblioAudit is a command-line tool that checks and verifies citations in BibTeX (`.bib`) files. It cross-checks references across more than 12 academic databases in parallel to confirm that entries exist, identify missing or broken DOIs, correct publication years and journal names, and locate legal open-access PDFs.
+
+It also includes an automated re-check loop (`--loop`) that repairs metadata, generates a corrected BibTeX library via `doi2bib`, and verifies that all corrections pass validation.
+
+---
+
+## Example Output
+
+```text
+========================================================================
+  BiblioAudit v2.2.0 - Reference Integrity & Verification System
+========================================================================
+  Cascading Triangulation Matrix: 12 Academic Databases
+
+[*] Reading bibliography: References/sn-bibliography.bib
+[*] Found 42 entries. Starting AUDIT...
+[*] Processing 42 references (Concurrency limit: 6)...
+
+  [VERIFIED]  (100%) Moskal2014          -> Crossref (DOI)
+  [VERIFIED]  (100%) Tiwari2025          -> Crossref (DOI)
+  [VERIFIED]  (100%) Spencer2021         -> Crossref (Search)
+  [VERIFIED]  (100%) Tiwari_BiblioAudit  -> DataCite (DOI)
+  [ATTENTION] ( 75%) Liu2021             -> Crossref (Search)
+        └─ Year: BibTeX='2021' vs Record='2025'
+  [NOT FOUND] (  0%) NEMA2018            -> Missing in all queried databases
+
+============================================================
+                      AUDIT SUMMARY
+============================================================
+  Total References Audited : 42
+  Verified Clean (>90%)    :   35  ( 83.3%)
+  Needs Attention          :    4  (  9.5%)
+  Not Found                :    3  (  7.1%)
+  Total Time Elapsed       : 12.59s
+============================================================
+[+] Audit CSV report saved to: References/sn-bibliography_report.csv
+[+] Corrected BibTeX library saved to: References/sn-bibliography_fixed.bib
+```
+
+---
+
+## Supported Academic Databases
+
+BiblioAudit queries the following scientific databases in parallel:
+
+| Database | Coverage and Specialization | Query Method |
+|---|---|---|
+| **Crossref** | Primary registry for journal articles, conference proceedings, and books | DOI, Title, Author |
+| **DataCite** | Research datasets, software records, and Zenodo deposits | DOI, Title, Keyword |
+| **OpenAlex** | Global index covering 250M+ scientific publications | DOI, Title, Author |
+| **Semantic Scholar** | Multidisciplinary literature and computer science graph | DOI, Title, Author |
+| **arXiv** | Preprints in physics, mathematics, and computer science | Title, Author |
+| **PubMed** | Biomedical and clinical literature (NLM/NIH) | E-utilities Search |
+| **Europe PMC** | Medical physics, clinical research, and European open access | REST Search, DOI |
+| **DOAJ** | Peer-reviewed open access journals worldwide | Title Search |
+| **HAL Open Science** | European multidisciplinary open archive (CNRS, INRIA, CEA) | Field Search |
+| **Zenodo** | Open research code, software citations, and data archives | REST Records API |
+| **INSPIRE HEP** | High-energy physics, astrophysics, and quantum field theory | Literature Search |
+| **NASA ADS** | Astrophysics, astronomy, and planetary physics literature | Search API (optional token) |
+| **Unpaywall** | Legal open-access PDF discovery | DOI lookup |
+| **OpenCitations** | Citation metrics and citation network counts | COCI DOI index |
+
+---
+
+## Installation
+
+### From Source
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/Official-Satyam-Tiwari/Reference-Architect.git
+   cd Reference-Architect
+   ```
+
+2. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+### Optional Package Install
+
+To make the `biblioaudit` command directly available from anywhere in your terminal:
+```bash
+pip install -e .
+```
+
+---
+
+## Usage
+
+Run the tool from your terminal:
+
+```bash
+python biblioaudit.py [path-to-bib-file-or-folder] [options]
+```
+
+If you do not specify a path, BiblioAudit automatically checks files in the `References/` directory.
+
+### Options
+
+| Option | Description | Default |
+|---|---|---|
+| `-o`, `--output` | File path for the CSV report | `<filename>_audit_report.csv` |
+| `--fix-bib` | File path to export corrected BibTeX entries | None |
+| `--loop` | Run automated feedback loop: re-audits the corrected file and reports convergence metrics | `False` |
+| `-r`, `--rate` | Maximum number of concurrent requests | `4` |
+| `-v`, `--verbose` | Print field-by-field differences for mismatched citations | `False` |
+| `--version` | Show program version | |
+| `-h`, `--help` | Show command-line help message | |
+
+---
+
+## Examples
+
+### 1. Basic Check
+
+Check a bibliography file and print progress to the console:
+```bash
+python biblioaudit.py References/sn-bibliography.bib
+```
+
+### 2. Automated Re-Check Loop
+
+Audits the original file, repairs citations via `doi2bib`, immediately re-checks the repaired file, and prints a before-and-after convergence report:
+```bash
+python biblioaudit.py References/sn-bibliography.bib --loop
+```
+
+### 3. Generate Reports and Corrected BibTeX
+
+Save a detailed CSV report and write official publisher BibTeX records:
+```bash
+python biblioaudit.py References/sn-bibliography.bib -o report.csv --fix-bib fixed.bib
+```
+
+### 4. Fast Processing with Detailed Field Differences
+
+Increase the request rate and print field-by-field differences for mismatched citations:
+```bash
+python biblioaudit.py References/sn-bibliography.bib --rate 6 --verbose
+```
+
+---
+
+## Project Structure
+
+```text
+Reference-Architect/
+├── References/              # Directory for your .bib files (ignored by git)
+│   └── sn-bibliography.bib
+├── biblioaudit.py           # Main runner, engines, and verification logic
+├── utility.py               # Text similarity, BibTeX parsing, and CSV exports
+├── requirements.txt         # Package dependencies
+├── pyproject.toml           # Packaging metadata
+├── CITATION.cff             # Citation metadata for GitHub
+├── LICENSE                  # MIT License
+└── README.md                # Documentation
+```
+
+---
+
+## Citation
+
+If you use BiblioAudit in your research, please cite:
+
+> Tiwari, S. (2025). BiblioAudit: Automated Citation Integrity & Verification Tool (Version 2.2.0) [Software]. Zenodo. https://doi.org/10.5281/zenodo.18155557
+
+```bibtex
+@software{Tiwari_BiblioAudit_2025,
+  author = {Tiwari, Satyam},
+  title = {{BiblioAudit: Automated Citation Integrity & Verification Tool}},
+  version = {2.2.0},
+  year = {2025},
+  publisher = {Zenodo},
+  doi = {10.5281/zenodo.18155557},
+  url = {https://doi.org/10.5281/zenodo.18155557}
+}
+```
+
+---
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

biblioaudit-2.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+biblioaudit.py,sha256=K_ZiMlfsCkFa0xbyiE7VROAQGkX-sku_lqvvJs-dMbc,56757
+utility.py,sha256=gNpmlKd6jmeKmYbBSCE-akw9YBh6BomeDduBCpjcLuQ,12906
+biblioaudit-2.2.0.dist-info/licenses/LICENSE,sha256=TqvJtqe0wiUT34lhhmZdDIW7YyL8_Wg2lA5c7wWgMmo,1075
+biblioaudit-2.2.0.dist-info/METADATA,sha256=YiU4367BK9dXt5s7aG-sxhHlwVw_CFGtqEtaDEL_uUw,8333
+biblioaudit-2.2.0.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
+biblioaudit-2.2.0.dist-info/entry_points.txt,sha256=ABGy8wt2jnxBw4P1_Hvzit788CqVGO4qdJfEjhGvYB0,49
+biblioaudit-2.2.0.dist-info/top_level.txt,sha256=P-o08gV3TXcWrAbYDAJXryFaR6iAF_J-1qjUHHsKNVY,20
+biblioaudit-2.2.0.dist-info/RECORD,,

biblioaudit-2.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

biblioaudit-2.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+biblioaudit = biblioaudit:main

biblioaudit-2.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Satyam Tiwari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

biblioaudit-2.2.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+biblioaudit
+utility