Metadata-Version: 1.1
Name: sshpubkeys
Version: 1.0.4
Summary: SSH public key parser
Home-page: https://github.com/ojarva/sshpubkeys
Author: Olli Jarva
Author-email: olli@jarva.fi
License: BSD
Description: OpenSSH Public Key Parser for Python
        ====================================
        
        .. image:: https://travis-ci.org/ojarva/sshpubkeys.svg?branch=master
            :target: https://travis-ci.org/ojarva/sshpubkeys
        
        This library validates OpenSSH public keys.
        
        Currently ssh-rsa, ssh-dss (DSA) and ecdsa-ssh keys with NIST curves is supported.
        
        Installation:
        
        ::
        
          pip install sshpubkeys
        
        or clone the `repository <https://github.com/ojarva/sshpubkeys>`_ and use
        
        ::
        
          python setup.py install
        
        Usage:
        
        ::
        
          import sshpubkeys
          ssh = SSHKey("ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAYQCxO38tKAJXIs9ivPxt7AY"
                "dfybgtAR1ow3Qkb9GPQ6wkFHQqcFDe6faKCxH6iDRteo4D8L8B"
                "xwzN42uZSB0nfmjkIxFTcEU3mFSXEbWByg78aoddMrAAjatyrh"
                "H1pON6P0= ojarva@ojar-laptop")
          print(ssh.bits) # 768
          print(ssh.hash()) # 56:84:1e:90:08:3b:60:c7:29:70:5f:5e:25:a6:3b:86
        
        
        Exceptions
        ----------
        
        - NotImplementedError if invalid ecdsa curve or unknown key type is encountered.
        - InvalidKeyException if any other error is encountered:
            - TooShortKeyException if key is too short (<768 bits for RSA, <1024 for DSA)
            - TooLongKeyException if key is too long (>16384 for RSA, >1024 for DSA)
            - InvalidTypeException if key type ("ssh-rsa" in above example) does not match to what is included in base64 encoded data.
            - MalformedDataException if decoding and extracting the data fails.
        
        Tests
        -----
        
        See "`tests/ <https://github.com/ojarva/sshpubkeys/tree/master/tests>`_" folder for unit tests. Use
        
        ::
        
          python setup.py test
        
        or
        
        ::
        
          python3 setup.py test
        
        to run test suite. If you have keys that are not parsed properly, or malformed keys that raise incorrect exception, please send your *public key* to olli@jarva.fi, and I'll include it. Alternatively, `create a new issue <https://github.com/ojarva/sshpubkeys/issues/new>`_ or make `a pull request <https://github.com/ojarva/sshpubkeys/compare>`_ in github.
        
Keywords: ssh pubkey public key openssh ssh-rsa ssh-dss ssh-ed25519
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Security
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
