wiba 0.2.3__tar.gz

wiba-0.2.3/MANIFEST.in

@@ -0,0 +1 @@
+include requirements.txt

wiba-0.2.3/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: wiba
+Version: 0.2.3
+Summary: Official Python client library for WIBA argument mining API
+Home-page: https://github.com/WIBA-ORG/wiba-python-client
+Author: WIBA Research Team
+Author-email: WIBA Research Team <airan002@ucr.edu>
+Maintainer-email: Arman Irani <airan002@ucr.edu>
+License: MIT
+Project-URL: Homepage, https://wiba.dev
+Project-URL: Documentation, https://wiba.dev/docs
+Project-URL: Repository, https://github.com/WIBA-ORG/wiba-python-client
+Project-URL: Bug Reports, https://github.com/WIBA-ORG/wiba-python-client/issues
+Keywords: argument mining,natural language processing,nlp,text analysis,computational argumentation,topic extraction,stance detection
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pandas>=1.2.0
+Requires-Dist: numpy>=1.19.0
+Requires-Dist: tqdm>=4.50.0
+Requires-Dist: structlog>=21.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=5.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == "docs"
+Requires-Dist: myst-parser>=1.0.0; extra == "docs"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# WIBA Python Client
+
+Official Python client library for the WIBA (What Is Being Argued?) argument mining API.
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install wiba
+```
+
+### Basic Usage
+
+```python
+from wiba import WIBA
+
+# Initialize client
+client = WIBA(api_token="your_api_token")
+
+# Detect arguments
+result = client.detect("Climate change requires immediate action.")
+print(result.is_argument)  # True
+print(result.confidence)   # 0.89
+
+# Extract topics
+topic = client.extract("We must invest in renewable energy now.")
+print(topic.topic)  # "renewable energy"
+
+# Analyze stance
+stance = client.stance("Solar power is expensive", "renewable energy")
+print(stance.stance)  # "Against"
+
+# Discover arguments in longer text
+segments = client.discover_arguments(long_text)
+for segment in segments:
+    print(f"Argument: {segment.text} (confidence: {segment.confidence})")
+```
+
+### Batch Processing
+
+```python
+# Process multiple texts
+texts = [
+    "Climate change is a serious threat.",
+    "We need renewable energy sources.",
+    "Nuclear power is too dangerous."
+]
+
+# Batch argument detection
+results = client.detect(texts)
+for result in results:
+    print(f"{result.text}: {result.is_argument}")
+
+# Process DataFrames
+import pandas as pd
+df = pd.DataFrame({'text': texts})
+df_results = client.detect(df)
+print(df_results[['text', 'is_argument', 'confidence']])
+```
+
+## 🔧 Configuration
+
+### API Token
+
+Get your API token from [wiba.dev](https://wiba.dev):
+
+```python
+# Using API token
+client = WIBA(api_token="your_token_here")
+
+# Using environment variable
+import os
+os.environ['WIBA_API_TOKEN'] = 'your_token_here'
+client = WIBA()  # Will use WIBA_API_TOKEN automatically
+```
+
+### Custom Configuration
+
+```python
+from wiba import WIBA, ClientConfig
+
+config = ClientConfig(
+    api_url="https://custom.wiba.dev",
+    api_token="your_token",
+    log_level="DEBUG"
+)
+
+client = WIBA(config=config)
+```
+
+## 📊 Features
+
+### Core Functions
+
+- **`detect(texts)`** - Argument detection in text
+- **`extract(texts)`** - Topic extraction from arguments
+- **`stance(texts, topics)`** - Stance analysis (favor/against/neutral)
+- **`discover_arguments(text)`** - Find argumentative segments in longer texts
+
+### Input Formats
+
+- **Single text**: `"This is an argument"`
+- **List of texts**: `["Text 1", "Text 2", "Text 3"]`
+- **pandas DataFrame**: DataFrame with text column
+- **CSV string**: Comma-separated values
+
+### Response Objects
+
+All methods return structured response objects with:
+- **Results**: List of prediction results
+- **Metadata**: Request information and statistics
+- **Confidence scores**: Model confidence for each prediction
+
+### Advanced Features
+
+- **Batch processing** with progress bars
+- **Automatic retries** with exponential backoff
+- **Connection pooling** for better performance
+- **DataFrame integration** for data science workflows
+- **Statistics tracking** for usage monitoring
+
+## 🧪 Examples
+
+Check out the [examples/](examples/) directory for:
+- Basic usage examples
+- Batch processing demonstrations
+- DataFrame integration
+- Advanced configuration
+- Error handling patterns
+
+## 🤝 Contributing
+
+This package is part of the WIBA-ORG collaborative development setup:
+
+1. **Report bugs**: [GitHub Issues](https://github.com/WIBA-ORG/wiba-python-client/issues)
+2. **Contribute code**: See [CONTRIBUTING.md](CONTRIBUTING.md)
+3. **Documentation**: Help improve our docs
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- **Homepage**: [wiba.dev](https://wiba.dev)
+- **API Documentation**: [wiba.dev/docs](https://wiba.dev/docs)
+- **Research Paper**: [Link to paper]
+- **GitHub Organization**: [WIBA-ORG](https://github.com/WIBA-ORG)

wiba-0.2.3/README.md

@@ -0,0 +1,149 @@
+# WIBA Python Client
+
+Official Python client library for the WIBA (What Is Being Argued?) argument mining API.
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install wiba
+```
+
+### Basic Usage
+
+```python
+from wiba import WIBA
+
+# Initialize client
+client = WIBA(api_token="your_api_token")
+
+# Detect arguments
+result = client.detect("Climate change requires immediate action.")
+print(result.is_argument)  # True
+print(result.confidence)   # 0.89
+
+# Extract topics
+topic = client.extract("We must invest in renewable energy now.")
+print(topic.topic)  # "renewable energy"
+
+# Analyze stance
+stance = client.stance("Solar power is expensive", "renewable energy")
+print(stance.stance)  # "Against"
+
+# Discover arguments in longer text
+segments = client.discover_arguments(long_text)
+for segment in segments:
+    print(f"Argument: {segment.text} (confidence: {segment.confidence})")
+```
+
+### Batch Processing
+
+```python
+# Process multiple texts
+texts = [
+    "Climate change is a serious threat.",
+    "We need renewable energy sources.",
+    "Nuclear power is too dangerous."
+]
+
+# Batch argument detection
+results = client.detect(texts)
+for result in results:
+    print(f"{result.text}: {result.is_argument}")
+
+# Process DataFrames
+import pandas as pd
+df = pd.DataFrame({'text': texts})
+df_results = client.detect(df)
+print(df_results[['text', 'is_argument', 'confidence']])
+```
+
+## 🔧 Configuration
+
+### API Token
+
+Get your API token from [wiba.dev](https://wiba.dev):
+
+```python
+# Using API token
+client = WIBA(api_token="your_token_here")
+
+# Using environment variable
+import os
+os.environ['WIBA_API_TOKEN'] = 'your_token_here'
+client = WIBA()  # Will use WIBA_API_TOKEN automatically
+```
+
+### Custom Configuration
+
+```python
+from wiba import WIBA, ClientConfig
+
+config = ClientConfig(
+    api_url="https://custom.wiba.dev",
+    api_token="your_token",
+    log_level="DEBUG"
+)
+
+client = WIBA(config=config)
+```
+
+## 📊 Features
+
+### Core Functions
+
+- **`detect(texts)`** - Argument detection in text
+- **`extract(texts)`** - Topic extraction from arguments
+- **`stance(texts, topics)`** - Stance analysis (favor/against/neutral)
+- **`discover_arguments(text)`** - Find argumentative segments in longer texts
+
+### Input Formats
+
+- **Single text**: `"This is an argument"`
+- **List of texts**: `["Text 1", "Text 2", "Text 3"]`
+- **pandas DataFrame**: DataFrame with text column
+- **CSV string**: Comma-separated values
+
+### Response Objects
+
+All methods return structured response objects with:
+- **Results**: List of prediction results
+- **Metadata**: Request information and statistics
+- **Confidence scores**: Model confidence for each prediction
+
+### Advanced Features
+
+- **Batch processing** with progress bars
+- **Automatic retries** with exponential backoff
+- **Connection pooling** for better performance
+- **DataFrame integration** for data science workflows
+- **Statistics tracking** for usage monitoring
+
+## 🧪 Examples
+
+Check out the [examples/](examples/) directory for:
+- Basic usage examples
+- Batch processing demonstrations
+- DataFrame integration
+- Advanced configuration
+- Error handling patterns
+
+## 🤝 Contributing
+
+This package is part of the WIBA-ORG collaborative development setup:
+
+1. **Report bugs**: [GitHub Issues](https://github.com/WIBA-ORG/wiba-python-client/issues)
+2. **Contribute code**: See [CONTRIBUTING.md](CONTRIBUTING.md)
+3. **Documentation**: Help improve our docs
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- **Homepage**: [wiba.dev](https://wiba.dev)
+- **API Documentation**: [wiba.dev/docs](https://wiba.dev/docs)
+- **Research Paper**: [Link to paper]
+- **GitHub Organization**: [WIBA-ORG](https://github.com/WIBA-ORG)

wiba-0.2.3/pyproject.toml

@@ -0,0 +1,99 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wiba"
+version = "0.2.3"
+description = "Official Python client library for WIBA argument mining API"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "WIBA Research Team", email = "airan002@ucr.edu"},
+]
+maintainers = [
+    {name = "Arman Irani", email = "airan002@ucr.edu"},
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers", 
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "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 :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Text Processing :: Linguistic",
+]
+keywords = [
+    "argument mining",
+    "natural language processing", 
+    "nlp",
+    "text analysis",
+    "computational argumentation",
+    "topic extraction",
+    "stance detection",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "requests>=2.25.0",
+    "pandas>=1.2.0",
+    "numpy>=1.19.0",
+    "tqdm>=4.50.0",
+    "structlog>=21.1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "flake8>=6.0.0",
+    "mypy>=1.0.0",
+]
+docs = [
+    "sphinx>=5.0.0",
+    "sphinx-rtd-theme>=1.2.0",
+    "myst-parser>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://wiba.dev"
+Documentation = "https://wiba.dev/docs"
+Repository = "https://github.com/WIBA-ORG/wiba-python-client"
+"Bug Reports" = "https://github.com/WIBA-ORG/wiba-python-client/issues"
+
+[project.scripts]
+wiba = "wiba.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["wiba*"]
+
+[tool.black]
+line-length = 88
+target-version = ['py38', 'py39', 'py310', 'py311', 'py312']
+include = '\.pyi?$'
+
+[tool.isort]
+profile = "black"
+multi_line_output = 3
+line_length = 88
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true

wiba-0.2.3/requirements.txt

@@ -0,0 +1,6 @@
+# Core dependencies for WIBA Python client
+requests>=2.25.0
+pandas>=1.2.0
+numpy>=1.19.0
+tqdm>=4.50.0
+structlog>=21.1.0

wiba-0.2.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wiba-0.2.3/setup.py

@@ -0,0 +1,75 @@
+"""Setup configuration for WIBA Python client."""
+
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+with open("requirements.txt", "r", encoding="utf-8") as fh:
+    requirements = [line.strip() for line in fh if line.strip() and not line.startswith("#")]
+
+setup(
+    name="wiba",
+    version="0.2.3",
+    author="WIBA Research Team",
+    author_email="airan002@ucr.edu",
+    description="Official Python client library for WIBA argument mining API",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/WIBA-ORG/wiba-python-client",
+    project_urls={
+        "Homepage": "https://wiba.dev",
+        "Documentation": "https://wiba.dev/docs",
+        "Repository": "https://github.com/WIBA-ORG/wiba-python-client",
+        "Bug Reports": "https://github.com/WIBA-ORG/wiba-python-client/issues",
+    },
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Intended Audience :: Science/Research",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "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 :: Scientific/Engineering :: Artificial Intelligence",
+        "Topic :: Text Processing :: Linguistic",
+    ],
+    python_requires=">=3.8",
+    install_requires=requirements,
+    extras_require={
+        "dev": [
+            "pytest>=7.0.0",
+            "pytest-asyncio>=0.21.0",
+            "black>=23.0.0",
+            "isort>=5.12.0",
+            "flake8>=6.0.0",
+            "mypy>=1.0.0",
+        ],
+        "docs": [
+            "sphinx>=5.0.0",
+            "sphinx-rtd-theme>=1.2.0",
+            "myst-parser>=1.0.0",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "wiba=wiba.cli:main",
+        ],
+    },
+    keywords=[
+        "argument mining",
+        "natural language processing",
+        "nlp",
+        "text analysis",
+        "computational argumentation",
+        "topic extraction",
+        "stance detection",
+    ],
+    zip_safe=False,
+    include_package_data=True,
+)