Skip to main content

th2_grpc_common

Project description

th2 gRPC common library (4.6.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
    
    ### 4.6.0
    + Updated:
      + th2 gradle plugin 0.1.1 -> 0.1.3
      + bom 4.6.1 -> 4.8.0
    
    ### 4.5.0
    
    + Updated:
      + bom 4.4.0 -> 4.6.1
      + grpc 1.56.0 -> 1.62.2
      + grpc-service-generator removed
    
    ### 4.4.0
    
    + Added `check_simple_collections_order` parameter to `RootComparisonSettings`
    
    ### 4.3.0
    
    + Added golang specific properties
    + Updated bom:4.4.0
    + Updated grpc-service-generator:3.4.0
    + Updated grpcio-tools:1.56.0
    + Updated mypy-protobuf:3.4
    
    ### 4.2.0
    
    + Added vulnerability check
    + Updated bom:4.2.0
    + Updated protoc:3.21.7
    + Updated grpc-service-generator:3.3.1
    + Downgraded grpc version from 1.50.2 to 1.48.1 according to bom
    
    ### 4.1.1
    
    + Added script for publishing dev-release for maven artefacts
    + Migrated to bom:4.2.0
    
    ### 4.1.0
    
    + Added event / message batch metadata with the external_user_queue field. This field can be used to send MQ message to
      direct queue instead of schema routing in some cases.
    
    ### 4.0.0
    
    + Marked deprecated fields as `reserved`
    + Moved `timestamp` from `MessageMetadata`/`RawMessageMetadata` to `MessageID`
    + Moved `start_timestamp` from `Event` to `EventID`
    + Added `book_name` to `MessageID` and `EventID`
    + Added `scope` to `EventID`
    + Added `map<string, SessionAliasToDirectionCheckpoint>` to `Checkpoint`. It describes book to session alias to
      direction.
    + Added `EventBatchMetadata` and `MessageGroupBatchMetadata` with `external_queue` property
    
    ### 3.13.0
    
    + Update `th2-bom` version from '3.0.0' to '4.1.0'
    
    ### 3.12.0
    
    + Update `grpcio-tools` Python dependency version from `1.38.1` to `1.50.0`
    + Update `grpc` Java dependency version from `1.32.1` to `1.50.2`
    
    ### 3.11.1
    
    + Update `mypy-protobuf` Python dependency version from `2.5` to `3.2`
    
    ### 3.11.0
    
    + Added `session_group` parameter to `ConnectionID`
    
    ### 3.10.0
    
    + Updated grpc-service-generator (added support for gRPC pins filters).
    
    ### 3.9.0
    
    + Added `null_value` in `ValueFilter`. Should be used only with EQUAL and NOT_EQUAL operations.
    
    ### 3.8.0
    
    + Added `time_precision` and `decimal_precision` parameters to `RootComparisonSettings`
    + Added `EQ_TIME_PRECISION` and `EQ_DECIMAL_PRECISION` filter operation, witch filter a field by comparing
      values(`date/time` in ISO format and `numeric` types) with the precision. The timestamps will be compared with the
      protobuf duration format. Numbers use string format, for example _0.0001_, _0.125_, _125E-3_
    
    ### 3.7.0
    
    + Added `check_repeating_group_order` parameter to `RootComparisonSettings`
    
    ### 3.6.0
    
    + Added `description` parameter to `RootMessageFilter`.
    
    ### 3.5.0
    
    + Added SimpleList parameter to SimpleFilter.
    
    ### 3.4.0
    
    + Added `IN` and `NOT_IN` filter operation, which filter a field by value from list of `String`.
    + Added `LIKE` and `NOT_LIKE` filter operation, which filter a field by `String` regEx expression.
    + Added `MORE`, `LESS`, `NOT_MORE`, `NOT_LESS` filter operations, which filter a field by comparing values(`numeric`
      types and `date/time` in ISO format).
    + Added `WILDCARD` and `NOT_WILDCARD`  filter operations, which filter a field by `String` 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.
    + "abc-123", "*-123"     --&gt; true
    + "abc-123", "*-xyz"     --&gt; false
    + "abc-123", "ab*"       --&gt; true
    + "abc-123", "*-???"     --&gt; true
    + "abc-123", "*-????"    --&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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

th2_grpc_common-4.6.0.dev13242390829.tar.gz (17.8 kB view details)

Uploaded Source

File details

Details for the file th2_grpc_common-4.6.0.dev13242390829.tar.gz.

File metadata

File hashes

Hashes for th2_grpc_common-4.6.0.dev13242390829.tar.gz
Algorithm Hash digest
SHA256 b8c9def36044831bf85ea904f6e4471c8e8dbc20887660ddb01e3ae30e231c1a
MD5 9fe1ef3372810205964f3fc2664e633d
BLAKE2b-256 d120000acaf94169b0d45d46f622f7df854ef04a76e5e3853c1e79428cc7338e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page