Metadata-Version: 1.2
Name: postmortem
Version: 0.3.0
Summary: Produces a package of information for dependents and partners to be opened upon death.
Home-page: https://github.com/kenkundert/postmortem
Author: Ken Kundert
Author-email: postmortem@nurdletech.com
License: GPLv3+
Download-URL: https://github.com/kenkundert/postmortem/tarball/master
Description: PostMortem: Generates Packets of Useful Information for Partners and Dependents to be Opened Upon Death
        =======================================================================================================
        
        | Version: 0.3.0
        | Released: 2019-04-28
        |
        
        *PostMortem* works with `Avendesora <https://avendesora.readthedocs.io>`_ to 
        produce packets of information for partners and dependents to help them carry on 
        after your death or incapacitation.  Primarily *PostMortem* queries *Avendesora* 
        to produce an encrypted document that contains information about all of your 
        essential accounts including security credentials such as usernames and 
        passcodes. It also can include related pre-prepared documents such as the legal 
        documents that establish and control your estate.
        
        Your partners and dependents do not need *PostMortem* or *Avendesora* to access 
        their documents, however they must be capable of using *GPG* and have a GPG 
        encryption key.  However, if they do use happen to use *Avendesora*, they can 
        import the accounts you shared with them directly into *Avendesora*.
        
        Please report all bugs and suggestions to postmortem@nurdletech.com
        
        Getting Started
        ---------------
        
        You download and install *PostMortem* with::
        
            pip3 install --user postmortem
        
        Once installed, you will need a configuration file. The file is: 
        ~/.config/postmortem/config and should contain the following fields.
        
        my_gpg_ids:
        
            A string that contains an identifier for your GPG key. This could be your 
            email address or a GPG ID. The output files will be encrypted with this key 
            as well as the keys of the intended recipients.
        
        name_template:
        
            A python format string that specifies how the packet directory should be 
            named. It can include two named parameters, *name* and *now*. *name* is the 
            name of a recipient and now is and Arrow time object.
        
        recipients:
        
            A dictionary of dictionary that contains preferences for each of the 
            recipients.
        
        Here is an example config file::
        
            my_gpg_ids = 'odin@norse-gods.com'
            name_template = '{name}-{now:YYMMDD}'
        
            recipients = dict(
                frigg = dict(
                    email = 'frigg@norse-gods.com',
                    category = 'wife',
                    extras = [
                        '~/home/finances/estate
                    ],
                    networth = True,
                ),
                thor = dict(
                    email = 'thor@norse-gods.com',
                    category = 'kids',
                    extras = [
                        '~/home/finances/estate
                    ],
                ),
                loki = dict(
                    email = 'loki@norse-gods.com',
                    category = 'kids',
                    extras = [
                        '~/home/finances/estate
                    ],
                ),
            )
        
        Two encrypted files are created for each recipient, one is an encrypted text 
        file that contains your account information, the other is an encrypted 
        Avendesora account file. Both of these files contain the same information.  Each 
        recipient should have an *email* or *gpg_id* that is associated with a known GPG 
        key. Each recipient should also belong to a category.  Your Avendesora accounts 
        are searched for a field named *postmortem_recipients*, which is a string or 
        list.  The account is included in the packet if the recipients category is 
        contained in *postmortem_recipients*.  *extras* is a list of files or 
        directories that are also included in the packet.  Finally, if *networth* is 
        specified and is True, then a networth summary is also included.  *networth* may 
        also be a profile name for the networth command, in which case that profile is 
        used. The networth command is available from `Cryptocurrency 
        <https://github.com/KenKundert/cryptocurrency>`_.
        
        
        Running PostMortem
        ------------------
        
        You can generate a packet for a particular recipient using::
        
            postmortem thor
        
        This creates the encrypted file that contains the packet. The packet can be 
        extracted with::
        
            gpg -d -o thor-190101.tgz thor-190101.tgz.gpg
            tar zxf thor-190101.tgz
        
        or, in a single step using::
        
            gpg -d -o - thor-190101.tgz.gpg | tar zxf -
        
        You can have *PostMortem* send the packet directly using email if *email* is 
        given in the configuration file using::
        
            postmortem -s thor
        
        Finally, if you do not specify a recipient, packets are created for all known 
        recipients.
        
        
        Importing Accounts into Avendesora
        ----------------------------------
        
        Once you have extracted the files from a packet you will see a file named 
        *avendesora_acounts.gpg*.  This is an *Avendesora* accounts file. If you use 
        *Avendesora* you can import the accounts using these two steps:
        
        1. Copy the file into your *Avendesora* accounts directory. You may rename the 
           file, but keep the extension the same.  For example::
        
               mv avendesora_acounts.gpg ~/.config/avendesora/parents.gpg
        
        2. Edit the *Avendesora* accounts file and add your new file to the 
           *accounts_files* list::
        
               vi ~/.config/avendesora/accounts_files
        
        Once you have done this you may find that there are conflicting names or aliases 
        for your *Avendesora* accounts. For example, if both you and your parents use 
        *Nordea* bank, the name *nordea* might conflict. In this case you should adjust 
        the names and aliases used in your newly imported accounts file. None of the 
        secrets in the imported file are generated, and so change the account names in 
        this file will change the underlying secrets.
        
Keywords: postmortem
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Utilities
Requires-Python: >=3.6
