Skip to content

Commit

Permalink
docs: disable properties, add them into the attributes list
Browse files Browse the repository at this point in the history
PR Closed: #373
  • Loading branch information
luyao77 committed Apr 15, 2021
1 parent 735d687 commit 76fe65f
Show file tree
Hide file tree
Showing 18 changed files with 44 additions and 7 deletions.
2 changes: 1 addition & 1 deletion docs/source/api/client/dataset.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ tensorbay.client.dataset
.. automodule:: tensorbay.client.dataset
:members:
:show-inheritance:
:exclude-members:
:exclude-members: name, dataset_id, status
1 change: 1 addition & 0 deletions docs/source/api/client/requests.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,4 @@ tensorbay.client.requests
.. automodule:: tensorbay.client.requests
:members:
:show-inheritance:
:exclude-members: is_intern
2 changes: 1 addition & 1 deletion docs/source/api/client/segment.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ tensorbay.client.segment
.. automodule:: tensorbay.client.segment
:members:
:show-inheritance:
:exclude-members:
:exclude-members: name, status
1 change: 1 addition & 0 deletions docs/source/api/dataset/data.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,4 @@ tensorbay.dataset.data
.. automodule:: tensorbay.dataset.data
:members:
:show-inheritance:
:exclude-members: target_remote_path
2 changes: 1 addition & 1 deletion docs/source/api/dataset/dataset.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,5 @@ tensorbay.dataset.dataset
.. automodule:: tensorbay.dataset.dataset
:members:
:show-inheritance:
:exclude-members:
:exclude-members: catalog, notes

1 change: 1 addition & 0 deletions docs/source/api/label/supports.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,4 @@ tensorbay.label.supports
.. automodule:: tensorbay.label.supports
:members:
:show-inheritance:
:exclude-members: number
1 change: 1 addition & 0 deletions docs/source/api/sensor/intrinsics.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,4 @@ tensorbay.sensor.intrinsics
.. automodule:: tensorbay.sensor.intrinsics
:members:
:show-inheritance:
:exclude-members: camera_matrix, distortion_coefficients
1 change: 1 addition & 0 deletions docs/source/api/utility/name.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,4 @@ tensorbay.utility.name
.. automodule:: tensorbay.utility.name
:members:
:show-inheritance:
:exclude-members: name
1 change: 1 addition & 0 deletions docs/source/api/utility/tbrn.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,4 @@ tensorbay.utility.tbrn
.. automodule:: tensorbay.utility.tbrn
:members:
:show-inheritance:
:exclude-members: dataset_name, segment_name, frame_index, sensor_name, remote_path, type
5 changes: 5 additions & 0 deletions tensorbay/client/dataset.py
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,11 @@ class DatasetClientBase: # pylint: disable=too-many-public-methods
dataset_id: Dataset ID.
gas_client: The initial client to interact between local and TensorBay.
Attributes:
name: Dataset name.
dataset_id: Dataset ID.
status: The status of the dataset client.
"""

_client: Client
Expand Down
7 changes: 6 additions & 1 deletion tensorbay/client/requests.py
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,12 @@


class Config: # pylint: disable=too-few-public-methods
"""This is a base class defining the concept of Request Config."""
"""This is a base class defining the concept of Request Config.
Attributes:
is_intern: Whether the request is from intern.
"""

def __init__(self) -> None:

Expand Down
4 changes: 4 additions & 0 deletions tensorbay/client/segment.py
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,10 @@ class SegmentClientBase: # pylint: disable=too-many-instance-attributes
name: Segment name.
dataset_client: The dataset client.
Attributes:
name: Segment name.
status: The status of the dataset client.
"""

_EXPIRED_IN_SECOND = 240
Expand Down
1 change: 1 addition & 0 deletions tensorbay/dataset/data.py
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,7 @@ class Data(DataBase):
path: The file local path.
timestamp: The timestamp for the file.
labels: The :class:`Labels` that contains all the label information of the file.
target_remote_path: The target remote path of the data.
"""

Expand Down
4 changes: 4 additions & 0 deletions tensorbay/dataset/dataset.py
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,10 @@ class DatasetBase(NameMixin, Sequence[_T]): # pylint: disable=too-many-ancestor
Arguments:
name: The name of the dataset.
Attributes:
catalog: The :class:`~tensorbay.label.catalog.Catalog` of the dataset.
notes: The :class:`Notes` of the dataset.
"""

_repr_type = ReprType.SEQUENCE
Expand Down
1 change: 1 addition & 0 deletions tensorbay/label/supports.py
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@ class KeypointsInfo(ReprMixin, EqMixin):
description: The description of the keypoints.
Attributes:
number: The number of the set of keypoints.
names: All the names of the keypoints.
skeleton: The skeleton of the keypoints
indicating which keypoint should connect with another.
Expand Down
6 changes: 3 additions & 3 deletions tensorbay/sensor/intrinsics.py
Original file line number Diff line number Diff line change
Expand Up @@ -493,9 +493,9 @@ class CameraIntrinsics(ReprMixin):
**kwargs: Float values to initialize :class:`DistortionCoefficients`.
Attributes:
_camera_matrix: A 3x3 Sequence of the camera matrix.
_distortion_coefficients: It is the deviation from rectilinear projection. It includes
radial distortion and tangential distortion.
camera_matrix: A 3x3 Sequence of the camera matrix.
distortion_coefficients: It is the deviation from rectilinear projection. It includes
radial distortion and tangential distortion.
Examples:
>>> matrix = [[1, 3, 3],
Expand Down
3 changes: 3 additions & 0 deletions tensorbay/utility/name.py
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,9 @@ class NameMixin(ReprMixin, EqMixin):
name: Name of the class.
description: Description of the class.
Attributes:
name: Name of the class.
"""

_P = TypeVar("_P", bound="NameMixin")
Expand Down
8 changes: 8 additions & 0 deletions tensorbay/utility/tbrn.py
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,14 @@ class TBRN:
remote_path: Object path of the file.
tbrn: Full TBRN string.
Attributes:
dataset_name: Name of the dataset.
segment_name: Name of the segment.
frame_index: Index of the frame.
sensor_name: Name of the sensor.
remote_path: Object path of the file.
type: The type of this TBRN.
Raises:
TypeError: The TBRN is invalid.
Expand Down

0 comments on commit 76fe65f

Please sign in to comment.