geneplus-tools-test 0.1.0__tar.gz

geneplus_tools_test-0.1.0/.gitignore

@@ -0,0 +1,133 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store

geneplus_tools_test-0.1.0/.pypirc.template

@@ -0,0 +1,3 @@
+[pypi]
+username = __token__
+password = pypi-替换为您的API-Token

geneplus_tools_test-0.1.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: geneplus-tools-test
+Version: 0.1.0
+Summary: GenePlus Python Client - A simple HTTP client for GenePlus API
+Project-URL: Homepage, https://github.com/geneplus/geneplus-tools-test
+Project-URL: Documentation, https://github.com/geneplus/geneplus-tools-test#readme
+Project-URL: Repository, https://github.com/geneplus/geneplus-tools-test.git
+Project-URL: Issues, https://github.com/geneplus/geneplus-tools-test/issues
+Author: GenePlus Team
+License: MIT
+Keywords: api,client,geneplus,http
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# GenePlus Tools Test
+
+GenePlus Python Client - A simple HTTP client for GenePlus API.
+
+## Installation
+
+```bash
+pip install geneplus-tools-test
+```
+
+## Quick Start
+
+```python
+from geneplus_tools_test import GenePlusClient
+
+# Create client (token will be loaded from config or environment variable)
+client = GenePlusClient()
+
+# Test connectivity
+result = client.ping()
+print(result)  # 'pong'
+
+# Get user info
+info = client.get_info("张三", "13512341234")
+print(info)  # '张三 - 13512341234，喜欢探索新事物'
+```
+
+## Configuration
+
+The client can be configured in three ways (in order of priority):
+
+### 1. Direct Token
+
+```python
+client = GenePlusClient(token="your-token-here")
+```
+
+### 2. Environment Variable
+
+```bash
+export GENEPLUS_TOKEN="your-token-here"
+```
+
+```python
+client = GenePlusClient()  # Will use GENEPLUS_TOKEN
+```
+
+### 3. Config File
+
+Create `~/.config/geneplus/token.json`:
+
+```json
+{
+  "gp-tools-token": "your-token-here"
+}
+```
+
+```python
+client = GenePlusClient()  # Will read from config file
+```
+
+## CLI Usage
+
+After installation, you can use the `gp-tool` command:
+
+### Test connectivity
+
+```bash
+gp-tool ping
+```
+
+### Get user information
+
+```bash
+gp-tool get-info --name "张三" --phone "13512341234"
+```
+
+### Help
+
+```bash
+gp-tool --help
+gp-tool get-info --help
+```
+
+## API Reference
+
+### GenePlusClient
+
+#### `__init__(token=None, base_url=None)`
+
+Initialize the client.
+
+- `token`: Optional API token
+- `base_url`: Optional base URL (default: http://jdh.test.geneplus.org.cn)
+
+#### `ping() -> str`
+
+Test network connectivity to the server.
+
+Returns response text from the server.
+
+Raises `GenePlusConnectionError` if connection fails.
+
+#### `get_info(name: str, phone: str) -> str`
+
+Get user information from the server.
+
+- `name`: User name
+- `phone`: User phone number (11 digits, starts with 1)
+
+Returns user information string.
+
+Raises:
+- `ValueError`: If phone number format is invalid
+- `GenePlusAuthError`: If token is invalid
+- `GenePlusAPIError`: If API returns other errors
+- `GenePlusConnectionError`: If network connection fails
+
+## Exceptions
+
+- `GenePlusError`: Base exception
+- `GenePlusConnectionError`: Network connection error
+- `GenePlusAuthError`: Authentication error (invalid token)
+- `GenePlusAPIError`: API error
+- `GenePlusConfigError`: Configuration error (missing token)
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/geneplus/geneplus-tools-test.git
+cd geneplus-tools-test
+pip install -e ".[dev]"
+```
+
+### Build
+
+```bash
+python -m build
+```
+
+### Publish to PyPI
+
+```bash
+twine upload dist/*
+```
+
+## License
+
+MIT

geneplus_tools_test-0.1.0/README.md

@@ -0,0 +1,151 @@
+# GenePlus Tools Test
+
+GenePlus Python Client - A simple HTTP client for GenePlus API.
+
+## Installation
+
+```bash
+pip install geneplus-tools-test
+```
+
+## Quick Start
+
+```python
+from geneplus_tools_test import GenePlusClient
+
+# Create client (token will be loaded from config or environment variable)
+client = GenePlusClient()
+
+# Test connectivity
+result = client.ping()
+print(result)  # 'pong'
+
+# Get user info
+info = client.get_info("张三", "13512341234")
+print(info)  # '张三 - 13512341234，喜欢探索新事物'
+```
+
+## Configuration
+
+The client can be configured in three ways (in order of priority):
+
+### 1. Direct Token
+
+```python
+client = GenePlusClient(token="your-token-here")
+```
+
+### 2. Environment Variable
+
+```bash
+export GENEPLUS_TOKEN="your-token-here"
+```
+
+```python
+client = GenePlusClient()  # Will use GENEPLUS_TOKEN
+```
+
+### 3. Config File
+
+Create `~/.config/geneplus/token.json`:
+
+```json
+{
+  "gp-tools-token": "your-token-here"
+}
+```
+
+```python
+client = GenePlusClient()  # Will read from config file
+```
+
+## CLI Usage
+
+After installation, you can use the `gp-tool` command:
+
+### Test connectivity
+
+```bash
+gp-tool ping
+```
+
+### Get user information
+
+```bash
+gp-tool get-info --name "张三" --phone "13512341234"
+```
+
+### Help
+
+```bash
+gp-tool --help
+gp-tool get-info --help
+```
+
+## API Reference
+
+### GenePlusClient
+
+#### `__init__(token=None, base_url=None)`
+
+Initialize the client.
+
+- `token`: Optional API token
+- `base_url`: Optional base URL (default: http://jdh.test.geneplus.org.cn)
+
+#### `ping() -> str`
+
+Test network connectivity to the server.
+
+Returns response text from the server.
+
+Raises `GenePlusConnectionError` if connection fails.
+
+#### `get_info(name: str, phone: str) -> str`
+
+Get user information from the server.
+
+- `name`: User name
+- `phone`: User phone number (11 digits, starts with 1)
+
+Returns user information string.
+
+Raises:
+- `ValueError`: If phone number format is invalid
+- `GenePlusAuthError`: If token is invalid
+- `GenePlusAPIError`: If API returns other errors
+- `GenePlusConnectionError`: If network connection fails
+
+## Exceptions
+
+- `GenePlusError`: Base exception
+- `GenePlusConnectionError`: Network connection error
+- `GenePlusAuthError`: Authentication error (invalid token)
+- `GenePlusAPIError`: API error
+- `GenePlusConfigError`: Configuration error (missing token)
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/geneplus/geneplus-tools-test.git
+cd geneplus-tools-test
+pip install -e ".[dev]"
+```
+
+### Build
+
+```bash
+python -m build
+```
+
+### Publish to PyPI
+
+```bash
+twine upload dist/*
+```
+
+## License
+
+MIT

geneplus_tools_test-0.1.0/geneplus_tools_test/__init__.py

@@ -0,0 +1,230 @@
+"""GenePlus Python Client - A simple HTTP client for GenePlus API."""
+
+import json
+import os
+import re
+from pathlib import Path
+from typing import Optional
+
+import requests
+
+
+# Custom Exceptions
+class GenePlusError(Exception):
+    """Base exception for GenePlus client."""
+    pass
+
+
+class GenePlusConnectionError(GenePlusError):
+    """Raised when network connection fails."""
+    pass
+
+
+class GenePlusAuthError(GenePlusError):
+    """Raised when authentication fails (invalid token)."""
+    pass
+
+
+class GenePlusAPIError(GenePlusError):
+    """Raised when API returns an error."""
+    pass
+
+
+class GenePlusConfigError(GenePlusError):
+    """Raised when configuration is missing or invalid."""
+    pass
+
+
+class GenePlusClient:
+    """Client for GenePlus API.
+    
+    Provides methods to interact with GenePlus test server:
+    - ping(): Test network connectivity
+    - get_info(name, phone): Get user information
+    
+    Token can be provided directly, via environment variable GENEPLUS_TOKEN,
+    or read from ~/.config/geneplus/token.json file.
+    
+    Args:
+        token: Optional API token. If not provided, will try to load from
+               environment variable or config file.
+        base_url: Optional base URL for the API. Defaults to
+                  http://jdh.test.geneplus.org.cn
+    
+    Raises:
+        GenePlusConfigError: If no token is found
+    
+    Example:
+        >>> client = GenePlusClient()
+        >>> client.ping()
+        'pong'
+        >>> client.get_info("张三", "13512341234")
+        '张三 - 13512341234，喜欢探索新事物'
+    """
+    
+    DEFAULT_BASE_URL = "http://jdh.test.geneplus.org.cn"
+    CONFIG_PATH = Path.home() / ".config" / "geneplus" / "token.json"
+    
+    def __init__(self, token: Optional[str] = None, base_url: Optional[str] = None):
+        """Initialize the client."""
+        self.base_url = base_url or self.DEFAULT_BASE_URL
+        
+        if token:
+            self.token = token
+        else:
+            self.token = self._load_token()
+        
+        if not self.token:
+            raise GenePlusConfigError(
+                "无法读取访问令牌。请提供 token 参数，"
+                "设置 GENEPLUS_TOKEN 环境变量，"
+                "或配置 ~/.config/geneplus/token.json 文件"
+            )
+    
+    def _load_token(self) -> Optional[str]:
+        """Load token from environment variable or config file.
+        
+        Returns:
+            The token string if found, None otherwise
+        """
+        # Try environment variable first
+        env_token = os.environ.get("GENEPLUS_TOKEN")
+        if env_token:
+            return env_token
+        
+        # Try config file
+        if self.CONFIG_PATH.exists():
+            try:
+                with open(self.CONFIG_PATH, 'r', encoding='utf-8') as f:
+                    config = json.load(f)
+                    return config.get("gp-tools-token")
+            except (json.JSONDecodeError, IOError):
+                pass
+        
+        return None
+    
+    def _validate_phone(self, phone: str) -> None:
+        """Validate phone number format.
+        
+        Args:
+            phone: Phone number to validate
+        
+        Raises:
+            ValueError: If phone number format is invalid
+        """
+        if not re.match(r'^1[3-9]\d{9}$', phone):
+            raise ValueError(
+                "手机号码格式错误，请输入正确的11位中国大陆手机号码（如13812345678）"
+            )
+    
+    def ping(self) -> str:
+        """Test network connectivity to the server.
+        
+        Sends a GET request to the /ping endpoint.
+        
+        Returns:
+            Response text from the server
+        
+        Raises:
+            GenePlusConnectionError: If network connection fails
+        """
+        url = f"{self.base_url}/ping"
+        
+        try:
+            response = requests.get(url, timeout=10)
+            response.raise_for_status()
+            return response.text
+        except requests.exceptions.ConnectionError as e:
+            raise GenePlusConnectionError(f"无法连接到服务器: {e}")
+        except requests.exceptions.Timeout:
+            raise GenePlusConnectionError("请求超时，请稍后重试")
+        except requests.exceptions.RequestException as e:
+            raise GenePlusConnectionError(f"网络请求错误: {e}")
+    
+    def get_info(self, name: str, phone: str) -> str:
+        """Get user information from the server.
+        
+        Sends a POST request to the /get_info endpoint with token,
+        name, and phone number.
+        
+        Args:
+            name: User name
+            phone: User phone number (11 digits, starts with 1)
+        
+        Returns:
+            User information string from the server
+        
+        Raises:
+            ValueError: If phone number format is invalid
+            GenePlusAuthError: If token is invalid (401)
+            GenePlusAPIError: If API returns other errors
+            GenePlusConnectionError: If network connection fails
+        """
+        # Validate phone number
+        self._validate_phone(phone)
+        
+        url = f"{self.base_url}/get_info"
+        payload = {
+            "token": self.token,
+            "name": name,
+            "phone": phone
+        }
+        
+        try:
+            response = requests.post(
+                url,
+                json=payload,
+                headers={"Content-Type": "application/json"},
+                timeout=10
+            )
+            
+            # Handle different status codes
+            if response.status_code == 401:
+                data = response.json()
+                raise GenePlusAuthError(data.get("message", "token无效"))
+            
+            if response.status_code == 400:
+                data = response.json()
+                raise GenePlusAPIError(data.get("message", "请求参数错误"))
+            
+            response.raise_for_status()
+            data = response.json()
+            
+            if data.get("code") == 200:
+                return data.get("message", "")
+            else:
+                raise GenePlusAPIError(data.get("message", "未知错误"))
+                
+        except requests.exceptions.ConnectionError as e:
+            raise GenePlusConnectionError(f"无法连接到服务器: {e}")
+        except requests.exceptions.Timeout:
+            raise GenePlusConnectionError("请求超时，请稍后重试")
+        except requests.exceptions.RequestException as e:
+            raise GenePlusConnectionError(f"网络请求错误: {e}")
+
+
+# Convenience function for quick usage
+def get_client(token: Optional[str] = None, base_url: Optional[str] = None) -> GenePlusClient:
+    """Create a new GenePlusClient instance.
+    
+    This is a convenience function that creates and returns a client.
+    
+    Args:
+        token: Optional API token
+        base_url: Optional base URL
+    
+    Returns:
+        A new GenePlusClient instance
+    """
+    return GenePlusClient(token=token, base_url=base_url)
+
+
+__all__ = [
+    "GenePlusClient",
+    "GenePlusError",
+    "GenePlusConnectionError",
+    "GenePlusAuthError",
+    "GenePlusAPIError",
+    "GenePlusConfigError",
+    "get_client",
+]

geneplus_tools_test-0.1.0/geneplus_tools_test/cli.py

@@ -0,0 +1,66 @@
+"""GenePlus CLI - Command line interface for GenePlus API."""
+
+import argparse
+import sys
+
+from geneplus_tools_test import GenePlusClient, GenePlusError
+
+
+def main():
+    """Main entry point for CLI."""
+    parser = argparse.ArgumentParser(
+        prog="gp-tool",
+        description="GenePlus CLI tool - interact with GenePlus API"
+    )
+    
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+    
+    # ping command
+    ping_parser = subparsers.add_parser(
+        "ping",
+        help="Test network connectivity to the server"
+    )
+    
+    # get-info command
+    get_info_parser = subparsers.add_parser(
+        "get-info",
+        help="Get user information from the server"
+    )
+    get_info_parser.add_argument(
+        "--name",
+        required=True,
+        help="User name"
+    )
+    get_info_parser.add_argument(
+        "--phone",
+        required=True,
+        help="User phone number (11 digits)"
+    )
+    
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        sys.exit(1)
+    
+    try:
+        client = GenePlusClient()
+        
+        if args.command == "ping":
+            result = client.ping()
+            print(result)
+        
+        elif args.command == "get-info":
+            result = client.get_info(args.name, args.phone)
+            print(result)
+            
+    except GenePlusError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except KeyboardInterrupt:
+        print("\nOperation cancelled", file=sys.stderr)
+        sys.exit(130)
+
+
+if __name__ == "__main__":
+    main()

geneplus_tools_test-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "geneplus-tools-test"
+version = "0.1.0"
+description = "GenePlus Python Client - A simple HTTP client for GenePlus API"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "GenePlus Team"},
+]
+keywords = ["geneplus", "api", "client", "http"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build",
+    "twine",
+    "pytest",
+]
+
+[project.urls]
+Homepage = "https://github.com/geneplus/geneplus-tools-test"
+Documentation = "https://github.com/geneplus/geneplus-tools-test#readme"
+Repository = "https://github.com/geneplus/geneplus-tools-test.git"
+Issues = "https://github.com/geneplus/geneplus-tools-test/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["geneplus_tools_test"]
+
+[project.scripts]
+gp-tool = "geneplus_tools_test.cli:main"