@@ -72,7 +72,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
72
72
< span class ="kn "> import</ span > < span class ="nn "> json</ span >
73
73
< span class ="kn "> from</ span > < span class ="nn "> json.decoder</ span > < span class ="kn "> import</ span > < span class ="n "> JSONDecodeError</ span >
74
74
75
- < span class ="kn "> from</ span > < span class ="nn "> versionedobj.exceptions</ span > < span class ="kn "> import</ span > < span class ="n "> InvalidFilterError</ span > < span class ="p "> ,</ span > < span class ="n "> LoadObjError </ span > < span class ="p "> ,</ span > < span class ="n "> InputValidationError</ span > < span class ="p "> ,</ span > < span class ="n "> InvalidVersionAttributeError</ span >
75
+ < span class ="kn "> from</ span > < span class ="nn "> versionedobj.exceptions</ span > < span class ="kn "> import</ span > < span class ="n "> InvalidFilterError</ span > < span class ="p "> ,</ span > < span class ="n "> LoadObjectError </ span > < span class =" p " > , </ span > < span class =" n " > ObjectMigrationError </ span > < span class ="p "> ,</ span > < span class ="n "> InputValidationError</ span > < span class ="p "> ,</ span > < span class ="n "> InvalidVersionAttributeError</ span >
76
76
77
77
78
78
< div class ="viewcode-block " id ="migration "> < a class ="viewcode-back " href ="../../versionedobj.html#versionedobj.object.migration "> [docs]</ a > < span class ="k "> def</ span > < span class ="nf "> migration</ span > < span class ="p "> (</ span > < span class ="bp "> cls</ span > < span class ="p "> ,</ span > < span class ="n "> from_version</ span > < span class ="p "> ,</ span > < span class ="n "> to_version</ span > < span class ="p "> ):</ span >
@@ -352,7 +352,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
352
352
< span class ="sd "> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</ span >
353
353
354
354
< span class ="sd "> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</ span >
355
- < span class ="sd "> :raises versionedobj.exceptions.LoadObjError : if migration to current version fails.</ span >
355
+ < span class ="sd "> :raises versionedobj.exceptions.ObjectMigrationError : if migration to current version fails.</ span >
356
356
< span class ="sd "> :raises versionedobj.exceptions.InvalidFilterError: if both 'only' and 'ignore' are provided.</ span >
357
357
< span class ="sd "> """</ span >
358
358
< span class ="k "> return</ span > < span class ="bp "> cls</ span > < span class ="p "> ()</ span > < span class ="o "> .</ span > < span class ="n "> from_dict</ span > < span class ="p "> (</ span > < span class ="n "> attrs</ span > < span class ="p "> ,</ span > < span class ="n "> validate</ span > < span class ="p "> ,</ span > < span class ="n "> only</ span > < span class ="p "> ,</ span > < span class ="n "> ignore</ span > < span class ="p "> )</ span > </ div >
@@ -371,7 +371,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
371
371
< span class ="sd "> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</ span >
372
372
373
373
< span class ="sd "> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</ span >
374
- < span class ="sd "> :raises versionedobj.exceptions.LoadObjError : if migration to current version fails.</ span >
374
+ < span class ="sd "> :raises versionedobj.exceptions.ObjectMigrationError : if migration to current version fails.</ span >
375
375
< span class ="sd "> :raises versionedobj.exceptions.InvalidFilterError: if both 'only' and 'ignore' are provided.</ span >
376
376
< span class ="sd "> """</ span >
377
377
< span class ="k "> return</ span > < span class ="bp "> cls</ span > < span class ="p "> ()</ span > < span class ="o "> .</ span > < span class ="n "> from_json</ span > < span class ="p "> (</ span > < span class ="n "> jsonstr</ span > < span class ="p "> ,</ span > < span class ="n "> validate</ span > < span class ="p "> ,</ span > < span class ="n "> only</ span > < span class ="p "> ,</ span > < span class ="n "> ignore</ span > < span class ="p "> )</ span > </ div >
@@ -390,7 +390,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
390
390
< span class ="sd "> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</ span >
391
391
392
392
< span class ="sd "> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</ span >
393
- < span class ="sd "> :raises versionedobj.exceptions.LoadObjError : if migration to current version fails.</ span >
393
+ < span class ="sd "> :raises versionedobj.exceptions.ObjectMigrationError : if migration to current version fails.</ span >
394
394
< span class ="sd "> :raises versionedobj.exceptions.InvalidFilterError: if both 'only' and 'ignore' are provided.</ span >
395
395
< span class ="sd "> """</ span >
396
396
< span class ="k "> return</ span > < span class ="bp "> cls</ span > < span class ="p "> ()</ span > < span class ="o "> .</ span > < span class ="n "> from_file</ span > < span class ="p "> (</ span > < span class ="n "> filename</ span > < span class ="p "> ,</ span > < span class ="n "> validate</ span > < span class ="p "> ,</ span > < span class ="n "> only</ span > < span class ="p "> ,</ span > < span class ="n "> ignore</ span > < span class ="p "> )</ span > </ div >
@@ -432,7 +432,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
432
432
< span class ="k "> break</ span >
433
433
434
434
< span class ="k "> if</ span > < span class ="n "> version_after_migration</ span > < span class ="o "> !=</ span > < span class ="n "> version</ span > < span class ="p "> :</ span >
435
- < span class ="k "> raise</ span > < span class ="n "> LoadObjError </ span > < span class ="p "> (</ span > < span class ="sa "> f</ span > < span class ="s2 "> "Failed to migrate from version </ span > < span class ="si "> {</ span > < span class ="n "> version_before_migration</ span > < span class ="si "> }</ span > < span class ="s2 "> to </ span > < span class ="si "> {</ span > < span class ="n "> version</ span > < span class ="si "> }</ span > < span class ="s2 "> "</ span > < span class ="p "> )</ span >
435
+ < span class ="k "> raise</ span > < span class ="n "> ObjectMigrationError </ span > < span class ="p "> (</ span > < span class ="sa "> f</ span > < span class ="s2 "> "Failed to migrate from version </ span > < span class ="si "> {</ span > < span class ="n "> version_before_migration</ span > < span class ="si "> }</ span > < span class ="s2 "> to </ span > < span class ="si "> {</ span > < span class ="n "> version</ span > < span class ="si "> }</ span > < span class ="s2 "> "</ span > < span class ="p "> )</ span >
436
436
437
437
< span class ="k "> return</ span > < span class ="n "> attrs</ span >
438
438
@@ -549,7 +549,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
549
549
< span class ="sd "> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</ span >
550
550
551
551
< span class ="sd "> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</ span >
552
- < span class ="sd "> :raises versionedobj.exceptions.LoadObjError : if migration to current version fails.</ span >
552
+ < span class ="sd "> :raises versionedobj.exceptions.ObjectMigrationError : if migration to current version fails.</ span >
553
553
< span class ="sd "> :raises versionedobj.exceptions.InvalidFilterError: if both 'only' and 'ignore' are provided.</ span >
554
554
< span class ="sd "> """</ span >
555
555
< span class ="k "> if</ span > < span class ="n "> only</ span > < span class ="ow "> and</ span > < span class ="n "> ignore</ span > < span class ="p "> :</ span >
@@ -599,13 +599,14 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
599
599
< span class ="sd "> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</ span >
600
600
601
601
< span class ="sd "> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</ span >
602
- < span class ="sd "> :raises versionedobj.exceptions.LoadObjError: if JSON parsing fails, or if migration to current version fails.</ span >
602
+ < span class ="sd "> :raises versionedobj.exceptions.LoadObjectError: if JSON parsing fails</ span >
603
+ < span class ="sd "> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails</ span >
603
604
< span class ="sd "> :raises versionedobj.exceptions.InvalidFilterError: if both 'only' and 'ignore' are provided.</ span >
604
605
< span class ="sd "> """</ span >
605
606
< span class ="k "> try</ span > < span class ="p "> :</ span >
606
607
< span class ="n "> d</ span > < span class ="o "> =</ span > < span class ="n "> json</ span > < span class ="o "> .</ span > < span class ="n "> loads</ span > < span class ="p "> (</ span > < span class ="n "> jsonstr</ span > < span class ="p "> )</ span >
607
608
< span class ="k "> except</ span > < span class ="n "> JSONDecodeError</ span > < span class ="p "> :</ span >
608
- < span class ="k "> raise</ span > < span class ="n "> LoadObjError </ span > < span class ="p "> (</ span > < span class ="s2 "> "JSON decode failure"</ span > < span class ="p "> )</ span >
609
+ < span class ="k "> raise</ span > < span class ="n "> LoadObjectError </ span > < span class ="p "> (</ span > < span class ="s2 "> "JSON decode failure"</ span > < span class ="p "> )</ span >
609
610
610
611
< span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> from_dict</ span > < span class ="p "> (</ span > < span class ="n "> d</ span > < span class ="p "> ,</ span > < span class ="n "> validate</ span > < span class ="p "> ,</ span > < span class ="n "> only</ span > < span class ="p "> ,</ span > < span class ="n "> ignore</ span > < span class ="p "> )</ span >
611
612
< span class ="k "> return</ span > < span class ="bp "> self</ span > </ div >
@@ -634,7 +635,8 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
634
635
< span class ="sd "> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</ span >
635
636
636
637
< span class ="sd "> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</ span >
637
- < span class ="sd "> :raises versionedobj.exceptions.LoadObjError: if JSON parsing fails, or if migration to current version fails.</ span >
638
+ < span class ="sd "> :raises versionedobj.exceptions.LoadObjectError: if JSON parsing fails</ span >
639
+ < span class ="sd "> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails.</ span >
638
640
< span class ="sd "> :raises versionedobj.exceptions.InvalidFilterError: if both 'only' and 'ignore' are provided.</ span >
639
641
< span class ="sd "> """</ span >
640
642
< span class ="k "> with</ span > < span class ="nb "> open</ span > < span class ="p "> (</ span > < span class ="n "> filename</ span > < span class ="p "> ,</ span > < span class ="s1 "> 'r'</ span > < span class ="p "> )</ span > < span class ="k "> as</ span > < span class ="n "> fh</ span > < span class ="p "> :</ span >
0 commit comments