nber-cli 0.1.3__tar.gz → 0.1.4__tar.gz

{nber_cli-0.1.3 → nber_cli-0.1.4}/.gitignore

@@ -6,6 +6,8 @@ dist/
 wheels/
 *.egg-info
 
+release/
+
 # Virtual environments
 .venv
 
@@ -17,3 +19,6 @@ wheels/
 
 # OS X
 *.DS_Store
+
+# local files
+*.local.*

nber_cli-0.1.4/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog (Auto Generated by Claude Code)
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.4] - 2025-08-09
+
+### Added
+- Added `--version` / `-v` flag to display current version
+- Added comprehensive help message with examples
+- Added `__main__.py` file to support `python -m nber_cli` usage
+- Added argument grouping for better CLI organization
+- Added automatic help display when no arguments are provided
+
+### Changed
+- Improved CLI argument parsing with better error handling
+- Enhanced help text formatting with examples
+- Updated argument structure to use argument groups
+
+### Fixed
+- Fixed CLI behavior when no arguments are provided (now shows help instead of error)
+
+## [0.1.3] - Previous
+
+### Added
+- Initial release with basic NBER paper downloading functionality
+- Support for downloading multiple papers by ID
+- Configurable save path for downloaded papers
+- Command-line interface with download functionality
+- Web UI support via `nber-cli-web` command
+
+### Features
+- Async downloading for better performance
+- Support for NBER paper IDs (e.g., w1234, w5678)
+- Default save path: ~/Documents/nber_paper

