Skip to main content

s1crets is a thin Python wrapper to read secrets from cloud resources. Wherever supported, it can be used to read/update non-encrypted values as well.

You can find its documentation at readthedocs.io

Installing

Install and update using pip:

pip install -U s1crets

A Simple Example

# Using AWS Parameter Store
import s1crets.providers.aws
ps = s1crets.providers.aws.ParameterStore()
ps.get('/prod/databases/mysql/bigdb/root')
ps.get_by_path('/prod/databases/mysql')
ps.path_exists('/prod/databases/mysql')
ps.update('/prod/databases/mysql/bigdb/root', 'S3cr3Tp4Ssw0Rd!^')

# AWS Secrets Manager
sm = s1crets.providers.aws.SecretsManager()
sm.get('prod/databases/mysql/bigdb/root')
sm.path_exists('prod/databases/mysql')
sm.update('prod/databases/mysql/bigdb/root', 'S3cr3Tp4Ssw0Rd!^')
$ s1crets get secrets/json_test
{'level1': {'level2': 3}}
$ s1crets get secrets/json_test level1
{'level2': 3}
$ s1crets get secrets/json_test level1 level2
3

Getting secrets from a different (than configured) region:

import s1crets.providers.aws
sm = s1crets.providers.aws.SecretsManager(sts_args={"aws_region": "us-east-1"})
sm.get("secret-from-us-east-1")

This library is developed and used internally at System1

Metadata

Release files for s1crets 0.0.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for s1crets 0.0.12
File Size Uploaded
s1crets-0.0.12.tar.gz 9.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for s1crets 0.0.12
File Interpreter ABI Platform
s1crets-0.0.12-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 20.8 kB

Release files / s1crets-0.0.12.tar.gz

Download URL s1crets-0.0.12.tar.gz
Size 9.4 kB
Tags Source
SHA-256 checksum
How to use checksums
7c725d98d470c366090255047057d335ff8240bc1fb83d0e8a57c4ac4b1c0a57
BLAKE2b-256 checksum
How to use checksums
67cd3e6fc22d5c1a814496110fa1ecddd45ee995d75d856f8b5b4f4d34bd6783
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.18

Release files / s1crets-0.0.12-py2.py3-none-any.whl

Download URL s1crets-0.0.12-py2.py3-none-any.whl
Size 11.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
36c72e995384118668885048a749c52b04be08352b946784fee0a3bff3f4be4a
BLAKE2b-256 checksum
How to use checksums
2866cd96d23e2b62467166e44429a2f86670e6d62db0e7f97ac38c2ce5e6ba5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.18

Release history Release notifications | RSS feed

This release

0.0.12 This release

2 release files

0.0.11

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.3

1 release file

0.0.2

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page