rezen 1.0.0__tar.gz

rezen-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 The Perry Group
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

rezen-1.0.0/MANIFEST.in

@@ -0,0 +1,16 @@
+include README.md
+include LICENSE
+include requirements.txt
+include requirements-dev.txt
+include pyproject.toml
+recursive-include rezen *.py
+recursive-include rezen py.typed
+recursive-include docs *.md
+recursive-exclude tests *
+recursive-exclude venv *
+recursive-exclude .git *
+recursive-exclude __pycache__ *
+recursive-exclude *.pyc *
+recursive-exclude .pytest_cache *
+recursive-exclude .mypy_cache *
+recursive-exclude htmlcov * 

rezen-1.0.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: rezen
+Version: 1.0.0
+Summary: Python wrapper for The Real Brokerage ReZEN API - Transaction Builder, Transactions, and Teams management
+Author-email: The Perry Group <dev@theperrygroup.com>
+Maintainer-email: The Perry Group <dev@theperrygroup.com>
+License: MIT
+Project-URL: Homepage, https://github.com/theperrygroup/rezen
+Project-URL: Documentation, https://github.com/theperrygroup/rezen/blob/main/docs/README.md
+Project-URL: Repository, https://github.com/theperrygroup/rezen
+Project-URL: Bug Tracker, https://github.com/theperrygroup/rezen/issues
+Project-URL: Changelog, https://github.com/theperrygroup/rezen/releases
+Keywords: real-estate,api,transactions,realty,rezen,the-real-brokerage,real-estate-api,transaction-management
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+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 :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: responses>=0.23.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: pylint>=2.17.0; extra == "dev"
+Dynamic: license-file
+
+# ReZEN API Python Client
+
+A comprehensive Python wrapper for the ReZEN (Real Estate) API, providing easy access to transaction builder, transactions, teams, and related real estate services.
+
+## 🚀 Quick Start
+
+```python
+from rezen import RezenClient
+
+# Initialize client (uses REZEN_API_KEY environment variable)
+client = RezenClient()
+
+# Or provide API key directly
+client = RezenClient(api_key="your_api_key_here")
+
+# Create a transaction builder
+response = client.transaction_builder.create_transaction_builder({
+    "type": "PURCHASE",
+    "property": {
+        "address": "123 Main St",
+        "city": "Anytown",
+        "state": "CA",
+        "zipCode": "12345"
+    }
+})
+
+# Search for teams
+teams = client.teams.search_teams(status="ACTIVE")
+
+# Get transaction details
+transaction = client.transactions.get_transaction("transaction-id")
+```
+
+## 📦 Installation
+
+```bash
+pip install rezen-api  # (when published)
+
+# Or for development:
+git clone <repository-url>
+cd rezen
+pip install -r requirements-dev.txt
+```
+
+## 🔧 Setup
+
+1. **Get your API key** from the ReZEN platform
+2. **Set environment variable**:
+   ```bash
+   export REZEN_API_KEY="your_api_key_here"
+   ```
+3. **Or create a `.env` file**:
+   ```
+   REZEN_API_KEY=your_api_key_here
+   ```
+
+## 🔄 Main Workflows
+
+### 🏗️ Transaction Builder Workflows
+- **Create transactions** from scratch
+- **Import existing transactions** 
+- **Manage participants** (buyers, sellers, agents)
+- **Submit transactions** for processing
+- **Update transaction details** and contracts
+
+### 📋 Transaction Management Workflows  
+- **Retrieve transaction details** and status
+- **Manage participants** and their information
+- **Handle financial operations** (payments, fees)
+- **Escrow management** (deposits, documentation)
+- **Generate reports** and summaries
+
+### 👥 Team Management Workflows
+- **Search teams** by name, status, or type
+- **Get team details** and member information
+- **Filter by team types** (Normal, Platinum, Group, etc.)
+
+### 🧪 Testing & Development Workflows
+- **Unit testing** with mocked responses
+- **Live API testing** with real endpoints
+- **Error handling** and validation
+- **Coverage reporting**
+
+## 📖 Detailed Documentation
+
+For comprehensive workflow documentation, see:
+
+- **[Transaction Builder Workflows](docs/workflows/transaction-builder.md)** - Creating and managing transaction builders
+- **[Transaction Management Workflows](docs/workflows/transactions.md)** - Working with existing transactions
+- **[Team Management Workflows](docs/workflows/teams.md)** - Finding and managing teams
+- **[Authentication & Setup](docs/workflows/authentication.md)** - API key setup and configuration
+- **[Testing Workflows](docs/workflows/testing.md)** - Development and testing procedures
+- **[Error Handling](docs/workflows/error-handling.md)** - Common errors and solutions
+
+## 🏗️ Client Structure
+
+The ReZEN client provides access to different API sections:
+
+```python
+client = RezenClient()
+
+# Transaction Builder API (89 endpoints)
+client.transaction_builder.create_transaction_builder()
+client.transaction_builder.add_buyer()
+client.transaction_builder.submit_transaction()
+
+# Transactions API (49 endpoints) 
+client.transactions.get_transaction()
+client.transactions.create_participant()
+client.transactions.get_summary_pdf()
+
+# Teams API (2 endpoints)
+client.teams.search_teams()
+client.teams.get_team_without_agents()
+```
+
+## 🎯 Key Features
+
+- **✅ 140+ endpoints** implemented with full coverage
+- **🔒 Type-safe** with comprehensive type hints
+- **🧪 100% test coverage** with pytest
+- **📝 Complete documentation** with examples
+- **🔧 Easy configuration** with environment variables
+- **🚨 Robust error handling** with custom exceptions
+- **🔄 Async support** planned for future versions
+
+## 🛠️ Development
+
+```bash
+# Clone and setup
+git clone <repository-url>
+cd rezen
+python -m venv venv
+source venv/bin/activate  # or `venv\Scripts\activate` on Windows
+pip install -r requirements-dev.txt
+
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=rezen --cov-report=html
+
+# Format code
+black rezen tests
+isort rezen tests
+
+# Type checking
+mypy rezen
+```
+
+## 📄 API Coverage
+
+| API Section | Endpoints | Status |
+|-------------|-----------|--------|
+| Transaction Builder | 89 | ✅ Complete |
+| Transactions | 49 | ✅ Complete |  
+| Teams | 2 | ✅ Complete |
+| **Total** | **140** | **✅ Complete** |
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes with tests
+4. Ensure 100% test coverage
+5. Submit a pull request
+
+See [STYLE_GUIDE.md](STYLE_GUIDE.md) for coding standards.
+
+## 📝 License
+
+[Add your license here]
+
+## 🆘 Support
+
+- **Documentation**: [docs/](docs/)
+- **Issues**: [Create an issue](../../issues)
+- **API Reference**: [docs/api-reference/](docs/api-reference/) 

