betty.model.ancestry module¶
Provide Betty’s main data model.
- class betty.model.ancestry.Ancestry[source]¶
Bases:
MultipleTypesEntityCollection
[Entity
]An ancestry contains all the entities of a single family tree/genealogical data set.
- add_unchecked_graph(*entities: betty.model.Entity) None [source]¶
Add entities to the ancestry but do not automatically add associates as well.
It is the caller’s responsibility to ensure all associates are added to the ancestry. If this is done, calling this method is faster than the usual entity collection methods.
- Parameters:
entities (
betty.model.Entity
)- Return type:
- class betty.model.ancestry.Attendee[source]¶
Bases:
PresenceRole
Someone attended the event (further details unknown).
- property label: Localizable¶
The human-readable label.
- class betty.model.ancestry.Beneficiary[source]¶
Bases:
PresenceRole
Someone was a benificiary in the event, such as a
betty.model.event_type.Will
.- property label: Localizable¶
The human-readable label.
- class betty.model.ancestry.Celebrant[source]¶
Bases:
PresenceRole
Someone was the celebrant at the event.
This includes but is not limited to:
civil servant
religious leader
civilian
- property label: Localizable¶
The human-readable label.
- class betty.model.ancestry.Citation[source]¶
Bases:
Dated
,HasFiles
,HasPrivacy
,HasLinksEntity
,UserFacingEntity
,Entity
A citation (a reference to a source).
- Parameters:
facts (
typing.Optional
[typing.Iterable
[betty.model.ancestry.HasCitations
]])source (
betty.model.ancestry.Source
|None
)location (
betty.locale.Localizable
|None
)date (
betty.locale.Date
|betty.locale.DateRange
|None
)files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])privacy (
betty.model.ancestry.Privacy
|None
)
- __init__(*, id: str | None = None, facts: Iterable[betty.model.ancestry.HasCitations] | None = None, source: betty.model.ancestry.Source | None = None, location: betty.locale.Localizable | None = None, date: betty.locale.Date | betty.locale.DateRange | None = None, files: Iterable[betty.model.ancestry.File] | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None)[source]¶
- Parameters:
facts (
typing.Optional
[typing.Iterable
[betty.model.ancestry.HasCitations
]])source (
betty.model.ancestry.Source
|None
)location (
betty.locale.Localizable
|None
)date (
betty.locale.Date
|betty.locale.DateRange
|None
)files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])privacy (
betty.model.ancestry.Privacy
|None
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property facts: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property source: _AssociateT & Entity | None¶
Get the associate from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- class betty.model.ancestry.Dated[source]¶
Bases:
LinkedDataDumpable
A resource with date information.
- Parameters:
args (
typing.Any
)date (
betty.locale.Date
|betty.locale.DateRange
|None
)kwargs (
typing.Any
)
- __init__(*args: Any, date: betty.locale.Date | betty.locale.DateRange | None = None, **kwargs: Any)[source]¶
- Parameters:
args (
typing.Any
)date (
betty.locale.Date
|betty.locale.DateRange
|None
)kwargs (
typing.Any
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.Described[source]¶
Bases:
LinkedDataDumpable
A resource with a description.
- Parameters:
args (
typing.Any
)kwargs (
typing.Any
)
- __init__(*args: Any, description: str | None = None, **kwargs: Any)[source]¶
- Parameters:
args (
typing.Any
)kwargs (
typing.Any
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.Enclosure[source]¶
Bases:
Dated
,HasCitations
,Entity
The enclosure of one place by another.
Enclosures describe the outer (
`enclosed_by`) and inner(``encloses
) places, and their relationship.- Parameters:
encloses (
betty.model.ancestry.Place
|None
)enclosed_by (
betty.model.ancestry.Place
|None
)
- __init__(encloses: betty.model.ancestry.Place | None = None, enclosed_by: betty.model.ancestry.Place | None = None)[source]¶
- Parameters:
encloses (
betty.model.ancestry.Place
|None
)enclosed_by (
betty.model.ancestry.Place
|None
)
- property enclosed_by: _AssociateT & Entity | None¶
The outer place.
- Parameters:
owner (_OwnerT & Entity)
- property encloses: _AssociateT & Entity | None¶
The inner place.
- Parameters:
owner (_OwnerT & Entity)
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- class betty.model.ancestry.Event[source]¶
Bases:
Dated
,HasFiles
,HasCitations
,HasNotes
,Described
,HasPrivacy
,HasLinksEntity
,UserFacingEntity
,Entity
An event that took place.
- Parameters:
event_type (
type
[betty.model.event_type.EventType
])date (
betty.locale.Date
|betty.locale.DateRange
|None
)files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])citations (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Citation
]])notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])privacy (
betty.model.ancestry.Privacy
|None
)place (
betty.model.ancestry.Place
|None
)
- __init__(*, id: str | None = None, event_type: type[betty.model.event_type.EventType] = <class 'betty.model.event_type.UnknownEventType'>, date: betty.locale.Date | betty.locale.DateRange | None = None, files: typing.Iterable[betty.model.ancestry.File] | None = None, citations: typing.Iterable[betty.model.ancestry.Citation] | None = None, notes: typing.Iterable[betty.model.ancestry.Note] | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None, place: betty.model.ancestry.Place | None = None, description: str | None = None)[source]¶
- Parameters:
event_type (
type
[betty.model.event_type.EventType
])date (
betty.locale.Date
|betty.locale.DateRange
|None
)files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])citations (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Citation
]])notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])privacy (
betty.model.ancestry.Privacy
|None
)place (
betty.model.ancestry.Place
|None
)
- property associated_files: Iterable[File]¶
All files directly or indirectly associated with this entity.
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property place: _AssociateT & Entity | None¶
The place the event happened.
- Parameters:
owner (_OwnerT & Entity)
- property presences: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- class betty.model.ancestry.File[source]¶
Bases:
Described
,HasPrivacy
,HasLinksEntity
,HasMediaType
,HasNotes
,HasCitations
,UserFacingEntity
,Entity
A file on disk.
This includes but is not limited to:
images
video
audio
PDF documents
- Parameters:
path (
pathlib.Path
)media_type (
betty.media_type.MediaType
|None
)notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])citations (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Citation
]])privacy (
betty.model.ancestry.Privacy
|None
)links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)
- __init__(path: pathlib.Path, *, id: str | None = None, name: str | None = None, media_type: betty.media_type.MediaType | None = None, description: str | None = None, notes: Iterable[betty.model.ancestry.Note] | None = None, citations: Iterable[betty.model.ancestry.Citation] | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None, links: collections.abc.MutableSequence[betty.model.ancestry.Link] | None = None)[source]¶
- Parameters:
path (
pathlib.Path
)media_type (
betty.media_type.MediaType
|None
)notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])citations (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Citation
]])privacy (
betty.model.ancestry.Privacy
|None
)links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property entities: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.HasCitations[source]¶
Bases:
LinkedDataDumpable
An entity with citations that support it.
- Parameters:
self (HasCitations & Entity)
args (Any)
citations (Iterable[Citation] | None)
kwargs (Any)
- __init__(*args: Any, citations: Iterable[Citation] | None = None, **kwargs: Any)[source]¶
- Parameters:
self (HasCitations & Entity)
args (Any)
citations (Iterable[Citation] | None)
kwargs (Any)
- property citations: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.HasFiles[source]¶
Bases:
object
An entity that has associated
betty.model.ancestry.File
entities.- Parameters:
self (HasFiles & Entity)
args (Any)
files (Iterable[File] | None)
kwargs (Any)
- __init__(*args: Any, files: Iterable[File] | None = None, **kwargs: Any)[source]¶
- Parameters:
self (HasFiles & Entity)
args (Any)
files (Iterable[File] | None)
kwargs (Any)
- property associated_files: Iterable[File]¶
All files directly or indirectly associated with this entity.
- property files: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- class betty.model.ancestry.HasLinks[source]¶
Bases:
LinkedDataDumpable
A resource that has external links.
- Parameters:
args (
typing.Any
)links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)kwargs (
typing.Any
)
- __init__(*args: Any, links: collections.abc.MutableSequence[betty.model.ancestry.Link] | None = None, **kwargs: Any)[source]¶
- Parameters:
args (
typing.Any
)links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)kwargs (
typing.Any
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property links: MutableSequence[Link]¶
The extenal links.
- class betty.model.ancestry.HasLinksEntity[source]¶
Bases:
HasLinks
An entity that has external links.
- Parameters:
args (
typing.Any
)links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)kwargs (
typing.Any
)
- class betty.model.ancestry.HasMediaType[source]¶
Bases:
LinkedDataDumpable
A resource with an IANA media type.
- Parameters:
args (
typing.Any
)media_type (
betty.media_type.MediaType
|None
)kwargs (
typing.Any
)
- __init__(*args: Any, media_type: betty.media_type.MediaType | None = None, **kwargs: Any)[source]¶
- Parameters:
args (
typing.Any
)media_type (
betty.media_type.MediaType
|None
)kwargs (
typing.Any
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.HasNotes[source]¶
Bases:
LinkedDataDumpable
An entity that has notes associated with it.
- Parameters:
self (HasNotes & Entity)
args (Any)
notes (Iterable[Note] | None)
kwargs (Any)
- __init__(*args: Any, notes: Iterable[Note] | None = None, **kwargs: Any)[source]¶
- Parameters:
self (HasNotes & Entity)
args (Any)
notes (Iterable[Note] | None)
kwargs (Any)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property notes: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- class betty.model.ancestry.HasPrivacy[source]¶
Bases:
LinkedDataDumpable
A resource that has privacy.
- Parameters:
args (
typing.Any
)privacy (
betty.model.ancestry.Privacy
|None
)kwargs (
typing.Any
)
- __init__(*args: Any, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None, **kwargs: Any)[source]¶
- Parameters:
args (
typing.Any
)privacy (
betty.model.ancestry.Privacy
|None
)kwargs (
typing.Any
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property own_privacy: Privacy¶
The resource’s own privacy.
This returns the value that was set for
betty.model.ancestry.HasPrivacy.privacy
and ignores computed privacies.For access control and permissions checking, use
betty.model.ancestry.HasPrivacy.privacy
.
- class betty.model.ancestry.Link[source]¶
Bases:
HasMediaType
,Localized
,Described
,LinkedDataDumpable
An external link.
- Parameters:
- __init__(url: str, *, relationship: str | None = None, label: str | None = None, description: str | None = None, media_type: betty.media_type.MediaType | None = None, locale: str | None = None)[source]¶
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
-
relationship:
str
|None
¶ The link’s IANA link relationship.
- class betty.model.ancestry.Note[source]¶
Bases:
UserFacingEntity
,HasPrivacy
,HasLinksEntity
,Entity
A note is a bit of textual information that can be associated with another entity.
- Parameters:
- __init__(text: str, *, id: str | None = None, entity: betty.model.ancestry.HasNotes | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None)[source]¶
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property entity: _AssociateT & Entity | None¶
The entity the note belongs to.
- Parameters:
owner (_OwnerT & Entity)
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.Organizer[source]¶
Bases:
PresenceRole
Someone organized the event.
- property label: Localizable¶
The human-readable label.
- class betty.model.ancestry.Person[source]¶
Bases:
HasFiles
,HasCitations
,HasNotes
,HasLinksEntity
,HasPrivacy
,UserFacingEntity
,Entity
A person.
- Parameters:
files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])citations (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Citation
]])links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])privacy (
betty.model.ancestry.Privacy
|None
)parents (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Person
]])children (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Person
]])presences (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Presence
]])names (
typing.Optional
[typing.Iterable
[betty.model.ancestry.PersonName
]])
- __init__(*, id: str | None = None, files: Iterable[betty.model.ancestry.File] | None = None, citations: Iterable[betty.model.ancestry.Citation] | None = None, links: collections.abc.MutableSequence[betty.model.ancestry.Link] | None = None, notes: Iterable[betty.model.ancestry.Note] | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None, parents: Iterable[betty.model.ancestry.Person] | None = None, children: Iterable[betty.model.ancestry.Person] | None = None, presences: Iterable[betty.model.ancestry.Presence] | None = None, names: Iterable[betty.model.ancestry.PersonName] | None = None)[source]¶
- Parameters:
files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])citations (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Citation
]])links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])privacy (
betty.model.ancestry.Privacy
|None
)parents (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Person
]])children (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Person
]])presences (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Presence
]])names (
typing.Optional
[typing.Iterable
[betty.model.ancestry.PersonName
]])
- property associated_files: Iterable[File]¶
All files directly or indirectly associated with this entity.
- property children: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property names: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- property parents: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- property presences: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- class betty.model.ancestry.PersonName[source]¶
Bases:
Localized
,HasCitations
,HasPrivacy
,Entity
A name for a
betty.model.ancestry.Person
.- Parameters:
- __init__(*, id: str | None = None, person: betty.model.ancestry.Person | None = None, individual: str | None = None, affiliation: str | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None, locale: str | None = None)[source]¶
- property affiliation: str | None¶
The name’s affiliation, or family component.
Also known as:
last name
surname
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property individual: str | None¶
The name’s individual component.
Also known as:
first name
given name
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property person: _AssociateT & Entity | None¶
The person whose name this is.
- Parameters:
owner (_OwnerT & Entity)
- class betty.model.ancestry.Place[source]¶
Bases:
HasLinksEntity
,HasFiles
,HasNotes
,HasPrivacy
,UserFacingEntity
,Entity
A place.
A place is a physical location on earth. It may be identifiable by GPS coordinates only, or be a well-known city, with names in many languages, imagery, and its own Wikipedia page, or any type of place in between.
- Parameters:
names (
list
[betty.model.ancestry.PlaceName
] |None
)events (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Event
]])enclosed_by (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Enclosure
]])encloses (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Enclosure
]])notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])coordinates (
geopy.point.Point
|None
)links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)privacy (
betty.model.ancestry.Privacy
|None
)
- __init__(*, id: str | None = None, names: list[betty.model.ancestry.PlaceName] | None = None, events: Iterable[betty.model.ancestry.Event] | None = None, enclosed_by: Iterable[betty.model.ancestry.Enclosure] | None = None, encloses: Iterable[betty.model.ancestry.Enclosure] | None = None, notes: Iterable[betty.model.ancestry.Note] | None = None, coordinates: geopy.point.Point | None = None, links: collections.abc.MutableSequence[betty.model.ancestry.Link] | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None)[source]¶
- Parameters:
names (
list
[betty.model.ancestry.PlaceName
] |None
)events (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Event
]])enclosed_by (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Enclosure
]])encloses (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Enclosure
]])notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])coordinates (
geopy.point.Point
|None
)links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)privacy (
betty.model.ancestry.Privacy
|None
)
- property associated_files: Iterable[File]¶
All files directly or indirectly associated with this entity.
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- property enclosed_by: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- property encloses: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property events: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.PlaceName[source]¶
Bases:
Localized
,Dated
,LinkedDataDumpable
A place name.
A name has a locale and a date during which the name was in use.
- Parameters:
name (
str
)date (
betty.locale.Date
|betty.locale.DateRange
|None
)
- __init__(name: str, *, locale: str | None = None, date: betty.locale.Date | betty.locale.DateRange | None = None)[source]¶
- Parameters:
name (
str
)date (
betty.locale.Date
|betty.locale.DateRange
|None
)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.Presence[source]¶
Bases:
HasPrivacy
,Entity
The presence of a
betty.model.ancestry.Person
at anbetty.model.ancestry.Event
.- Parameters:
person (
betty.model.ancestry.Person
|None
)event (
betty.model.ancestry.Event
|None
)
- __init__(person: betty.model.ancestry.Person | None, role: betty.model.ancestry.PresenceRole, event: betty.model.ancestry.Event | None)[source]¶
- Parameters:
person (
betty.model.ancestry.Person
|None
)event (
betty.model.ancestry.Event
|None
)
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property event: _AssociateT & Entity | None¶
The event the person was present at.
- Parameters:
owner (_OwnerT & Entity)
- property label: Localizable¶
The entity’s human-readable label.
- property person: _AssociateT & Entity | None¶
The person whose presence is described.
- Parameters:
owner (_OwnerT & Entity)
-
role:
betty.model.ancestry.PresenceRole
¶ The role the person performed at the event.
- class betty.model.ancestry.PresenceRole[source]¶
Bases:
object
A person’s role at an event.
- property label: Localizable¶
The human-readable label.
- class betty.model.ancestry.Privacy[source]¶
Bases:
Enum
The available privacy modes.
- PRIVATE = 2¶
The resource is explicitly made private.
- PUBLIC = 1¶
The resource is explicitly made public.
- UNDETERMINED = 3¶
The resource has no explicit privacy. This means that:
it may be changed at will
when checking access, UNDETERMINED evaluates to PUBLIC.
- class betty.model.ancestry.Source[source]¶
Bases:
Dated
,HasFiles
,HasNotes
,HasLinksEntity
,HasPrivacy
,UserFacingEntity
,Entity
A source of information.
- Parameters:
contained_by (
betty.model.ancestry.Source
|None
)contains (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Source
]])notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])date (
betty.locale.Date
|betty.locale.DateRange
|None
)files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)privacy (
betty.model.ancestry.Privacy
|None
)
- __init__(name: str | None = None, *, id: str | None = None, author: str | None = None, publisher: str | None = None, contained_by: betty.model.ancestry.Source | None = None, contains: Iterable[betty.model.ancestry.Source] | None = None, notes: Iterable[betty.model.ancestry.Note] | None = None, date: betty.locale.Date | betty.locale.DateRange | None = None, files: Iterable[betty.model.ancestry.File] | None = None, links: collections.abc.MutableSequence[betty.model.ancestry.Link] | None = None, privacy: betty.model.ancestry.Privacy | None = None, public: bool | None = None, private: bool | None = None)[source]¶
- Parameters:
contained_by (
betty.model.ancestry.Source
|None
)contains (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Source
]])notes (
typing.Optional
[typing.Iterable
[betty.model.ancestry.Note
]])date (
betty.locale.Date
|betty.locale.DateRange
|None
)files (
typing.Optional
[typing.Iterable
[betty.model.ancestry.File
]])links (
collections.abc.MutableSequence
[betty.model.ancestry.Link
] |None
)privacy (
betty.model.ancestry.Privacy
|None
)
- property citations: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- property contained_by: _AssociateT & Entity | None¶
The source this one is directly contained by.
- Parameters:
owner (_OwnerT & Entity)
- property contains: EntityCollection[_AssociateT & Entity]¶
Get the associates from the given owner.
- Parameters:
owner (_OwnerT & Entity)
- async dump_linked_data(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Dump this instance to JSON-LD.
- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- classmethod entity_type_label() betty.locale.Localizable [source]¶
The human-readable entity type label, singular.
- Return type:
- classmethod entity_type_label_plural() betty.locale.Localizable [source]¶
The human-readable entity type label, plural.
- Return type:
- property label: Localizable¶
The entity’s human-readable label.
- async classmethod linked_data_schema(app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Define the JSON Schema for
betty.json.linked_data.LinkedDataDumpable.dump_linked_data()
.- Parameters:
app (
betty.app.App
)- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- class betty.model.ancestry.Speaker[source]¶
Bases:
PresenceRole
Someone performed public speaking at the event.
- property label: Localizable¶
The human-readable label.
- class betty.model.ancestry.Subject[source]¶
Bases:
PresenceRole
Someone was the subject of the event.
The meaning of this role depends on the event type. For example, for
betty.model.event_type.Marriage
, the subjects are the people who got married. Forbetty.model.event_type.Death
it is the person who died.- property label: Localizable¶
The human-readable label.
- class betty.model.ancestry.Witness[source]¶
Bases:
PresenceRole
Someone witnessed the event.
- property label: Localizable¶
The human-readable label.
- betty.model.ancestry.is_private(target: Any) bool [source]¶
Check if the given target is private.
- Parameters:
target (
typing.Any
)- Return type:
- betty.model.ancestry.is_public(target: Any) bool [source]¶
Check if the given target is public.
- Parameters:
target (
typing.Any
)- Return type:
- betty.model.ancestry.merge_privacies(*privacies: betty.model.ancestry.Privacy | betty.model.ancestry.HasPrivacy | None) betty.model.ancestry.Privacy [source]¶
Merge multiple privacies into one.
- Parameters:
privacies (
betty.model.ancestry.Privacy
|betty.model.ancestry.HasPrivacy
|None
)- Return type:
- async betty.model.ancestry.ref_link(root_schema: dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]], app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Reference the Link schema.
- Parameters:
root_schema (
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]])app (
betty.app.App
)
- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- async betty.model.ancestry.ref_link_collection(root_schema: dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]], app: betty.app.App) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Reference the schema for a collection of Link instances.
- Parameters:
root_schema (
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]])app (
betty.app.App
)
- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- betty.model.ancestry.ref_media_type(root_schema: dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]]) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Reference the MediaType schema.
- Parameters:
root_schema (
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]])- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- betty.model.ancestry.ref_role(root_schema: dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]]) dict[str, bool | int | float | str | None | Sequence[bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]] | Mapping[str, bool | int | float | str | None | Sequence[Dump] | Mapping[str, Dump]]] [source]¶
Reference the PresenceRole schema.
- Parameters:
root_schema (
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]])- Return type:
dict
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]],typing.Mapping
[str
,typing.Union
[bool
,int
,float
,str
,None
,typing.Sequence
[Dump],typing.Mapping
[str
, Dump]]]]]
- betty.model.ancestry.resolve_privacy(privacy: betty.model.ancestry.Privacy | betty.model.ancestry.HasPrivacy | None) betty.model.ancestry.Privacy [source]¶
Resolve the privacy of a value.
- Parameters:
privacy (
betty.model.ancestry.Privacy
|betty.model.ancestry.HasPrivacy
|None
)- Return type: