boto3-refresh-session 5.1.1__tar.gz → 5.1.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/PKG-INFO +20 -4
  2. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/README.md +19 -3
  3. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/__init__.py +1 -1
  4. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/pyproject.toml +1 -1
  5. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/LICENSE +0 -0
  6. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/NOTICE +0 -0
  7. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/exceptions.py +0 -0
  8. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/methods/__init__.py +0 -0
  9. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/methods/custom.py +0 -0
  10. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/methods/iot/__init__.py +0 -0
  11. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/methods/iot/core.py +0 -0
  12. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/methods/iot/x509.py +0 -0
  13. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/methods/sts.py +0 -0
  14. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/session.py +0 -0
  15. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/utils/__init__.py +0 -0
  16. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/utils/internal.py +0 -0
  17. {boto3_refresh_session-5.1.1 → boto3_refresh_session-5.1.3}/boto3_refresh_session/utils/typing.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: boto3-refresh-session
3
- Version: 5.1.1
3
+ Version: 5.1.3
4
4
  Summary: A simple Python package for refreshing the temporary security credentials in a boto3.session.Session object automatically.
5
5
  License: MIT
6
6
  Keywords: boto3,botocore,aws,sts,credentials,token,refresh,iot,x509,mqtt
@@ -103,10 +103,10 @@ Description-Content-Type: text/markdown
103
103
  />
104
104
  </a>
105
105
 
106
- <a href="https://medium.com/@lettsmt/you-shouldnt-have-to-think-about-refreshing-aws-credentials-214f7cbbd83b">
106
+ <a href="https://michaelthomasletts.github.io/blog/brs-rationale/">
107
107
  <img
108
- src="https://img.shields.io/badge/Medium%20Article-📘-FF0000?style=flat&labelColor=555&logo=readthedocs"
109
- alt="medium"
108
+ src="https://img.shields.io/badge/Blog%20Post-📘-FF0000?style=flat&labelColor=555&logo=readthedocs"
109
+ alt="blog"
110
110
  />
111
111
  </a>
112
112
 
@@ -341,6 +341,22 @@ pip install boto3-refresh-session
341
341
  )
342
342
  ```
343
343
 
344
+ ### MQTT
345
+
346
+ After initializing a session object, you can can begin making actions with MQTT using the [mqtt method](https://github.com/michaelthomasletts/boto3-refresh-session/blob/deb68222925bf648f26e878ed4bc24b45317c7db/boto3_refresh_session/methods/iot/x509.py#L367)! You can reuse the same certificate, private key, et al as that used to initialize `RefreshableSession`. Or, alternatively, you can provide separate PKCS#11 or certificate information, whether those be file paths or bytes values. Either way, at a minimum, you will need to provide the endpoint and client identifier (i.e. thing name).
347
+
348
+ ```python
349
+ from awscrt.mqtt.QoS import AT_LEAST_ONCE
350
+ conn = session.mqtt(
351
+ endpoint="<your endpoint>-ats.iot.<region>.amazonaws.com",
352
+ client_id="<your thing name or client ID>",
353
+ )
354
+ conn.connect()
355
+ conn.connect().result()
356
+ conn.publish(topic="foo/bar", payload=b"hi", qos=AT_LEAST_ONCE)
357
+ conn.disconnect().result()
358
+ ```
359
+
344
360
  </details>
345
361
 
346
362
  ## ⚠️ Changes
@@ -76,10 +76,10 @@
76
76
  />
77
77
  </a>
78
78
 
79
- <a href="https://medium.com/@lettsmt/you-shouldnt-have-to-think-about-refreshing-aws-credentials-214f7cbbd83b">
79
+ <a href="https://michaelthomasletts.github.io/blog/brs-rationale/">
80
80
  <img
81
- src="https://img.shields.io/badge/Medium%20Article-📘-FF0000?style=flat&labelColor=555&logo=readthedocs"
82
- alt="medium"
81
+ src="https://img.shields.io/badge/Blog%20Post-📘-FF0000?style=flat&labelColor=555&logo=readthedocs"
82
+ alt="blog"
83
83
  />
84
84
  </a>
85
85
 
@@ -314,6 +314,22 @@ pip install boto3-refresh-session
314
314
  )
315
315
  ```
316
316
 
317
+ ### MQTT
318
+
319
+ After initializing a session object, you can can begin making actions with MQTT using the [mqtt method](https://github.com/michaelthomasletts/boto3-refresh-session/blob/deb68222925bf648f26e878ed4bc24b45317c7db/boto3_refresh_session/methods/iot/x509.py#L367)! You can reuse the same certificate, private key, et al as that used to initialize `RefreshableSession`. Or, alternatively, you can provide separate PKCS#11 or certificate information, whether those be file paths or bytes values. Either way, at a minimum, you will need to provide the endpoint and client identifier (i.e. thing name).
320
+
321
+ ```python
322
+ from awscrt.mqtt.QoS import AT_LEAST_ONCE
323
+ conn = session.mqtt(
324
+ endpoint="<your endpoint>-ats.iot.<region>.amazonaws.com",
325
+ client_id="<your thing name or client ID>",
326
+ )
327
+ conn.connect()
328
+ conn.connect().result()
329
+ conn.publish(topic="foo/bar", payload=b"hi", qos=AT_LEAST_ONCE)
330
+ conn.disconnect().result()
331
+ ```
332
+
317
333
  </details>
318
334
 
319
335
  ## ⚠️ Changes
@@ -9,7 +9,7 @@ from .session import *
9
9
 
10
10
  __all__.extend(session.__all__)
11
11
  __all__.extend(exceptions.__all__)
12
- __version__ = "5.1.1"
12
+ __version__ = "5.1.3"
13
13
  __title__ = "boto3-refresh-session"
14
14
  __author__ = "Mike Letts"
15
15
  __maintainer__ = "Mike Letts"
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "boto3-refresh-session"
3
- version = "5.1.1"
3
+ version = "5.1.3"
4
4
  description = "A simple Python package for refreshing the temporary security credentials in a boto3.session.Session object automatically."
5
5
  authors = [
6
6
  {name = "Mike Letts",email = "lettsmt@gmail.com"}