[](https://finosfoundation.atlassian.net/wiki/display/FINOS/Incubating)
[](https://opensource.org/licenses/Apache-2.0)
[](https://www.python.org/downloads/release/python-3)
[](https://pypi.org/project/symphony-bdk-python/)
# Symphony BDK for Python
This is the Symphony BDK for Python to help develop bots and interact with the [Symphony REST APIs](https://developers.symphony.com/restapi/reference).
## Installation and getting started
The [reference documentation](https://symphony-bdk-python.finos.org/) includes detailed
installation instructions as well as a comprehensive
[getting started](https://symphony-bdk-python.finos.org/markdown/getting_started.html)
guide.
## Build from source
The Symphony BDK uses and requires Python 3.8 or higher. Be sure you have it installed before going further.
We use [poetry](https://python-poetry.org/) in order to manage dependencies, build, run tests and publish.
To install poetry, follow instructions [here](https://python-poetry.org/docs/#installation).
On the first time, run `poetry install`. Then run `poetry build` to build the sdist and wheel packages.
To run the tests, use `poetry run pytest`.
It is possible to run pylint scan locally (on a specific file or package) executing the following command:
`poetry run pylint <module_name>`.
To generate locally the Sphinx documentation, run: `cd docsrc && make html`.
## Roadmap
Our next milestone is the [2.5.x](https://github.com/finos/symphony-bdk-python/milestone/6) one.
It will only consist in delivering the next improvements and bug fixes of the BDK.
## Contributing
In order to get in touch with the project team, please open a [GitHub Issue](https://github.com/finos/symphony-bdk-python/issues).
Alternatively, you can email/subscribe to [symphony@finos.org](https://groups.google.com/a/finos.org/g/symphony).
1. Fork it
2. Create your feature branch (`git checkout -b feature/fooBar`)
3. Read our [contribution guidelines](CONTRIBUTING.md) and [Community Code of Conduct](https://www.finos.org/code-of-conduct)
4. Commit your changes (`git commit -am 'Add some fooBar'`)
5. Push to the branch (`git push origin feature/fooBar`)
6. Create a new Pull Request
_NOTE:_ Commits and pull requests to FINOS repositories will only be accepted from those contributors with an active,
executed Individual Contributor License Agreement (ICLA) with FINOS OR who are covered under an existing and active
Corporate Contribution License Agreement (CCLA) executed with FINOS.
Commits from individuals not covered under an ICLA or CCLA will be flagged and blocked by the FINOS Clabot tool.
Please note that some CCLAs require individuals/employees to be explicitly named on the CCLA.
*Need an ICLA? Unsure if you are covered under an existing CCLA? Email [help@finos.org](mailto:help@finos.org)*
### Update generated code
While contributing to the project, you might need to update the generated code.
Python BDK uses [OpenAPITools/openapi-generator](https://github.com/OpenAPITools/openapi-generator/) to generate code. In order to customise the templates, a fork has been created in [https://github.com/SymphonyPlatformSolutions/openapi-generator/tree/sym-python-5.5.0](https://github.com/SymphonyPlatformSolutions/openapi-generator/tree/sym-python-5.5.0).
Here are the steps to follow:
- Checkout the latest branch of the fork (currently [sym-python-5.5.0](https://github.com/SymphonyPlatformSolutions/openapi-generator/tree/sym-python-5.5.0))
- Update the fork source code, review and merge it
- Generate a jar file in `openapi-generatormodules/openapi-generator-cli/target/openapi-generator-cli.jar`:
- Using maven: `mvn clean install -Dmaven.test.skip=true && mvn clean package -Dmaven.test.skip=true`. _You can also use IntelliJ's build button to build the project and generate the jar_
- Copy the jar in Python BDK repository `symphony-api-client-python/api_client_generation/openapi-generator-cli.jar`
- Execute the generation script `./generate.sh` and commit and push you new code along with the new jar file.
## License
Copyright 2021 Symphony LLC
Distributed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
SPDX-License-Identifier: [Apache-2.0](https://spdx.org/licenses/Apache-2.0)
Raw data
{
"_id": null,
"home_page": "https://github.com/finos/symphony-bdk-python",
"name": "symphony-bdk-python",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Symphony Platform Solutions",
"author_email": "symphony@finos.org",
"download_url": "https://files.pythonhosted.org/packages/97/1e/b96f632c5188eb9c1a5e822f8cd9b5ef3d3afd83d6103bdccc820d3f82b7/symphony_bdk_python-2.6.1.tar.gz",
"platform": null,
"description": "[](https://finosfoundation.atlassian.net/wiki/display/FINOS/Incubating)\n[](https://opensource.org/licenses/Apache-2.0)\n[](https://www.python.org/downloads/release/python-3)\n[](https://pypi.org/project/symphony-bdk-python/)\n\n\n# Symphony BDK for Python\n\nThis is the Symphony BDK for Python to help develop bots and interact with the [Symphony REST APIs](https://developers.symphony.com/restapi/reference).\n\n## Installation and getting started\nThe [reference documentation](https://symphony-bdk-python.finos.org/) includes detailed\ninstallation instructions as well as a comprehensive\n[getting started](https://symphony-bdk-python.finos.org/markdown/getting_started.html)\nguide.\n\n## Build from source\n\nThe Symphony BDK uses and requires Python 3.8 or higher. Be sure you have it installed before going further.\n\nWe use [poetry](https://python-poetry.org/) in order to manage dependencies, build, run tests and publish.\nTo install poetry, follow instructions [here](https://python-poetry.org/docs/#installation).\n\nOn the first time, run `poetry install`. Then run `poetry build` to build the sdist and wheel packages.\nTo run the tests, use `poetry run pytest`.\n\nIt is possible to run pylint scan locally (on a specific file or package) executing the following command:\n`poetry run pylint <module_name>`.\n\nTo generate locally the Sphinx documentation, run: `cd docsrc && make html`.\n\n## Roadmap\n\nOur next milestone is the [2.5.x](https://github.com/finos/symphony-bdk-python/milestone/6) one.\nIt will only consist in delivering the next improvements and bug fixes of the BDK.\n\n\n## Contributing\nIn order to get in touch with the project team, please open a [GitHub Issue](https://github.com/finos/symphony-bdk-python/issues).\nAlternatively, you can email/subscribe to [symphony@finos.org](https://groups.google.com/a/finos.org/g/symphony).\n\n1. Fork it\n2. Create your feature branch (`git checkout -b feature/fooBar`)\n3. Read our [contribution guidelines](CONTRIBUTING.md) and [Community Code of Conduct](https://www.finos.org/code-of-conduct)\n4. Commit your changes (`git commit -am 'Add some fooBar'`)\n5. Push to the branch (`git push origin feature/fooBar`)\n6. Create a new Pull Request\n\n_NOTE:_ Commits and pull requests to FINOS repositories will only be accepted from those contributors with an active,\nexecuted Individual Contributor License Agreement (ICLA) with FINOS OR who are covered under an existing and active\nCorporate Contribution License Agreement (CCLA) executed with FINOS.\nCommits from individuals not covered under an ICLA or CCLA will be flagged and blocked by the FINOS Clabot tool.\nPlease note that some CCLAs require individuals/employees to be explicitly named on the CCLA.\n\n*Need an ICLA? Unsure if you are covered under an existing CCLA? Email [help@finos.org](mailto:help@finos.org)*\n\n### Update generated code\nWhile contributing to the project, you might need to update the generated code.\nPython BDK uses [OpenAPITools/openapi-generator](https://github.com/OpenAPITools/openapi-generator/) to generate code. In order to customise the templates, a fork has been created in [https://github.com/SymphonyPlatformSolutions/openapi-generator/tree/sym-python-5.5.0](https://github.com/SymphonyPlatformSolutions/openapi-generator/tree/sym-python-5.5.0). \nHere are the steps to follow:\n- Checkout the latest branch of the fork (currently [sym-python-5.5.0](https://github.com/SymphonyPlatformSolutions/openapi-generator/tree/sym-python-5.5.0))\n- Update the fork source code, review and merge it\n- Generate a jar file in `openapi-generatormodules/openapi-generator-cli/target/openapi-generator-cli.jar`:\n - Using maven: `mvn clean install -Dmaven.test.skip=true && mvn clean package -Dmaven.test.skip=true`. _You can also use IntelliJ's build button to build the project and generate the jar_\n- Copy the jar in Python BDK repository `symphony-api-client-python/api_client_generation/openapi-generator-cli.jar`\n- Execute the generation script `./generate.sh` and commit and push you new code along with the new jar file.\n## License\nCopyright 2021 Symphony LLC\n\nDistributed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).\n\nSPDX-License-Identifier: [Apache-2.0](https://spdx.org/licenses/Apache-2.0)",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Symphony Bot Development Kit for Python",
"version": "2.6.1",
"project_urls": {
"Documentation": "https://symphony-bdk-python.finos.org/",
"Homepage": "https://github.com/finos/symphony-bdk-python",
"Repository": "https://github.com/finos/symphony-bdk-python"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fa238d5aba8fe91bfc325a4c63139869e4d8be5855618f356e15661776f85bb4",
"md5": "a878ff5dfc81568bc36a92b09e666712",
"sha256": "ce160b982bab2a82c9853ef308cb27b579f46f09774cf2892a195f3b73ed4f04"
},
"downloads": -1,
"filename": "symphony_bdk_python-2.6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a878ff5dfc81568bc36a92b09e666712",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 1424159,
"upload_time": "2023-06-05T08:54:09",
"upload_time_iso_8601": "2023-06-05T08:54:09.505931Z",
"url": "https://files.pythonhosted.org/packages/fa/23/8d5aba8fe91bfc325a4c63139869e4d8be5855618f356e15661776f85bb4/symphony_bdk_python-2.6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "971eb96f632c5188eb9c1a5e822f8cd9b5ef3d3afd83d6103bdccc820d3f82b7",
"md5": "7d0bb06848acd3dee584a5b6cb82f82a",
"sha256": "668e4191aaad62b40cb361c4f77c13f8735e1a29d064bb0ab873b0e8e28bb38d"
},
"downloads": -1,
"filename": "symphony_bdk_python-2.6.1.tar.gz",
"has_sig": false,
"md5_digest": "7d0bb06848acd3dee584a5b6cb82f82a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 330194,
"upload_time": "2023-06-05T08:54:11",
"upload_time_iso_8601": "2023-06-05T08:54:11.205320Z",
"url": "https://files.pythonhosted.org/packages/97/1e/b96f632c5188eb9c1a5e822f8cd9b5ef3d3afd83d6103bdccc820d3f82b7/symphony_bdk_python-2.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-05 08:54:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "finos",
"github_project": "symphony-bdk-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "symphony-bdk-python"
}
JSON
