aio-sf 0.1.0b1__tar.gz → 0.1.0b4__tar.gz

aio_sf-0.1.0b4/.cursor/rules/api-structure.mdc

@@ -0,0 +1,225 @@
+---
+description: adding new apis
+alwaysApply: false
+---
+# Salesforce API Organization
+
+This directory contains organized Salesforce API clients following a consistent convention.
+
+## Directory Structure Convention
+
+Each API module follows this structure:
+
+```
+api/
+├── {api_name}/
+│   ├── __init__.py          # Export API client and types
+│   ├── client.py            # Main API client class
+│   └── types.py             # TypedDict definitions for responses
+└── __init__.py              # Export all APIs and types
+```
+
+## Current APIs
+
+### `describe/` - Describe API
+- **Client**: `DescribeAPI`
+- **Purpose**: Object describe/metadata, organization info, limits
+- **Key Methods**: 
+  - `describe_sobject()` → `SObjectDescribe`
+  - `list_sobjects()` → `List[SObjectInfo]`
+  - `get_organization_info()` → `OrganizationInfo`
+  - `get_limits()` → `OrganizationLimits`
+
+### `bulk_v2/` - Bulk API v2
+- **Client**: `BulkV2API`  
+- **Purpose**: Large data operations, bulk queries
+- **Key Methods**:
+  - `create_job()` → `BulkJobInfo`
+  - `get_job_status()` → `BulkJobStatus`
+  - `get_job_results()` → `Tuple[str, Optional[str]]`
+  - `wait_for_job_completion()` → `BulkJobStatus`
+
+### `query/` - Query API
+- **Client**: `QueryAPI`
+- **Purpose**: SOQL queries, QueryMore, SOSL search
+- **Key Methods**:
+  - `soql(query, include_deleted=False)` → `QueryResult` (with async iteration)
+  - `sosl(search)` → `List[Dict[str, Any]]` (SOSL search)
+  - `explain(query)` → `Dict[str, Any]` (query execution plan)
+  - `query_more()` → `QueryMoreResponse` (internal pagination)
+- **Features**: SOQL injection protection, automatic pagination, deleted records support
+- **Note**: Batch size is controlled by Salesforce, not configurable in Query API
+
+### `collections/` - Collections API
+- **Client**: `CollectionsAPI`
+- **Purpose**: Bulk record operations using composite sObject collections
+- **Key Methods**:
+  - `insert(sobject_type, records, all_or_none=True, batch_size=200, max_concurrent_batches=5)` → `CollectionInsertResponse`
+  - `update(sobject_type, records, all_or_none=True, batch_size=200, max_concurrent_batches=5)` → `CollectionUpdateResponse`
+  - `upsert(sobject_type, records, external_id_field, all_or_none=True, batch_size=200, max_concurrent_batches=5)` → `CollectionUpsertResponse`
+  - `delete(record_ids, all_or_none=True, batch_size=2000, max_concurrent_batches=5)` → `CollectionDeleteResponse`
+- **Features**: Atomic operations (all-or-none), automatic batching for large datasets, concurrent batch processing, order preservation
+- **Limits**: Insert/Update/Upsert: 200 records per batch, Delete: 2000 records per batch
+- **Order Guarantee**: Results maintain the same order as input records, enabling error correlation by index
+- **Note**: Automatically splits large datasets into batches and processes them concurrently for optimal performance
+
+## Naming Conventions
+
+### API Clients
+- **Class Name**: `{ApiName}API` (e.g., `DescribeAPI`, `BulkV2API`, `CollectionsAPI`)
+- **File**: `client.py`
+- **Connection Property**: `sf.{api_name}` (e.g., `sf.describe`, `sf.bulk_v2`, `sf.collections`)
+
+### Types
+- **File**: `types.py`
+- **Naming**: Descriptive, specific to the API
+- **Examples**: `SObjectDescribe`, `BulkJobInfo`, `OrganizationLimits`
+
+### Methods
+- **Return Types**: Always use TypedDict for structured responses
+- **Naming**: Clear, action-oriented (e.g., `get_job_status`, `describe_sobject`)
+- **Parameters**: Use typed parameters with Optional where appropriate
+
+## Adding New APIs
+
+When adding a new API (e.g., `query` for SOQL):
+
+1. **Create directory**: `api/query/`
+2. **Create files**:
+   ```python
+   # api/query/__init__.py
+   from .client import QueryAPI
+   from .types import QueryResult, QueryError
+   __all__ = ["QueryAPI", "QueryResult", "QueryError"]
+   
+   # api/query/client.py  
+   class QueryAPI:
+       def __init__(self, connection): ...
+       async def execute(self, soql: str) -> QueryResult: ...
+   
+   # api/query/types.py
+   class QueryResult(TypedDict): ...
+   ```
+3. **Add to main API `__init__.py`**:
+   ```python
+   from .query import QueryAPI, QueryResult, QueryError
+   ```
+4. **Add to connection**:
+   ```python
+   @property
+   def query(self):
+       if self._query_api is None:
+           from .api.query import QueryAPI
+           self._query_api = QueryAPI(self)
+       return self._query_api
+   ```# Salesforce API Organization
+
+This directory contains organized Salesforce API clients following a consistent convention.
+
+## Directory Structure Convention
+
+Each API module follows this structure:
+
+```
+api/
+├── {api_name}/
+│   ├── __init__.py          # Export API client and types
+│   ├── client.py            # Main API client class
+│   └── types.py             # TypedDict definitions for responses
+└── __init__.py              # Export all APIs and types
+```
+
+## Current APIs
+
+### `describe/` - Describe API
+- **Client**: `DescribeAPI`
+- **Purpose**: Object describe/metadata, organization info, limits
+- **Key Methods**: 
+  - `describe_sobject()` → `SObjectDescribe`
+  - `list_sobjects()` → `List[SObjectInfo]`
+  - `get_organization_info()` → `OrganizationInfo`
+  - `get_limits()` → `OrganizationLimits`
+
+### `bulk_v2/` - Bulk API v2
+- **Client**: `BulkV2API`  
+- **Purpose**: Large data operations, bulk queries
+- **Key Methods**:
+  - `create_job()` → `BulkJobInfo`
+  - `get_job_status()` → `BulkJobStatus`
+  - `get_job_results()` → `Tuple[str, Optional[str]]`
+  - `wait_for_job_completion()` → `BulkJobStatus`
+
+### `query/` - Query API
+- **Client**: `QueryAPI`
+- **Purpose**: SOQL queries, QueryMore, SOSL search
+- **Key Methods**:
+  - `soql(query, include_deleted=False)` → `QueryResult` (with async iteration)
+  - `sosl(search)` → `List[Dict[str, Any]]` (SOSL search)
+  - `explain(query)` → `Dict[str, Any]` (query execution plan)
+  - `query_more()` → `QueryMoreResponse` (internal pagination)
+- **Features**: SOQL injection protection, automatic pagination, deleted records support
+- **Note**: Batch size is controlled by Salesforce, not configurable in Query API
+
+### `collections/` - Collections API
+- **Client**: `CollectionsAPI`
+- **Purpose**: Bulk record operations using composite sObject collections
+- **Key Methods**:
+  - `insert(sobject_type, records, all_or_none=True, batch_size=200, max_concurrent_batches=5)` → `CollectionInsertResponse`
+  - `update(sobject_type, records, all_or_none=True, batch_size=200, max_concurrent_batches=5)` → `CollectionUpdateResponse`
+  - `upsert(sobject_type, records, external_id_field, all_or_none=True, batch_size=200, max_concurrent_batches=5)` → `CollectionUpsertResponse`
+  - `delete(record_ids, all_or_none=True, batch_size=2000, max_concurrent_batches=5)` → `CollectionDeleteResponse`
+- **Features**: Atomic operations (all-or-none), automatic batching for large datasets, concurrent batch processing, order preservation
+- **Limits**: Insert/Update/Upsert: 200 records per batch, Delete: 2000 records per batch
+- **Order Guarantee**: Results maintain the same order as input records, enabling error correlation by index
+- **Note**: Automatically splits large datasets into batches and processes them concurrently for optimal performance
+
+## Naming Conventions
+
+### API Clients
+- **Class Name**: `{ApiName}API` (e.g., `DescribeAPI`, `BulkV2API`, `CollectionsAPI`)
+- **File**: `client.py`
+- **Connection Property**: `sf.{api_name}` (e.g., `sf.describe`, `sf.bulk_v2`, `sf.collections`)
+
+### Types
+- **File**: `types.py`
+- **Naming**: Descriptive, specific to the API
+- **Examples**: `SObjectDescribe`, `BulkJobInfo`, `OrganizationLimits`
+
+### Methods
+- **Return Types**: Always use TypedDict for structured responses
+- **Naming**: Clear, action-oriented (e.g., `get_job_status`, `describe_sobject`)
+- **Parameters**: Use typed parameters with Optional where appropriate
+
+## Adding New APIs
+
+When adding a new API (e.g., `query` for SOQL):
+
+1. **Create directory**: `api/query/`
+2. **Create files**:
+   ```python
+   # api/query/__init__.py
+   from .client import QueryAPI
+   from .types import QueryResult, QueryError
+   __all__ = ["QueryAPI", "QueryResult", "QueryError"]
+   
+   # api/query/client.py  
+   class QueryAPI:
+       def __init__(self, connection): ...
+       async def execute(self, soql: str) -> QueryResult: ...
+   
+   # api/query/types.py
+   class QueryResult(TypedDict): ...
+   ```
+3. **Add to main API `__init__.py`**:
+   ```python
+   from .query import QueryAPI, QueryResult, QueryError
+   ```
+4. **Add to connection**:
+   ```python
+   @property
+   def query(self):
+       if self._query_api is None:
+           from .api.query import QueryAPI
+           self._query_api = QueryAPI(self)
+       return self._query_api
+   ```

