obspy.core.event.base.Comment

class Comment(force_resource_id=True, *args, **kwargs)[source]

Bases: AbstractEventTypeWithResourceID

Comment holds information on comments to a resource as well as author and creation time information.

Parameters:
  • text (str) – Text of comment.

  • resource_id (ResourceIdentifier) – Resource identifier of comment.

  • force_resource_id (bool, optional) – If set to False, the automatic initialization of resource_id attribute in case it is not specified will be skipped.

  • creation_info (CreationInfo, optional) – Creation info for the comment.

>>> comment = Comment(text="Some comment")
>>> print(comment)  
Comment(text='Some comment', resource_id=ResourceIdentifier(...))
>>> comment = Comment(text="Some comment", force_resource_id=False)
>>> print(comment)
Comment(text='Some comment')
>>> comment.resource_id = "comments/obspy-comment-123456"
>>> print(comment) 
Comment(text='Some comment', resource_id=ResourceIdentifier(...))
>>> comment.creation_info = {"author": "obspy.org"}
>>> print(comment.creation_info)
CreationInfo(author='obspy.org')

Note

For handling additional information not covered by the QuakeML standard and how to output it to QuakeML see the ObsPy Tutorial.

Attributes

defaults

do_not_warn_on

item

key

readonly

warn_on_non_default_key

Public Methods

clear

Clear the class :return:

copy

get

items

keys

pop

If key is not found, d is returned if given, otherwise KeyError is raised.

popitem

as a 2-tuple; but raise KeyError if D is empty.

setdefault

update

values

Private Methods

Warning

Private methods are mainly for internal/developer use and their API might change without notice.

Comment._cast_type(key, value)

Cast type of value to type required in _types dict.

Parameters:
  • key (str) – The key from __setattr__.

  • value – The value being set to key.

Returns:

value cast to correct type.

Comment._pretty_str(priorized_keys=[], min_label_length=16)

Return better readable string representation of AttribDict object.

Parameters:
  • priorized_keys (list[str], optional) – Keywords of current AttribDict which will be shown before all other keywords. Those keywords must exists otherwise an exception will be raised. Defaults to empty list.

  • min_label_length (int, optional) – Minimum label length for keywords. Defaults to 16.

Returns:

String representation of current AttribDict object.

Comment._repr_pretty_(p, cycle)

Special Methods

Comment.__bool__()
classmethod Comment.__class_getitem__()

Represent a PEP 585 generic type

E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).

Comment.__contains__(key)
Comment.__delattr__(name)
Comment.__delitem__(name)
Comment.__dir__()

Default dir() implementation.

Comment.__eq__(other)

Two instances are considered equal if all attributes and all lists are identical.

Comment.__format__(format_spec, /)

Default object formatter.

Comment.__ge__(value, /)

Return self>=value.

Comment.__getattr__(name, default=None)

Py3k hasattr() expects an AttributeError no KeyError to be raised if the attribute is not found.

Comment.__getattribute__(name, /)

Return getattr(self, name).

Comment.__getitem__(name, default=None)
Comment.__gt__(value, /)

Return self>value.

Comment.__init__(force_resource_id=True, *args, **kwargs)
Comment.__init_subclass__()

This method is called when a class is subclassed.

The default implementation does nothing. It may be overridden to extend subclasses.

Comment.__iter__()
Comment.__le__(value, /)

Return self<=value.

Comment.__len__()
Comment.__lt__(value, /)

Return self<value.

Comment.__ne__(other)
Comment.__new__(**kwargs)
Comment.__reduce__()

Helper for pickle.

Comment.__reduce_ex__(protocol, /)

Helper for pickle.

Comment.__repr__()
Comment.__setattr__(name, value)

Custom property implementation that works if the class is inheriting from AttribDict.

Comment.__setitem__(key, value)
Comment.__sizeof__()

Size of object in memory, in bytes.

Comment.__str__(force_one_line=False)

Fairly extensive in an attempt to cover several use cases. It is always possible to change it in the child class.

classmethod Comment.__subclasshook__(C)