Current File : /opt/hc_python/lib/python3.12/site-packages/nose/plugins/__pycache__//attrib.cpython-312.pyc
�
H��g�% � �� � d Z ddlZddlZddlZddlZddlmZ ddlmZ ddlm Z ddl
Z
ej d� Z ej dk\ Zd� Zdd �Z G d
� d � Z G d � d
e� Zy)a Attribute selector plugin.
Oftentimes when testing you will want to select tests based on
criteria rather then simply by filename. For example, you might want
to run all tests except for the slow ones. You can do this with the
Attribute selector plugin by setting attributes on your test methods.
Here is an example:
.. code-block:: python
def test_big_download():
import urllib
# commence slowness...
test_big_download.slow = 1
Once you've assigned an attribute ``slow = 1`` you can exclude that
test and all other tests having the slow attribute by running ::
$ nosetests -a '!slow'
There is also a decorator available for you that will set attributes.
Here's how to set ``slow=1`` like above with the decorator:
.. code-block:: python
from nose.plugins.attrib import attr
@attr('slow')
def test_big_download():
import urllib
# commence slowness...
And here's how to set an attribute with a specific value:
.. code-block:: python
from nose.plugins.attrib import attr
@attr(speed='slow')
def test_big_download():
import urllib
# commence slowness...
This test could be run with ::
$ nosetests -a speed=slow
In Python 2.6 and higher, ``@attr`` can be used on a class to set attributes
on all its test methods at once. For example:
.. code-block:: python
from nose.plugins.attrib import attr
@attr(speed='slow')
class MyTestCase:
def test_long_integration(self):
pass
def test_end_to_end_something(self):
pass
Below is a reference to the different syntaxes available.
Simple syntax
-------------
Examples of using the ``-a`` and ``--attr`` options:
* ``nosetests -a status=stable``
Only runs tests with attribute "status" having value "stable"
* ``nosetests -a priority=2,status=stable``
Runs tests having both attributes and values
* ``nosetests -a priority=2 -a slow``
Runs tests that match either attribute
* ``nosetests -a tags=http``
If a test's ``tags`` attribute was a list and it contained the value
``http`` then it would be run
* ``nosetests -a slow``
Runs tests with the attribute ``slow`` if its value does not equal False
(False, [], "", etc...)
* ``nosetests -a '!slow'``
Runs tests that do NOT have the attribute ``slow`` or have a ``slow``
attribute that is equal to False
**NOTE**:
if your shell (like bash) interprets '!' as a special character make sure to
put single quotes around it.
Expression Evaluation
---------------------
Examples using the ``-A`` and ``--eval-attr`` options:
* ``nosetests -A "not slow"``
Evaluates the Python expression "not slow" and runs the test if True
* ``nosetests -A "(priority > 5) and not slow"``
Evaluates a complex Python expression and runs the test if True
� N)�
isfunction)�Plugin)�tolistznose.plugins.attrib)� � c � � �� � �fd�}|S )zgDecorator that adds attributes to classes or functions
for use with the Attribute (-a) plugin.
c �z �� �D ] }t | |d� � �j � D ] \ }}t | ||� � | S )NT)�setattr�items)�ob�name�value�args�kwargss ���B/opt/hc_python/lib/python3.12/site-packages/nose/plugins/attrib.py�wrap_obzattr.<locals>.wrap_obw s> �� ��D� �B��d� #� �!�<�<�>�K�D�%� �B��e� $� *�� � � )r r r s `` r �attrr s s �� �� �Nr c �f � t � }t | ||� }||u r|�
t |||� }||u r|S |S )z�Look up an attribute on a method/ function.
If the attribute isn't found there, looking it up in the
method's class, if any.
)�object�getattr)�method�cls� attr_name�default�Missingr s r �get_method_attrr sE � �
�h�G� �F�I�w� /�E� ���C�O���Y��0�� ����� �Lr c � � e Zd ZdZd� Zd� Zy)�
ContextHelperz�Object that can act as context dictionary for eval and looks up
names as attributes on a method/ function and its class.
c � � || _ || _ y �N)r r ��selfr r s r �__init__zContextHelper.__init__� s � � �� ���r c �D � t | j | j |� S r" )r r r )r$ r
s r � __getitem__zContextHelper.__getitem__� s � � �t�{�{�D�H�H�d�;�;r N)�__name__�
__module__� __qualname__�__doc__r% r' r r r r r � s � ���<r r c �6 � e Zd ZdZd� Zd� Zd� Zd d�Zd� Zd� Z y)
�AttributeSelectorz<Selects test cases to be run based on their attributes.
c �< � t j | � g | _ y r" )r r% �attribs)r$ s r r% zAttributeSelector.__init__� s � ����� ��� r c
� � |j dddd|j d� dd�� t r(|j d d
d d d|j d
� d�� yy)z Register command line optionsz-az--attrr �append� NOSE_ATTR�ATTRzARun only tests that have attributes specified by ATTR [NOSE_ATTR])�dest�actionr �metavar�helpz-Az --eval-attr� eval_attr�EXPR�NOSE_EVAL_ATTRzaRun only tests for whose attributes the Python expression EXPR evaluates to True [NOSE_EVAL_ATTR])r4 r6 r5 r r7 N)�
add_option�get� compat_24)r$ �parser�envs r �optionszAttributeSelector.options� sl � ����$�� %�h�"%�'�'�+�"6�"(� :� � ;� � � � �d�M�#.��x�&)�g�g�.>�&?�$9�
�
:� r c �P � g | _ t rI|j r=t |j � }|D ]# }d� }| j j ||fg� �% |j
r�t |j
� }|D ]� }g }|j
� j d� D ]U }|s�|j dd� } t | � dkD r| \ }
} n| d }
|
d dk( r|
dd }
d} nd } |j |
| f� �W | j j |� �� | j rd | _ yy)
a Configure the plugin and system, based on selected options.
attr and eval_attr may each be lists.
self.attribs will be a list of lists of tuples. In that list, each
list is a group of attributes, all of which must match for the rule to
match.
c �0 � t | d t ||� � S r" )�evalr )�expr�objr s r �eval_in_contextz4AttributeSelector.configure.<locals>.eval_in_context� s � � ��d�M�#�s�,C�D�Dr �,�=� r �!NFT)
r/ r= r8 r r1 r �strip�split�len�enabled) r$ r@ �configr8 r rF �std_attr�
attr_group�attribr �keyr s r � configurezAttributeSelector.configure� s' � � �� � ��*�*� �w� 0� 0�1�I�!��E�� � �#�#�d�O�%<�$=�>� "� �<�<� �g�l�l�+�H� �� �
� "�j�j�l� 0� 0�� 5�F�!� � "�L�L��a� 0�E��5�z�A�~� &+�
��U� #�A�h�� �q�6�S�=� #&�a�b�'�C�$)�E� %)�E� �%�%�s�E�l�3�) 6�* � � �#�#�J�/�1 !�2 �<�<� �D�L� r Nc �P � d}| j D �] }d}|D ]� \ }}t |||� }t |t j � r ||||� r�8d} n�|du rt |� r�Ld} n�|du rt |� s�`d} n�t
|� t t fv rEt |� j � |D � cg c] } t | � j � �� c} vs��d} n?||k7 s��t |� j � t |� j � k7 s��d} n |xs |}�� |ryyc c} w )z�Verify whether a method has the required attributes
The method is considered a match if it matches all attributes
for any attribute group.
.FTN) r/ r �
isinstance� collections�Callable�bool�type�list�tuple�str�lower)
r$ r r �any�group�matchrS r r �xs
r �validateAttribz AttributeSelector.validateAttrib� s, � � ���\�\�E��E� #�
��U�&�v�s�C�8�� �e�[�%9�%9�:� ��f�c�2� %�� ��d�]� ��:� %�� ��e�^��D�z� %�� ��$�Z�D�%�=�0� �u�:�+�+�-�;?�2A�;?�a� 36�a�&�,�,�.�;?�2A� A� %�� � ��
� ��J� ,� ,� .�#�d�)�/�/�2C� C� %�� �7 $�8 �,��C�= "�> � ��� 2As �. D#
c �$ � | j |� S )z5Accept the function if its attributes match.
)rc )r$ �functions r � wantFunctionz AttributeSelector.wantFunction s � � �"�"�8�,�,r c �r � |j j }| j ||� S # t $ r Y yw xY w)z3Accept the method if its attributes match.
F)�__self__� __class__�AttributeErrorrc r# s r �
wantMethodz AttributeSelector.wantMethod s? � � ��/�/�+�+�C� �"�"�6�3�/�/�� � �� �s �* � 6�6r" )
r( r) r* r+ r% r@ rT rc rf rk r r r r- r- � s' � ���:�"3 �j*�X-�
0r r- )F)r+ �inspect�logging�os�sysr �nose.plugins.baser � nose.utilr rW � getLogger�log� version_infor= r r r r- r r r �<module>ru sk ��e�L � � �
� � $� � ��g���-�.�� � � �� &� �
� � <� <�F0�� F0r 