Package: youtrack
Features modifiedPorted to python3Addedto_dictmethod on YouTrack objectsYouTrack REST API Client Library for PythonThis is a Python client library that you can use to access the REST API for JetBrains YouTrack. Previously, this repository also included command-line tools for importing issues from other issue trackers. We have created aseparate repositoryto store scripts that use this library.The primary purpose of this library is to support migration to YouTrack, but you are welcome to build integrations with it as well. If you choose to work with this library, please be mindful of the following limitations:We don't provide any documentation for this library. You can either learn through trial and error or by dissecting the import scripts in the linked repository.This library references an older version of the YouTrack REST API. Many of the newer features in YouTrack are not supported.We will continue to support this library with updates that are required to support issue import. Other issues that are not import related may be closed.
Our intention is to eventually publish a fully-documented library that uses the latest version of the YouTrack REST API and is also compatible with Python 3.CompatibilityThis client library and the import scripts that use the library are compatible with Python 2.7+. Python 3 releases are not supported.This library supports YouTrack Standalone versions 5.x and higher as well as the current version of YouTrack InCloud. The REST API is enabled by default in all YouTrack installations.Getting StartedThis package has been published to PyPI and can be installed with pip.pip install youtrackAuthenticationTo communicate with YouTrack, you need a connection.The preferred method is to use a permanent token for authentication requests. You can generate your own permanent tokens in your user profile. For instructions, refer to theYouTrack documentation.You can also authenticate using a login and password, however, these values are printed in plain text and expose your credentials in your client application.fromyoutrack.connectionimportConnectionasYouTrack# authentication request with permanent tokenyt=YouTrack('https://instance_name.myjetbrains.com/youtrack/',token='perm:abcdefghijklmn')# versus authentication with username and passwordyt=YouTrack('https://instance_name.myjetbrains.com/youtrack/',login='username',password='password')This request requires that you specify the base URL of the target YouTrack server. For YouTrack InCloud instances, your base URL includes the trailing/youtrack, as shown in the previous example.Once you have established a connection, your credentials are cached for subsequent requests.Supported OperationsMost of the operations that are supported by the YouTrack REST API are mapped to methods for theConnectionobject. The Python client library, however, supports a simplified set of parameters. In some cases, likecreateIssue, the Python method supports a custom set of request parameters.To learn more about the YouTrack REST API, refer to theYouTrack documentation.YouTrack SupportYour feedback is always appreciated.To report bugs and request updates, pleasecreate an issue.If you experience problems with an import script, pleasesubmit a support request.