toru-vault 0.2.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

toru_vault/vault.py

@@ -20,6 +20,7 @@ _KEYRING_SERVICE_NAME = "bitwarden_vault"
 _KEYRING_BWS_TOKEN_KEY = "bws_token"
 _KEYRING_ORG_ID_KEY = "organization_id"
 _KEYRING_STATE_FILE_KEY = "state_file"
+_KEYRING_PROJECT_ID_KEY = "project_id"
 
 def _get_from_keyring_or_env(key, env_var):
     """
@@ -125,7 +126,7 @@ def env_load(project_id=None, override=False):
     Load all secrets related to the project into environmental variables.
     
     Args:
-        project_id (str, optional): Project ID to filter secrets
+        project_id (str, optional): Project ID to filter secrets. If None, will try to get from keyring or PROJECT_ID environment variable
         override (bool, optional): Whether to override existing environment variables
     """
     try:
@@ -138,6 +139,10 @@ def env_load(project_id=None, override=False):
         logger.error("ORGANIZATION_ID not found in keyring or environment variable")
         return
     
+    # If project_id is not provided, try to get it from keyring or environment variable
+    if project_id is None:
+        project_id = _get_from_keyring_or_env(_KEYRING_PROJECT_ID_KEY, "PROJECT_ID")
+    
     secrets = load_secrets_env(client, organization_id, project_id)
 
     set_env_vars(secrets, override)
@@ -171,7 +176,7 @@ def get(project_id=None, use_keyring=True):
     Return a dictionary of all project secrets with JIT decryption
     
     Args:
-        project_id (str, optional): Project ID to filter secrets
+        project_id (str, optional): Project ID to filter secrets. If None, will try to get from keyring or PROJECT_ID environment variable
         use_keyring (bool, optional): Whether to use system keyring (True) or in-memory encryption (False)
         
     Returns:
@@ -188,6 +193,10 @@ def get(project_id=None, use_keyring=True):
         logger.error("ORGANIZATION_ID not found in keyring or environment variable")
         return {}
     
+    # If project_id is not provided, try to get it from keyring or environment variable
+    if project_id is None:
+        project_id = _get_from_keyring_or_env(_KEYRING_PROJECT_ID_KEY, "PROJECT_ID")
+    
     from .in_memory import load_secrets_memory
     all_secrets = load_secrets_memory(client, organization_id, project_id)
     

{toru_vault-0.2.0.dist-info → toru_vault-0.3.1.dist-info}/METADATA

@@ -1,15 +1,22 @@
 Metadata-Version: 2.4
 Name: toru-vault
-Version: 0.2.0
+Version: 0.3.1
 Summary: ToruVault: A simple Python package for managing Bitwarden secrets
 Author: Toru AI
 Author-email: ToruAI <mpaszynski@toruai.com>
 License: MIT
 Project-URL: Homepage, https://github.com/ToruAI/ToruVault
 Project-URL: Issues, https://github.com/ToruAI/ToruVault/issues
+Keywords: env manager,api key manager,secrets manager python,bitwarden python,environment variable manager,secret management,keyring,Bitwarden integration
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Intended Audience :: Developers
+Classifier: Environment :: Console
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -25,23 +32,23 @@ Dynamic: requires-python
 
 # ToruVault
 
