# Piranha
[](https://gitter.im/uber/piranha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Feature flags are commonly used to enable gradual rollout or experiment with new features. In a few cases, even after the purpose of the flag is accomplished, the code pertaining to the feature flag is not removed. We refer to such flags as stale flags. The presence of code pertaining to stale flags can have the following drawbacks:
- Unnecessary code clutter increases the overall complexity w.r.t maintenance resulting in reduced developer productivity
- The flags can interfere with other experimental flags (e.g., due to nesting under a flag that is always false)
- Presence of unused code in the source as well as the binary
- Stale flags can also cause bugs
Piranha is a tool to automatically refactor code related to stale flags. At a higher level, the input to the tool is the name of the flag and the expected behavior, after specifying a list of APIs related to flags in a properties file. Piranha will use these inputs to automatically refactor the code according to the expected behavior.
This repository contains four independent versions of Piranha, one for each of the four supported languages: Java, JavaScript, Objective-C and Swift. **It also contains a redesigned variant of Piranha (as of May 2022) that is a common refactoring tool to support multiple languages and feature flag APIs. If interested in this polyglot variant, goto [Polyglot Piranha](POLYGLOT_README.md)**.
To use/build each version, look under the corresponding [lang]/ directory and follow instructions in the corresponding [lang]/README.md file. Make sure to cd into that directory to build any related code following the instructions in the README.
- [PiranhaJava](legacy/java/README.md)
- [PiranhaJS](legacy/javascript/README.md)
- [PiranhaObjC](legacy/objc/README.md)
- [PiranhaSwift](legacy/swift/README.md)
A few additional links on Piranha:
- A technical [report](report.pdf) detailing our experiences with using Piranha at Uber.
- A [blogpost](https://eng.uber.com/piranha/) presenting more information on Piranha.
- 6 minute [video](https://www.youtube.com/watch?v=V5XirDs6LX8&feature=emb_logo) overview of Piranha.
## Support
If you have any questions on how to use Piranha, please feel free to reach out to us on the [gitter channel](https://gitter.im/uber/piranha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). For bugs and enhancement requests, [open a GitHub issue](https://github.com/uber/piranha/issues).
## Contributors
We'd love for you to contribute to Piranha! Please note that once
you create a pull request, you will be asked to sign our [Uber Contributor License Agreement](https://cla-assistant.io/uber/piranha).
We are also looking for contributions to extend Piranha to other languages (C++, C#, Kotlin).
## License
Piranha is licensed under the Apache 2.0 license. See the LICENSE file for more information.
Raw data
{
"_id": null,
"home_page": "",
"name": "polyglot-piranha",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "refactoring,code update,structural find-replace,structural search and replace,structural search",
"author": "Uber Technologies Inc.",
"author_email": "Ameya Ketkar <ketkara@uber.com>, Lazaro Clapp <lazaro@uber.com>",
"download_url": "https://files.pythonhosted.org/packages/3a/09/3eecdfb3ad508fd0ebe575e65e1bf19b09c80568ecddee1dce0c277aad7d/polyglot_piranha-0.3.23.tar.gz",
"platform": null,
"description": "# Piranha\n\n[](https://gitter.im/uber/piranha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n\nFeature flags are commonly used to enable gradual rollout or experiment with new features. In a few cases, even after the purpose of the flag is accomplished, the code pertaining to the feature flag is not removed. We refer to such flags as stale flags. The presence of code pertaining to stale flags can have the following drawbacks: \n- Unnecessary code clutter increases the overall complexity w.r.t maintenance resulting in reduced developer productivity \n- The flags can interfere with other experimental flags (e.g., due to nesting under a flag that is always false)\n- Presence of unused code in the source as well as the binary \n- Stale flags can also cause bugs \n\nPiranha is a tool to automatically refactor code related to stale flags. At a higher level, the input to the tool is the name of the flag and the expected behavior, after specifying a list of APIs related to flags in a properties file. Piranha will use these inputs to automatically refactor the code according to the expected behavior. \n\nThis repository contains four independent versions of Piranha, one for each of the four supported languages: Java, JavaScript, Objective-C and Swift. **It also contains a redesigned variant of Piranha (as of May 2022) that is a common refactoring tool to support multiple languages and feature flag APIs. If interested in this polyglot variant, goto [Polyglot Piranha](POLYGLOT_README.md)**.\n\nTo use/build each version, look under the corresponding [lang]/ directory and follow instructions in the corresponding [lang]/README.md file. Make sure to cd into that directory to build any related code following the instructions in the README. \n\n- [PiranhaJava](legacy/java/README.md)\n- [PiranhaJS](legacy/javascript/README.md)\n- [PiranhaObjC](legacy/objc/README.md)\n- [PiranhaSwift](legacy/swift/README.md)\n\nA few additional links on Piranha: \n\n- A technical [report](report.pdf) detailing our experiences with using Piranha at Uber.\n- A [blogpost](https://eng.uber.com/piranha/) presenting more information on Piranha. \n- 6 minute [video](https://www.youtube.com/watch?v=V5XirDs6LX8&feature=emb_logo) overview of Piranha.\n\n## Support\n\nIf you have any questions on how to use Piranha, please feel free to reach out to us on the [gitter channel](https://gitter.im/uber/piranha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge). For bugs and enhancement requests, [open a GitHub issue](https://github.com/uber/piranha/issues).\n\n## Contributors\n\nWe'd love for you to contribute to Piranha! Please note that once\nyou create a pull request, you will be asked to sign our [Uber Contributor License Agreement](https://cla-assistant.io/uber/piranha).\n\nWe are also looking for contributions to extend Piranha to other languages (C++, C#, Kotlin). \n\n## License\nPiranha is licensed under the Apache 2.0 license. See the LICENSE file for more information.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Polyglot Piranha is a library for performing structural find and replace with deep cleanup.",
"version": "0.3.23",
"project_urls": {
"documentation": "https://github.com/uber/piranha",
"homepage": "https://github.com/uber/piranha",
"repository": "https://github.com/uber/piranha"
},
"split_keywords": [
"refactoring",
"code update",
"structural find-replace",
"structural search and replace",
"structural search"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "58e544b71842f3d1c8da13eebc3a69d3e580e0a930b11c653f3406c730d36f0d",
"md5": "7d44408b1fe7e2810e2cb96b0bc9dd53",
"sha256": "a48c7179ca997318e19716d7a59878c08ef07854942f3c48b0f95cf1776e6142"
},
"downloads": -1,
"filename": "polyglot_piranha-0.3.23-cp38-cp38-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl",
"has_sig": false,
"md5_digest": "7d44408b1fe7e2810e2cb96b0bc9dd53",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.7",
"size": 8136076,
"upload_time": "2024-01-02T18:38:23",
"upload_time_iso_8601": "2024-01-02T18:38:23.648484Z",
"url": "https://files.pythonhosted.org/packages/58/e5/44b71842f3d1c8da13eebc3a69d3e580e0a930b11c653f3406c730d36f0d/polyglot_piranha-0.3.23-cp38-cp38-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f0817e9073a9df262a40db8a542025c26c5bf3508202bbb108e143ef88abbb8f",
"md5": "e60621b9c11b10a77d3585b94a6cdfac",
"sha256": "f11c58fb4adebec5c9a25ef418ebc977f66011b0c19dc46d8a157dc1e19a4b61"
},
"downloads": -1,
"filename": "polyglot_piranha-0.3.23-cp38-cp38-macosx_10_16_x86_64.whl",
"has_sig": false,
"md5_digest": "e60621b9c11b10a77d3585b94a6cdfac",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.7",
"size": 4014887,
"upload_time": "2024-01-02T18:29:41",
"upload_time_iso_8601": "2024-01-02T18:29:41.777514Z",
"url": "https://files.pythonhosted.org/packages/f0/81/7e9073a9df262a40db8a542025c26c5bf3508202bbb108e143ef88abbb8f/polyglot_piranha-0.3.23-cp38-cp38-macosx_10_16_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dcc6207344876664e9de7f0de08ef163a0b84efe0fb003a98e7310f178fdbb42",
"md5": "cf79c83e9142a536f595468b4c4bf8de",
"sha256": "da8462a89a819fd21c0d4bd2ebac557b8fe05c522705bc69380aa837b8d49646"
},
"downloads": -1,
"filename": "polyglot_piranha-0.3.23-cp38-cp38-manylinux_2_34_x86_64.whl",
"has_sig": false,
"md5_digest": "cf79c83e9142a536f595468b4c4bf8de",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.7",
"size": 19920804,
"upload_time": "2024-01-02T18:28:40",
"upload_time_iso_8601": "2024-01-02T18:28:40.599478Z",
"url": "https://files.pythonhosted.org/packages/dc/c6/207344876664e9de7f0de08ef163a0b84efe0fb003a98e7310f178fdbb42/polyglot_piranha-0.3.23-cp38-cp38-manylinux_2_34_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3a093eecdfb3ad508fd0ebe575e65e1bf19b09c80568ecddee1dce0c277aad7d",
"md5": "033cd9d8bda9fb8002f9a0c0f644db18",
"sha256": "c1afa21dfa1ff9d8264464d1beb39e6918018c10b21e5ab3d8bf4d3d35f6f093"
},
"downloads": -1,
"filename": "polyglot_piranha-0.3.23.tar.gz",
"has_sig": false,
"md5_digest": "033cd9d8bda9fb8002f9a0c0f644db18",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 154803,
"upload_time": "2024-01-02T18:28:43",
"upload_time_iso_8601": "2024-01-02T18:28:43.623638Z",
"url": "https://files.pythonhosted.org/packages/3a/09/3eecdfb3ad508fd0ebe575e65e1bf19b09c80568ecddee1dce0c277aad7d/polyglot_piranha-0.3.23.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-02 18:28:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "uber",
"github_project": "piranha",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "polyglot-piranha"
}
JSON