rezen-1.0.0/README.md

@@ -0,0 +1,178 @@
+# ReZEN API Python Client
+
+A comprehensive Python wrapper for the ReZEN (Real Estate) API, providing easy access to transaction builder, transactions, teams, and related real estate services.
+
+## 🚀 Quick Start
+
+```python
+from rezen import RezenClient
+
+# Initialize client (uses REZEN_API_KEY environment variable)
+client = RezenClient()
+
+# Or provide API key directly
+client = RezenClient(api_key="your_api_key_here")
+
+# Create a transaction builder
+response = client.transaction_builder.create_transaction_builder({
+    "type": "PURCHASE",
+    "property": {
+        "address": "123 Main St",
+        "city": "Anytown",
+        "state": "CA",
+        "zipCode": "12345"
+    }
+})
+
+# Search for teams
+teams = client.teams.search_teams(status="ACTIVE")
+
+# Get transaction details
+transaction = client.transactions.get_transaction("transaction-id")
+```
+
+## 📦 Installation
+
+```bash
+pip install rezen-api  # (when published)
+
+# Or for development:
+git clone <repository-url>
+cd rezen
+pip install -r requirements-dev.txt
+```
+
+## 🔧 Setup
+
+1. **Get your API key** from the ReZEN platform
+2. **Set environment variable**:
+   ```bash
+   export REZEN_API_KEY="your_api_key_here"
+   ```
+3. **Or create a `.env` file**:
+   ```
+   REZEN_API_KEY=your_api_key_here
+   ```
+
+## 🔄 Main Workflows
+
+### 🏗️ Transaction Builder Workflows
+- **Create transactions** from scratch
+- **Import existing transactions** 
+- **Manage participants** (buyers, sellers, agents)
+- **Submit transactions** for processing
+- **Update transaction details** and contracts
+
+### 📋 Transaction Management Workflows  
+- **Retrieve transaction details** and status
+- **Manage participants** and their information
+- **Handle financial operations** (payments, fees)
+- **Escrow management** (deposits, documentation)
+- **Generate reports** and summaries
+
+### 👥 Team Management Workflows
+- **Search teams** by name, status, or type
+- **Get team details** and member information
+- **Filter by team types** (Normal, Platinum, Group, etc.)
+
+### 🧪 Testing & Development Workflows
+- **Unit testing** with mocked responses
+- **Live API testing** with real endpoints
+- **Error handling** and validation
+- **Coverage reporting**
+
+## 📖 Detailed Documentation
+
+For comprehensive workflow documentation, see:
+
+- **[Transaction Builder Workflows](docs/workflows/transaction-builder.md)** - Creating and managing transaction builders
+- **[Transaction Management Workflows](docs/workflows/transactions.md)** - Working with existing transactions
+- **[Team Management Workflows](docs/workflows/teams.md)** - Finding and managing teams
+- **[Authentication & Setup](docs/workflows/authentication.md)** - API key setup and configuration
+- **[Testing Workflows](docs/workflows/testing.md)** - Development and testing procedures
+- **[Error Handling](docs/workflows/error-handling.md)** - Common errors and solutions
+
+## 🏗️ Client Structure
+
+The ReZEN client provides access to different API sections:
+
+```python
+client = RezenClient()
+
+# Transaction Builder API (89 endpoints)
+client.transaction_builder.create_transaction_builder()
+client.transaction_builder.add_buyer()
+client.transaction_builder.submit_transaction()
+
+# Transactions API (49 endpoints) 
+client.transactions.get_transaction()
+client.transactions.create_participant()
+client.transactions.get_summary_pdf()
+
+# Teams API (2 endpoints)
+client.teams.search_teams()
+client.teams.get_team_without_agents()
+```
+
+## 🎯 Key Features
+
+- **✅ 140+ endpoints** implemented with full coverage
+- **🔒 Type-safe** with comprehensive type hints
+- **🧪 100% test coverage** with pytest
+- **📝 Complete documentation** with examples
+- **🔧 Easy configuration** with environment variables
+- **🚨 Robust error handling** with custom exceptions
+- **🔄 Async support** planned for future versions
+
+## 🛠️ Development
+
+```bash
+# Clone and setup
+git clone <repository-url>
+cd rezen
+python -m venv venv
+source venv/bin/activate  # or `venv\Scripts\activate` on Windows
+pip install -r requirements-dev.txt
+
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=rezen --cov-report=html
+
+# Format code
+black rezen tests
+isort rezen tests
+
+# Type checking
+mypy rezen
+```
+
+## 📄 API Coverage
+
+| API Section | Endpoints | Status |
+|-------------|-----------|--------|
+| Transaction Builder | 89 | ✅ Complete |
+| Transactions | 49 | ✅ Complete |  
+| Teams | 2 | ✅ Complete |
+| **Total** | **140** | **✅ Complete** |
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes with tests
+4. Ensure 100% test coverage
+5. Submit a pull request
+
+See [STYLE_GUIDE.md](STYLE_GUIDE.md) for coding standards.
+
+## 📝 License
+
+[Add your license here]
+
+## 🆘 Support
+
+- **Documentation**: [docs/](docs/)
+- **Issues**: [Create an issue](../../issues)
+- **API Reference**: [docs/api-reference/](docs/api-reference/) 

