commit 82c2976ff72e300848e0b7180b1303872d466d8b · dwn.poxiao-labs.work/atpasser

+25 -2

src/atpasser/recordKeys/__init__.py src/atpasser/rKey/__init__.py

···

       1
       -
       class RecordKey:

     

       2
        
           """

     

       0
        
       
     

       3
        
           A class representing a RecordKey.

     

       0
        
       
     

       4
        
       

     

       5
        
       

     

       6
        
           Attributes:

     

       0
        
       
     

       7
        
               recordKey (str): The RecordKey URI.

     

       8
        
           """

     

       0
        
       
     

       9
        
       

     

       10
        
           def __init__(self, recordKey: str) -> None:

     

       11
        
               """

     

       0
        
       
     

       12
        
               Initalizes an RecordKey object.

     

       13
        
       

     

       0
        
       
     

       14
        
               Parameters:

     

       0
        
       
     

       15
        
                   recordKey (str): The RecordKey.

     

       16
        
               """

     

       17
        
       

     

       0
        
       
     

       18
        
               if recordKey == "" or len(recordKey) > 512:

     

       0
        
       
     

       19
        
                   raise ValueError("null record key or record key longer than 512 chars")

     

       20
        
       

     

       0
        
       
     

       21
        
               if recordKey == ".." or recordKey == ".":

     

       0
        
       
     

       22
        
                   raise ValueError("reserved value . and ..")

     

       0
        
       
     

       23
        
       

     

       24
        
               if not set(recordKey).issubset(

     

       0
        
       
     

       25
        
                   set("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789.-_:~")

     

       26
        
               ):

     

       0
        
       
     

       27
        
                   raise ValueError("invalid char")

     

       28
        
       

     

       0
        
       
     

       29
        
               self.recordKey = recordKey

     

       0
        
       
     

       30
        
       

     

       31
        
           def __str__(self) -> str:

     

       32
        
               """

     

       33
        
       

     

       0
        
       
     

       34
        
               Convert the RecordKey to a string by given the URI.

     

       35
        
               """

     

       36
        
               return self.recordKey

     

       0
        
       
     

       37
        
       

     

       38
        
           def __eq__(self, value: object, /) -> bool:

     

       39
        
               """

     

       0
        
       
     

       40
        
       

     

       41
        
               Check if the 2 values are exactly the same.

     

       42
        
               """

     

       43
        
       

     

       44
       -
               if isinstance(value, RecordKey):

     

       0
        
       
     

       0
        
       
     

       45
        
       

     

       46
        
                   return str(self) == str(value)

     

       47
        
               else:

     

       0
        
       
     

       48
        
       

     

       49
        
                   return False

     

       0

···

       1
       +
       class RKey:

     

       2
        
           """

     

       3
       +
       

     

       4
        
           A class representing a RecordKey.

     

       5
       +
       

     

       6
        
       

     

       7
        
       

     

       8
        
           Attributes:

     

       9
       +
       

     

       10
        
               recordKey (str): The RecordKey URI.

     

       11
        
           """

     

       12
       +
       

     

       13
        
       

     

       14
        
           def __init__(self, recordKey: str) -> None:

     

       15
        
               """

     

       16
       +
       

     

       17
        
               Initalizes an RecordKey object.

     

       18
        
       

     

       19
       +
       

     

       20
        
               Parameters:

     

       21
       +
       

     

       22
        
                   recordKey (str): The RecordKey.

     

       23
        
               """

     

       24
        
       

     

       25
       +
       

     

       26
        
               if recordKey == "" or len(recordKey) > 512:

     

       27
       +
       

     

       28
        
                   raise ValueError("null record key or record key longer than 512 chars")

     

       29
        
       

     

       30
       +
       

     

       31
        
               if recordKey == ".." or recordKey == ".":

     

       32
       +
       

     

       33
        
                   raise ValueError("reserved value . and ..")

     

       34
       +
       

     

       35
        
       

     

       36
        
               if not set(recordKey).issubset(

     

       37
       +
       

     

       38
        
                   set("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789.-_:~")

     

       39
        
               ):

     

       40
       +
       

     

       41
        
                   raise ValueError("invalid char")

     

       42
        
       

     

       43
       +
       

     

       44
        
               self.recordKey = recordKey

     

       45
       +
       

     

       46
        
       

     

       47
        
           def __str__(self) -> str:

     

       48
        
               """

     

       49
        
       

     

       50
       +
       

     

       51
        
               Convert the RecordKey to a string by given the URI.

     

       52
        
               """

     

       53
        
               return self.recordKey

     

       54
       +
       

     

       55
        
       

     

       56
        
           def __eq__(self, value: object, /) -> bool:

     

       57
        
               """

     

       58
       +
       

     

       59
        
       

     

       60
        
               Check if the 2 values are exactly the same.

     

       61
        
               """

     

       62
        
       

     

       63
       +
       

     

       64
       +
               if isinstance(value, RKey):

     

       65
       +
       

     

       66
        
       

     

       67
        
                   return str(self) == str(value)

     

       68
        
               else:

     

       69
       +
       

     

       70
        
       

     

       71
        
                   return False

     

       72
       +

