Metadata-Version: 2.1
Name: th2-grpc-common
Version: 3.4.0.dev1120696633
Summary: th2_grpc_common
Home-page: https://github.com/th2-net/th2-grpc-common
Author: TH2-devs
Author-email: th2-devs@exactprosystems.com
License: Apache License 2.0
Description: # th2 gRPC common library (3.4.0)
        
        This library contains common proto messages that are used in all th2 components. See [common.proto](https://github.com/th2-net/th2-grpc-common/blob/master/src/main/proto/th2_grpc_common/common.proto "common.proto") file for details. <br>
        Tool generates code from `.proto` files and uploads built packages (`.proto` files and generated code) to specified repositories.
        
        ## How to maintain a project
        1. Perform the necessary changes.
        2. Update the package version of Java in `gradle.properties` file.
        3. Update the package version of Python in `package_info.json` file.
        4. Commit everything.
        
        ### Java
        If you wish to manually create and publish a package for Java, run the following command:
        ```
        gradle --no-daemon clean build publish artifactoryPublish \
               -Purl=${URL} \ 
               -Puser=${USER} \
               -Ppassword=${PASSWORD}
        ```
        `URL`, `USER` and `PASSWORD` are parameters for publishing.
        
        ### Python
        If you wish to manually create and publish a package for Python:
        1. Generate services with `Gradle`:
            ```
               gradle --no-daemon clean generateProto
            ```
           You can find the generated files by following path: `src/gen/main/services/python`
        2. Generate code from `.proto` files and publish everything using `twine`:
            ```
            pip install -r requirements.txt
            pip install twine
            python setup.py generate
            python setup.py sdist
            twine upload --repository-url ${PYPI_REPOSITORY_URL} --username ${PYPI_USER} --password ${PYPI_PASSWORD} dist/*
            ```
            `PYPI_REPOSITORY_URL`, `PYPI_USER` and `PYPI_PASSWORD` are parameters for publishing.
        
        ## Release notes
        
        ### 3.4.0
        
        + Added `IN` and 'NOT_IN' filter operation, which filter a field by value from list
        + Added `LIKE` and 'NOT_LIKE' filter operation, which filter a field by regEx expression
        + Added `MORE`, `LESS`, 'NOT_MORE', 'NOT_LESS' filter operations, which filter a field by comparing numeric values
        + Added 'WILDCARD" and 'NOT_WILDCARD'  filter operations, which filter a field by specified wildcard expression. 
        
        The wildcard matcher uses the characters '?' and '*' to represent a single or multiple (zero or more) wildcard characters.
        
        This is the same as often found on Dos/Unix command lines
        + "c.txt", "*.txt"     --&gt; true
        + "c.txt", "*.jpg"     --&gt; false
        + "a/b/c.txt", "a/b/*" --&gt; true
        + "c.txt", "*.???"     --&gt; true
        + "c.txt", "*.????"    --&gt; false
        
        N.B. the sequence "*?" does not work properly at present in match strings.
        
        ### 3.3.0
        
        + Added information about message timestamp into checkpoint message
        
        ### 3.2.0
        
        + Implement stubs creation for Python
Platform: UNKNOWN
Requires-Python: >=3.7
Description-Content-Type: text/markdown