rezen-1.0.0/docs/README.md

@@ -0,0 +1,166 @@
+# ReZEN API Documentation
+
+Welcome to the comprehensive documentation for the ReZEN Python API client.
+
+## 📖 Documentation Structure
+
+### 🔄 Workflow Documentation
+
+Complete guides for common patterns and use cases:
+
+- **[🏗️ Transaction Builder Workflows](workflows/transaction-builder.md)**  
+  Create and manage transaction builders from scratch, add participants, and submit transactions
+
+- **[📋 Transaction Management Workflows](workflows/transactions.md)**  
+  Work with live transactions, manage participants, handle finances, and generate reports
+
+- **[👥 Team Management Workflows](workflows/teams.md)**  
+  Search for teams, get team details, and integrate teams with transaction workflows
+
+- **[🔑 Authentication & Setup](workflows/authentication.md)**  
+  Configure API keys, set up environments, and validate authentication
+
+- **[🚨 Error Handling Workflows](workflows/error-handling.md)**  
+  Handle errors gracefully, implement retry logic, and troubleshoot common issues
+
+- **[🧪 Testing Workflows](workflows/testing.md)**  
+  Test your integration with unit tests, mocked responses, and live API testing
+
+### 📚 API Reference
+
+Detailed technical reference (future expansion):
+
+- **[Transaction Builder API](api-reference/)** - Endpoint specifications and examples
+- **[Transactions API](api-reference/)** - Complete API reference  
+- **[Teams API](api-reference/)** - Team endpoints documentation
+
+## 🚀 Quick Start Paths
+
+### New to ReZEN API?
+1. Start with **[Authentication & Setup](workflows/authentication.md)** to configure your environment
+2. Try **[Teams](workflows/teams.md)** to find your team ID
+3. Follow **[Transaction Builder](workflows/transaction-builder.md)** to create your first transaction
+
+### Building Production Applications?
+1. Review **[Error Handling](workflows/error-handling.md)** for robust applications
+2. Implement **[Testing](workflows/testing.md)** for reliable code
+3. Use **[Transaction Management](workflows/transactions.md)** for live transaction operations
+
+### Integration Developer?
+1. **[Transaction Builder](workflows/transaction-builder.md)** - Core transaction creation
+2. **[Teams](workflows/teams.md)** - Team assignment for agents
+3. **[Error Handling](workflows/error-handling.md)** - Production-ready error handling
+
+## 🎯 Common Use Cases
+
+### 🏠 Real Estate Transaction Processing
+- Create purchase/sale transactions
+- Assign agents to teams
+- Add buyers, sellers, and service providers
+- Handle escrow and financial operations
+
+### 📊 Agent Management
+- Find agent teams for commission tracking
+- Manage agent participants in transactions
+- Track agent performance across transactions
+
+### 💰 Financial Operations
+- Process commission payments
+- Handle escrow deposits and withdrawals
+- Manage banking information
+- Generate financial reports
+
+### 📄 Documentation & Reporting
+- Generate transaction summaries
+- Export transaction data
+- Create compliance reports
+
+## 🔧 Development Resources
+
+### Code Examples
+Each workflow guide includes complete, runnable examples that you can copy and adapt for your use case.
+
+### Error Handling
+Comprehensive error handling patterns with specific solutions for common issues.
+
+### Testing Support
+Full test suites and mocking strategies for reliable development.
+
+### Best Practices
+Industry-standard patterns for real estate API integration.
+
+## 📋 API Coverage
+
+| API Section | Endpoints | Documentation Status |
+|-------------|-----------|---------------------|
+| Transaction Builder | 89 endpoints | ✅ Complete workflows |
+| Transactions | 49 endpoints | ✅ Complete workflows |
+| Teams | 2 endpoints | ✅ Complete workflows |
+| **Total** | **140 endpoints** | **✅ Complete** |
+
+## 🆘 Getting Help
+
+### Workflow Issues
+- Check the specific workflow guide for your use case
+- Review the **[Error Handling](workflows/error-handling.md)** guide
+- Look at **[Common Issues](workflows/error-handling.md#-common-issues)** sections
+
+### API Questions
+- Consult the workflow documentation for your endpoint
+- Review code examples in the relevant workflow guide
+- Check error handling patterns for API-specific issues
+
+### Setup Problems
+- Start with **[Authentication & Setup](workflows/authentication.md)**
+- Review **[Testing](workflows/testing.md)** for validation approaches
+- Check environment configuration examples
+
+## 🔄 Workflow Connections
+
+The workflow guides are interconnected:
+
+```
+Authentication & Setup
+    ↓
+Teams (find team IDs)
+    ↓
+Transaction Builder (create transactions)
+    ↓
+Transaction Management (work with live transactions)
+    ↓
+Error Handling + Testing (production ready)
+```
+
+## 🚧 Future Documentation
+
+Coming soon:
+- **API Reference** - Detailed endpoint specifications
+- **Webhook Integration** - Real-time transaction updates
+- **Advanced Patterns** - Complex integration scenarios
+- **Performance Optimization** - Scaling best practices
+
+## 🏗️ Contributing to Documentation
+
+Found an issue or want to improve the documentation?
+
+1. **Workflow Improvements** - Suggest better patterns or examples
+2. **Error Solutions** - Share solutions to new error scenarios  
+3. **Use Case Examples** - Contribute real-world integration examples
+4. **Code Samples** - Submit working code examples
+
+---
+
+## 📚 Quick Reference
+
+| Task | Workflow Guide |
+|------|----------------|
+| Set up API access | [Authentication](workflows/authentication.md) |
+| Find your team | [Teams](workflows/teams.md) |
+| Create a transaction | [Transaction Builder](workflows/transaction-builder.md) |
+| Work with live transactions | [Transactions](workflows/transactions.md) |
+| Handle errors | [Error Handling](workflows/error-handling.md) |
+| Test your code | [Testing](workflows/testing.md) |
+
+---
+
+**🎉 Happy coding with the ReZEN API!**