+26 -2

src/atpasser/uri/restricted.py

···

       1
       -
       from atpasser import uri, handle, nsid, recordKeys

     

       0
        
       
     

       2
        
       

     

       3
        
       

     

       4
        
       class RestrictedURI(uri.URI):

     

       5
        
           """

     

       0
        
       
     

       6
        
           A class representing a restricted URI.

     

       7
        
       

     

       0
        
       
     

       8
        
           Attributes:

     

       0
        
       
     

       9
        
               collection (atpasser.nsid.NSID): Collection as NSID.

     

       0
        
       
     

       10
        
               rkey (atpasser.rKey.RKey): Record key as a RKey object.

     

       11
        
           """

     

       12
        
       

     

       0
        
       
     

       13
        
           def __init__(self, uri: str) -> None:

     

       14
        
               """

     

       0
        
       
     

       15
        
               Initalizes a restricted URI.

     

       16
        
       

     

       0
        
       
     

       17
        
               Parameters:

     

       0
        
       
     

       18
        
                   uri (str): The AT URI.

     

       19
        
               """

     

       0
        
       
     

       20
        
               super().__init__(uri)

     

       0
        
       
     

       21
        
               if self.query != None and self.fragment != None:

     

       0
        
       
     

       22
        
                   raise ValueError("has query and/or fragments")

     

       0
        
       
     

       23
        
               if self.authority == None:

     

       0
        
       
     

       24
        
                   raise ValueError("invalid DID or handle")

     

       0
        
       
     

       25
        
               if len(self.path) == 0:

     

       0
        
       
     

       26
        
                   self.collection, self.rkey = None, None

     

       0
        
       
     

       27
        
               elif len(self.path) == 1:

     

       0
        
       
     

       28
        
                   self.collection = nsid.NSID(self.path[0])

     

       0
        
       
     

       29
        
                   self.rkey = None

     

       0
        
       
     

       30
        
               elif len(self.path) == 2:

     

       0
        
       
     

       31
        
                   self.collection = nsid.NSID(self.path[0])

     

       32
       -
                   self.rkey = recordKeys.RecordKey(self.path[1])

     

       0
        
       
     

       33
        
               else:

     

       0
        
       
     

       34
        
                   raise ValueError("ttoo much path segments")

     

       0

···

       1
       +
       from atpasser import uri, handle, nsid, rKey

     

       2
       +
       

     

       3
        
       

     

       4
        
       

     

       5
        
       class RestrictedURI(uri.URI):

     

       6
        
           """

     

       7
       +
       

     

       8
        
           A class representing a restricted URI.

     

       9
        
       

     

       10
       +
       

     

       11
        
           Attributes:

     

       12
       +
       

     

       13
        
               collection (atpasser.nsid.NSID): Collection as NSID.

     

       14
       +
       

     

       15
        
               rkey (atpasser.rKey.RKey): Record key as a RKey object.

     

       16
        
           """

     

       17
        
       

     

       18
       +
       

     

       19
        
           def __init__(self, uri: str) -> None:

     

       20
        
               """

     

       21
       +
       

     

       22
        
               Initalizes a restricted URI.

     

       23
        
       

     

       24
       +
       

     

       25
        
               Parameters:

     

       26
       +
       

     

       27
        
                   uri (str): The AT URI.

     

       28
        
               """

     

       29
       +
       

     

       30
        
               super().__init__(uri)

     

       31
       +
       

     

       32
        
               if self.query != None and self.fragment != None:

     

       33
       +
       

     

       34
        
                   raise ValueError("has query and/or fragments")

     

       35
       +
       

     

       36
        
               if self.authority == None:

     

       37
       +
       

     

       38
        
                   raise ValueError("invalid DID or handle")

     

       39
       +
       

     

       40
        
               if len(self.path) == 0:

     

       41
       +
       

     

       42
        
                   self.collection, self.rkey = None, None

     

       43
       +
       

     

       44
        
               elif len(self.path) == 1:

     

       45
       +
       

     

       46
        
                   self.collection = nsid.NSID(self.path[0])

     

       47
       +
       

     

       48
        
                   self.rkey = None

     

       49
       +
       

     

       50
        
               elif len(self.path) == 2:

     

       51
       +
       

     

       52
        
                   self.collection = nsid.NSID(self.path[0])

     

       53
       +
       

     

       54
       +
                   self.rkey = rKey.RKey(self.path[1])

     

       55
        
               else:

     

       56
       +
       

     

       57
        
                   raise ValueError("ttoo much path segments")

     

       58
       +

