Trees       Indices       Help   
Advene2
Package advene :: Package model :: Package cam :: Module annotation :: Class Annotation
[hide private]
[frames] | no frames]

Class Annotation

source code

                object --+            
                         |            
   core.meta.WithMetaMixin --+        
                             |        
                object --+   |        
                         |   |        
    events.WithEventsMixin --+        
                             |        
                object --+   |        
                         |   |        
tales.WithAbsoluteUrlMixin --+        
                             |        
                    object --+        
                             |        
   core.element.PackageElement --+    
                                 |    
 core.content.WithContentMixin --+    
                                 |    
        core.annotation.Annotation --+
                                     |
                object --+           |
                         |           |
   core.meta.WithMetaMixin --+       |
                             |       |
                object --+   |       |
                         |   |       |
    events.WithEventsMixin --+       |
                             |       |
                object --+   |       |
                         |   |       |
tales.WithAbsoluteUrlMixin --+       |
                             |       |
                    object --+       |
                             |       |
   core.element.PackageElement --+   |
                                 |   |
           element.CamElementMixin --+
                                     |
                                    Annotation

FIXME: missing docstring.

Instance Methods [hide private]
 
set_meta(self, key, value, val_is_idref=False)
Set the metadata.		 source code
 
del_meta(self, key)
Delete the metadata.		 source code

Inherited from object: __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__

    Inherited from core.annotation.Annotation
 
__contains__(self, other) source code
 
__ge__(self, other) source code
 
__gt__(self, other) source code
 
__le__(self, other) source code
 
__lt__(self, other) source code
 
__str__(self)
str(x)		 source code
 
_cmp(self, other)
Common implementation for __lt__, __gt__, __le__ and __ge__.		 source code
 
_get_begin(self) source code
 
_get_duration(self)
The duration of this annotation.		 source code
 
_get_end(self) source code
 
_get_media(self)
Return the media associated to this annotation.		 source code
 
_get_media_id(self)
The id-ref of this annotation's media.		 source code
 
_set_begin(self, val) source code
 
_set_duration(self, val) source code
 
_set_end(self, val) source code
 
_set_media(self, media) source code
 
_tales_incoming_relations(self, context) source code
 
_tales_outgoing_relations(self, context) source code
 
_tales_player_url(self, context) source code
 
_tales_relations(annotation, context_package) source code
 
_tales_snapshot_url(self, context) source code
 
_tales_typed_related_in(self, context)
Dictionary of tuples (relation type id, list of related incoming annotations)		 source code
 
_tales_typed_related_out(self, context)
Dictionary of tuples (relation type id, list of related outgoing annotations)		 source code
 
_update_caches(self, old_idref, new_idref, element, relation)
:see-also: `advene.model.core.element.PackageElement._update_caches`		 source code
 
count_relations(self, package=None, position=None)
Count all the relations involving this annotation, from the point of view of `package`.		 source code
 
get_media(self, default=None)
Return the media associated to this annotation.		 source code
 
iter_relations(self, package=None, position=None, inherited=True)
Iter over all the relations involving this annotation, from the point of view of `package`.		 source code
    Inherited from element.CamElementMixin
 
_iter_my_tag_ids_nowarn(self, package=None, inherited=True)
Allows to call iter_my_tag_ids internally without raising a warning.		 source code
 
_iter_my_tags_nowarn(self, package=None, inherited=True)
Allows to call iter_my_tags internally without raising a warning.		 source code
 
_set_camsys_type(self, value, val_is_idref=False) source code
 
_tales_my_tags(self, context_package)
Iter over all the user-tags of this element in the context of the reference package.		 source code
 
iter_my_tag_ids(self, package=None, inherited=True)
This method is inherited from core.Package but is unsafe on cam.Package.		 source code
 
iter_my_tags(self, package=None, inherited=True)
This method is inherited from core.Package but is unsafe on cam.Package.		 source code
 
iter_my_user_tag_ids(self, package=None, inherited=True)
FIXME: missing docstring		 source code
 
iter_my_user_tags(self, package=None, inherited=True) source code
    Inherited from core.element.PackageElement
 
__delattr__(self, name)
Make instance lighter when a custom attribute is deleted.		 source code
 
__init__(self, owner, id)
Must not be used directly, nor overridden.		 source code
 
__setattr__(self, name, value)
Make instance heavier when a new custom attribute is created.		 source code
 
_compute_absolute_url(self, aliases) source code
 
_decrease_weight(self)
:see: _increase_weight		 source code
 
_get_id(self)
The identifier of this element in the context of its owner package.		 source code
 
_get_owner(self)
The package containing (or owner package) this element.		 source code
 
_get_uriref(self)
The URI-ref identifying this element.		 source code
 
_increase_weight(self)
Elements are created with weight 0.		 source code
 
