easybib 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

easybib/cli.py

@@ -17,9 +17,9 @@ def main():
     parser = argparse.ArgumentParser(
         description="Extract citations and download BibTeX from NASA/ADS"
     )
-    parser.add_argument("directory", help="Directory containing LaTeX files")
+    parser.add_argument("path", help="LaTeX file or directory containing LaTeX files")
     parser.add_argument(
-        "-o", "--output", default="references.bib", help="Output BibTeX file"
+        "-o", "--output", default="references.bib", help="Output BibTeX file (existing entries are retained)"
     )
     parser.add_argument(
         "-a",
@@ -46,13 +46,21 @@ def main():
         default="ads",
         help="Preferred BibTeX source: 'ads' (default), 'inspire', or 'auto' (based on key format)",
     )
+    parser.add_argument(
+        "--ads-api-key",
+        help="ADS API key (overrides ADS_API_KEY environment variable)",
+    )
     args = parser.parse_args()
 
     # Collect all citation keys
-    tex_dir = Path(args.directory)
+    input_path = Path(args.path)
     all_keys = set()
     all_warnings = []
-    for tex_file in tex_dir.glob("**/*.tex"):
+    if input_path.is_file():
+        tex_files = [input_path]
+    else:
+        tex_files = input_path.glob("**/*.tex")
+    for tex_file in tex_files:
         keys, warnings = extract_cite_keys(tex_file)
         all_keys.update(keys)
         all_warnings.extend(warnings)
@@ -73,7 +81,7 @@ def main():
         return 0
 
     # Check for ADS API key (not required if using --source inspire)
-    api_key = os.getenv("ADS_API_KEY")
+    api_key = args.ads_api_key or os.getenv("ADS_API_KEY")
     if not api_key and args.source != "inspire":
         print("Error: ADS_API_KEY environment variable not set")
         print("Get your API key from: https://ui.adsabs.harvard.edu/user/settings/token")

{easybib-0.1.0.dist-info → easybib-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easybib
-Version: 0.1.0
+Version: 0.2.0
 Summary: Automatically fetch BibTeX entries from INSPIRE and ADS for LaTeX projects
 Author-email: Gregory Ashton <gregory.ashton@ligo.org>
 License-Expression: MIT
@@ -9,9 +9,15 @@ Project-URL: Repository, https://github.com/GregoryAshton/easybib
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: requests
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
 
 # easybib
 
+[![Tests](https://github.com/GregoryAshton/easybib/actions/workflows/tests.yml/badge.svg)](https://github.com/GregoryAshton/easybib/actions/workflows/tests.yml)
+[![codecov](https://codecov.io/gh/GregoryAshton/easybib/branch/main/graph/badge.svg)](https://codecov.io/gh/GregoryAshton/easybib)
+
 Automatically fetch BibTeX entries from [INSPIRE](https://inspirehep.net/) and [NASA/ADS](https://ui.adsabs.harvard.edu/) for LaTeX projects.
 
 easybib scans your `.tex` files for citation keys, looks them up on INSPIRE and/or ADS, and writes a `.bib` file with the results. It handles INSPIRE texkeys (e.g. `Author:2020abc`) and ADS bibcodes (e.g. `2016PhRvL.116f1102A`).
@@ -26,9 +32,10 @@ pip install easybib
 
 ```bash
 easybib /path/to/latex/project
+easybib paper.tex
 ```
 
-This will scan all `.tex` files in the directory, fetch BibTeX entries, and write them to `references.bib`.
+Pass a directory to scan all `.tex` files recursively, or a single `.tex` file. BibTeX entries are fetched and written to `references.bib`.
 
 ### Options
 
@@ -39,13 +46,17 @@ This will scan all `.tex` files in the directory, fetch BibTeX entries, and writ
 | `-a`, `--max-authors` | Truncate author lists (default: 3, use 0 for no limit) |
 | `-l`, `--list-keys` | List found citation keys and exit (no fetching) |
 | `--fresh` | Ignore existing output file and start from scratch |
+| `--ads-api-key` | ADS API key (overrides `ADS_API_KEY` environment variable) |
 
 ### Examples
 
 ```bash
-# Fetch from INSPIRE (no API key needed)
+# Scan a directory
 easybib ./paper -s inspire
 
+# Scan a single file
+easybib paper.tex
+
 # Use a custom output file
 easybib ./paper -o paper.bib
 
@@ -58,13 +69,19 @@ easybib ./paper -a 0
 
 ### ADS API key
 
-When using ADS as the source (the default), set your API key:
+When using ADS as the source (the default), provide your API key either via the command line:
+
+```bash
+easybib ./paper --ads-api-key your-key-here
+```
+
+Or as an environment variable:
 
 ```bash
 export ADS_API_KEY="your-key-here"
 ```
 
-Get one from https://ui.adsabs.harvard.edu/user/settings/token.
+Get a key from https://ui.adsabs.harvard.edu/user/settings/token.
 
 ## How it works
 

easybib-0.2.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+easybib/__init__.py,sha256=zCCoB5obi_21h_a_5LK-Zr4G3VkO6XF6Yft5J8pqruU,721
+easybib/__main__.py,sha256=91xpHXOEBRWH-6SL2xquZoAsyDHasxiEPpCK62izpnU,90
+easybib/cli.py,sha256=IBfiZaBgw_-ZqFiY_XzAeODipRdP6XnQJKyFkFRYFXo,4530
+easybib/core.py,sha256=OvXeVF_jV3FZlrdtcztxlbU4tCnN0Voei3luJPe3V_8,10066
+easybib-0.2.0.dist-info/METADATA,sha256=w9_tKSHjtc47nOBgNsDC8PK-6w1XURiHzGRh_Tm6uTY,2982
+easybib-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+easybib-0.2.0.dist-info/entry_points.txt,sha256=IHBiLzF5bW19fQOGvK3e1LKnGcYIL81icdGsvrvZ_Zs,45
+easybib-0.2.0.dist-info/top_level.txt,sha256=Xi0IA9fNmv68UPp2bZCEEIXiQYQy0NweD0J9iqZ-LdQ,8
+easybib-0.2.0.dist-info/RECORD,,

easybib-0.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-easybib/__init__.py,sha256=zCCoB5obi_21h_a_5LK-Zr4G3VkO6XF6Yft5J8pqruU,721
-easybib/__main__.py,sha256=91xpHXOEBRWH-6SL2xquZoAsyDHasxiEPpCK62izpnU,90
-easybib/cli.py,sha256=nU6DC9IEyycbcjNd7hB7G4OBz4V7R12ETlQTlpdrBng,4237
-easybib/core.py,sha256=OvXeVF_jV3FZlrdtcztxlbU4tCnN0Voei3luJPe3V_8,10066
-easybib-0.1.0.dist-info/METADATA,sha256=Ia24a6a3E73u7LxTndNW9TIIkB3QxkGgIAMwbcbpdBc,2314
-easybib-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-easybib-0.1.0.dist-info/entry_points.txt,sha256=IHBiLzF5bW19fQOGvK3e1LKnGcYIL81icdGsvrvZ_Zs,45
-easybib-0.1.0.dist-info/top_level.txt,sha256=Xi0IA9fNmv68UPp2bZCEEIXiQYQy0NweD0J9iqZ-LdQ,8
-easybib-0.1.0.dist-info/RECORD,,