{nber_cli-0.1.3 → nber_cli-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nber-cli
-Version: 0.1.3
+Version: 0.1.4
 Summary: A command-line tool to download NBER papers.
 License-File: LICENSE
 Requires-Python: >=3.11
@@ -14,6 +14,13 @@ Requires-Dist: orjson
 Description-Content-Type: text/markdown
 
 # NBER-CLI
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![PyPI version](https://img.shields.io/pypi/v/nber-cli.svg)](https://pypi.org/project/nber-cli/)
+[![PyPI Downloads](https://static.pepy.tech/badge/nber-cli)](https://pepy.tech/projects/nber-cli)
+[![Issue](https://img.shields.io/badge/Issue-report-green.svg)](https://github.com/sepinetam/nber-cli/issues/new)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/nber-cli)
+
 NBER-CLI is a command line interface for the National Bureau of Economic Research (NBER) paper data.
 
 

{nber_cli-0.1.3 → nber_cli-0.1.4}/README.md

@@ -1,4 +1,11 @@
 # NBER-CLI
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![PyPI version](https://img.shields.io/pypi/v/nber-cli.svg)](https://pypi.org/project/nber-cli/)
+[![PyPI Downloads](https://static.pepy.tech/badge/nber-cli)](https://pepy.tech/projects/nber-cli)
+[![Issue](https://img.shields.io/badge/Issue-report-green.svg)](https://github.com/sepinetam/nber-cli/issues/new)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/nber-cli)
+
 NBER-CLI is a command line interface for the National Bureau of Economic Research (NBER) paper data.
 
 

{nber_cli-0.1.3 → nber_cli-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nber-cli"
-version = "0.1.3"
+version = "0.1.4"
 description = "A command-line tool to download NBER papers."
 readme = "README.md"
 requires-python = ">=3.11"

nber_cli-0.1.4/src/nber_cli/__init__.py

@@ -0,0 +1,67 @@
+import argparse
+import asyncio
+import os
+import sys
+from importlib.metadata import version as get_version
+
+from .core.download.downloader import main_download_multiple
+
+
+def get_version_info() -> str:
+    """Get the version information of the package."""
+    try:
+        return get_version("nber-cli")
+    except Exception:
+        return "0.1.3"  # Fallback version
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="NBER CLI - A command-line tool to download NBER papers.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  nber-cli -d w1234 w5678
+  nber-cli --download w1234 --save_path ./papers
+  nber-cli --version
+  nber-cli --help
+        """
+    )
+
+    # 添加版本参数
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        version=f"NBER CLI v{get_version_info()}"
+    )
+
+    # 添加下载参数组
+    download_group = parser.add_argument_group("Download Options")
+    download_group.add_argument(
+        "-d",
+        "-D",
+        "--download",
+        dest="paper_ids",
+        nargs='+',
+        type=str,
+        help="One or more NBER paper IDs (e.g., w1234 w5678).")
+    download_group.add_argument(
+        "--save_path",
+        type=str,
+        default=os.path.expanduser("~/Documents/nber_paper"),
+        help="The directory to save the downloaded paper. Defaults to ~/Documents/nber_paper.")
+
+    args = parser.parse_args()
+
+    # 如果没有提供任何参数，显示帮助信息
+    if not any(vars(args).values()):
+        parser.print_help()
+        sys.exit(0)
+
+    # 如果提供了paper_ids参数，执行下载
+    if args.paper_ids:
+        asyncio.run(main_download_multiple(args.paper_ids, args.save_path))
+    else:
+        parser.print_help()
+        sys.exit(1)

nber_cli-0.1.4/src/nber_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for the nber-cli package."""
+
+from . import main
+
+if __name__ == "__main__":
+    main()

{nber_cli-0.1.3 → nber_cli-0.1.4}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 2
+revision = 3
 requires-python = ">=3.11"
 
 [[package]]
@@ -135,11 +135,11 @@ wheels = [
 
 [[package]]
 name = "certifi"
-version = "2025.6.15"
+version = "2025.8.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/73/f7/f14b46d4bcd21092d7d3ccef689615220d8a08fb25e564b65d20738e672e/certifi-2025.6.15.tar.gz", hash = "sha256:d747aa5a8b9bbbb1bb8c22bb13e22bd1f18e9796defa16bab421f7f7a317323b", size = 158753, upload-time = "2025-06-15T02:45:51.329Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/dc/67/960ebe6bf230a96cda2e0abcf73af550ec4f090005363542f0765df162e0/certifi-2025.8.3.tar.gz", hash = "sha256:e564105f78ded564e3ae7c923924435e1daa7463faeab5bb932bc53ffae63407", size = 162386, upload-time = "2025-08-03T03:07:47.08Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/84/ae/320161bd181fc06471eed047ecce67b693fd7515b16d495d8932db763426/certifi-2025.6.15-py3-none-any.whl", hash = "sha256:2e0c7ce7cb5d8f8634ca55d2ba7e6ec2689a2fd6537d8dec1296a477a4910057", size = 157650, upload-time = "2025-06-15T02:45:49.977Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/48/1549795ba7742c948d2ad169c1c8cdbae65bc450d6cd753d124b17c8cd32/certifi-2025.8.3-py3-none-any.whl", hash = "sha256:f6c12493cfb1b06ba2ff328595af9350c65d6644968e5d3a2ffd78699af217a5", size = 161216, upload-time = "2025-08-03T03:07:45.777Z" },
 ]
 
 [[package]]
@@ -427,7 +427,7 @@ wheels = [
 
 [[package]]
 name = "nber-cli"
-version = "0.1.3"
+version = "0.1.4"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },

nber_cli-0.1.3/src/nber_cli/__init__.py

@@ -1,27 +0,0 @@
-import argparse
-import asyncio
-import os
-
-from .core.download.downloader import main_download_multiple
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Download NBER papers.")
-    parser.add_argument(
-        "-d",
-        "-D",
-        "--download",
-        dest="paper_ids",
-        required=True,
-        nargs='+',
-        type=str,
-        help="One or more NBER paper IDs (e.g., w1234 w5678).")
-    parser.add_argument(
-        "--save_path",
-        type=str,
-        default=os.path.expanduser("~/Documents/nber_paper"),
-        help="The directory to save the downloaded paper. Defaults to ~/Documents/nber_paper.")
-
-    args = parser.parse_args()
-
-    asyncio.run(main_download_multiple(args.paper_ids, args.save_path))