Metadata-Version: 2.1
Name: th2-grpc-act-template
Version: 4.1.0.dev5531718452
Summary: th2_grpc_act_template
Home-page: https://github.com/th2-net/th2-grpc-act-template
Author: TH2-devs
Author-email: th2-devs@exactprosystems.com
License: Apache License 2.0
Description: # th2 gRPC act template library (4.0.1)
        
        This is the template project for creating custom gRPC act libraries. It contains proto messages and `Act` service that
        are used [th2 act template](https://github.com/th2-net/th2-act-template-j "th2-act-template-j").
        See [act_template.proto](src/main/proto/th2_grpc_act_template/act_template.proto "act_template.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 transform the template
        
        1. Create a directory with the same name as the project name (use underscores instead of dashes) under `src/main/proto`
           directory (remove other files and directories if they exist).
        2. Place your custom `.proto` files in the created directory. Pay attention to both the `package` specifier and to
           the `import` statements.
        3. Edit `release_version` and `vcs_url` properties in `gradle.properties` file.
        4. Edit `rootProject.name` variable in `settings.gradle` file. This will be the name of the Java package.
        5. Edit `package_info.json` file in order to specify its name and its version for Python package (create the file in
           case it's absent).
        6. Edit parameters of `setup.py` in `setup` function invocation such as: `author`, `author_email`, `url`. Do not edit
           the other's parameters.
        7. Edit `README.md` file according to the new project.
        
        Note that the name of the created directory under `src/main/proto` directory is used in Python (it's a package name).
        
        ## 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.
        
        ## How to run project
        
        ### 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.1.0
        
        + Update to `th2-grpc-common` version `4.2.0`
        + Update to `th2-bom` version `4.4.0`
        + Update to `th2-grpc-service-genrator` version `3.4.0`
        
        ### 4.0.0
        
        + Update to `th2-grpc-common` version `4.0.0`
        + Marked deprecated fields as `reserved`
        
        ### 3.12.0
        
        + grpc version bump to `1.48.2`
        + protobuf version bump to `3.21.7`
        + serviceGenerator version bump to `3.3.1`
        + Add dependency check pipeline step.
        + Add dev-release workflow.
        
        ### 3.11.0
        
        + Add `multiSendMessage` method for sending several messages at once
        
        ### 3.10.0
        
        + Add `placeOrderCancelReplaceRequest` method for sending `OrderCancelReplaceRequest`
        + Rename `placeCancelFIX` to `placeOrderCancelRequest`
        
        ### 3.9.0
        
        + Update to `th2-grpc-common` version `3.11.1`
        
        ### 3.8.0
        
        + Update to `th2-grpc-common` version `3.9.0`
        
        ### 3.7.0
        
        + Add new method for sending `SecurityStatusRequest`
        
        ### 3.6.0
        
        + Add new method for sending `OrderCancelRequest`
        
        ### 3.5.0
        
        + Update to `th2-grpc-common` version `3.8.0`
        
        ### 3.4.0
        
        + Update to `th2-grpc-common` version `3.7.0`
        
        ### 3.3.0
        
        + Update to `th2-grpc-common` version `3.4.0`
        
        ### 3.2.0
        
        + Implement stubs creation for Python
Platform: UNKNOWN
Requires-Python: >=3.7
Description-Content-Type: text/markdown