aio_sf-0.1.0b4/.cursor/rules/async-patterns.mdc

@@ -0,0 +1,12 @@
+---
+globs: *.py
+description: "Async programming patterns and conventions"
+---
+
+# Async Programming Patterns
+
+This project uses async/await patterns throughout. Follow these conventions:
+
+## Client Management
+- Always use `async with SalesforceClient(auth_strategy=auth_strategy) as sf:` for client handling
+- All API interaction should happen through the client object

aio_sf-0.1.0b4/.cursor/rules/project-tooling.mdc

@@ -0,0 +1,6 @@
+---
+globs: *.py
+description: "Project tooling"
+---
+
+This project uses uv.  Do not use pip.

{aio_sf-0.1.0b1 → aio_sf-0.1.0b4}/.github/workflows/test.yml

@@ -27,18 +27,22 @@ jobs:
     - name: Install dependencies
       run: uv sync --all-extras --dev
     
+    - name: Run unit tests
+      run: |
+        uv run pytest tests/ -v --cov=aio_sf --cov-report=xml
+    
     - name: Test core installation (no exporter)
       run: |
         uv run --isolated python -c "
-        from aio_salesforce import SalesforceConnection, ClientCredentialsAuth
+        from aio_sf import SalesforceClient, ClientCredentialsAuth
         print('✅ Core installation works')
         "
     
     - name: Test full installation (with exporter)
       run: |
         uv run python -c "