+83 -4

tests/_strings.py

···

       1
       -
       from atpasser import did, handle, nsid, recordKeys, uri

     

       0
        
       
     

       2
        
       

     

       3
        
       testStrings, testMethods = {}, {}

     

       4
        
       

     

       0
        
       
     

       5
        
       testStrings[

     

       6
        
           "did"

     

       0
        
       
     

       7
        
       ] = """did:plc:z72i7hdynmk6r22z27h6tvur

     

       0
        
       
     

       8
        
       did:web:blueskyweb.xyz

     

       0
        
       
     

       9
        
       did:method:val:two

     

       0
        
       
     

       10
        
       did:m:v

     

       0
        
       
     

       11
        
       did:method::::val

     

       0
        
       
     

       12
        
       did:method:-:_:.

     

       0
        
       
     

       13
        
       did:key:zQ3shZc2QzApp2oymGvQbzP8eKheVshBHbU4ZYjeXqwSKEn6N

     

       0
        
       
     

       14
        
       did:METHOD:val

     

       0
        
       
     

       15
        
       did:m123:val

     

       0
        
       
     

       16
        
       DID:method:val

     

       17
        
       did:method:

     

       0
        
       
     

       18
        
       did:method:val/two

     

       0
        
       
     

       19
        
       did:method:val?two

     

       0
        
       
     

       20
        
       did:method:val#two"""

     

       0
        
       
     

       21
        
       testMethods["did"] = did.DID

     

       0
        
       
     

       22
        
       

     

       23
        
       testStrings[

     

       24
        
           "handle"

     

       0
        
       
     

       25
        
       ] = """jay.bsky.social

     

       0
        
       
     

       26
        
       8.cn

     

       0
        
       
     

       27
        
       name.t--t

     

       0
        
       
     

       28
        
       XX.LCS.MIT.EDU

     

       29
        
       a.co

     

       0
        
       
     

       30
        
       xn--notarealidn.com

     

       0
        
       
     

       31
        
       xn--fiqa61au8b7zsevnm8ak20mc4a87e.xn--fiqs8s

     

       0
        
       
     

       32
        
       xn--ls8h.test

     

       33
        
       example.t

     

       0
        
       
     

       34
        
       jo@hn.test

     

       35
       -
       💩.test

     

       0
        
       
     

       0
        
       
     

       36
        
       john..test

     

       0
        
       
     

       37
        
       xn--bcher-.tld

     

       0
        
       
     

       38
        
       john.0

     

       0
        
       
     

       39
        
       cn.8

     

       0
        
       
     

       40
        
       www.masełkowski.pl.com

     

       0
        
       
     

       41
        
       org

     

       0
        
       
     

       42
        
       name.org.

     

       0
        
       
     

       43
        
       2gzyxa5ihm7nsggfxnu52rck2vv4rvmdlkiu3zzui5du4xyclen53wid.onion

     

       44
        
       laptop.local

     

       0
        
       
     

       45
        
       blah.arpa"""

     

       0
        
       
     

       46
        
       testMethods["handle"] = handle.Handle

     

       0
        
       
     

       47
        
       

     

       48
        
       testStrings[

     

       49
        
           "nsid"

     

       0
        
       
     

       50
        
       ] = """com.example.fooBar

     

       0
        
       
     

       51
        
       net.users.bob.ping

     

       0
        
       
     

       52
        
       a-0.b-1.c

     

       0
        
       
     

       53
        
       a.b.c

     

       0
        
       
     

       54
        
       com.example.fooBarV2

     

       0
        
       
     

       55
        
       cn.8.lex.stuff

     

       56
       -
       com.exa💩ple.thing

     

       0
        
       
     

       57
        
       com.example

     

       0
        
       
     

       58
        
       com.example.3"""

     

       0
        
       
     

       59
        
       testMethods["nsid"] = nsid.NSID

     

       0
        
       
     

       60
        
       

     

       61
        
       testStrings[

     

       0
        
       
     

       62
        
           "rkey"

     

       0
        
       
     

       63
        
       ] = """3jui7kd54zh2y

     

       64
        
       self

     

       65
        
       example.com

     

       0
        
       
     

       66
        
       ~1.2-3_

     

       0
        
       
     

       67
        
       dHJ1ZQ

     

       68
        
       pre:fix

     

       0
        
       
     

       69
        
       _

     

       0
        
       
     

       70
        
       alpha/beta

     

       71
        
       .

     

       72
        
       ..

     

       0
        
       
     

       73
        
       #extra

     

       0
        
       
     

       74
        
       @handle

     

       0
        
       
     

       75
        
       any space

     

       0
        
       
     

       76
        
       any+space

     

       0
        
       
     

       77
        
       number[3]

     

       0
        
       
     

       78
        
       number(3)

     

       0
        
       
     

       79
        
       "quote"

     

       0
        
       
     

       80
        
       dHJ1ZQ=="""

     

       81
       -
       testMethods["rkey"] = recordKeys.RecordKey

     

       0
        
       
     

       0
        
       
     

       82
        
       

     

       83
        
       testStrings[

     

       84
        
           "uri"

     

       0
        
       
     

       85
        
       ] = """at://foo.com/com.example.foo/123

     

       0
        
       
     

       86
        
       at://foo.com/example/123

     

       0
        
       
     

       87
        
       at://computer

     

       0
        
       
     

       88
        
       at://example.com:3000

     

       0
        
       
     

       89
        
       at://foo.com/

     

       0
        
       
     

       90
        
       at://user:pass@foo.com"""

     

       0
        
       
     

       91
        
       testMethods["uri"] = uri.URI

     

       0
        
       
     

       92
        
       

     

       93
        
       for item in testMethods:

     

       0
        
       
     

       94
        
           print(f"START TEST {item}")

     

       0
        
       
     

       95
        
           for value in testStrings[item].splitlines():

     

       0
        
       
     

       96
        
               print(f"Value: {value}")

     

       0
        
       
     

       97
        
               try:

     

       0
        
       
     

       98
        
                   print(f"str(): {str(testMethods[item](value))}")

     

       0
        
       
     

       99
        
               except Exception as e:

     

       0
        
       
     

       100
        
                   print(f"× {e}")

     

       0