_iter_my_tags_or_tag_ids(self, package=None, inherited=True, _get=0)
Iter over the id-refs of the tags associated with this element in ``package``.		 source code
 
_make_event_delegate(self)
Required by WithEventsMixin		 source code
 
_self_connect(self, detailed_signal, handler, *args)
This alternative to `connect` can only be used by the element itself.		 source code
 
_set_id(self, new_id)
Rename this element to `new_id`, if it is not already in use in the package, else raises an AssertionError.		 source code
 
_tales_color(self, context)
Return the color of the element.		 source code
 
_tales_representation(self, context)
Return a concise representation for the element.		 source code
 
connect(self, detailed_signal, handler, *args)
Connect a handler to a signal.		 source code
 
delete(self)
Delete this element.		 source code
 
disconnect(self, handler_id)
Disconnect a handler from a signal.		 source code
 
emit(self, detailed_signal, *args)
Override WithEventsMixin.emit in order to automatically emit the package signal corresponding to each element signal.		 source code
 
has_tag(self, tag, package=None, inherited=True)
Is this element associated to ``tag`` by ``package``.		 source code
 
iter_references(self, package=None)
Iter over all references that are made to this element.		 source code
 
iter_taggers(self, tag, package=None)
Iter over all the packages associating this element to ``tag``.		 source code
 
make_id_in(self, pkg)
Compute an id-ref for this element in the context of the given package.		 source code
    Inherited from core.meta.WithMetaMixin
 
_get_meta_id_or_ref(self, key, default=_RAISE, _return_id=True)
Return the metadata id (string or element) associated to the given key.		 source code
 
_get_ns_dict(self) source code
 
_tales_meta(self, context=None) source code
 
get_meta(self, key, default=_RAISE)
Return the metadata (string or element) associated to the given key.		 source code
 
get_meta_id(self, key, default=_RAISE, _return_id=True)
Return the metadata id (string or element) associated to the given key.		 source code
 
iter_meta(self)
Iter over all the metadata of this object.		 source code
 
iter_meta_ids(self)
Iter over all the metadata of this object.		 source code
    Inherited from events.WithEventsMixin
 
block_handler(self, handler_id)
Prevent the handler identified by handler_id to be invoked until it is unblocked.		 source code
 
emit_lazy(self, lazy_params)
Like emit, but lazy_params is assumed to be a function returning an iterable of the params to send to emit.		 source code
 
enter_no_event_section(self)
Disable all event emission for this object, until `exit_no_event_section` is called.		 source code
 
exit_no_event_section(self)
Re-enables all event emission for this object.		 source code
 
handler_block(self, handler_id)
Prevent the handler identified by handler_id to be invoked until it is unblocked.		 source code
 
handler_is_connected(self, handler_id)
Return True iff the given handler_id represents a connected handler.		 source code
 
handler_unblock(self, handler_id)
Unblock the blocked handler identified by handler_id so it can be invoked again.		 source code
 
has_handler(self, handler_id)
Return True iff the given handler_id represents a connected handler.		 source code
 
stop_emission(self, detailed_signal)
Stop the current emission of the signal specified by detailed_signal.		 source code
 
unblock_handler(self, handler_id)
Unblock the blocked handler identified by handler_id so it can be invoked again.		 source code
    Inherited from tales.WithAbsoluteUrlMixin
 
_absolute_url_fail(self, msg='') source code
 
_tales_absolute_url(self, context)
See class documentation.		 source code
    Inherited from core.content.WithContentMixin
 
_check_content(self, mimetype=None, model_id=None, url=None)
Check that the provided values (assumed to be the future values of the corresponding attributes) are valid and consistent (with each other *and* with unmodified attributes).		 source code
 
_get_content(self)
Return a `Content` instance representing the content.		 source code
 
_get_content_as_file(self)
This property returns a *copy* of this element's content data wrapped in a file-like object.		 source code
 
_get_content_data(self)
This property holds the data of the content.		 source code
 
_get_content_is_textual(self)
This property indicates if this element's content data can be handled as text.		 source code
 
_get_content_mimetype(self)
The mimetype of this element's content.		 source code
 
_get_content_model(self)
The resource used as the model of the content of this element.		 source code
 
_get_content_model_id(self)
The id-ref of the content model, or an empty string.		 source code
 
_get_content_parsed(self) source code
 
_get_content_url(self)
This property holds the URL of the content, or an empty string.		 source code
 
_instantiate_content(self, mimetype, model, url)
This is method is for optimization only: it is not strictly required (though recommended) to call it at instantiate time (see class docstring).		 source code
 
_load_content_info(self)
Load the content info (mimetype, model, url).		 source code
 
_set_content_data(self, data)
See `_get_content_data`.		 source code
 
_set_content_mimetype(self, mimetype) source code
 
_set_content_model(self, resource)
FIXME: missing docstring.		 source code
 
_set_content_parsed(self, parsed) source code
 
