# Toolbox
The Toolbox allows for trendlines, ray lines and horizontal lines to be drawn and edited directly on the chart.

It can be used within any Chart object, and is enabled by setting the `toolbox` parameter to `True` upon Chart declaration.

The Toolbox should only be accessed from the `toolbox` attribute of the chart object. (`chart.toolbox.<method>`)

The following hotkeys can also be used when the Toolbox is enabled:
* Alt+T: Trendline
* Alt+H: Horizontal Line
* Alt+R: Ray Line
* Meta+Z or Ctrl+Z: Undo

Drawings can also be deleted by right-clicking on them, which brings up a context menu.
___

## `save_drawings_under`
`widget: Widget`

Saves drawings under a specific `topbar` text widget. For example:

```python
chart.toolbox.save_drawings_under(chart.topbar['symbol'])
```
___

## `load_drawings`
`tag: str`

Loads and displays drawings stored under the tag given.
___

## `import_drawings`
`file_path: str`

Imports the drawings stored at the JSON file given in `file_path`.
___

## `export_drawings`
`file_path: str`

Exports all currently saved drawings to the JSON file given in `file_path`.
___

## Example:

To get started, create a file called `drawings.json`, which should only contain `{}`.

```python
import pandas as pd
from lightweight_charts import Chart


def get_bar_data(symbol, timeframe):
    if symbol not in ('AAPL', 'GOOGL', 'TSLA'):
        print(f'No data for "{symbol}"')
        return pd.DataFrame()
    return pd.read_csv(f'bar_data/{symbol}_{timeframe}.csv')


class API:
    def __init__(self):
        self.chart: Chart = None

    def on_search(self, searched_string): 
        new_data = get_bar_data(searched_string, self.chart.topbar['timeframe'].value)
        if new_data.empty:
            return
        self.chart.topbar['symbol'].set(searched_string)
        self.chart.set(new_data)
        self.chart.toolbox.load_drawings(searched_string)  # Loads the drawings saved under the symbol.

    def on_timeframe_selection(self):
        new_data = get_bar_data(self.chart.topbar['symbol'].value, self.chart.topbar['timeframe'].value)
        if new_data.empty:
            return
        self.chart.set(new_data, render_drawings=True)  # The symbol has not changed, so we want to re-render the drawings.
    
        
if __name__ == '__main__':
    api = API()

    chart = Chart(api=api, topbar=True, searchbox=True, toolbox=True)
    chart.legend(True)

    chart.topbar.textbox('symbol', 'TSLA')
    chart.topbar.switcher('timeframe', api.on_timeframe_selection, '1min', '5min', '30min', default='5min')

    df = get_bar_data('TSLA', '5min')

    chart.set(df)

    chart.toolbox.import_drawings('drawings.json')  # Imports the drawings saved in the JSON file.
    chart.toolbox.load_drawings(chart.topbar['symbol'].value)  # Loads the drawings under the default symbol.

    chart.toolbox.save_drawings_under(chart.topbar['symbol'])  # Saves drawings based on the symbol.
    
    chart.show(block=True)

    chart.toolbox.export_drawings('drawings.json')  # Exports the drawings to the JSON file.

```