···

       1
       +
       from atpasser import did, handle, nsid, rKey, uri

     

       2
       +
       

     

       3
        
       

     

       4
        
       testStrings, testMethods = {}, {}

     

       5
        
       

     

       6
       +
       

     

       7
        
       testStrings[

     

       8
        
           "did"

     

       9
       +
       

     

       10
        
       ] = """did:plc:z72i7hdynmk6r22z27h6tvur

     

       11
       +
       

     

       12
        
       did:web:blueskyweb.xyz

     

       13
       +
       

     

       14
        
       did:method:val:two

     

       15
       +
       

     

       16
        
       did:m:v

     

       17
       +
       

     

       18
        
       did:method::::val

     

       19
       +
       

     

       20
        
       did:method:-:_:.

     

       21
       +
       

     

       22
        
       did:key:zQ3shZc2QzApp2oymGvQbzP8eKheVshBHbU4ZYjeXqwSKEn6N

     

       23
       +
       

     

       24
        
       did:METHOD:val

     

       25
       +
       

     

       26
        
       did:m123:val

     

       27
       +
       

     

       28
        
       DID:method:val

     

       29
        
       did:method:

     

       30
       +
       

     

       31
        
       did:method:val/two

     

       32
       +
       

     

       33
        
       did:method:val?two

     

       34
       +
       

     

       35
        
       did:method:val#two"""

     

       36
       +
       

     

       37
        
       testMethods["did"] = did.DID

     

       38
       +
       

     

       39
        
       

     

       40
        
       testStrings[

     

       41
        
           "handle"

     

       42
       +
       

     

       43
        
       ] = """jay.bsky.social

     

       44
       +
       

     

       45
        
       8.cn

     

       46
       +
       

     

       47
        
       name.t--t

     

       48
       +
       

     

       49
        
       XX.LCS.MIT.EDU

     

       50
        
       a.co

     

       51
       +
       

     

       52
        
       xn--notarealidn.com

     

       53
       +
       

     

       54
        
       xn--fiqa61au8b7zsevnm8ak20mc4a87e.xn--fiqs8s

     

       55
       +
       

     

       56
        
       xn--ls8h.test

     

       57
        
       example.t

     

       58
       +
       

     

       59
        
       jo@hn.test

     

       60
       +
       

     

       61
       +
       💩.tes

     

       62
       +
       t

     

       63
        
       john..test

     

       64
       +
       

     

       65
        
       xn--bcher-.tld

     

       66
       +
       

     

       67
        
       john.0

     

       68
       +
       

     

       69
        
       cn.8

     

       70
       +
       

     

       71
        
       www.masełkowski.pl.com

     

       72
       +
       

     

       73
        
       org

     

       74
       +
       

     

       75
        
       name.org.

     

       76
       +
       

     

       77
        
       2gzyxa5ihm7nsggfxnu52rck2vv4rvmdlkiu3zzui5du4xyclen53wid.onion

     

       78
        
       laptop.local

     

       79
       +
       

     

       80
        
       blah.arpa"""

     

       81
       +
       

     

       82
        
       testMethods["handle"] = handle.Handle

     

       83
       +
       

     

       84
        
       

     

       85
        
       testStrings[

     

       86
        
           "nsid"

     

       87
       +
       

     

       88
        
       ] = """com.example.fooBar

     

       89
       +
       

     

       90
        
       net.users.bob.ping

     

       91
       +
       

     

       92
        
       a-0.b-1.c

     

       93
       +
       

     

       94
        
       a.b.c

     

       95
       +
       

     

       96
        
       com.example.fooBarV2

     

       97
       +
       

     

       98
        
       cn.8.lex.stuff

     

       99
       +
       

     

       100
       +
       com.exa💩ple.thin

     

       101
        
       com.example

     

       102
       +
       

     

       103
        
       com.example.3"""

     

       104
       +
       

     

       105
        
       testMethods["nsid"] = nsid.NSID

     

       106
       +
       

     

       107
        
       

     

       108
        
       testStrings[

     

       109
       +
       

     

       110
        
           "rkey"

     

       111
       +
       

     

       112
        
       ] = """3jui7kd54zh2y

     

       113
        
       self

     

       114
        
       example.com

     

       115
       +
       

     

       116
        
       ~1.2-3_

     

       117
       +
       

     

       118
        
       dHJ1ZQ

     

       119
        
       pre:fix

     

       120
       +
       

     

       121
        
       _

     

       122
       +
       

     

       123
        
       alpha/beta

     

       124
        
       .

     

       125
        
       ..

     

       126
       +
       

     

       127
        
       #extra

     

       128
       +
       

     

       129
        
       @handle

     

       130
       +
       

     

       131
        
       any space

     

       132
       +
       

     

       133
        
       any+space

     

       134
       +
       

     

       135
        
       number[3]

     

       136
       +
       

     

       137
        
       number(3)

     

       138
       +
       

     

       139
        
       "quote"

     

       140
       +
       

     

       141
        
       dHJ1ZQ=="""

     

       142
       +
       

     

       143
       +
       testMethods["rkey"] = rKey.RKey

     

       144
       +
       

     

       145
        
       

     

       146
        
       testStrings[

     

       147
        
           "uri"

     

       148
       +
       

     

       149
        
       ] = """at://foo.com/com.example.foo/123

     

       150
       +
       

     

       151
        
       at://foo.com/example/123

     

       152
       +
       

     

       153
        
       at://computer

     

       154
       +
       

     

       155
        
       at://example.com:3000

     

       156
       +
       

     

       157
        
       at://foo.com/

     

       158
       +
       

     

       159
        
       at://user:pass@foo.com"""

     

       160
       +
       

     

       161
        
       testMethods["uri"] = uri.URI

     

       162
       +
       

     

       163
        
       

     

       164
        
       for item in testMethods:

     

       165
       +
       

     

       166
        
           print(f"START TEST {item}")

     

       167
       +
       

     

       168
        
           for value in testStrings[item].splitlines():

     

       169
       +
       

     

       170
        
               print(f"Value: {value}")

     

       171
       +
       

     

       172
        
               try:

     

       173
       +
       

     

       174
        
                   print(f"str(): {str(testMethods[item](value))}")

     

       175
       +
       

     

       176
        
               except Exception as e:

     

       177
       +
       

     

       178
        
                   print(f"× {e}")

     

       179
       +