File: //lib/python3/dist-packages/boto/dynamodb/__pycache__/table.cpython-312.pyc
�
ckF[0U � �h � d dl mZ d dlmZ d dlmZ d dlmZ d dl Z G d� de
� Z G d� d e
� Z y)
� )� BatchList)�Schema)�Item)�
exceptionsNc �( � e Zd ZdZ dd�Zd� Zd� Zy)�TableBatchGeneratorz�
A low-level generator used to page through results from
batch_get_item operations.
:ivar consumed_units: An integer that holds the number of
ConsumedCapacityUnits accumulated thus far for this
generator.
Nc �J � || _ || _ d| _ || _ || _ y )Nr )�table�keys�consumed_units�attributes_to_get�consistent_read)�selfr
r r
r s �5/usr/lib/python3/dist-packages/boto/dynamodb/table.py�__init__z TableBatchGenerator.__init__) s( � ���
��� � ���!2�� � .�� � c �� � d|vry | j j |d vry |d | j j d }|D ]/ }|d }d|v r|d nd }| j j ||f� �1 y )N�UnprocessedKeys�Keys�HashKeyElement�RangeKeyElement)r
�namer �append)r �resr �key�h�rs r �_queue_unprocessedz&TableBatchGenerator._queue_unprocessed1 s� � � �S� (� � �:�:�?�?�#�&8�"9� 9� ��%�&�t�z�z���7��@��� %�C��%�&�A�+=��+D��&�'�$�A� �I�I� � �a��V� $� %r c # �@ K � | j �r
t | j j � }|j | j | j d d | j
� |j
� }| j j |d vr��| xj |d | j j d z
c_ |d | j j d D ] }|�� � | j dd | _ | j |� | j r�� y y �w)N�d � Responses�ConsumedCapacityUnits�Items)
r r r
�layer2� add_batchr
�submitr r r )r �batchr �elems r �__iter__z TableBatchGenerator.__iter__> s� � �� ��i�i� �d�j�j� /� /�0�E� �O�O�D�J�J�� � �$�3�� � 2� 2�
4��,�,�.�C� �z�z���c�,�&7�7�� � � �3�|�#4�T�Z�Z�_�_�#E�F^�#_� _� ��L�)�$�*�*�/�/�:�8�D�
���
�
� � � �#�$��D�I� � #� #�C� (�! �i�i�s �DD � D �NF)�__name__�
__module__� __qualname__�__doc__r r r) � r r r r s � �� 7;�!&�/� %�)r r c � � e Zd ZdZd� Zed� � Zd� Zed� � Z ed� � Z
ed� � Z ed� � Z ed � � Z
ed
� � Zed � � Zed � � Zd
� Zdd�Zd� Zd� Zdddefd�ZeZdd�Zdddefd�Zd� Zd� Zdd�Z y) �Tablea�
An Amazon DynamoDB table.
:ivar name: The name of the table.
:ivar create_time: The date and time that the table was created.
:ivar status: The current status of the table. One of:
'ACTIVE', 'UPDATING', 'DELETING'.
:ivar schema: A :class:`boto.dynamodb.schema.Schema` object representing
the schema defined for the table.
:ivar item_count: The number of items in the table. This value is
set only when the Table object is created or refreshed and
may not reflect the actual count.
:ivar size_bytes: Total size of the specified table, in bytes.
Amazon DynamoDB updates this value approximately every six hours.
Recent changes might not be reflected in this value.
:ivar read_units: The ReadCapacityUnits of the tables
Provisioned Throughput.
:ivar write_units: The WriteCapacityUnits of the tables
Provisioned Throughput.
:ivar schema: The Schema object associated with the table.
c �B � || _ i | _ | j |� y)z�
:type layer2: :class:`boto.dynamodb.layer2.Layer2`
:param layer2: A `Layer2` api object.
:type response: dict
:param response: The output of
`boto.dynamodb.layer1.Layer1.describe_table`.
N)r$ �_dict�update_from_response)r r$ �responses r r zTable.__init__i s � � �� ���
� �!�!�(�+r c �. � | |dd|ii� }||_ |S )aW Create a Table object.
If you know the name and schema of your table, you can
create a ``Table`` object without having to make any
API calls (normally an API call is made to retrieve
the schema of a table).
Example usage::
table = Table.create_from_schema(
boto.connect_dynamodb(),
'tablename',
Schema.create(hash_key=('keyname', 'N')))
:type layer2: :class:`boto.dynamodb.layer2.Layer2`
:param layer2: A ``Layer2`` api object.
:type name: str
:param name: The name of the table.
:type schema: :class:`boto.dynamodb.schema.Schema`
:param schema: The schema associated with the table.
:rtype: :class:`boto.dynamodb.table.Table`
:return: A Table object representing the table.
r1 � TableName��_schema)�clsr$ r �schemar
s r �create_from_schemazTable.create_from_schemax s& � �: �F�W�{�D�&9� :�;�� ��
�� r c � � d| j z S )Nz Table(%s))r �r s r �__repr__zTable.__repr__� s � ��T�Y�Y�&�&r c � � | j d S )Nr7 )r3 r> s r r z
Table.name� s � ��z�z�+�&�&r c �: � | j j dd � S )N�CreationDateTime�r3 �getr> s r � create_timezTable.create_time� s � ��z�z�~�~� 0�$�7�7r c �: � | j j dd � S )N� TableStatusrC r> s r �statusz Table.status� s � ��z�z�~�~�m�T�2�2r c �: � | j j dd� S )N� ItemCountr rC r> s r �
item_countzTable.item_count� s � ��z�z�~�~�k�1�-�-r c �: � | j j dd� S )N�TableSizeBytesr rC r> s r �
size_byteszTable.size_bytes� s � ��z�z�~�~� .��2�2r c � � | j S �Nr8 r> s r r; z Table.schema� s � ��|�|�r c �F � | j d d S # t $ r Y y w xY w)N�ProvisionedThroughput�ReadCapacityUnits�r3 �KeyErrorr> s r �
read_unitszTable.read_units� s/ � � ��:�:� 5�6�7J�K� K��� �� �� � � � c �F � | j d d S # t $ r Y y w xY w)NrR �WriteCapacityUnitsrT r> s r � write_unitszTable.write_units� s/ � � ��:�:� 5�6�7K�L� L��� �� �rW c �� � d|v r | j j |d � n"d|v r | j j |d � d| j v r t | j d � | _ yy)zx
Update the state of the Table object based on the response
data received from Amazon DynamoDB.
r1 �TableDescription� KeySchemaN)r3 �updater r9 )r r5 s r r4 zTable.update_from_response� si � � �h� � �J�J� � �h�w� /� 0�
�8�
+� �J�J� � �h�'9� :� ;� �$�*�*� $�!�$�*�*�[�"9�:�D�L� %r Fc �� � d}|sf| j j | j � }| j |� |r(| j dk( rd}nt j |� nd}|s�eyy)a6
Refresh all of the fields of the Table object by calling
the underlying DescribeTable request.
:type wait_for_active: bool
:param wait_for_active: If True, this command will not return
until the table status, as returned from Amazon DynamoDB, is
'ACTIVE'.
:type retry_seconds: int
:param retry_seconds: If wait_for_active is True, this
parameter controls the number of seconds of delay between
calls to update_table in Amazon DynamoDB. Default is 5 seconds.
F�ACTIVETN)r$ �describe_tabler r4 rH �time�sleep)r �wait_for_active�
retry_seconds�doner5 s r �refreshz
Table.refresh� s\ � � ����{�{�1�1�$�)�)�<�H� � %� %�h� /� ��;�;�(�*� �D��J�J�}�-��� r c �> � | j j | ||� y)a
Update the ProvisionedThroughput for the Amazon DynamoDB Table.
:type read_units: int
:param read_units: The new value for ReadCapacityUnits.
:type write_units: int
:param write_units: The new value for WriteCapacityUnits.
N)r$ �update_throughput)r rV rZ s r ri zTable.update_throughput� s � �
� � �%�%�d�J� �Dr c �: � | j j | � y)z�
Delete this table and all items in it. After calling this
the Table objects status attribute will be set to 'DELETING'.
N)r$ � delete_tabler> s r �deletez Table.delete� s � �
� � � � ��&r Nc �B � | j j | |||||� S )a�
Retrieve an existing item from the table.
:type hash_key: int|long|float|str|unicode|Binary
:param hash_key: The HashKey of the requested item. The
type of the value must match the type defined in the
schema for the table.
:type range_key: int|long|float|str|unicode|Binary
:param range_key: The optional RangeKey of the requested item.
The type of the value must match the type defined in the
schema for the table.
:type attributes_to_get: list
:param attributes_to_get: A list of attribute names.
If supplied, only the specified attribute names will
be returned. Otherwise, all attributes will be returned.
:type consistent_read: bool
:param consistent_read: If True, a consistent read
request is issued. Otherwise, an eventually consistent
request is issued.
:type item_class: Class
:param item_class: Allows you to override the class used
to generate the items. This should be a subclass of
:class:`boto.dynamodb.item.Item`
)r$ �get_item)r �hash_key� range_keyr
r �
item_classs r rn zTable.get_item� s) � �> �{�{�#�#�D�(�I�$5��$.�0� 0r c �d � | j |||g|�� y# t j $ r Y yw xY w)aC
Checks the table to see if the Item with the specified ``hash_key``
exists. This may save a tiny bit of time/bandwidth over a
straight :py:meth:`get_item` if you have no intention to touch
the data that is returned, since this method specifically tells
Amazon not to return anything but the Item's key.
:type hash_key: int|long|float|str|unicode|Binary
:param hash_key: The HashKey of the requested item. The
type of the value must match the type defined in the
schema for the table.
:type range_key: int|long|float|str|unicode|Binary
:param range_key: The optional RangeKey of the requested item.
The type of the value must match the type defined in the
schema for the table.
:type consistent_read: bool
:param consistent_read: If True, a consistent read
request is issued. Otherwise, an eventually consistent
request is issued.
:rtype: bool
:returns: ``True`` if the Item exists, ``False`` if not.
)rp r
r FT)rn �dynamodb_exceptions�DynamoDBKeyNotFoundError)r ro rp r s r �has_itemzTable.has_item" sE � �4 �
�M�M�(�i�-5�J�*9�
�
;� �� #�;�;� �� �s � �/�/c � � || |||� S )a�
Return an new, unsaved Item which can later be PUT to
Amazon DynamoDB.
This method has explicit (but optional) parameters for
the hash_key and range_key values of the item. You can use
these explicit parameters when calling the method, such as::
>>> my_item = my_table.new_item(hash_key='a', range_key=1,
attrs={'key1': 'val1', 'key2': 'val2'})
>>> my_item
{u'bar': 1, u'foo': 'a', 'key1': 'val1', 'key2': 'val2'}
Or, if you prefer, you can simply put the hash_key and range_key
in the attrs dictionary itself, like this::
>>> attrs = {'foo': 'a', 'bar': 1, 'key1': 'val1', 'key2': 'val2'}
>>> my_item = my_table.new_item(attrs=attrs)
>>> my_item
{u'bar': 1, u'foo': 'a', 'key1': 'val1', 'key2': 'val2'}
The effect is the same.
.. note:
The explicit parameters take priority over the values in
the attrs dict. So, if you have a hash_key or range_key
in the attrs dict and you also supply either or both using
the explicit parameters, the values in the attrs will be
ignored.
:type hash_key: int|long|float|str|unicode|Binary
:param hash_key: The HashKey of the new item. The
type of the value must match the type defined in the
schema for the table.
:type range_key: int|long|float|str|unicode|Binary
:param range_key: The optional RangeKey of the new item.
The type of the value must match the type defined in the
schema for the table.
:type attrs: dict
:param attrs: A dictionary of key value pairs used to
populate the new item.
:type item_class: Class
:param item_class: Allows you to override the class used
to generate the items. This should be a subclass of
:class:`boto.dynamodb.item.Item`
r/ )r ro rp �attrsrq s r �new_itemzTable.new_itemH s � �f �$��)�U�;�;r c �D � | j j | |g|��i |��S )a�
Perform a query on the table.
:type hash_key: int|long|float|str|unicode|Binary
:param hash_key: The HashKey of the requested item. The
type of the value must match the type defined in the
schema for the table.
:type range_key_condition: :class:`boto.dynamodb.condition.Condition`
:param range_key_condition: A Condition object.
Condition object can be one of the following types:
EQ|LE|LT|GE|GT|BEGINS_WITH|BETWEEN
The only condition which expects or will accept two
values is 'BETWEEN', otherwise a single value should
be passed to the Condition constructor.
:type attributes_to_get: list
:param attributes_to_get: A list of attribute names.
If supplied, only the specified attribute names will
be returned. Otherwise, all attributes will be returned.
:type request_limit: int
:param request_limit: The maximum number of items to retrieve
from Amazon DynamoDB on each request. You may want to set
a specific request_limit based on the provisioned throughput
of your table. The default behavior is to retrieve as many
results as possible per request.
:type max_results: int
:param max_results: The maximum number of results that will
be retrieved from Amazon DynamoDB in total. For example,
if you only wanted to see the first 100 results from the
query, regardless of how many were actually available, you
could set max_results to 100 and the generator returned
from the query method will only yeild 100 results max.
:type consistent_read: bool
:param consistent_read: If True, a consistent read
request is issued. Otherwise, an eventually consistent
request is issued.
:type scan_index_forward: bool
:param scan_index_forward: Specified forward or backward
traversal of the index. Default is forward (True).
:type exclusive_start_key: list or tuple
:param exclusive_start_key: Primary key of the item from
which to continue an earlier query. This would be
provided as the LastEvaluatedKey in that query.
:type count: bool
:param count: If True, Amazon DynamoDB returns a total
number of items for the Query operation, even if the
operation has no matching items for the assigned filter.
If count is True, the actual items are not returned and
the count is accessible as the ``count`` attribute of
the returned object.
:type item_class: Class
:param item_class: Allows you to override the class used
to generate the items. This should be a subclass of
:class:`boto.dynamodb.item.Item`
)r$ �query)r ro �args�kws r rz z Table.query} s( � �F !�t�{�{� � ��x�=�$�=�"�=�=r c �B � | j j | g|��i |��S )a�
Scan through this table, this is a very long
and expensive operation, and should be avoided if
at all possible.
:type scan_filter: A dict
:param scan_filter: A dictionary where the key is the
attribute name and the value is a
:class:`boto.dynamodb.condition.Condition` object.
Valid Condition objects include:
* EQ - equal (1)
* NE - not equal (1)
* LE - less than or equal (1)
* LT - less than (1)
* GE - greater than or equal (1)
* GT - greater than (1)
* NOT_NULL - attribute exists (0, use None)
* NULL - attribute does not exist (0, use None)
* CONTAINS - substring or value in list (1)
* NOT_CONTAINS - absence of substring or value in list (1)
* BEGINS_WITH - substring prefix (1)
* IN - exact match in list (N)
* BETWEEN - >= first value, <= second value (2)
:type attributes_to_get: list
:param attributes_to_get: A list of attribute names.
If supplied, only the specified attribute names will
be returned. Otherwise, all attributes will be returned.
:type request_limit: int
:param request_limit: The maximum number of items to retrieve
from Amazon DynamoDB on each request. You may want to set
a specific request_limit based on the provisioned throughput
of your table. The default behavior is to retrieve as many
results as possible per request.
:type max_results: int
:param max_results: The maximum number of results that will
be retrieved from Amazon DynamoDB in total. For example,
if you only wanted to see the first 100 results from the
query, regardless of how many were actually available, you
could set max_results to 100 and the generator returned
from the query method will only yeild 100 results max.
:type count: bool
:param count: If True, Amazon DynamoDB returns a total
number of items for the Scan operation, even if the
operation has no matching items for the assigned filter.
If count is True, the actual items are not returned and
the count is accessible as the ``count`` attribute of
the returned object.
:type exclusive_start_key: list or tuple
:param exclusive_start_key: Primary key of the item from
which to continue an earlier query. This would be
provided as the LastEvaluatedKey in that query.
:type item_class: Class
:param item_class: Allows you to override the class used
to generate the items. This should be a subclass of
:class:`boto.dynamodb.item.Item`
:return: A TableGenerator (generator) object which will iterate
over all results
:rtype: :class:`boto.dynamodb.layer2.TableGenerator`
)r$ �scan)r r{ r| s r r~ z
Table.scan� s& � �H �t�{�{� � ��2�t�2�r�2�2r c � � t | ||� S )a-
Return a set of attributes for a multiple items from a single table
using their primary keys. This abstraction removes the 100 Items per
batch limitations as well as the "UnprocessedKeys" logic.
:type keys: list
:param keys: A list of scalar or tuple values. Each element in the
list represents one Item to retrieve. If the schema for the
table has both a HashKey and a RangeKey, each element in the
list should be a tuple consisting of (hash_key, range_key). If
the schema for the table contains only a HashKey, each element
in the list should be a scalar value of the appropriate type
for the table schema. NOTE: The maximum number of items that
can be retrieved for a single operation is 100. Also, the
number of items retrieved is constrained by a 1 MB size limit.
:type attributes_to_get: list
:param attributes_to_get: A list of attribute names.
If supplied, only the specified attribute names will
be returned. Otherwise, all attributes will be returned.
:return: A TableBatchGenerator (generator) object which will
iterate over all results
:rtype: :class:`boto.dynamodb.table.TableBatchGenerator`
)r )r r r
s r �batch_get_itemzTable.batch_get_item s � �4 #�4��/@�A�Ar )F� r* rP ) r+ r, r- r. r � classmethodr< r? �propertyr rE rH rK rN r; rV rZ r4 rg ri rl r rn �lookupru rx rz r~ r� r/ r r r1 r1 R s! � ��,
,� � � � �@'� �'� �'� �8� �8� �3� �3� �.� �.� �3� �3� � � � � �� �� �� �� ;� �6
E�'� ,0�#'�� �!0�D �F�$�L !%��D� �3<�jC>�JD3�LBr r1 )
�boto.dynamodb.batchr �boto.dynamodb.schemar �boto.dynamodb.itemr �
boto.dynamodbr rs rb �objectr r1 r/ r r �<module>r� s3 ��0 *� '� #� ;� �0)�&� 0)�fPB�F� PBr