_set_content_url(self, url)
See `_get_content_url`.		 source code
 
_update_content_handler(self)
See :class:`WithContentMixin` documentation.		 source code
 
get_content_as_synced_file(self)
Return a file-like object giving access to the content data.		 source code
 
get_content_model(self, default=None)
Return the resource used as the model of the content of this element.		 source code
Class Methods [hide private]
    Inherited from core.annotation.Annotation
 
create_new(cls, owner, id, media, begin, end, mimetype, model, url)
Factory method to create a new instance both in memory and backend.		 source code
 
instantiate(cls, owner, id, media, begin, end, mimetype, model, url, *args)
Factory method to create an instance based on backend data.		 source code
    Inherited from core.meta.WithMetaMixin
 
make_metadata_property(cls, key, alias=None, default=_RAISE, doc=None)
Attempts to create a python property in cls mapping to metadata key.		 source code
    Inherited from core.content.WithContentMixin
 
_check_content_cls(cls, mimetype, model, url, _func=<function _check_content at 0x8f0125c>)
This is a classmethod variant of _check_content, to be use in _instantiate (note that all parameters must be provided in this variant).		 source code
Static Methods [hide private]
    Inherited from core.element.PackageElement
 
_check_reference(pkg, element, type=None, required=False)
Raise a ModelError if element is not referenceable by pkg, and (if provided) if it has not the given type.		 source code
Class Variables [hide private]
    Inherited from core.annotation.Annotation
  ADVENE_TYPE = 'a'
  _begin = None
  _end = None
  _media = None
  _media_id = None
    Inherited from core.element.PackageElement
  _id = None
  _owner = None
  _weight = 0
Properties [hide private]
  type
The type of this annotation, created with Package.create_annotation_type().

Inherited from object: __class__

    Inherited from core.annotation.Annotation
  begin
  duration
The duration of this annotation.
  end
  incoming_relations
List of incoming relations.
  media
Return the media associated to this annotation.
  media_id
The id-ref of this annotation's media.
  outgoing_relations
List of outgoing relations.
  related
List (iterator) of related annotations
  relations
  typed_related_in
List of tuples (relation type, list of related incoming annotations)
  typed_related_out
List of tuples (relation type, list of related outgoing annotations)
    Inherited from element.CamElementMixin
  contributor
shortcut for metadata with key <http://purl.org/dc/elements/1.1/contributor>
  created
shortcut for metadata with key <http://purl.org/dc/elements/1.1/created>
  creator
shortcut for metadata with key <http://purl.org/dc/elements/1.1/creator>
  description
shortcut for metadata with key <http://purl.org/dc/elements/1.1/description>
  modified
shortcut for metadata with key <http://purl.org/dc/elements/1.1/modified>
  seeAlso
shortcut for metadata with key <http://www.w3.org/2000/01/rdf-schema#seeAlso>
  title
shortcut for metadata with key <http://purl.org/dc/elements/1.1/title>
    Inherited from core.element.PackageElement
  id
The identifier of this element in the context of its owner package.
  owner
The package containing (or owner package) this element.
  uriref
The URI-ref identifying this element.
    Inherited from core.meta.WithMetaMixin
  meta
    Inherited from core.content.WithContentMixin
  content
Return a `Content` instance representing the content.
  content_as_file
This property returns a *copy* of this element's content data wrapped in a file-like object.
  content_data
This property holds the data of the content.
  content_is_textual
This property indicates if this element's content data can be handled as text.
  content_mimetype
The mimetype of this element's content.
  content_model
The resource used as the model of the content of this element.
  content_model_id
The id-ref of the content model, or an empty string.
  content_parsed
  content_url
This property holds the URL of the content, or an empty string.
Method Details [hide private]

set_meta(self, key, value, val_is_idref=False)

source code 

Set the metadata.

``val`` can either be a PackageElement or a string. If an element, it must be directly imported by the package of self, or a ModelError will be raised.

Use `val_is_idref` only if you know what you are doing: it forces `val` to be interpreted as an id-ref rather than a plain string; if the id-ref has an import-prefix, only the existence of the import is checked. This is mainly useful for parsers.

Overrides: core.meta.WithMetaMixin.set_meta
(inherited documentation)

del_meta(self, key)

source code 

Delete the metadata.

Note that if the given key is not in use, this will have no effect.

Overrides: core.meta.WithMetaMixin.del_meta
(inherited documentation)

Property Details [hide private]

type

The type of this annotation, created with Package.create_annotation_type(). May be None if undefined.

Get Method:
unreachable.getter(obj)
Set Method:
unreachable.setter(obj, val)
Delete Method:
unreachable.deller(obj)

   Trees       Indices       Help   
Advene2
Generated by Epydoc 3.0.1 on Wed Jul 8 16:00:01 2009 http://epydoc.sourceforge.net