taco-bell-python 0.2.0
Order Taco Bell using Python!
License: MIT

# Taco Bell Python

A python sdk for Taco Bell.

## Goal

To be able to order my favorite taco bell items (rip potatoes) via code.

## What Works

1. Logging into Taco Bell account with username/password

2. Adding a single, uncustomized item to your cart

3. Adding a customized item to your cart, either adding extras or modifying what comes by default

4. Getting your cart total cost

5. Find the nearest stores and set store for pickup

## Usage

Sign into your Taco Bell account with your username (email) and password:
```
from tacobell import TacoBell
tbell = TacoBell('rileysndr@gmail.com', '<super secure password>')
```

Add an item to your cart:
```
tbell.add_to_cart('Cheesy Bean and Rice Burrito')
```

Add a customized item to your cart:
```
tbell.add_to_cart_customized(
    'Cheesy Bean and Rice Burrito',
    sauces=[
        'Red Sauce',
        'Avocado Ranch'
    ],
    addons=[
        '3 Cheese Blend'
    ]
)
```

```
tbell.add_to_cart_customized(
    'Cheesy Bean and Rice Burrito',
    modify=[
        ('Creamy Jalapeño Sauce', 'EXTRA')
    ]
)
```

Get your cart total:
```
tbell.cart_total()
```

Find your desired pickup location:
```
for store in tbell.find_store('<latitude>', '<longitude>'):
    print(store)
```

Set your pickup location:
```
tbell.set_pickup('<store id>')
```

## Current problems/issues

I am accomplishing this by exporling the network calls made on the Taco Bell site. I will publish the API endpoints I have found and how to use them.

It seems like logging in and doing actions is hit or miss. I am unsure if this is some sort of anti-robot protections taco bell has or they are just blocking my IP every once and a while.

There is no great way to list items, so for now I am building a relationship of item names -> product codes. Hopefull this can be replaced by a search function later.


## Known API Endpoints

### Root URL: `https://www.tacobell.com`

### Login: POST `/j_spring_security_check`
Data:
```
{
    "j_username": <username>,
    "j_password": <password>,
    "CSRFToken": <CSRF Token>
}
```

### Cart Total: GET `/cart/miniCart/SUBTOTAL`
Always returns 200 status code

### Add uncustomized item to cart: POST `/cart/add`
Params:
```
{
    "productCodePost": <product code>,
    "CSRFToken": <CSRF Token>
}
```

### Get options for item customization: GET `/p/<product code>/customizationOverlay?store=<store id (optional)>`
Example return data in `tests/customizations.json`

### Add customized item to cart: POST `/cart/add-composite`
Data:
```
{
    "baseProduct": <product code>,
    "code": <product code>,
    "qty": <quantity>,
    "includeProduct": [
        {
            "code": <modifier code>,
            "group": "included",
            "qty": 1
        }
    ],
    "modifierProduct": [
        {
            "code": <modifier code>,
            "group": <modifier type>,
            "qty": 1
        }
    ]
}
```

### Find Stores: GET `/store-finder/findStores`
Params:
```
{
    "latitude": <latitude>,
    "longitude": <longitude>
}
```

### Set Pickup Store: POST `/pickup-location/pickupLocation`
Params:
```
{
    "storeName": <store id>,
    "CSRFToken": <CSRF Token>
}
```

For these, you can change the items that come on the product normall with the `includeProduct` list. You can then add extra items with the `modifierProduct` list.

Get modification options: `p/<product_code>/customizationOverlay?store=<store_id>`
The return data here is a huge JSON with all your options, the meat of the code is taking your modification input and finding the correct modifier code for what you want.


## Contributing

Contributions are obviously welcome. Exporing the backend Taco Bell API is most of the work. Until we can get a good source for product codes I will be putting them in the code by hand.

Things on the ToDo list:

1. Query for list of products and codes

2. Select/Find store to send order to

3. Select payment method

4. Checkout/Submit order