-A simple Python package for managing Bitwarden secrets with enhanced security.
+A secure Python secrets manager and environment variable manager for Bitwarden integration. Safely manage API keys and secrets in your Python applications.
 
 
-![Version](https://img.shields.io/badge/version-0.2.0-blue)
+![Version](https://img.shields.io/badge/version-0.3.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 
 ## Features
 
-- Load secrets from Bitwarden Secret Manager into environment variables
-- Get secrets as a Python dictionary
-- Filter secrets by project ID
-- JIT decryption of individual secrets
-- No persistent caching of decrypted values
-- Secure file permissions for state storage
-- Machine-specific secret protection
-- Secure credential storage using OS keyring
+- **Secrets Manager for Python**: Load secrets from Bitwarden Secret Manager into environment variables
+- **API Key Management**: Access and manage API keys securely in your Python applications
+- **Environment Variable Manager**: Easily inject secrets as environment variables
+- **Bitwarden Python Integration**: Seamless integration with Bitwarden Secret Manager
+- **Secure In-Memory Caching**: Encrypted caching with automatic expiration (5 minutes)
+- **Project-Based Secret Filtering**: Filter secrets by project ID
+- **Secure Storage**: Machine-specific secret protection with proper file permissions
+- **OS Keyring Integration**: Secure credential storage using your operating system's keyring
 
 ## Installation
 
@@ -118,6 +125,7 @@ Alternatively, you can set the following environment variables:
 - `BWS_TOKEN`: Your Bitwarden access token
 - `ORGANIZATION_ID`: Your Bitwarden organization ID
 - `STATE_FILE`: Path to the state file (must be in an existing directory)
+- `PROJECT_ID` (optional): Your Bitwarden project ID to filter secrets
 - `API_URL` (optional): Defaults to "https://api.bitwarden.com"
 - `IDENTITY_URL` (optional): Defaults to "https://identity.bitwarden.com"
 
@@ -144,7 +152,7 @@ python -m vault list --org-id YOUR_ORGANIZATION_ID
 
 ## Python Usage
 
-### Loading secrets into environment variables
+### Loading secrets into environment variables (Env Manager)
 
 ```python
 import toru_vault as vault
@@ -159,6 +167,11 @@ print(os.environ.get("SECRET_NAME"))
 # Load secrets for a specific project
 vault.env_load(project_id="your-project-id")
 
+# Alternatively, set PROJECT_ID environment variable and call without parameter
+# export PROJECT_ID="your-project-id"  # Linux/macOS
+# set PROJECT_ID=your-project-id     # Windows
+vault.env_load()  # Will use PROJECT_ID from environment
+
 # Override existing environment variables (default: False)
 vault.env_load(override=True)
 ```
@@ -178,6 +191,11 @@ secrets = vault.get(refresh=True)
 # Get secrets for a specific project
 secrets = vault.get(project_id="your-project-id")
 
+# Alternatively, set PROJECT_ID environment variable and call without parameter
+# export PROJECT_ID="your-project-id"  # Linux/macOS
+# set PROJECT_ID=your-project-id     # Windows
+secrets = vault.get()  # Will use PROJECT_ID from environment
+
 # Use in-memory encryption instead of system keyring
 secrets = vault.get(use_keyring=False)
 ```
@@ -196,19 +214,20 @@ vault.env_load_all(override=True)
 
 ## Security Features
 
-The vault package includes several security enhancements:
+ToruVault provides robust security for your API keys and environment variables:
 
 1. **OS Keyring Integration**: Securely stores BWS_TOKEN, ORGANIZATION_ID, and STATE_FILE in your OS keyring
-2. **Memory Protection**: Secrets are individually encrypted in memory using Fernet encryption (AES-128)
-3. **JIT Decryption**: Secrets are only decrypted when explicitly accessed and never stored in decrypted form
-4. **Secure File Permissions**: Sets secure permissions on state files
-5. **Machine-Specific Encryption**: Uses machine-specific identifiers for encryption keys
+2. **Memory Protection**: Secrets are encrypted in memory using Fernet encryption (AES-128)
+3. **Lazy Decryption**: Secrets are only decrypted when explicitly accessed
+4. **Cache Expiration**: Cached secrets expire after 5 minutes by default
+5. **Secure File Permissions**: Sets secure permissions on state files
+6. **Machine-Specific Encryption**: Uses machine-specific identifiers for encryption keys
 7. **Cache Clearing**: Automatically clears secret cache on program exit
 8. **Environment Variable Protection**: Doesn't override existing environment variables by default
 9. **Secure Key Derivation**: Uses PBKDF2 with SHA-256 for key derivation
 10. **No Direct Storage**: Never stores secrets in plain text on disk
 
-## Bitwarden Secrets
+## Bitwarden Python Integration
 
 ### BWS_TOKEN
 
@@ -253,3 +272,18 @@ When working with secrets, always follow these important guidelines:
 6. **Use Environment-Specific Secrets**: Use different secrets for development, staging, and production environments.
 
 Remember that the vault package is designed to protect secrets once they're in your system, but you must handle the initial configuration securely.
+
+## Why Choose ToruVault
+
+ToruVault stands out as a comprehensive solution for Python developers who need:
+
+- A reliable **secrets manager for Python** applications
+- Secure **API key management** with encryption
+- An **environment variable manager** that simplifies configuration
+- Seamless **Bitwarden Python integration** for team secret sharing
+
+By combining the security of Bitwarden with the convenience of Python's environment variables, ToruVault provides a robust solution for managing sensitive information in your applications.
+
+## License
+
+ToruVault is released under the MIT License. See the LICENSE file for details.

{toru_vault-0.2.0.dist-info → toru_vault-0.3.1.dist-info}/RECORD

@@ -4,10 +4,10 @@ toru_vault/in_env.py,sha256=cr-Md7YODsRgeebPrzMcRsvojmVH4Mb-cmsUWFcj64k,6253
 toru_vault/in_memory.py,sha256=Xt9F_a3it-SQ9f2lMdvO0e4aCkrcZR6bUujuMKHABS0,13608
 toru_vault/lazy_dict.py,sha256=VRJAP-3SSk09GZh4le69kmHCoPzNOmP2ewWEEG5po6g,3054
 toru_vault/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-toru_vault/vault.py,sha256=rkXeNcRMbyg0zof8oaEJWJii-y2zUQ7uahSXvwypMQs,8764
-toru_vault-0.2.0.dist-info/licenses/LICENSE,sha256=TbuuchABSutbmmaI1M232F22GsaI88_hwEvto5w_Ux4,1063
-toru_vault-0.2.0.dist-info/METADATA,sha256=4T7rk_eTDzdgQLsYPrEgFR0Qyuz5cMTfCuhIsd71Eq8,8131
-toru_vault-0.2.0.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-toru_vault-0.2.0.dist-info/entry_points.txt,sha256=dfqkbNftpmAv0iKzVgdkjymkCfj3TwzUrQm2PO7Xgxs,56
-toru_vault-0.2.0.dist-info/top_level.txt,sha256=c9ulQ18kKs3HbkI5oeoLmnFTknjC0rY1BwsNLJKDua8,11
-toru_vault-0.2.0.dist-info/RECORD,,
+toru_vault/vault.py,sha256=10FVC6kV-IU9p5ptYG48hyrloC_cI75dTALN3tpnGBY,9361
+toru_vault-0.3.1.dist-info/licenses/LICENSE,sha256=TbuuchABSutbmmaI1M232F22GsaI88_hwEvto5w_Ux4,1063
+toru_vault-0.3.1.dist-info/METADATA,sha256=E7PIw2VqfddU6Yu1QeJdhZHYuzpnIJiLQtbi5HMijSI,10237
+toru_vault-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+toru_vault-0.3.1.dist-info/entry_points.txt,sha256=dfqkbNftpmAv0iKzVgdkjymkCfj3TwzUrQm2PO7Xgxs,56
+toru_vault-0.3.1.dist-info/top_level.txt,sha256=c9ulQ18kKs3HbkI5oeoLmnFTknjC0rY1BwsNLJKDua8,11
+toru_vault-0.3.1.dist-info/RECORD,,

{toru_vault-0.2.0.dist-info → toru_vault-0.3.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any