Python-pyo3: add library interface

[Esgrove]

Enable using python-pyo3 vault version as a python library. Adds wrappers for accessing most vault functions:
all, delete, delete_many, direct_encrypt, direct_decrypt, exists, list_all, lookup, store, init, update, and stack_status
(Some of these are new compared to the old python version)

• Re-organize pyo3 package to match old python version:
  • rename p_vault to n_vault
  • put Python CLI under cli.py and library in vault.py
• Add integration tests for Python library usage
• Update python readme with vault library usage instructions

The Vault class in the new library is a dummy class that is only there to make the interface the same as before, so you can use it like before but it does not actually construct a vault instance:

from n_vault import Vault

Vault().store("key", "value")

vault = Vault()
value = vault.lookup("key")

Parameters and names are mostly the same, the vault class has some differences due to the Rust vault doing things a bit differently:

# OLD
def __init__(
    self,
    vault_stack="",
    vault_key="",
    vault_bucket="",
    vault_iam_id="",
    vault_iam_secret="",
    vault_prefix="",
    vault_region=None,
    vault_init=False,
):
    
# NEW
def __init__(
    self,
    vault_stack: str = None,
    vault_key: str = None,
    vault_bucket: str = None,
    vault_prefix: str = None,
    vault_region: str = None,
    profile: str = None,
):

init, update, and stack_status return dataclasses so data is nicely typed and accessible:

➜  python-pyo3 git:(pyo3-library) ✗ nep nitor-core

➜  python-pyo3 git:(pyo3-library) ✗ python
Python 3.13.0 (main, Oct  7 2024, 05:02:14) [Clang 16.0.0 (clang-1600.0.26.3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> from n_vault import Vault
>>> Vault().init()
CloudFormationStackData(result='EXISTS', bucket='nitor-core-vault', key='arn:aws:kms:eu-west-1:293246570391:key/726c1aeb-ba7d-4616-ac9f-d67e72774d88', status='UPDATE_COMPLETE', status_reason=None, version=27)
>>> result = Vault().update()
>>> print(result)
CloudFormationStackData(result='UP_TO_DATE', bucket='nitor-core-vault', key='arn:aws:kms:eu-west-1:293246570391:key/726c1aeb-ba7d-4616-ac9f-d67e72774d88', status='UPDATE_COMPLETE', status_reason=None, version=27)
>>> result.bucket
'nitor-core-vault'
>>> Vault(vault_stack="testing-new-library").init()
StackCreated(result='CREATED', stack_name='testing-new-library', stack_id='arn:aws:cloudformation:eu-west-1:293246570391:stack/testing-new-library/01102700-a1d0-11ef-84d1-06ed5a90571f', region='eu-west-1')

[kahlstrm]

Haven't tested it but looks good 👍