-        from aio_salesforce import SalesforceConnection
-        from aio_salesforce.exporter import bulk_query, ParquetWriter
+        from aio_sf import SalesforceClient
+        from aio_sf.exporter import bulk_query, ParquetWriter
         print('✅ Full installation works')
         "
     
@@ -48,4 +52,4 @@ jobs:
     - name: Test wheel installation
       run: |
         uv run --isolated pip install dist/*.whl
-        uv run --isolated python -c "import aio_salesforce; print('✅ Wheel installation works')"
+        uv run --isolated python -c "import aio_sf; print('✅ Wheel installation works')"

{aio_sf-0.1.0b1 → aio_sf-0.1.0b4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: aio-sf
-Version: 0.1.0b1
-Summary: Async Salesforce library for Python with Bulk API 2.0 support
+Version: 0.1.0b4
+Summary: Async Salesforce library for Python
 Project-URL: Homepage, https://github.com/callawaycloud/aio-salesforce
 Project-URL: Repository, https://github.com/callawaycloud/aio-salesforce
 Project-URL: Issues, https://github.com/callawaycloud/aio-salesforce/issues
@@ -32,11 +32,9 @@ 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.9
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: python-dotenv>=1.0.0
@@ -48,6 +46,7 @@ Provides-Extra: dev
 Requires-Dist: black>=23.0.0; extra == 'dev'
 Requires-Dist: mypy>=1.5.0; extra == 'dev'
 Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
@@ -61,28 +60,31 @@ Description-Content-Type: text/markdown
 
 # aio-sf
 
-An async Salesforce library for Python with Bulk API 2.0 support.
+An async Salesforce library for Python.
 
 ## Features
 
 ### ✅ Supported APIs
-- [x] **OAuth Client Credentials Flow** - Automatic authentication
 - [x] **Bulk API 2.0** - Efficient querying of large datasets
 - [x] **Describe API** - Field metadata and object descriptions
 - [x] **SOQL Query API** - Standard Salesforce queries
-
-### 🔄 Planned APIs
-- [ ] **SObjects API** - Standard CRUD operations
+- [x] **SObjects Collections API** - CRUD on collections of SObjects (up to 2000 records at a time)
 - [ ] **Tooling API** - Development and deployment tools
 - [ ] **Bulk API 1.0** - Legacy bulk operations
 - [ ] **Streaming API** - Real-time event streaming
 
+### ✅ Supported Authentication Strategies
+- [x] **OAuth Client Credentials** - Automatic authentication
+- [x] **Static Token** - Existing access tokens
+- [x] **Refresh Token** - Refresh token flow
+- [x] **SFDX CLI** - Login by grabbing a token from the SFDX CLI
+- [ ] **Password Authentication** - Password + ST authentication (soap login)
+
 ### 🚀 Export Features
 - [x] **Parquet Export** - Efficient columnar storage with schema mapping
 - [x] **CSV Export** - Simple text format export
 - [x] **Resume Support** - Resume interrupted queries using job IDs
 - [x] **Streaming Processing** - Memory-efficient processing of large datasets
-- [x] **Type Mapping** - Automatic Salesforce to PyArrow type conversion
 
 ## Installation
 
@@ -104,7 +106,7 @@ uv add "aio-sf[exporter]"
 ```python
 import asyncio
 import os
-from aio_salesforce import SalesforceConnection, ClientCredentialsAuth
+from aio_sf import SalesforceClient, ClientCredentialsAuth
 
 async def main():
     auth = ClientCredentialsAuth(
@@ -113,7 +115,7 @@ async def main():
         instance_url=os.getenv('SF_INSTANCE_URL'),
     )
     
-    async with SalesforceConnection(auth_strategy=auth) as sf:
+    async with SalesforceClient(auth_strategy=auth) as sf:
         print(f"✅ Connected to: {sf.instance_url}")
 
         sobjects = await sf.describe.list_sobjects()
@@ -133,50 +135,34 @@ async def main():
 
         query_result = await sf.query.soql(query)
         # Loop over records using async iteration
+        # or: await query_result.collect_all() to collect all records into a list
         async for record in query_result:
             print(record.get("AccountId"))
 
+        # Create a new Account
+        await sf.collections.insert(
+            sobject_type="Account",
+            records=[{"Name": "Test Account"}]
+        )
+
 asyncio.run(main())
 ```
 
 
 
-
 ## Exporter
 
 The Exporter library contains a streamlined and "opinionated" way to export data from Salesforce to various formats.  
 
-### 2. Query Records
-```python
-from aio_salesforce.exporter import bulk_query
-
-async def main():
-    # ... authentication code from above ...
-    
-    async with SalesforceConnection(auth_strategy=auth) as sf:
-        # Execute bulk query
-        query_result = await bulk_query(
-            sf=sf,
-            soql_query="SELECT Id, Name, Email FROM Contact LIMIT 1000"
-        )
-        
-        # Process records
-        count = 0
-        async for record in query_result:
-            print(f"Contact: {record['Name']} - {record['Email']}")
-            count += 1
-            
-        print(f"Processed {count} records")
-```
 
 ### 3. Export to Parquet
 ```python
-from aio_salesforce.exporter import bulk_query, write_query_to_parquet
+from aio_sf.exporter import bulk_query, write_query_to_parquet
 
 async def main():
     # ... authentication code from above ...
     
-    async with SalesforceConnection(auth_strategy=auth) as sf:
+    async with SalesforceClient(auth_strategy=auth) as sf:
         # Query with proper schema
         query_result = await bulk_query(
             sf=sf,

{aio_sf-0.1.0b1 → aio_sf-0.1.0b4}/README.md

@@ -1,27 +1,30 @@
 # aio-sf
 
-An async Salesforce library for Python with Bulk API 2.0 support.
+An async Salesforce library for Python.
 
 ## Features
 
 ### ✅ Supported APIs
-- [x] **OAuth Client Credentials Flow** - Automatic authentication
 - [x] **Bulk API 2.0** - Efficient querying of large datasets
 - [x] **Describe API** - Field metadata and object descriptions
 - [x] **SOQL Query API** - Standard Salesforce queries
-
-### 🔄 Planned APIs
-- [ ] **SObjects API** - Standard CRUD operations
+- [x] **SObjects Collections API** - CRUD on collections of SObjects (up to 2000 records at a time)
 - [ ] **Tooling API** - Development and deployment tools
 - [ ] **Bulk API 1.0** - Legacy bulk operations
 - [ ] **Streaming API** - Real-time event streaming
 
+### ✅ Supported Authentication Strategies
+- [x] **OAuth Client Credentials** - Automatic authentication
+- [x] **Static Token** - Existing access tokens
+- [x] **Refresh Token** - Refresh token flow
+- [x] **SFDX CLI** - Login by grabbing a token from the SFDX CLI
+- [ ] **Password Authentication** - Password + ST authentication (soap login)
+
 ### 🚀 Export Features
 - [x] **Parquet Export** - Efficient columnar storage with schema mapping
 - [x] **CSV Export** - Simple text format export
 - [x] **Resume Support** - Resume interrupted queries using job IDs
 - [x] **Streaming Processing** - Memory-efficient processing of large datasets
-- [x] **Type Mapping** - Automatic Salesforce to PyArrow type conversion
 
 ## Installation
 
@@ -43,7 +46,7 @@ uv add "aio-sf[exporter]"
 ```python
 import asyncio
 import os
-from aio_salesforce import SalesforceConnection, ClientCredentialsAuth
+from aio_sf import SalesforceClient, ClientCredentialsAuth
 
 async def main():
     auth = ClientCredentialsAuth(
@@ -52,7 +55,7 @@ async def main():
         instance_url=os.getenv('SF_INSTANCE_URL'),
     )
     
-    async with SalesforceConnection(auth_strategy=auth) as sf:
+    async with SalesforceClient(auth_strategy=auth) as sf:
         print(f"✅ Connected to: {sf.instance_url}")
 
         sobjects = await sf.describe.list_sobjects()
@@ -72,50 +75,34 @@ async def main():
 
         query_result = await sf.query.soql(query)
         # Loop over records using async iteration
+        # or: await query_result.collect_all() to collect all records into a list
         async for record in query_result:
             print(record.get("AccountId"))
 
+        # Create a new Account
+        await sf.collections.insert(
+            sobject_type="Account",
+            records=[{"Name": "Test Account"}]
+        )
+
 asyncio.run(main())
 ```
 
 
 
-
 ## Exporter
 
 The Exporter library contains a streamlined and "opinionated" way to export data from Salesforce to various formats.  
 
-### 2. Query Records
-```python
-from aio_salesforce.exporter import bulk_query
-
-async def main():
-    # ... authentication code from above ...
-    
-    async with SalesforceConnection(auth_strategy=auth) as sf:
-        # Execute bulk query
-        query_result = await bulk_query(
-            sf=sf,
-            soql_query="SELECT Id, Name, Email FROM Contact LIMIT 1000"
-        )
-        
-        # Process records
-        count = 0
-        async for record in query_result:
-            print(f"Contact: {record['Name']} - {record['Email']}")
-            count += 1
-            
-        print(f"Processed {count} records")
-```
 
 ### 3. Export to Parquet
 ```python
-from aio_salesforce.exporter import bulk_query, write_query_to_parquet
+from aio_sf.exporter import bulk_query, write_query_to_parquet
 
 async def main():
     # ... authentication code from above ...
     
-    async with SalesforceConnection(auth_strategy=auth) as sf:
+    async with SalesforceClient(auth_strategy=auth) as sf:
         # Query with proper schema
         query_result = await bulk_query(
             sf=sf,

{aio_sf-0.1.0b1 → aio_sf-0.1.0b4}/RELEASE.md

@@ -26,12 +26,7 @@
 - **Purpose**: Test your packaging pipeline
 
 ### Tagged Push → PyPI  
-1. **Update version** in `src/aio_salesforce/__init__.py`:
-   ```python
-   __version__ = "0.2.0"  # Update this
-   ```
-
-2. **Create and push tag**:
+1. **Create and push tag** (version is automatically derived from tag):
    ```bash
    git add -A
    git commit -m "Release v0.2.0"
@@ -39,7 +34,7 @@
    git push origin main --tags
    ```
 
-3. **Automatic PyPI Publishing**:
+2. **Automatic PyPI Publishing**:
    - GitHub Actions detects the tag
    - Builds and publishes to PyPI automatically
    - Requires manual approval in the `pypi` environment
@@ -71,14 +66,19 @@ pip install --index-url https://test.pypi.org/simple/ aio-salesforce
 
 ## Version Strategy
 
+### Automatic Versioning
+- **Version is automatically derived from Git tags** - no manual version updates needed!
+- **Tagged commits**: Use the exact tag (e.g., `v0.2.0` → version `0.2.0`)
+- **Development builds**: Auto-generate dev versions (e.g., `0.1.0b3.dev0+gf2b7d84`)
+
+### Semantic Versioning
 - **Patch** (0.1.1): Bug fixes, small improvements
-- **Minor** (0.2.0): New features, backwards compatible
+- **Minor** (0.2.0): New features, backwards compatible  
 - **Major** (1.0.0): Breaking changes
 
 ## Checklist Before Release
 
-- [ ] Update version in `__init__.py`
-- [ ] Update CHANGELOG (if you have one)
 - [ ] All tests passing in CI
-- [ ] Documentation updated
+- [ ] Documentation updated  
 - [ ] No breaking changes (or properly documented)
+- [ ] Choose appropriate tag name (version is automatically derived from tag)

{aio_sf-0.1.0b1 → aio_sf-0.1.0b4}/pyproject.toml

@@ -1,11 +1,11 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"
 
 [project]
 name = "aio-sf"
 dynamic = ["version"]
-description = "Async Salesforce library for Python with Bulk API 2.0 support"
+description = "Async Salesforce library for Python"
 readme = "README.md"
 license = {file = "LICENSE"}
 authors = [
@@ -16,12 +16,10 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.11"
 dependencies = [
     "httpx>=0.25.0",
     "pydantic>=2.0.0",
@@ -39,6 +37,7 @@ all = [
 ]
 dev = [
     "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
     "pytest-cov>=4.0.0",
     "pytest-mock>=3.10.0",
     "black>=23.0.0",
@@ -54,18 +53,18 @@ Repository = "https://github.com/callawaycloud/aio-salesforce"
 Issues = "https://github.com/callawaycloud/aio-salesforce/issues"
 
 # [project.scripts]
-# aio-salesforce = "aio_salesforce.cli:main"  # CLI not implemented yet
+# aio-sf = "aio_sf.cli:main"  # CLI not implemented yet
 
 [tool.hatch.version]
-path = "src/aio_salesforce/__init__.py"
+source = "vcs"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/aio_salesforce"]
+packages = ["src/aio_sf"]
 
 # Black configuration
 [tool.black]
 line-length = 88
-target-version = ['py39', 'py310', 'py311', 'py312']
+target-version = ['py311', 'py312']
 include = '\.pyi?$'
 extend-exclude = '''
 /(
@@ -83,7 +82,7 @@ extend-exclude = '''
 
 # Ruff configuration
 [tool.ruff]
-target-version = "py39"
+target-version = "py311"
 line-length = 88
 select = [
     "E",  # pycodestyle errors
@@ -105,7 +104,7 @@ ignore = [
 
 # MyPy configuration
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.11"
 check_untyped_defs = true
 disallow_any_generics = true
 disallow_incomplete_defs = true
@@ -146,3 +145,10 @@ exclude_lines = [
     "class .*\\bProtocol\\):",
     "@(abc\\.)?abstractmethod",
 ]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.4.2",
+    "pytest-asyncio>=1.2.0",
+    "pytest-cov>=7.0.0",
+]

aio_sf-0.1.0b4/pytest.ini

@@ -0,0 +1,11 @@
+[pytest]
+minversion = 7.0
+addopts = 
+    -ra
+    --strict-markers
+    --strict-config
+testpaths = tests
+asyncio_mode = auto
+markers =
+    slow: marks tests as slow (deselect with '-m "not slow"')
+    integration: marks tests as integration tests (require real Salesforce org)