reviewboard.diffviewer.models¶
Model re-exports for reviewboard.diffviewer.*.
-
class
DiffCommit
(*args, **kwargs)[source]¶ Bases:
django.db.models.base.Model
A representation of a commit from a version control system.
A DiffSet on a Review Request that represents a commit history will have one or more DiffCommits. Each DiffCommit will have one or more associated FileDiffs (which also belong to the parent DiffSet).
The information stored herein is intended to fully represent the state of a single commit in that history. The series of DiffCommits can be used to re-create the original series of commits posted for review.
-
filename
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
diffset
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
committer_name
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
committer_email
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
committer_date_utc
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
committer_date_offset
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
commit_message
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
commit_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
parent_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
extra_data
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
The author’s name and e-mail address.
This is formatted as
author_name <author_email>
.
The author date in its original timezone.
-
committer
[source]¶ The committer’s name and e-mail address (if applicable).
This will be formatted as
committer_name <committer_email>
if bothcommitter_name
andcommitter_email
are set. Otherwise, it be whichever is defined. If neither are defined, this will beNone
.
-
committer_date
[source]¶ The committer date in its original timezone.
If the commit has no committer, this will be
None
.
-
serialize
()[source]¶ Serialize to a dictionary.
Returns: A dictionary representing this commit. Return type: dict
-
get_total_line_counts
()[source]¶ Return the total line counts of all child FileDiffs.
Returns: A dictionary with the following keys: raw_insert_count
raw_delete_count
insert_count
delete_count
replace_count
equal_count
total_line_count
Each entry maps to the sum of that line count type for all child
FileDiffs
.Return type: dict
-
__unicode__
()[source]¶ Return a human-readable representation of the commit.
Returns: The commit ID and its summary (if available). Return type: unicode
-
diffset_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
files
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
-
class
DiffSet
(*args, **kwargs)[source]¶ Bases:
django.db.models.base.Model
A revisioned collection of FileDiffs.
-
name
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
revision
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
timestamp
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
basedir
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
history
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
repository
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
diffcompat
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
base_commit_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
commit_count
= <djblets.db.fields.relation_counter_field.RelationCounterField: commit_count>[source]¶
-
extra_data
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
is_commit_series_finalized
[source]¶ Whether the commit series represented by this DiffSet is finalized.
When a commit series is finalized, no more
DiffCommits
can be added to it.
-
finalize_commit_series
(cumulative_diff, validation_info, parent_diff=None, request=None, validate=True, save=False)[source]¶ Finalize the commit series represented by this DiffSet.
Parameters: - cumulative_diff (bytes) – The cumulative diff of the entire commit series.
- validation_info (dict) – The parsed validation information.
- parent_diff (bytes, optional) – The parent diff of the cumulative diff, if any.
- request (django.http.HttpRequest, optional) – The HTTP request from the client, if any.
- validate (bool, optional) – Whether or not the cumulative diff (and optional parent diff) should be validated, up to and including file existence checks.
- save (bool, optional) –
Whether to save the model after finalization. Defaults to
False
.If
True
, only theextra_data
field will be updated.If
False
, the caller must save this model.
Returns: The list of created FileDiffs.
Return type: list of reviewboard.diffviewer.models.filediff.FileDiff
Raises: django.core.exceptions.ValidationError
– The commit series failed validation.
-
get_total_line_counts
()[source]¶ Return the total line counts of all child FileDiffs.
Returns: A dictionary with the following keys: raw_insert_count
raw_delete_count
insert_count
delete_count
replace_count
equal_count
total_line_count
Each entry maps to the sum of that line count type for all child
FileDiffs
.Return type: dict
-
per_commit_files
[source]¶ The files limited to per-commit diffs.
This will cache the results for future lookups. If the set of all files has already been fetched with
prefetch_related()
, no queries will be performed.
-
cumulative_files
[source]¶ The files limited to the cumulative diff.
This will cache the results for future lookups. If the set of all files has been already been fetched with
prefetch_related()
, no queries will be incurred.
-
update_revision_from_history
(diffset_history)[source]¶ Update the revision of this diffset based on a diffset history.
This will determine the appropriate revision to use for the diffset, based on how many other diffsets there are in the history. If there aren’t any, the revision will be set to 1.
Parameters: diffset_history (reviewboard.diffviewer.models.diffset_history.DiffSetHistory) – The diffset history used to compute the new revision. Raises: ValueError
– The revision already has a valid value set, and cannot be updated.
-
save
(**kwargs)[source]¶ Save this diffset.
This will set an initial revision of 1 if this is the first diffset in the history, and will set it to on more than the most recent diffset otherwise.
Parameters: **kwargs (dict) – Extra arguments for the save call.
-
__unicode__
()[source]¶ Return a human-readable representation of the DiffSet.
Returns: A human-readable representation of the DiffSet. Return type: unicode
-
commits
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
files
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
history_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
repository_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
review_request_draft
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
review_set
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
-
class
DiffSetHistory
(*args, **kwargs)[source]¶ Bases:
django.db.models.base.Model
A collection of diffsets.
This gives us a way to store and keep track of multiple revisions of diffsets belonging to an object.
-
name
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
timestamp
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
last_diff_updated
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
extra_data
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
__unicode__
()[source]¶ Return a human-readable representation of the model.
Returns: A human-readable representation of the model. Return type: unicode
-
diffsets
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
review_request
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
-
class
FileDiff
(*args, **kwargs)[source]¶ Bases:
django.db.models.base.Model
A diff of a single file.
This contains the patch and information needed to produce original and patched versions of a single file in a repository.
-
diffset
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
commit
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
source_file
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
dest_file
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
source_revision
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
dest_detail
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
binary
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
status
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
diff64
¶ Property-like class used to store/retrieve Base64 values.
This works much like a property, and takes care of encoding strings for storage and decoding them on retrieval. It’s set internally by
Base64Field
in place of the normal field attribute.
-
legacy_diff_hash
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
diff_hash
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
parent_diff64
¶ Property-like class used to store/retrieve Base64 values.
This works much like a property, and takes care of encoding strings for storage and decoding them on retrieval. It’s set internally by
Base64Field
in place of the normal field attribute.
-
legacy_parent_diff_hash
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
parent_diff_hash
[source]¶ Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
child.parent
is aForwardManyToOneDescriptor
instance.
-
extra_data
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
source_file_display
[source]¶ The displayed filename for the source/original file.
This may be different than
source_file
, as the associatedSCMTool
may normalize it for display.- Type:
- unicode
-
dest_file_display
[source]¶ The displayed filename for the destination/modified file.
This may be different than
dest_file
, as the associatedSCMTool
may normalize it for display.- Type:
- unicode
-
is_symlink
[source]¶ Whether this file represents a symlink.
This represents the value of the
is_symlink
key inextra_data
.New in version 4.0.6.
- Type:
- bool
-
old_symlink_target
[source]¶ The old target for the symlink.
This represents the value of the
old_symlink_target
key inextra_data
.New in version 4.0.6.
- Type:
- unicode
-
new_symlink_target
[source]¶ The new target for the symlink.
This represents the value of the
new_symlink_target
key inextra_data
.New in version 4.0.6.
- Type:
- unicode
-
old_unix_mode
[source]¶ The old UNIX permissions mode for the file.
This represents the value of the
old_unix_mode
key inextra_data
. It is stored as a string representing an octal.New in version 4.0.6.
- Type:
- unicode
-
new_unix_mode
[source]¶ The new UNIX permissions mode for the file.
This represents the value of the
new_unix_mode
key inextra_data
. It is stored as a string representing an octal.New in version 4.0.6.
- Type:
- unicode
-
is_parent_diff_empty
(cache_only=False)[source]¶ Return whether or not the parent diff is empty.
Parameters: cache_only (bool, optional) – Whether or not to only use cached results. Returns: Whether or not the parent diff is empty. This is true if either there is no parent diff or if the parent diff has no insertions and no deletions. Return type: bool
-
orig_sha1
[source]¶ The computed SHA1 hash of the original file.
This may be
None
, in which case it will be populated when the diff is next viewed.
-
patched_sha1
[source]¶ The computed SHA1 hash of the patched file.
This may be
None
, in which case it will be populated when the diff is next viewed.
-
orig_sha256
[source]¶ The computed SHA256 hash of the original file.
This may be
None
, in which case it will be populated when the diff is next viewed.New in version 4.0.
-
patched_sha256
[source]¶ The computed SHA256 hash of the patched file.
This may be
None
, in which case it will be populated when the diff is next viewed.New in version 4.0.
-
encoding
[source]¶ The encoding of the source and patched file.
This will check the
encoding
key inextra_data
. If not available, then this will beNone
.New in version 4.0.
-
get_line_counts
()[source]¶ Return the stored line counts for the diff.
This will return all the types of line counts that can be set.
Returns: A dictionary with the following keys: raw_insert_count
raw_delete_count
insert_count
delete_count
replace_count
equal_count
total_line_count
These are not all guaranteed to have values set, and may instead be
None
. Onlyraw_insert_count
,raw_delete_count
insert_count
, anddelete_count
are guaranteed to have values set.If there isn’t a processed number of inserts or deletes stored, then
insert_count
anddelete_count
will be equal to the raw versions.Return type: dict
-
set_line_counts
(raw_insert_count=None, raw_delete_count=None, insert_count=None, delete_count=None, replace_count=None, equal_count=None, total_line_count=None)[source]¶ Set the line counts on the FileDiff.
There are many types of useful line counts that can be set.
Parameters: - raw_insert_count (int, optional) –
The insert count on the original patch.
This will be set on the
reviewboard.diffviewer.models.raw_file_diff_data.RawFileDiffData
as well. - raw_delete_count (int, optional) –
The delete count in the original patch.
This will be set on the
reviewboard.diffviewer.models.raw_file_diff_data.RawFileDiffData
as well. - insert_count (int, optional) – The number of lines that were inserted in the diff.
- delete_count (int, optional) – The number of lines that were deleted in the diff.
- replace_count (int, optional) – The number of lines that were replaced in the diff.
- equal_count (int, optional) – The number of lines that were identical in the diff.
- total_line_count (int, optional) – The total line count.
- raw_insert_count (int, optional) –
-
get_ancestors
(minimal, filediffs=None, update=True)[source]¶ Return the ancestors of this FileDiff.
This will update the ancestors of this
FileDiff
and all its ancestors if they are not already cached.Parameters: - minimal (bool) –
Whether or not the minimal set of ancestors are returned.
The minimal set of ancestors does not include ancestors where the file was deleted. In other words, if a file is deleted and then re-created, the deletion will not appear in the re-created file’s ancestor list.
- filediffs (iterable of FileDiff, optional) – An optional list of FileDiffs to check for ancestors so that a query does not have to be performed.
- update (bool, optional) –
Whether or not to cache the results in the database.
If
True
and the results have not already been cached, this FileDiff and its ancestors will all be updated.
Returns: The ancestor
FileDiffs
, in application order.Return type: list of FileDiff
- minimal (bool) –
-
get_repository
()[source]¶ Return the repository this diff applies to.
New in version 4.0.
Returns: The repository used for any operations for this FileDiff. Return type: reviewboard.scmtools.models.Repository
-
get_base_filediff
(base_commit, ancestors=None)[source]¶ Return the base FileDiff within a commit range.
This looks through the FileDiff’s ancestors, looking for the most recent one that equals or precedes
base_commit
.Parameters: - base_commit (reviewboard.diffviewer.models.diffcommit.DiffCommit) – The newest commit that the resulting base FileDiff can be associated with.
- ancestors (list of FileDiff, optional) – A pre-fetched list of FileDiff ancestors. If not provided, a list will be fetched.
Returns: The base FileDiff, if one could be found.
None
will be returned if no base could be found.Return type:
-
__unicode__
()[source]¶ Return a human-readable representation of the model.
Returns: A human-readable representation of the model. Return type: unicode
-
added_attachments
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
comments
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
commit_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
diff_hash_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
diffset_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
interdiff_comments
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
legacy_diff_hash_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
legacy_parent_diff_hash_id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
-
class
LegacyFileDiffData
(*args, **kwargs)[source]¶ Bases:
django.db.models.base.Model
Deprecated, legacy class for base64-encoded diff data.
This is no longer populated, and exists solely to store legacy data that has not been migrated to
RawFileDiffData
.-
binary_hash
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
binary
¶ Property-like class used to store/retrieve Base64 values.
This works much like a property, and takes care of encoding strings for storage and decoding them on retrieval. It’s set internally by
Base64Field
in place of the normal field attribute.
-
extra_data
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
filediffs
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
parent_filediffs
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
-
class
RawFileDiffData
(*args, **kwargs)[source]¶ Bases:
django.db.models.base.Model
Stores raw diff data as binary content in the database.
This is the class used in Review Board 2.5+ to store diff content. Unlike in previous versions, the content is not base64-encoded. Instead, it is stored either as bzip2-compressed data (if the resulting compressed data is smaller than the raw data), or as the raw data itself.
-
binary_hash
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
binary
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
compression
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
extra_data
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
content
[source]¶ Return the content of the diff.
The content will be uncompressed (if necessary) and returned as the raw set of bytes originally uploaded.
-
recalculate_line_counts
(tool)[source]¶ Recalculates the insert_count and delete_count values.
This will attempt to re-parse the stored diff and fetch the line counts through the parser.
-
filediffs
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-
id
[source]¶ A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.
-
parent_filediffs
[source]¶ Accessor to the related objects manager on the reverse side of a many-to-one relation.
In the example:
class Child(Model): parent = ForeignKey(Parent, related_name='children')
parent.children
is aReverseManyToOneDescriptor
instance.Most of the implementation is delegated to a dynamically defined manager class built by
create_forward_many_to_many_manager()
defined below.
-