Metadata-Version: 1.0
Name: dropsonde
Version: 0.0.4
Summary: Compiled python generated from the Cloud Foundry Dropsonde Protobuf definition files
Home-page: https://github.com/hsdp/python-dropsonde
Author: Adam Jaso
Author-email: UNKNOWN
License: Apache License Version 2.0
Description: # Cloud Foundry Dropsonde Protocol for Python
        
        Compiled python generated from the Cloud Foundry Dropsonde Protobuf definition files.
        
        The [Dropsonde Protocol](https://github.com/cloudfoundry/dropsonde-protocol)
        is defined here, and this repo provides "protoc" compiled Python and Python3
        modules.
        
        ## Example
        
        The Standard protobuf files are referenced as follows.
        
        ```python
        from dropsonde.pb import envelope_pb2
        from dropsonde.pb import error_pb2
        from dropsonde.pb import http_pb2
        from dropsonde.pb import log_pb2
        from dropsonde.pb import metric_pb2
        from dropsonde.pb import uuid_pb2
        ```
        
        The UUID protobuf type is rather cryptic, so a utility function is included
        for parsing the type into a UUID formatted string.
        
        ```python
        >>> from dropsonde.util import get_uuid_string
        >>> application_guid = {
        ...   'low': '12413561682238894606',
        ...   'high': '3611542221973970511'
        ... }
        >>> application_guid = get_uuid_string(**application_guid)
        >>> print(application_guid)
        0ef23f83-94d4-45ac-e455-014268ec2103
        >>>
        ```
        
        ## Development
        
        The `Makefile` provides all core development tasks.
        
        ### Install environment
        
        `make install`
        
        This will
        
        1. clone the Dropsonde protobuf repo
        1. install dependencies for python2
        1. install dependencies for python3
        
        ### Refactor and compile the protobuf files
        
        `make compile`
        
        This will
        
        1. create a copy of the protobuf source files
        1. refactor the "import" directives in the source files to match the required python package structure
        1. run "protoc" on the refactored source files and output the generated Python code into the "dropsonde.pb" python package tree.
        
        ### Test
        
        `make test`
        
        This will
        
        1. run the tests to ensure that imports work
        1. ensure that the UUID conversion tool works
        
        ### Clean
        
        `make clean`
        
        This will
        
        1. remove all the refactored protobuf files
        1. remove the virtualenv environments for python2 and python3
        
        ### Package
        
        `make package`
        
        This will only package the compiled python files using `setup.py`
        
        ### Build
        
        `make build`
        
        This will
        
        1. run the "clone" task
        1. run the "compile" task
        1. run the "test" task
        1. run the "package" task
        
        ### Deploy
        
        `make deploy`
        
        This will
        
        1. run the "clean" task
        1. run the "clone" task
        1. run the "compile" task
        1. run the "test" task
        1. run the `python setup.py sdist upload` to deploy to PyPI.
        
Platform: UNKNOWN
