run the things

docs/source/atproto/atproto_client.models.rst

@@ -29,6 +29,7 @@ Submodules
    atproto_client.models.dot_dict
    atproto_client.models.languages
    atproto_client.models.models_loader
+   atproto_client.models.string_formats
    atproto_client.models.type_conversion
    atproto_client.models.unknown_type
    atproto_client.models.utils

docs/source/atproto/atproto_client.models.string_formats.rst

@@ -0,0 +1,7 @@
+string\_formats
+======================================
+
+.. automodule:: atproto_client.models.string_formats
+   :members:
+   :undoc-members:
+   :show-inheritance:

packages/atproto_client/models/app/bsky/actor/defs.py

@@ -12,17 +12,18 @@
 
 if t.TYPE_CHECKING:
     from atproto_client import models
+    from atproto_client.models import string_formats
 from atproto_client.models import base
 
 
 class ProfileViewBasic(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`."""
 
-    did: str  #: Did.
-    handle: str  #: Handle.
+    did: 'string_formats.Did'  #: Did.
+    handle: 'string_formats.Handle'  #: Handle.
     associated: t.Optional['models.AppBskyActorDefs.ProfileAssociated'] = None  #: Associated.
-    avatar: t.Optional[str] = None  #: Avatar.
-    created_at: t.Optional[str] = None  #: Created at.
+    avatar: t.Optional['string_formats.Uri'] = None  #: Avatar.
+    created_at: t.Optional['string_formats.DateTime'] = None  #: Created at.
     display_name: t.Optional[str] = Field(default=None, max_length=640)  #: Display name.
     labels: t.Optional[t.List['models.ComAtprotoLabelDefs.Label']] = None  #: Labels.
     viewer: t.Optional['models.AppBskyActorDefs.ViewerState'] = None  #: Viewer.
@@ -35,14 +36,14 @@ class ProfileViewBasic(base.ModelBase):
 class ProfileView(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`."""
 
-    did: str  #: Did.
-    handle: str  #: Handle.
+    did: 'string_formats.Did'  #: Did.
+    handle: 'string_formats.Handle'  #: Handle.
     associated: t.Optional['models.AppBskyActorDefs.ProfileAssociated'] = None  #: Associated.
-    avatar: t.Optional[str] = None  #: Avatar.
-    created_at: t.Optional[str] = None  #: Created at.
+    avatar: t.Optional['string_formats.Uri'] = None  #: Avatar.
+    created_at: t.Optional['string_formats.DateTime'] = None  #: Created at.
     description: t.Optional[str] = Field(default=None, max_length=2560)  #: Description.
     display_name: t.Optional[str] = Field(default=None, max_length=640)  #: Display name.
-    indexed_at: t.Optional[str] = None  #: Indexed at.
+    indexed_at: t.Optional['string_formats.DateTime'] = None  #: Indexed at.
     labels: t.Optional[t.List['models.ComAtprotoLabelDefs.Label']] = None  #: Labels.
     viewer: t.Optional['models.AppBskyActorDefs.ViewerState'] = None  #: Viewer.
 
@@ -54,17 +55,17 @@ class ProfileView(base.ModelBase):
 class ProfileViewDetailed(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`."""
 
-    did: str  #: Did.
-    handle: str  #: Handle.
+    did: 'string_formats.Did'  #: Did.
+    handle: 'string_formats.Handle'  #: Handle.
     associated: t.Optional['models.AppBskyActorDefs.ProfileAssociated'] = None  #: Associated.
-    avatar: t.Optional[str] = None  #: Avatar.
-    banner: t.Optional[str] = None  #: Banner.
-    created_at: t.Optional[str] = None  #: Created at.
+    avatar: t.Optional['string_formats.Uri'] = None  #: Avatar.
+    banner: t.Optional['string_formats.Uri'] = None  #: Banner.
+    created_at: t.Optional['string_formats.DateTime'] = None  #: Created at.
     description: t.Optional[str] = Field(default=None, max_length=2560)  #: Description.
     display_name: t.Optional[str] = Field(default=None, max_length=640)  #: Display name.
     followers_count: t.Optional[int] = None  #: Followers count.
     follows_count: t.Optional[int] = None  #: Follows count.
-    indexed_at: t.Optional[str] = None  #: Indexed at.
+    indexed_at: t.Optional['string_formats.DateTime'] = None  #: Indexed at.
     joined_via_starter_pack: t.Optional['models.AppBskyGraphDefs.StarterPackViewBasic'] = (
         None  #: Joined via starter pack.
     )
@@ -106,10 +107,10 @@ class ViewerState(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`. Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests."""
 
     blocked_by: t.Optional[bool] = None  #: Blocked by.
-    blocking: t.Optional[str] = None  #: Blocking.
+    blocking: t.Optional['string_formats.AtUri'] = None  #: Blocking.
     blocking_by_list: t.Optional['models.AppBskyGraphDefs.ListViewBasic'] = None  #: Blocking by list.
-    followed_by: t.Optional[str] = None  #: Followed by.
-    following: t.Optional[str] = None  #: Following.
+    followed_by: t.Optional['string_formats.AtUri'] = None  #: Followed by.
+    following: t.Optional['string_formats.AtUri'] = None  #: Following.
     known_followers: t.Optional['models.AppBskyActorDefs.KnownFollowers'] = None  #: Known followers.
     muted: t.Optional[bool] = None  #: Muted.
     muted_by_list: t.Optional['models.AppBskyGraphDefs.ListViewBasic'] = None  #: Muted by list.
@@ -168,7 +169,9 @@ class ContentLabelPref(base.ModelBase):
     visibility: t.Union[
         t.Literal['ignore'], t.Literal['show'], t.Literal['warn'], t.Literal['hide'], str
     ]  #: Visibility.
-    labeler_did: t.Optional[str] = None  #: Which labeler does this preference apply to? If undefined, applies globally.
+    labeler_did: t.Optional['string_formats.Did'] = (
+        None  #: Which labeler does this preference apply to? If undefined, applies globally.
+    )
 
     py_type: t.Literal['app.bsky.actor.defs#contentLabelPref'] = Field(
         default='app.bsky.actor.defs#contentLabelPref', alias='$type', frozen=True
@@ -201,8 +204,8 @@ class SavedFeedsPrefV2(base.ModelBase):
 class SavedFeedsPref(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`."""
 
-    pinned: t.List[str]  #: Pinned.
-    saved: t.List[str]  #: Saved.
+    pinned: t.List['string_formats.AtUri']  #: Pinned.
+    saved: t.List['string_formats.AtUri']  #: Saved.
     timeline_index: t.Optional[int] = None  #: Timeline index.
 
     py_type: t.Literal['app.bsky.actor.defs#savedFeedsPref'] = Field(
@@ -213,7 +216,7 @@ class SavedFeedsPref(base.ModelBase):
 class PersonalDetailsPref(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`."""
 
-    birth_date: t.Optional[str] = None  #: The birth date of account owner.
+    birth_date: t.Optional['string_formats.DateTime'] = None  #: The birth date of account owner.
 
     py_type: t.Literal['app.bsky.actor.defs#personalDetailsPref'] = Field(
         default='app.bsky.actor.defs#personalDetailsPref', alias='$type', frozen=True
@@ -273,7 +276,7 @@ class MutedWord(base.ModelBase):
     actor_target: t.Optional[t.Union[t.Literal['all'], t.Literal['exclude-following'], str]] = (
         'all'  #: Groups of users to apply the muted word to. If undefined, applies to all users.
     )
-    expires_at: t.Optional[str] = (
+    expires_at: t.Optional['string_formats.DateTime'] = (
         None  #: The date and time at which the muted word will expire and no longer be applied.
     )
     id: t.Optional[str] = None  #: Id.
@@ -296,7 +299,7 @@ class MutedWordsPref(base.ModelBase):
 class HiddenPostsPref(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`."""
 
-    items: t.List[str]  #: A list of URIs of posts the account owner has hidden.
+    items: t.List['string_formats.AtUri']  #: A list of URIs of posts the account owner has hidden.
 
     py_type: t.Literal['app.bsky.actor.defs#hiddenPostsPref'] = Field(
         default='app.bsky.actor.defs#hiddenPostsPref', alias='$type', frozen=True
@@ -316,7 +319,7 @@ class LabelersPref(base.ModelBase):
 class LabelerPrefItem(base.ModelBase):
     """Definition model for :obj:`app.bsky.actor.defs`."""
 
-    did: str  #: Did.
+    did: 'string_formats.Did'  #: Did.
 
     py_type: t.Literal['app.bsky.actor.defs#labelerPrefItem'] = Field(
         default='app.bsky.actor.defs#labelerPrefItem', alias='$type', frozen=True
@@ -357,7 +360,7 @@ class Nux(base.ModelBase):
     data: t.Optional[str] = Field(
         default=None, max_length=3000
     )  #: Arbitrary data for the NUX. The structure is defined by the NUX itself. Limited to 300 characters.
-    expires_at: t.Optional[str] = (
+    expires_at: t.Optional['string_formats.DateTime'] = (
         None  #: The date and time at which the NUX will expire and should be considered completed.
     )
 

packages/atproto_client/models/app/bsky/actor/get_profile.py

@@ -7,14 +7,16 @@
 
 import typing as t
 
+if t.TYPE_CHECKING:
+    from atproto_client.models import string_formats
 from atproto_client.models import base
 
 
 class Params(base.ParamsModelBase):
     """Parameters model for :obj:`app.bsky.actor.getProfile`."""
 
-    actor: str  #: Handle or DID of account to fetch profile of.
+    actor: 'string_formats.Handle'  #: Handle or DID of account to fetch profile of.
 
 
 class ParamsDict(t.TypedDict):
-    actor: str  #: Handle or DID of account to fetch profile of.
+    actor: 'string_formats.Handle'  #: Handle or DID of account to fetch profile of.

packages/atproto_client/models/app/bsky/actor/get_profiles.py

@@ -11,17 +11,18 @@
 
 if t.TYPE_CHECKING:
     from atproto_client import models
+    from atproto_client.models import string_formats
 from atproto_client.models import base
 
 
 class Params(base.ParamsModelBase):
     """Parameters model for :obj:`app.bsky.actor.getProfiles`."""
 
-    actors: t.List[str] = Field(max_length=25)  #: Actors.
+    actors: t.List['string_formats.Handle'] = Field(max_length=25)  #: Actors.
 
 
 class ParamsDict(t.TypedDict):
-    actors: t.List[str]  #: Actors.
+    actors: t.List['string_formats.Handle']  #: Actors.
 
 
 class Response(base.ResponseModelBase):

packages/atproto_client/models/app/bsky/actor/profile.py

@@ -12,6 +12,7 @@
 
 if t.TYPE_CHECKING:
     from atproto_client import models
+    from atproto_client.models import string_formats
     from atproto_client.models.blob_ref import BlobRef
 from atproto_client.models import base
 
@@ -23,7 +24,7 @@ class Record(base.RecordModelBase):
         None  #: Small image to be displayed next to posts from account. AKA, 'profile picture'.
     )
     banner: t.Optional['BlobRef'] = None  #: Larger horizontal image to display behind profile view.
-    created_at: t.Optional[str] = None  #: Created at.
+    created_at: t.Optional['string_formats.DateTime'] = None  #: Created at.
     description: t.Optional[str] = Field(default=None, max_length=2560)  #: Free-form profile description text.
     display_name: t.Optional[str] = Field(default=None, max_length=640)  #: Display name.
     joined_via_starter_pack: t.Optional['models.ComAtprotoRepoStrongRef.Main'] = None  #: Joined via starter pack.

packages/atproto_client/models/app/bsky/embed/external.py

@@ -11,6 +11,7 @@
 
 if t.TYPE_CHECKING:
     from atproto_client import models
+    from atproto_client.models import string_formats
     from atproto_client.models.blob_ref import BlobRef
 from atproto_client.models import base
 
@@ -28,7 +29,7 @@ class External(base.ModelBase):
 
     description: str  #: Description.
     title: str  #: Title.
-    uri: str  #: Uri.
+    uri: 'string_formats.Uri'  #: Uri.
     thumb: t.Optional['BlobRef'] = None  #: Thumb.
 
     py_type: t.Literal['app.bsky.embed.external#external'] = Field(
@@ -51,8 +52,8 @@ class ViewExternal(base.ModelBase):
 
     description: str  #: Description.
     title: str  #: Title.
-    uri: str  #: Uri.
-    thumb: t.Optional[str] = None  #: Thumb.
+    uri: 'string_formats.Uri'  #: Uri.
+    thumb: t.Optional['string_formats.Uri'] = None  #: Thumb.
 
     py_type: t.Literal['app.bsky.embed.external#viewExternal'] = Field(
         default='app.bsky.embed.external#viewExternal', alias='$type', frozen=True

packages/atproto_client/models/app/bsky/embed/images.py

@@ -11,6 +11,7 @@
 
 if t.TYPE_CHECKING:
     from atproto_client import models
+    from atproto_client.models import string_formats
     from atproto_client.models.blob_ref import BlobRef
 from atproto_client.models import base
 
@@ -49,8 +50,8 @@ class ViewImage(base.ModelBase):
     """Definition model for :obj:`app.bsky.embed.images`."""
 
     alt: str  #: Alt text description of the image, for accessibility.
-    fullsize: str  #: Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.
-    thumb: str  #: Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
+    fullsize: 'string_formats.Uri'  #: Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.
+    thumb: 'string_formats.Uri'  #: Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
     aspect_ratio: t.Optional['models.AppBskyEmbedDefs.AspectRatio'] = None  #: Aspect ratio.
 
     py_type: t.Literal['app.bsky.embed.images#viewImage'] = Field(

packages/atproto_client/models/app/bsky/embed/record.py

@@ -12,6 +12,7 @@
 
 if t.TYPE_CHECKING:
     from atproto_client import models
+    from atproto_client.models import string_formats
     from atproto_client.models.unknown_type import UnknownType
 from atproto_client.models import base
 
@@ -50,9 +51,9 @@ class ViewRecord(base.ModelBase):
     """Definition model for :obj:`app.bsky.embed.record`."""
 
     author: 'models.AppBskyActorDefs.ProfileViewBasic'  #: Author.
-    cid: str  #: Cid.
-    indexed_at: str  #: Indexed at.
-    uri: str  #: Uri.
+    cid: 'string_formats.Cid'  #: Cid.
+    indexed_at: 'string_formats.DateTime'  #: Indexed at.
+    uri: 'string_formats.AtUri'  #: Uri.
     value: 'UnknownType'  #: The record data itself.
     embeds: t.Optional[
         t.List[
@@ -83,7 +84,7 @@ class ViewNotFound(base.ModelBase):
     """Definition model for :obj:`app.bsky.embed.record`."""
 
     not_found: bool = Field(frozen=True)  #: Not found.
-    uri: str  #: Uri.
+    uri: 'string_formats.AtUri'  #: Uri.
 
     py_type: t.Literal['app.bsky.embed.record#viewNotFound'] = Field(
         default='app.bsky.embed.record#viewNotFound', alias='$type', frozen=True
@@ -95,7 +96,7 @@ class ViewBlocked(base.ModelBase):
 
     author: 'models.AppBskyFeedDefs.BlockedAuthor'  #: Author.
     blocked: bool = Field(frozen=True)  #: Blocked.
-    uri: str  #: Uri.
+    uri: 'string_formats.AtUri'  #: Uri.
 
     py_type: t.Literal['app.bsky.embed.record#viewBlocked'] = Field(
         default='app.bsky.embed.record#viewBlocked', alias='$type', frozen=True
@@ -106,7 +107,7 @@ class ViewDetached(base.ModelBase):
     """Definition model for :obj:`app.bsky.embed.record`."""
 
     detached: bool = Field(frozen=True)  #: Detached.
-    uri: str  #: Uri.
+    uri: 'string_formats.AtUri'  #: Uri.
 
     py_type: t.Literal['app.bsky.embed.record#viewDetached'] = Field(
         default='app.bsky.embed.record#viewDetached', alias='$type', frozen=True

packages/atproto_client/models/app/bsky/embed/video.py

@@ -11,6 +11,7 @@
 
 if t.TYPE_CHECKING:
     from atproto_client import models
+    from atproto_client.models import string_formats
     from atproto_client.models.blob_ref import BlobRef
 from atproto_client.models import base
 
@@ -32,7 +33,7 @@ class Caption(base.ModelBase):
     """Definition model for :obj:`app.bsky.embed.video`."""
 
     file: 'BlobRef'  #: File.
-    lang: str  #: Lang.
+    lang: 'string_formats.Language'  #: Lang.
 
     py_type: t.Literal['app.bsky.embed.video#caption'] = Field(
         default='app.bsky.embed.video#caption', alias='$type', frozen=True
@@ -42,11 +43,11 @@ class Caption(base.ModelBase):
 class View(base.ModelBase):
     """Definition model for :obj:`app.bsky.embed.video`."""
 
-    cid: str  #: Cid.
-    playlist: str  #: Playlist.
+    cid: 'string_formats.Cid'  #: Cid.
+    playlist: 'string_formats.Uri'  #: Playlist.
     alt: t.Optional[str] = Field(default=None, max_length=10000)  #: Alt.
     aspect_ratio: t.Optional['models.AppBskyEmbedDefs.AspectRatio'] = None  #: Aspect ratio.
-    thumbnail: t.Optional[str] = None  #: Thumbnail.
+    thumbnail: t.Optional['string_formats.Uri'] = None  #: Thumbnail.
 
     py_type: t.Literal['app.bsky.embed.video#view'] = Field(
         default='app.bsky.embed.video#view', alias='$type', frozen=True