Tensorbay

**IMPORTANT**: TensorBay system underwent a huge refactoring, which broke the downward compatibility
of OpenAPI and SDK. As a result, the SDK under version v1.6.0 does not work anymore.
**Please update tensorbay SDK to v1.6.0 or a higher version.**

---

New Features:

- Add the following methods to support multiple branches (644, 657):
- `DatasetClientBase.create_branch` (613)
- `DatasetClientBase.delete_branch` (616)

- Support creating draft on different branches (652, 649, 659, 733)
- Support uploading dataset on different branches in `GAS.upload_dataset` (694)
- Add open dataset loader `BDD100K` for its CLASSIFICATION and BOX2D label (631)

- Add the following CLI commands:
- `gas branch` to create, list and delete branches (587, 640, 663)
- `gas tag` to create, list and delete tags (600, 611, 622)
- `gas log` to show commit history (614)

- Add popup editor for the following CLI commands to edit title and description (662):
- `gas draft` (602)
- `gas commit` (625)

- Support setting `description` in `gas commit` command (730)

Interface adjustment:

- Change the default segment name from `""` to `"default"` (620, 686)
- Set argument `title` of `DatasetClientBase.create_draft` required (668)
- Use dynamic attr and public attrs in `CameraIntrinsics` (606)
- Implement `NamedList` to replace `NameOrderedDict` (621)
- Change the type of `Notes.bin_point_cloud_fields` to `list` (660)
- Disable method `SegmentClientBase.delete_data` temporarily (737)

Improvements:

- Rebuild uploading data procedure to adapt new TensorBay backend (671)
- Use `title` and `description` instead of `message` in commit (713, 718, 724)
- Handle the branch without commit history (618, 701, 709, 734, 596)
- Fix type hint errors reported by `mypy` (590)
- No longer dumps "skew" of zero value in `CameraMatrix` (609)
- Add `error()` function for CLI to echo error message then exit (642, 647, 658)
- Delete useless `need_team_dataset` argument in `GAS._list_datasets()` (682)
- Add `DefaultValueDeprecated` to deprecate arg default value (639, 654)
- Refine `AttrsMixin` framework (586, 591, 595, 598, 603, 607, 629, 633, 636)
- Apply `AttrsMixin` in the following modules and classes:
- `NameMixin` class (601)
- `sensor` module (617)
- `label` module (635)
- `dataset` module (570)
- `client.struct` module (692, 716)

Documentation:

- Add docs about multiple branches (650, 670, 720)
- Add docs about `gas tag`, `gas branch` and `gas log`(624, 630, 667)
- Update docstrings about version control (721)
- Refine the docs (661)

Bug fixes:

- Add a workaround for the inconsistent label format generated from annotation platform (751)

Bug fixes:

- Fix the `UnicodeEncodeError` in `RemoteData.open()` when there are Chinese characters in the remote data url (678, Fix 676)

Bug fixes:

- Fix the `AttributeError` when using `DatasetBase.keys()` to list segment names (641, Fix 637)

New Features:

- Redesign and implement the `gas` CLI based on TensorBay version control (575):
- Support `draft number` and `revision` in `TBRN` (525)
- Add `gas dataset` command to create, list and delete dataset (523, 526, 528, 530, 534, 571)
- Support `gas ls` command to list segments and data in specific draft or revision (541, 618)
- Add `gas draft` command to create and list drafts (546, 547, 548)
- Add `gas commit` command to commit draft (549)
- Add `gas cp` command to upload files to draft (551)
- Add `gas rm` command to remove segment and data in draft (555, 582)


- Add detailed resuming message when uploading process got interrupted (516, 536)
- Add `ModuleImportError` to print detailed install instruction when the optional requirement package is not installed (544)

- Implement `DatasetBase.__delitem__` to support delete segment from dataset by `del` (542)
- Add open dataset loader `LISA Traffic Sign` (518)

Bug fixes:

- Fix the `ValueError` when passing the last item to `UserSequence.index` (627, Fix 610)

Improvements:

- Remove the redundant class variable `description` in `KeypointsInfo` (506)
- Implement python attr framework `AttrsMixin` (447, 559, 560, 565, 569, 566, 580)
- Move `TBRN` from `utility` module to `cli` module (540)
- Inherit `EqMixin` to replace `__eq__` in the following intrinsic classes (539):
- `CameraMatrix`
- `DistortionCoefficients`
- `CameraIntrinsics`

Documentation:

- Refactor CLI related docs (520, 527, 533, 556, 558, 561, 578, 608, 628, 632)
- Add `Integrations` chapter for `PyTorch` and `TensorFlow` integration (550, 553, 588, 589, 594)
- Refine the docs (501, 508, 514, 517, 513, 509, 519, 537)
- Fix the typo in docs (531)

Deprecations:

- Deprecate CLI `gas create` and `gas delete` (568)
- Deprecate legacy fusion dataset `TBRN` (581)
- Remove the following deprecated interfaces (511):
- Following exceptions：
- `GASDatasetError`
- `GASDatasetTypeError`
- `GASException`
- `GASPathError`
- `GASResponseError`
- `GASSegmentError`
- The `start` and `stop` keyword arguments in the following methods:
- `GAS.list_dataset_names`
- `DatasetClientBase.list_drafts`
- `DatasetClientBase.list_commits`
- `DatasetClientBase.list_tags`
- `DatasetClientBase.list_branches`
- `DatasetClientBase.list_segment_names`
- `SegmentClient.list_data_paths`
- `SegmentClient.list_data`
- `FusionSegmentClient.list_frames`
- Following methods：
- `DatasetClientBase.list_draft_titles_and_numbers`

New Features:

- The local visualization plugin `pharos` is released, it can be installed by `pip3 install pharos`:
- Pypi: https://pypi.org/project/pharos/
- Docs: https://tensorbay-python-sdk.graviti.com/en/v1.4.1/features/visualization.html

Bug fixes:

- Fix the `JSONDecodeError` occurred when uploading dataset (563, Fix 562)
- Fix the `AttributeError` when using `CADC` dataloader in python3.6 (576, Fix 574)
- Fix the `AttributeError` when resuming upload of fusion dataset (583, Fix 579)

Documentation:

- Add docs for local visualization plugin `pharos` (510, 515, 577, 573, 585)