@@ -2268,21 +2268,24 @@ <h3>Instance variables</h3>
2268
2268
< span class ="sd "> that should be used to pop the scope again. Alternatively a callback</ span >
2269
2269
< span class ="sd "> can be provided that is executed in the context of the scope.</ span >
2270
2270
< span class ="sd "> """</ span >
2271
+ < span class ="k "> if</ span > < span class ="n "> callback</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="bp "> None</ span > < span class ="p "> :</ span >
2272
+ < span class ="k "> with</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> push_scope</ span > < span class ="p "> ()</ span > < span class ="k "> as</ span > < span class ="n "> scope</ span > < span class ="p "> :</ span >
2273
+ < span class ="n "> callback</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> )</ span >
2274
+ < span class ="k "> return</ span >
2275
+
2271
2276
< span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> scope</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="p "> [</ span > < span class ="o "> -</ span > < span class ="mi "> 1</ span > < span class ="p "> ]</ span >
2272
2277
< span class ="n "> new_layer</ span > < span class ="o "> =</ span > < span class ="p "> (</ span > < span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> copy</ span > < span class ="o "> .</ span > < span class ="n "> copy</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> ))</ span >
2273
2278
< span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="o "> .</ span > < span class ="n "> append</ span > < span class ="p "> (</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2274
2279
2275
- < span class ="k "> if</ span > < span class ="n "> callback</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="bp "> None</ span > < span class ="p "> :</ span >
2276
- < span class ="k "> if</ span > < span class ="n "> client</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="bp "> None</ span > < span class ="p "> :</ span >
2277
- < span class ="n "> callback</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> )</ span >
2278
- < span class ="k "> else</ span > < span class ="p "> :</ span >
2279
- < span class ="k "> return</ span > < span class ="n "> _ScopeManager</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2280
+ < span class ="k "> return</ span > < span class ="n "> _ScopeManager</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2281
+
2282
+ < span class ="n "> scope</ span > < span class ="o "> =</ span > < span class ="n "> push_scope</ span >
2280
2283
2281
2284
< span class ="k "> def</ span > < span class ="nf "> pop_scope_unsafe</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ):</ span >
2282
2285
< span class ="sd "> """Pops a scope layer from the stack. Try to use the context manager</ span >
2283
2286
< span class ="sd "> `push_scope()` instead."""</ span >
2284
2287
< span class ="n "> rv</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="o "> .</ span > < span class ="n "> pop</ span > < span class ="p "> ()</ span >
2285
- < span class ="k "> assert</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span >
2288
+ < span class ="k "> assert</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class =" p " > , </ span > < span class =" s2 " > "stack must have at least one layer" </ span >
2286
2289
< span class ="k "> return</ span > < span class ="n "> rv</ span >
2287
2290
2288
2291
< span class ="k "> def</ span > < span class ="nf "> configure_scope</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> callback</ span > < span class ="o "> =</ span > < span class ="bp "> None</ span > < span class ="p "> ):</ span >
@@ -2301,16 +2304,6 @@ <h3>Instance variables</h3>
2301
2304
< span class ="k "> yield</ span > < span class ="n "> Scope</ span > < span class ="p "> ()</ span >
2302
2305
2303
2306
< span class ="k "> return</ span > < span class ="n "> inner</ span > < span class ="p "> ()</ span >
2304
-
2305
- < span class ="k "> def</ span > < span class ="nf "> scope</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> callback</ span > < span class ="o "> =</ span > < span class ="bp "> None</ span > < span class ="p "> ):</ span >
2306
- < span class ="sd "> """Pushes a new scope and yields it for configuration.</ span >
2307
-
2308
- < span class ="sd "> The scope is dropped at the end of the with statement. Alternatively</ span >
2309
- < span class ="sd "> a callback can be provided similar to `configure_scope`.</ span >
2310
- < span class ="sd "> """</ span >
2311
- < span class ="k "> with</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> push_scope</ span > < span class ="p "> ():</ span >
2312
- < span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> scope</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="p "> [</ span > < span class ="o "> -</ span > < span class ="mi "> 1</ span > < span class ="p "> ]</ span >
2313
- < span class ="k "> return</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> configure_scope</ span > < span class ="p "> (</ span > < span class ="n "> callback</ span > < span class ="p "> )</ span >
2314
2307
</ pre > </ div >
2315
2308
2316
2309
</ div >
@@ -2670,7 +2663,7 @@ <h3>Static methods</h3>
2670
2663
< span class ="sd "> """Pops a scope layer from the stack. Try to use the context manager</ span >
2671
2664
< span class ="sd "> `push_scope()` instead."""</ span >
2672
2665
< span class ="n "> rv</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="o "> .</ span > < span class ="n "> pop</ span > < span class ="p "> ()</ span >
2673
- < span class ="k "> assert</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span >
2666
+ < span class ="k "> assert</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class =" p " > , </ span > < span class =" s2 " > "stack must have at least one layer" </ span >
2674
2667
< span class ="k "> return</ span > < span class ="n "> rv</ span >
2675
2668
</ pre > </ div >
2676
2669
@@ -2699,14 +2692,14 @@ <h3>Static methods</h3>
2699
2692
< span class ="sd "> that should be used to pop the scope again. Alternatively a callback</ span >
2700
2693
< span class ="sd "> can be provided that is executed in the context of the scope.</ span >
2701
2694
< span class ="sd "> """</ span >
2695
+ < span class ="k "> if</ span > < span class ="n "> callback</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="bp "> None</ span > < span class ="p "> :</ span >
2696
+ < span class ="k "> with</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> push_scope</ span > < span class ="p "> ()</ span > < span class ="k "> as</ span > < span class ="n "> scope</ span > < span class ="p "> :</ span >
2697
+ < span class ="n "> callback</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> )</ span >
2698
+ < span class ="k "> return</ span >
2702
2699
< span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> scope</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="p "> [</ span > < span class ="o "> -</ span > < span class ="mi "> 1</ span > < span class ="p "> ]</ span >
2703
2700
< span class ="n "> new_layer</ span > < span class ="o "> =</ span > < span class ="p "> (</ span > < span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> copy</ span > < span class ="o "> .</ span > < span class ="n "> copy</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> ))</ span >
2704
2701
< span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="o "> .</ span > < span class ="n "> append</ span > < span class ="p "> (</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2705
- < span class ="k "> if</ span > < span class ="n "> callback</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="bp "> None</ span > < span class ="p "> :</ span >
2706
- < span class ="k "> if</ span > < span class ="n "> client</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="bp "> None</ span > < span class ="p "> :</ span >
2707
- < span class ="n "> callback</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> )</ span >
2708
- < span class ="k "> else</ span > < span class ="p "> :</ span >
2709
- < span class ="k "> return</ span > < span class ="n "> _ScopeManager</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2702
+ < span class ="k "> return</ span > < span class ="n "> _ScopeManager</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2710
2703
</ pre > </ div >
2711
2704
2712
2705
</ div >
@@ -2750,20 +2743,25 @@ <h3>Static methods</h3>
2750
2743
2751
2744
2752
2745
2753
- < div class ="desc "> < p > Pushes a new scope and yields it for configuration. </ p >
2754
- < p > The scope is dropped at the end of the with statement . Alternatively
2755
- a callback can be provided similar to < code > configure_scope </ code > .</ p > </ div >
2746
+ < div class ="desc "> < p > Pushes a new layer on the scope stack. Returns a context manager
2747
+ that should be used to pop the scope again . Alternatively a callback
2748
+ can be provided that is executed in the context of the scope .</ p > </ div >
2756
2749
< div class ="source_cont ">
2757
2750
< p class ="source_link "> < a href ="javascript:void(0); " onclick ="toggle('source-sentry_sdk.Hub.scope', this); "> Show source ≡</ a > </ p >
2758
2751
< div id ="source-sentry_sdk.Hub.scope " class ="source ">
2759
- < div class ="codehilite "> < pre > < span > </ span > < span class ="k "> def</ span > < span class ="nf "> scope </ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> callback</ span > < span class ="o "> =</ span > < span class ="bp "> None</ span > < span class ="p "> ):</ span >
2760
- < span class ="sd "> """Pushes a new scope and yields it for configuration. </ span >
2761
- < span class ="sd "> The scope is dropped at the end of the with statement . Alternatively</ span >
2762
- < span class ="sd "> a callback can be provided similar to `configure_scope` .</ span >
2752
+ < div class ="codehilite "> < pre > < span > </ span > < span class ="k "> def</ span > < span class ="nf "> push_scope </ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> callback</ span > < span class ="o "> =</ span > < span class ="bp "> None</ span > < span class ="p "> ):</ span >
2753
+ < span class ="sd "> """Pushes a new layer on the scope stack. Returns a context manager </ span >
2754
+ < span class ="sd "> that should be used to pop the scope again . Alternatively a callback </ span >
2755
+ < span class ="sd "> can be provided that is executed in the context of the scope .</ span >
2763
2756
< span class ="sd "> """</ span >
2764
- < span class ="k "> with</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> push_scope</ span > < span class ="p "> ():</ span >
2765
- < span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> scope</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="p "> [</ span > < span class ="o "> -</ span > < span class ="mi "> 1</ span > < span class ="p "> ]</ span >
2766
- < span class ="k "> return</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> configure_scope</ span > < span class ="p "> (</ span > < span class ="n "> callback</ span > < span class ="p "> )</ span >
2757
+ < span class ="k "> if</ span > < span class ="n "> callback</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="bp "> None</ span > < span class ="p "> :</ span >
2758
+ < span class ="k "> with</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> push_scope</ span > < span class ="p "> ()</ span > < span class ="k "> as</ span > < span class ="n "> scope</ span > < span class ="p "> :</ span >
2759
+ < span class ="n "> callback</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> )</ span >
2760
+ < span class ="k "> return</ span >
2761
+ < span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> scope</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="p "> [</ span > < span class ="o "> -</ span > < span class ="mi "> 1</ span > < span class ="p "> ]</ span >
2762
+ < span class ="n "> new_layer</ span > < span class ="o "> =</ span > < span class ="p "> (</ span > < span class ="n "> client</ span > < span class ="p "> ,</ span > < span class ="n "> copy</ span > < span class ="o "> .</ span > < span class ="n "> copy</ span > < span class ="p "> (</ span > < span class ="n "> scope</ span > < span class ="p "> ))</ span >
2763
+ < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _stack</ span > < span class ="o "> .</ span > < span class ="n "> append</ span > < span class ="p "> (</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2764
+ < span class ="k "> return</ span > < span class ="n "> _ScopeManager</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> new_layer</ span > < span class ="p "> )</ span >
2767
2765
</ pre > </ div >
2768
2766
2769
2767
</ div >
0 commit comments