Metadata-Version: 2.1
Name: kdewallet
Version: 1.0.1
Summary: kdewallet interface
Home-page: https://github.com/syntaxfiend/kdewallet
Author: Connor Johnson
Author-email: CONjamesNOR@gmail.com
License: GNU
Description: This is a simple project that wraps the `kwallet-query` command.
        It was made to be flexible you can use whichever syntax suites your fancy
        the way that kde structures their password storage is
        wallet name -> folder name -> entry name  
        
        you can install this package via PyPI
        ```
        pip install kdewallet
        ```
        
        this module can be used in 3 ways here's a quick overview
        ```
        from kdewallet import KDEWallet
        my_pw = KDEWallet.wallet.folder.entry
        my_pw = KDEWallet[wallet][folder][entry]
        # or mix n match
        my_pw = KDEWallt[wallet].folder.[entry]
        
        
        # these are the more procedural style options
        my_pw = KDEWallet(wallet, folder).get_entry(entry)
        my_pw = KDEWallet(wallet).get_entry(entry, folder=folder)
        
        # setting is supported as well
        KDEWallet.wallet.folder.entry = 'really secure'
        ```
        
        For a more detailed example we'll assume we have two wallets just like this.
        ```
        work       # wallet 1
          servera  # folder 1
            root   # entry 1 in folder 1
            userx  # etnry 2 in folder 1
        
          serverb
            userz
            usery
        
        personal  # wallet 2
          gmail   # folder 1 in wallet 2
            frank # entry 1  
            maddy
        
          banking     # etc
            evil bank
            meh credit union
        ```
        
        so given that setup of data some examples of how you might use this would be as follows
        ```
        from kdewallet import KDEWallet
        my_wallet = KDEWallet(wallet='work')
        my_pw = my_wallet.get_entry(entry='root', folder='servera')
        function_that_needs_password(my_pw)
        other_pw = my_wallet.get_entry('frank', 'gmail', 'personal')
        function_that_needs_password(other_pw)
        ```
        
        This could use a bit more work still, but the core tests are passing
        most functionality seems to be working well enough for now. Not sure why I went mad with the
        alternate syntax styles but ya gotta have fun sometimes I guess.
        
        Currently my todos for this project are:
        - find if there is a more secure way to pass pw to kwallet-query than printf
        - add defult wallet/folder support to object access
        - make it clearer whats happening with properties
        - write more rigorous tests
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
