# th2 gRPC act template library (4.4.0)
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.4.0
+ [[GH-47] Added `placeHttpRequest` method for placing HTTP requests](https://github.com/th2-net/th2-grpc-act-template/issues/47)
### 4.3.1
+ Migrated to range python dependencies
+ Updated:
+ th2 gradle plugin: `0.3.8` (bom: `4.14.1`)
+ th2-grpc-common: `4.7.2`
### 4.3.0
+ Migrated to th2 gradle plugin: `0.3.4` (bom: `4.13.1`)
+ Updated:
+ th2-grpc-common: `4.7.1`
+ mypy-protobuf ~= `3.6`
### 4.2.0
+ Added rpc to send messages directly to component avoiding codec.
### 4.1.0
+ Update to `th2-grpc-common` version `4.3.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
Raw data
{
"_id": null,
"home_page": "https://github.com/th2-net/th2-grpc-act-template",
"name": "th2-grpc-act-template",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "TH2-devs",
"author_email": "th2-devs@exactprosystems.com",
"download_url": "https://files.pythonhosted.org/packages/8f/46/788080312eefb9ce536e397c9d74c704e44baf3c59f79126d9c97e12c4f5/th2_grpc_act_template-4.4.0.tar.gz",
"platform": null,
"description": "# th2 gRPC act template library (4.4.0)\n\nThis is the template project for creating custom gRPC act libraries. It contains proto messages and `Act` service that\nare used [th2 act template](https://github.com/th2-net/th2-act-template-j \"th2-act-template-j\").\nSee [act_template.proto](src/main/proto/th2_grpc_act_template/act_template.proto \"act_template.proto\") file for\ndetails. <br>\nTool generates code from `.proto` files and uploads built packages (`.proto` files and generated code) to specified\nrepositories.\n\n## How to transform the template\n\n1. Create a directory with the same name as the project name (use underscores instead of dashes) under `src/main/proto`\n directory (remove other files and directories if they exist).\n2. Place your custom `.proto` files in the created directory. Pay attention to both the `package` specifier and to\n the `import` statements.\n3. Edit `release_version` and `vcs_url` properties in `gradle.properties` file.\n4. Edit `rootProject.name` variable in `settings.gradle` file. This will be the name of the Java package.\n5. Edit `package_info.json` file in order to specify its name and its version for Python package (create the file in\n case it's absent).\n6. Edit parameters of `setup.py` in `setup` function invocation such as: `author`, `author_email`, `url`. Do not edit\n the other's parameters.\n7. Edit `README.md` file according to the new project.\n\nNote that the name of the created directory under `src/main/proto` directory is used in Python (it's a package name).\n\n## How to maintain a project\n\n1. Perform the necessary changes.\n2. Update the package version of Java in `gradle.properties` file.\n3. Update the package version of Python in `package_info.json` file.\n4. Commit everything.\n\n## How to run project\n\n### Java\n\nIf you wish to manually create and publish a package for Java, run the following command:\n\n```\ngradle --no-daemon clean build publish artifactoryPublish \\\n -Purl=${URL} \\ \n -Puser=${USER} \\\n -Ppassword=${PASSWORD}\n```\n\n`URL`, `USER` and `PASSWORD` are parameters for publishing.\n\n### Python\n\nIf you wish to manually create and publish a package for Python:\n\n1. Generate services with `Gradle`:\n ```\n gradle --no-daemon clean generateProto\n ```\n You can find the generated files by following path: `src/gen/main/services/python`\n2. Generate code from `.proto` files and publish everything using `twine`:\n ```\n pip install -r requirements.txt\n pip install twine\n python setup.py generate\n python setup.py sdist\n twine upload --repository-url ${PYPI_REPOSITORY_URL} --username ${PYPI_USER} --password ${PYPI_PASSWORD} dist/*\n ```\n `PYPI_REPOSITORY_URL`, `PYPI_USER` and `PYPI_PASSWORD` are parameters for publishing.\n\n## Release notes\n\n### 4.4.0\n\n+ [[GH-47] Added `placeHttpRequest` method for placing HTTP requests](https://github.com/th2-net/th2-grpc-act-template/issues/47)\n\n### 4.3.1\n\n+ Migrated to range python dependencies\n+ Updated:\n + th2 gradle plugin: `0.3.8` (bom: `4.14.1`)\n + th2-grpc-common: `4.7.2`\n\n### 4.3.0\n\n+ Migrated to th2 gradle plugin: `0.3.4` (bom: `4.13.1`)\n+ Updated:\n + th2-grpc-common: `4.7.1`\n + mypy-protobuf ~= `3.6`\n\n### 4.2.0\n+ Added rpc to send messages directly to component avoiding codec.\n\n### 4.1.0\n\n+ Update to `th2-grpc-common` version `4.3.0`\n+ Update to `th2-bom` version `4.4.0`\n+ Update to `th2-grpc-service-genrator` version `3.4.0`\n\n### 4.0.0\n\n+ Update to `th2-grpc-common` version `4.0.0`\n+ Marked deprecated fields as `reserved`\n\n### 3.12.0\n\n+ grpc version bump to `1.48.2`\n+ protobuf version bump to `3.21.7`\n+ serviceGenerator version bump to `3.3.1`\n+ Add dependency check pipeline step.\n+ Add dev-release workflow.\n\n### 3.11.0\n\n+ Add `multiSendMessage` method for sending several messages at once\n\n### 3.10.0\n\n+ Add `placeOrderCancelReplaceRequest` method for sending `OrderCancelReplaceRequest`\n+ Rename `placeCancelFIX` to `placeOrderCancelRequest`\n\n### 3.9.0\n\n+ Update to `th2-grpc-common` version `3.11.1`\n\n### 3.8.0\n\n+ Update to `th2-grpc-common` version `3.9.0`\n\n### 3.7.0\n\n+ Add new method for sending `SecurityStatusRequest`\n\n### 3.6.0\n\n+ Add new method for sending `OrderCancelRequest`\n\n### 3.5.0\n\n+ Update to `th2-grpc-common` version `3.8.0`\n\n### 3.4.0\n\n+ Update to `th2-grpc-common` version `3.7.0`\n\n### 3.3.0\n\n+ Update to `th2-grpc-common` version `3.4.0`\n\n### 3.2.0\n\n+ Implement stubs creation for Python\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "th2_grpc_act_template",
"version": "4.4.0",
"project_urls": {
"Homepage": "https://github.com/th2-net/th2-grpc-act-template"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8f46788080312eefb9ce536e397c9d74c704e44baf3c59f79126d9c97e12c4f5",
"md5": "edf7cf0028cc2aa5bf1662ba022b49f7",
"sha256": "c8c4039ff8f24b8bb0402e9bd2ba2583d7732b567693305421b7bc8854c249ad"
},
"downloads": -1,
"filename": "th2_grpc_act_template-4.4.0.tar.gz",
"has_sig": false,
"md5_digest": "edf7cf0028cc2aa5bf1662ba022b49f7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 14883,
"upload_time": "2025-10-24T07:20:21",
"upload_time_iso_8601": "2025-10-24T07:20:21.578882Z",
"url": "https://files.pythonhosted.org/packages/8f/46/788080312eefb9ce536e397c9d74c704e44baf3c59f79126d9c97e12c4f5/th2_grpc_act_template-4.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-24 07:20:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "th2-net",
"github_project": "th2-grpc-act-template",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "th2-grpc-common",
"specs": [
[
">=",
"4.7.2"
],
[
"<",
"5"
]
]
}
],
"lcname": "th2-grpc-act-template"
}
JSON
