uber-central-rest-client


Nameuber-central-rest-client JSON
Version 1.0.1 PyPI version JSON
download
home_pagehttps://github.com/lymanlabs/uber-central
SummaryOfficial Python client for the Uber Central API - Enterprise Uber ride management
upload_time2025-08-05 05:36:41
maintainerNone
docs_urlNone
authorUber Central Team
requires_python>=3.8
licenseMIT
keywords uber ride booking api client transportation enterprise business ride-sharing mobility travel scheduling fleet corporate expense tracking
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 🚗 Uber Central REST Client

[![PyPI version](https://badge.fury.io/py/uber-central-rest-client.svg)](https://badge.fury.io/py/uber-central-rest-client)
[![Python Support](https://img.shields.io/pypi/pyversions/uber-central-rest-client.svg)](https://pypi.org/project/uber-central-rest-client/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Documentation](https://img.shields.io/badge/docs-API%20Reference-blue)](https://apparel-scraper--uber-central-api-serve.modal.run/docs)

**Official Python client for the Uber Central API** - Enterprise-grade Uber ride management with comprehensive user tracking, usage analytics, and audit trails.

## ✨ Features

- 🔑 **Simple Authentication** - Single API key setup
- 👥 **User Management** - Client account system with unique identifiers
- 💰 **Ride Estimates** - Get prices for all vehicle types (UberX, Comfort, Black, etc.)
- 🚗 **Immediate Booking** - Book rides for immediate pickup
- 📅 **Scheduled Rides** - Schedule rides for future pickup (up to 30 days)
- 📊 **Usage Analytics** - Comprehensive usage tracking and ride history
- 🔍 **Ride Management** - Real-time status tracking and cancellation
- 🛡️ **Enterprise Ready** - Full audit trails, expense tracking, and compliance features
- 🎯 **Type Safe** - Full type hints and Pydantic models
- ⚡ **Easy Integration** - Simple, intuitive API

## 🚀 Quick Start

### Installation

```bash
pip install uber-central-rest-client
```

### Basic Usage

```python
from uber_central_client import UberCentralClient

# Initialize client
client = UberCentralClient(api_key="your-api-key")

# Create user account
user = client.initialize_user(
    name="John Doe",
    email="john@company.com",
    metadata={"department": "Sales", "cost_center": "SC-100"}
)
client_id = user.client_id

# Get ride estimates
estimates = client.get_estimates(
    client_id=client_id,
    pickup_address="Union Square, San Francisco, CA",
    dropoff_address="SFO Airport"
)

print("Available rides:")
for estimate in estimates:
    print(f"  {estimate.display_name}: {estimate.price_estimate}")

# Book immediate ride
ride = client.book_ride(
    client_id=client_id,
    pickup_address="Union Square, San Francisco, CA", 
    dropoff_address="SFO Airport",
    rider_name="John Doe",
    rider_phone="9167995790",
    message_to_driver="Terminal 3 pickup"
)

print(f"Ride booked! ID: {ride.ride_id}")
```

## 📋 API Reference

### 🔧 Client Initialization

```python
from uber_central_client import UberCentralClient

client = UberCentralClient(
    api_key="your-api-key",
    base_url="https://apparel-scraper--uber-central-api-serve.modal.run",  # optional
    timeout=30  # optional
)
```

### 👥 User Management

```python
# Create new user account
user = client.initialize_user(
    name="Alice Johnson",           # optional
    email="alice@company.com",      # optional
    metadata={                      # optional
        "department": "Marketing",
        "cost_center": "MC-200",
        "manager": "Bob Smith"
    }
)
client_id = user.client_id  # Save this for all future requests
```

### 💰 Get Ride Estimates

```python
estimates = client.get_estimates(
    client_id="your-client-id",
    pickup_address="123 Main St, San Francisco, CA",
    dropoff_address="456 Market St, San Francisco, CA",
    capacity=2  # optional, default: 1
)

# Available vehicle types: UberX, Comfort, UberXL, Black, Black SUV, Green, etc.
for estimate in estimates:
    print(f"{estimate.display_name}: {estimate.price_estimate} "
          f"(ETA: {estimate.estimate_time_minutes} min)")
```

### 🚗 Book Immediate Ride

```python
ride = client.book_ride(
    client_id="your-client-id",
    pickup_address="123 Main St, San Francisco, CA",
    dropoff_address="456 Market St, San Francisco, CA",
    rider_name="John Doe",
    rider_phone="9167995790",
    product_id="uber-x-product-id",           # optional - from estimates
    message_to_driver="Main entrance pickup", # optional
    expense_memo="Client meeting transport"   # optional
)

print(f"Ride booked: {ride.ride_id}")
```

### 📅 Schedule Future Ride

```python
from datetime import datetime, timedelta

# Schedule ride for 2 hours from now
pickup_time = datetime.now() + timedelta(hours=2)

ride = client.schedule_ride(
    client_id="your-client-id",
    pickup_address="SFO Airport Terminal 3",
    dropoff_address="123 Main St, San Francisco, CA",
    rider_name="Jane Doe",
    rider_phone="9167995790",
    pickup_time=pickup_time,  # or ISO string: "2025-08-05T14:30:00-07:00"
    message_to_driver="Flight AA 1234 arrival"
)
```

### 🔍 Ride Management

```python
# Get ride status
status = client.get_ride_status("ride-id")
print(f"Status: {status.status}")
print(f"Driver: {status.driver_name}")

# Cancel ride
result = client.cancel_ride("ride-id")
print(f"Cancelled: {result.status}")
```

### 📊 Analytics & Reporting

```python
# Get client usage statistics
stats = client.get_client_stats("client-id")
print(f"Total rides: {stats.total_rides}")
print(f"API calls: {stats.total_api_calls}")

# Get detailed usage history
usage = client.get_usage_history("client-id", limit=50)
for record in usage.usage_history:
    print(f"{record['endpoint']} at {record['timestamp']}")

# Get ride history
rides = client.get_ride_history("client-id", limit=25)
for ride in rides.ride_history:
    print(f"Ride {ride['ride_id']}: {ride['pickup_address']} → {ride['dropoff_address']}")
```

## 🏢 Enterprise Features

### User Management & Tracking
- **Client ID System** - Unique identifiers for each user/department
- **Flexible Metadata** - Store custom fields (department, cost center, etc.)
- **Usage Analytics** - Track API calls, ride patterns, and costs
- **Audit Trails** - Complete history of all operations

### Expense & Compliance
- **Expense Memos** - Attach internal tracking notes to rides
- **Driver Messages** - Special instructions for drivers
- **Complete History** - All ride details stored permanently
- **Usage Reporting** - Detailed analytics for expense reporting

### Safety & Control
- **No Unwanted Calls** - Automatic calling disabled by default
- **SMS Notifications** - Riders receive booking confirmations
- **Driver Verification** - All rides through verified Uber platform
- **Cancellation Control** - Easy ride cancellation with policy compliance

## 🛠️ Error Handling

The client provides specific exception types for different error scenarios:

```python
from uber_central_client import (
    UberCentralClient, 
    AuthenticationError, 
    ClientNotFoundError,
    ValidationError,
    BookingError
)

try:
    client = UberCentralClient(api_key="invalid-key")
except AuthenticationError:
    print("Invalid API key")

try:
    estimates = client.get_estimates(
        client_id="invalid-client",
        pickup_address="123 Main St",
        dropoff_address="456 Oak Ave"
    )
except ClientNotFoundError:
    print("Client not found - call initialize_user() first")
except ValidationError as e:
    print(f"Invalid request: {e}")
except BookingError as e:
    print(f"Booking failed: {e}")
```

### Exception Types
- **`AuthenticationError`** - Invalid API key
- **`ClientNotFoundError`** - Invalid client_id
- **`RideNotFoundError`** - Invalid ride_id
- **`ValidationError`** - Invalid request parameters
- **`BookingError`** - Ride booking/scheduling failures
- **`RateLimitError`** - API rate limits exceeded
- **`ServiceUnavailableError`** - Temporary service issues

## 🔧 Advanced Usage

### Custom Configuration

```python
from uber_central_client import UberCentralClient

# Custom timeouts and base URL
client = UberCentralClient(
    api_key="your-api-key",
    base_url="https://your-custom-domain.com",
    timeout=60  # 60 second timeout
)

# Health check
health = client.health_check()
print(f"API Status: {health.get('status')}")
```

### Batch Operations

```python
# Create multiple users
users = []
for i in range(5):
    user = client.initialize_user(
        name=f"User {i}",
        metadata={"batch": "onboarding-2025"}
    )
    users.append(user.client_id)

# Get estimates for multiple locations
locations = [
    ("Downtown", "Airport"),
    ("Office", "Hotel"),
    ("Station", "Mall")
]

for pickup, dropoff in locations:
    estimates = client.get_estimates(
        client_id=users[0],
        pickup_address=pickup,
        dropoff_address=dropoff
    )
    print(f"{pickup} → {dropoff}: {len(estimates)} options")
```

### Vehicle Type Selection

```python
from uber_central_client import VehicleTypes

estimates = client.get_estimates(client_id, pickup, dropoff)

# Find specific vehicle types
uberx_estimate = next(
    (est for est in estimates if est.display_name == VehicleTypes.UBER_X), 
    None
)

comfort_estimate = next(
    (est for est in estimates if est.display_name == VehicleTypes.COMFORT), 
    None
)

if uberx_estimate:
    print(f"UberX: {uberx_estimate.price_estimate}")
if comfort_estimate:
    print(f"Comfort: {comfort_estimate.price_estimate}")
```

## 📚 Complete Examples

### Corporate Booking System

```python
from uber_central_client import UberCentralClient
from datetime import datetime, timedelta

class CorporateRideManager:
    def __init__(self, api_key):
        self.client = UberCentralClient(api_key)
        
    def onboard_employee(self, name, email, department, cost_center):
        """Create new employee account."""
        user = self.client.initialize_user(
            name=name,
            email=email,
            metadata={
                "department": department,
                "cost_center": cost_center,
                "onboarded_at": datetime.now().isoformat()
            }
        )
        return user.client_id
    
    def book_airport_ride(self, client_id, employee_name, phone, flight_info):
        """Book airport pickup with flight details."""
        ride = self.client.book_ride(
            client_id=client_id,
            pickup_address="SFO Airport",
            dropoff_address="123 Office St, San Francisco, CA",
            rider_name=employee_name,
            rider_phone=phone,
            message_to_driver=f"Flight pickup: {flight_info}",
            expense_memo=f"Airport pickup - {flight_info}"
        )
        return ride.ride_id
    
    def generate_usage_report(self, client_id):
        """Generate usage report for employee."""
        stats = self.client.get_client_stats(client_id)
        usage = self.client.get_usage_history(client_id)
        rides = self.client.get_ride_history(client_id)
        
        return {
            "summary": stats,
            "detailed_usage": usage,
            "ride_history": rides
        }

# Usage
manager = CorporateRideManager("your-api-key")

# Onboard new employee
client_id = manager.onboard_employee(
    name="Alice Johnson",
    email="alice@company.com", 
    department="Sales",
    cost_center="SALES-2025"
)

# Book airport ride
ride_id = manager.book_airport_ride(
    client_id=client_id,
    employee_name="Alice Johnson",
    phone="9167995790",
    flight_info="United Airlines UA 123"
)

# Generate monthly report
report = manager.generate_usage_report(client_id)
```

## 🔗 Related Resources

- **📖 API Documentation**: https://apparel-scraper--uber-central-api-serve.modal.run/docs
- **🌐 Live API**: https://apparel-scraper--uber-central-api-serve.modal.run
- **📁 GitHub Repository**: https://github.com/lymanlabs/uber-central
- **🐛 Issue Tracker**: https://github.com/lymanlabs/uber-central/issues

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🤝 Support

- **Documentation**: Check the [API Reference](https://apparel-scraper--uber-central-api-serve.modal.run/docs)
- **Issues**: Report bugs on [GitHub Issues](https://github.com/lymanlabs/uber-central/issues)  
- **Questions**: Contact support@uber-central.com

## 🎯 Changelog

### v1.0.0 (2025-01-04)
- Initial release
- Complete API client implementation
- Full type safety with Pydantic models
- Comprehensive error handling
- Enterprise features (user management, analytics, audit trails)
- Production-ready with extensive testing

---

**🚀 Ready to integrate enterprise Uber ride management into your application!**

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/lymanlabs/uber-central",
    "name": "uber-central-rest-client",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "Uber Central Team <support@uber-central.com>",
    "keywords": "uber, ride, booking, api, client, transportation, enterprise, business, ride-sharing, mobility, travel, scheduling, fleet, corporate, expense, tracking",
    "author": "Uber Central Team",
    "author_email": "Uber Central Team <support@uber-central.com>",
    "download_url": "https://files.pythonhosted.org/packages/1a/58/23178e73ed25f7eea248fdae1e7f2fcb6f907182349c3088bbec4b8024e1/uber_central_rest_client-1.0.1.tar.gz",
    "platform": null,
    "description": "# \ud83d\ude97 Uber Central REST Client\n\n[![PyPI version](https://badge.fury.io/py/uber-central-rest-client.svg)](https://badge.fury.io/py/uber-central-rest-client)\n[![Python Support](https://img.shields.io/pypi/pyversions/uber-central-rest-client.svg)](https://pypi.org/project/uber-central-rest-client/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Documentation](https://img.shields.io/badge/docs-API%20Reference-blue)](https://apparel-scraper--uber-central-api-serve.modal.run/docs)\n\n**Official Python client for the Uber Central API** - Enterprise-grade Uber ride management with comprehensive user tracking, usage analytics, and audit trails.\n\n## \u2728 Features\n\n- \ud83d\udd11 **Simple Authentication** - Single API key setup\n- \ud83d\udc65 **User Management** - Client account system with unique identifiers\n- \ud83d\udcb0 **Ride Estimates** - Get prices for all vehicle types (UberX, Comfort, Black, etc.)\n- \ud83d\ude97 **Immediate Booking** - Book rides for immediate pickup\n- \ud83d\udcc5 **Scheduled Rides** - Schedule rides for future pickup (up to 30 days)\n- \ud83d\udcca **Usage Analytics** - Comprehensive usage tracking and ride history\n- \ud83d\udd0d **Ride Management** - Real-time status tracking and cancellation\n- \ud83d\udee1\ufe0f **Enterprise Ready** - Full audit trails, expense tracking, and compliance features\n- \ud83c\udfaf **Type Safe** - Full type hints and Pydantic models\n- \u26a1 **Easy Integration** - Simple, intuitive API\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\npip install uber-central-rest-client\n```\n\n### Basic Usage\n\n```python\nfrom uber_central_client import UberCentralClient\n\n# Initialize client\nclient = UberCentralClient(api_key=\"your-api-key\")\n\n# Create user account\nuser = client.initialize_user(\n    name=\"John Doe\",\n    email=\"john@company.com\",\n    metadata={\"department\": \"Sales\", \"cost_center\": \"SC-100\"}\n)\nclient_id = user.client_id\n\n# Get ride estimates\nestimates = client.get_estimates(\n    client_id=client_id,\n    pickup_address=\"Union Square, San Francisco, CA\",\n    dropoff_address=\"SFO Airport\"\n)\n\nprint(\"Available rides:\")\nfor estimate in estimates:\n    print(f\"  {estimate.display_name}: {estimate.price_estimate}\")\n\n# Book immediate ride\nride = client.book_ride(\n    client_id=client_id,\n    pickup_address=\"Union Square, San Francisco, CA\", \n    dropoff_address=\"SFO Airport\",\n    rider_name=\"John Doe\",\n    rider_phone=\"9167995790\",\n    message_to_driver=\"Terminal 3 pickup\"\n)\n\nprint(f\"Ride booked! ID: {ride.ride_id}\")\n```\n\n## \ud83d\udccb API Reference\n\n### \ud83d\udd27 Client Initialization\n\n```python\nfrom uber_central_client import UberCentralClient\n\nclient = UberCentralClient(\n    api_key=\"your-api-key\",\n    base_url=\"https://apparel-scraper--uber-central-api-serve.modal.run\",  # optional\n    timeout=30  # optional\n)\n```\n\n### \ud83d\udc65 User Management\n\n```python\n# Create new user account\nuser = client.initialize_user(\n    name=\"Alice Johnson\",           # optional\n    email=\"alice@company.com\",      # optional\n    metadata={                      # optional\n        \"department\": \"Marketing\",\n        \"cost_center\": \"MC-200\",\n        \"manager\": \"Bob Smith\"\n    }\n)\nclient_id = user.client_id  # Save this for all future requests\n```\n\n### \ud83d\udcb0 Get Ride Estimates\n\n```python\nestimates = client.get_estimates(\n    client_id=\"your-client-id\",\n    pickup_address=\"123 Main St, San Francisco, CA\",\n    dropoff_address=\"456 Market St, San Francisco, CA\",\n    capacity=2  # optional, default: 1\n)\n\n# Available vehicle types: UberX, Comfort, UberXL, Black, Black SUV, Green, etc.\nfor estimate in estimates:\n    print(f\"{estimate.display_name}: {estimate.price_estimate} \"\n          f\"(ETA: {estimate.estimate_time_minutes} min)\")\n```\n\n### \ud83d\ude97 Book Immediate Ride\n\n```python\nride = client.book_ride(\n    client_id=\"your-client-id\",\n    pickup_address=\"123 Main St, San Francisco, CA\",\n    dropoff_address=\"456 Market St, San Francisco, CA\",\n    rider_name=\"John Doe\",\n    rider_phone=\"9167995790\",\n    product_id=\"uber-x-product-id\",           # optional - from estimates\n    message_to_driver=\"Main entrance pickup\", # optional\n    expense_memo=\"Client meeting transport\"   # optional\n)\n\nprint(f\"Ride booked: {ride.ride_id}\")\n```\n\n### \ud83d\udcc5 Schedule Future Ride\n\n```python\nfrom datetime import datetime, timedelta\n\n# Schedule ride for 2 hours from now\npickup_time = datetime.now() + timedelta(hours=2)\n\nride = client.schedule_ride(\n    client_id=\"your-client-id\",\n    pickup_address=\"SFO Airport Terminal 3\",\n    dropoff_address=\"123 Main St, San Francisco, CA\",\n    rider_name=\"Jane Doe\",\n    rider_phone=\"9167995790\",\n    pickup_time=pickup_time,  # or ISO string: \"2025-08-05T14:30:00-07:00\"\n    message_to_driver=\"Flight AA 1234 arrival\"\n)\n```\n\n### \ud83d\udd0d Ride Management\n\n```python\n# Get ride status\nstatus = client.get_ride_status(\"ride-id\")\nprint(f\"Status: {status.status}\")\nprint(f\"Driver: {status.driver_name}\")\n\n# Cancel ride\nresult = client.cancel_ride(\"ride-id\")\nprint(f\"Cancelled: {result.status}\")\n```\n\n### \ud83d\udcca Analytics & Reporting\n\n```python\n# Get client usage statistics\nstats = client.get_client_stats(\"client-id\")\nprint(f\"Total rides: {stats.total_rides}\")\nprint(f\"API calls: {stats.total_api_calls}\")\n\n# Get detailed usage history\nusage = client.get_usage_history(\"client-id\", limit=50)\nfor record in usage.usage_history:\n    print(f\"{record['endpoint']} at {record['timestamp']}\")\n\n# Get ride history\nrides = client.get_ride_history(\"client-id\", limit=25)\nfor ride in rides.ride_history:\n    print(f\"Ride {ride['ride_id']}: {ride['pickup_address']} \u2192 {ride['dropoff_address']}\")\n```\n\n## \ud83c\udfe2 Enterprise Features\n\n### User Management & Tracking\n- **Client ID System** - Unique identifiers for each user/department\n- **Flexible Metadata** - Store custom fields (department, cost center, etc.)\n- **Usage Analytics** - Track API calls, ride patterns, and costs\n- **Audit Trails** - Complete history of all operations\n\n### Expense & Compliance\n- **Expense Memos** - Attach internal tracking notes to rides\n- **Driver Messages** - Special instructions for drivers\n- **Complete History** - All ride details stored permanently\n- **Usage Reporting** - Detailed analytics for expense reporting\n\n### Safety & Control\n- **No Unwanted Calls** - Automatic calling disabled by default\n- **SMS Notifications** - Riders receive booking confirmations\n- **Driver Verification** - All rides through verified Uber platform\n- **Cancellation Control** - Easy ride cancellation with policy compliance\n\n## \ud83d\udee0\ufe0f Error Handling\n\nThe client provides specific exception types for different error scenarios:\n\n```python\nfrom uber_central_client import (\n    UberCentralClient, \n    AuthenticationError, \n    ClientNotFoundError,\n    ValidationError,\n    BookingError\n)\n\ntry:\n    client = UberCentralClient(api_key=\"invalid-key\")\nexcept AuthenticationError:\n    print(\"Invalid API key\")\n\ntry:\n    estimates = client.get_estimates(\n        client_id=\"invalid-client\",\n        pickup_address=\"123 Main St\",\n        dropoff_address=\"456 Oak Ave\"\n    )\nexcept ClientNotFoundError:\n    print(\"Client not found - call initialize_user() first\")\nexcept ValidationError as e:\n    print(f\"Invalid request: {e}\")\nexcept BookingError as e:\n    print(f\"Booking failed: {e}\")\n```\n\n### Exception Types\n- **`AuthenticationError`** - Invalid API key\n- **`ClientNotFoundError`** - Invalid client_id\n- **`RideNotFoundError`** - Invalid ride_id\n- **`ValidationError`** - Invalid request parameters\n- **`BookingError`** - Ride booking/scheduling failures\n- **`RateLimitError`** - API rate limits exceeded\n- **`ServiceUnavailableError`** - Temporary service issues\n\n## \ud83d\udd27 Advanced Usage\n\n### Custom Configuration\n\n```python\nfrom uber_central_client import UberCentralClient\n\n# Custom timeouts and base URL\nclient = UberCentralClient(\n    api_key=\"your-api-key\",\n    base_url=\"https://your-custom-domain.com\",\n    timeout=60  # 60 second timeout\n)\n\n# Health check\nhealth = client.health_check()\nprint(f\"API Status: {health.get('status')}\")\n```\n\n### Batch Operations\n\n```python\n# Create multiple users\nusers = []\nfor i in range(5):\n    user = client.initialize_user(\n        name=f\"User {i}\",\n        metadata={\"batch\": \"onboarding-2025\"}\n    )\n    users.append(user.client_id)\n\n# Get estimates for multiple locations\nlocations = [\n    (\"Downtown\", \"Airport\"),\n    (\"Office\", \"Hotel\"),\n    (\"Station\", \"Mall\")\n]\n\nfor pickup, dropoff in locations:\n    estimates = client.get_estimates(\n        client_id=users[0],\n        pickup_address=pickup,\n        dropoff_address=dropoff\n    )\n    print(f\"{pickup} \u2192 {dropoff}: {len(estimates)} options\")\n```\n\n### Vehicle Type Selection\n\n```python\nfrom uber_central_client import VehicleTypes\n\nestimates = client.get_estimates(client_id, pickup, dropoff)\n\n# Find specific vehicle types\nuberx_estimate = next(\n    (est for est in estimates if est.display_name == VehicleTypes.UBER_X), \n    None\n)\n\ncomfort_estimate = next(\n    (est for est in estimates if est.display_name == VehicleTypes.COMFORT), \n    None\n)\n\nif uberx_estimate:\n    print(f\"UberX: {uberx_estimate.price_estimate}\")\nif comfort_estimate:\n    print(f\"Comfort: {comfort_estimate.price_estimate}\")\n```\n\n## \ud83d\udcda Complete Examples\n\n### Corporate Booking System\n\n```python\nfrom uber_central_client import UberCentralClient\nfrom datetime import datetime, timedelta\n\nclass CorporateRideManager:\n    def __init__(self, api_key):\n        self.client = UberCentralClient(api_key)\n        \n    def onboard_employee(self, name, email, department, cost_center):\n        \"\"\"Create new employee account.\"\"\"\n        user = self.client.initialize_user(\n            name=name,\n            email=email,\n            metadata={\n                \"department\": department,\n                \"cost_center\": cost_center,\n                \"onboarded_at\": datetime.now().isoformat()\n            }\n        )\n        return user.client_id\n    \n    def book_airport_ride(self, client_id, employee_name, phone, flight_info):\n        \"\"\"Book airport pickup with flight details.\"\"\"\n        ride = self.client.book_ride(\n            client_id=client_id,\n            pickup_address=\"SFO Airport\",\n            dropoff_address=\"123 Office St, San Francisco, CA\",\n            rider_name=employee_name,\n            rider_phone=phone,\n            message_to_driver=f\"Flight pickup: {flight_info}\",\n            expense_memo=f\"Airport pickup - {flight_info}\"\n        )\n        return ride.ride_id\n    \n    def generate_usage_report(self, client_id):\n        \"\"\"Generate usage report for employee.\"\"\"\n        stats = self.client.get_client_stats(client_id)\n        usage = self.client.get_usage_history(client_id)\n        rides = self.client.get_ride_history(client_id)\n        \n        return {\n            \"summary\": stats,\n            \"detailed_usage\": usage,\n            \"ride_history\": rides\n        }\n\n# Usage\nmanager = CorporateRideManager(\"your-api-key\")\n\n# Onboard new employee\nclient_id = manager.onboard_employee(\n    name=\"Alice Johnson\",\n    email=\"alice@company.com\", \n    department=\"Sales\",\n    cost_center=\"SALES-2025\"\n)\n\n# Book airport ride\nride_id = manager.book_airport_ride(\n    client_id=client_id,\n    employee_name=\"Alice Johnson\",\n    phone=\"9167995790\",\n    flight_info=\"United Airlines UA 123\"\n)\n\n# Generate monthly report\nreport = manager.generate_usage_report(client_id)\n```\n\n## \ud83d\udd17 Related Resources\n\n- **\ud83d\udcd6 API Documentation**: https://apparel-scraper--uber-central-api-serve.modal.run/docs\n- **\ud83c\udf10 Live API**: https://apparel-scraper--uber-central-api-serve.modal.run\n- **\ud83d\udcc1 GitHub Repository**: https://github.com/lymanlabs/uber-central\n- **\ud83d\udc1b Issue Tracker**: https://github.com/lymanlabs/uber-central/issues\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83e\udd1d Support\n\n- **Documentation**: Check the [API Reference](https://apparel-scraper--uber-central-api-serve.modal.run/docs)\n- **Issues**: Report bugs on [GitHub Issues](https://github.com/lymanlabs/uber-central/issues)  \n- **Questions**: Contact support@uber-central.com\n\n## \ud83c\udfaf Changelog\n\n### v1.0.0 (2025-01-04)\n- Initial release\n- Complete API client implementation\n- Full type safety with Pydantic models\n- Comprehensive error handling\n- Enterprise features (user management, analytics, audit trails)\n- Production-ready with extensive testing\n\n---\n\n**\ud83d\ude80 Ready to integrate enterprise Uber ride management into your application!**\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Official Python client for the Uber Central API - Enterprise Uber ride management",
    "version": "1.0.1",
    "project_urls": {
        "API Endpoint": "https://apparel-scraper--uber-central-api-serve.modal.run",
        "Documentation": "https://apparel-scraper--uber-central-api-serve.modal.run/docs",
        "Homepage": "https://github.com/lymanlabs/uber-central",
        "Issue Tracker": "https://github.com/lymanlabs/uber-central/issues",
        "Repository": "https://github.com/lymanlabs/uber-central"
    },
    "split_keywords": [
        "uber",
        " ride",
        " booking",
        " api",
        " client",
        " transportation",
        " enterprise",
        " business",
        " ride-sharing",
        " mobility",
        " travel",
        " scheduling",
        " fleet",
        " corporate",
        " expense",
        " tracking"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "174b1caffbf86791bd9434e70da9aa1053a1acb402a8d8f565e8aceaa707d672",
                "md5": "46744edb59b27557a7e321aa6eeeba91",
                "sha256": "b1aaa3035d2d92a850784d33a9ad3420dc94453846784a3af815751c8487e6d0"
            },
            "downloads": -1,
            "filename": "uber_central_rest_client-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "46744edb59b27557a7e321aa6eeeba91",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 16425,
            "upload_time": "2025-08-05T05:36:39",
            "upload_time_iso_8601": "2025-08-05T05:36:39.402963Z",
            "url": "https://files.pythonhosted.org/packages/17/4b/1caffbf86791bd9434e70da9aa1053a1acb402a8d8f565e8aceaa707d672/uber_central_rest_client-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1a5823178e73ed25f7eea248fdae1e7f2fcb6f907182349c3088bbec4b8024e1",
                "md5": "aec18af761cf77b1371c4ebdb22f2d4f",
                "sha256": "d0c02c507d897e1bd59430aa88c934da79b566488892a1cc4481f5324256e513"
            },
            "downloads": -1,
            "filename": "uber_central_rest_client-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "aec18af761cf77b1371c4ebdb22f2d4f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 15572,
            "upload_time": "2025-08-05T05:36:41",
            "upload_time_iso_8601": "2025-08-05T05:36:41.041124Z",
            "url": "https://files.pythonhosted.org/packages/1a/58/23178e73ed25f7eea248fdae1e7f2fcb6f907182349c3088bbec4b8024e1/uber_central_rest_client-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-05 05:36:41",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "lymanlabs",
    "github_project": "uber-central",
    "github_not_found": true,
    "lcname": "uber-central-rest-client"
}
        
Elapsed time: 1.64717s