{
    "info": {
        "author": "Josh Lee",
        "author_email": "",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# YTClient - A light weight YouTrack REST API Client for Python\nYTClient is a light weight HTTP client for interfacing with Jetbrain's YouTrack issue tracker via its REST API. This was based\nlightly off of the original [youtrack-rest-python-library](https://github.com/JetBrains/youtrack-rest-python-library), but \nunlike the original project YTClient was built to be Python 3 compatible and use [YouTrack's new REST API](https://www.jetbrains.com/help/youtrack/standalone/youtrack-rest-api-reference.html#youtrack-api-based-tools) \ninstead of the [old REST API](https://www.jetbrains.com/help/youtrack/standalone/deprecated-rest-api-reference.html) that the original project currently uses.\n\nIt should be noted that this fork was created for the [Tattler-Discord Issue Reporter](https://github.com/JoshLee0915/Tattler-DiscordIssueReporter)\nand the current release only contains the minimum functionality that was needed for that project. Additional functionality outside\nof this basic functionality is planned to be implemented in future versions of YTClient.\n\n## Compatibility\nThis client library and the import scripts that use the library are compatible with Python 3.6+. Python 2.7 is not supported.\n\nThis library supports any YouTrack Standalone versions that supports the new [REST API](https://www.jetbrains.com/help/youtrack/standalone/youtrack-rest-api-reference.html#youtrack-api-based-tools)\nas well as the current version of YouTrack InCloud. The REST API is enabled by default in all YouTrack installations.\n\n## Getting Started\nThis package has been published to PyPI and can be installed with pip. \n\n`pip install YTClient`\n\nAlternatively you can clone this repo and run setup.py.\n\n`setup.py install`\n\n## Authentication\nYTClient currently only supports using a permanent token for authentication requests. You can generate your own permanent \ntokens in your user profile. For instructions, refer to the [YouTrack documentation](https://www.jetbrains.com/help/youtrack/standalone/Manage-Permanent-Token.html#obtain-permanent-token).\n```python\nfrom YTClient.YTClient import YTClient\n\n# authentication request with permanent token\nclient = YTClient('https://instance_name.myjetbrains.com/youtrack/', token='perm:abcdefghijklmn')\n```\nThis request requires that you specify the base URL of the target YouTrack server. For YouTrack InCloud instances, your \nbase URL includes the trailing `/youtrack`, as shown in the previous example.\n\nOnce you have established a connection, your credentials are cached for subsequent requests.\n\nYou can reset the auth token at any time by using:\n\n```python\nclient.set_auth_token()\n```\n\n## Supported Operations\nCurrently YTClient only supports the following operations:\n- **create_issue** - Create a new issue\n   - Args\n      - **[REQ] project** - The project the issue belongs to\n      - **[REQ] summary** - The summary line of the issue\n      - **[OPT] description** - The description of the issue\n      - **[OPT] additional_fields** - A dictionary of additional fields to set **(NOTE: I have had issues getting this to work. I suggest\n        for now to use run_command to set additional fields).**\n      - **[OPT] return_fields** - A list of fields that should be returned with the request. The issue ID is returned by default.\n- **run_command** - Run a YouTrack command\n   - Args\n      - **[REQ] command** - The command to run. Uses a named tuple that contains the command to run (specified as query in the command tuple) \n        and a list of issues that the command is to run against.\n      - **[OPT] return_fields** - A list of fields that should be returned with the request. The command ID is returned by default.\n- **get_issues** - Get a list of issues that match the specified query\n   - Args\n      - **[REQ] query** - The query string to use\n      - **[OPT] fields** - A list of fields that should be returned with the request. The issue ID is returned by default.\n      - **[OPT] skip** - The number of records to skip\n      - **[OPT] top** - The number of records to return\n- **get_projects** - Get a list of all projects\n   - Args\n      - **[OPT] fields** - A list of fields that should be returned with the request. The project ID is returned by default.\n      - **[OPT] skip** - The number of records to skip\n      - **[OPT] top** - The number of records to return",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/JoshLee0915/youtrack-rest-python-library",
        "keywords": "",
        "license": "https://github.com/JoshLee0915/youtrack-rest-python-library/blob/master/LICENSE",
        "maintainer": "",
        "maintainer_email": "",
        "name": "YTClient",
        "package_url": "https://pypi.org/project/YTClient/",
        "platform": "",
        "project_url": "https://pypi.org/project/YTClient/",
        "project_urls": {
            "Homepage": "https://github.com/JoshLee0915/youtrack-rest-python-library"
        },
        "release_url": "https://pypi.org/project/YTClient/1.0.0/",
        "requires_dist": null,
        "requires_python": ">=3.6",
        "summary": "A rewrite of the YouTrack python API",
        "version": "1.0.0"
    },
    "last_serial": 5175313,
    "releases": {
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c1cd8588632b200c2953538c09542df6",
                    "sha256": "8353badac4a193506976e1064268a7a9794a119c353ebdd62b04314e51b11b86"
                },
                "downloads": -1,
                "filename": "YTClient-1.0.0.tar.gz",
                "has_sig": false,
                "md5_digest": "c1cd8588632b200c2953538c09542df6",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 4302,
                "upload_time": "2019-04-23T02:59:45",
                "url": "https://files.pythonhosted.org/packages/df/e0/1259051b79c37ba47ecdcc8b9960aa4fef8e12e0000032464785161f84c2/YTClient-1.0.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "c1cd8588632b200c2953538c09542df6",
                "sha256": "8353badac4a193506976e1064268a7a9794a119c353ebdd62b04314e51b11b86"
            },
            "downloads": -1,
            "filename": "YTClient-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "c1cd8588632b200c2953538c09542df6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 4302,
            "upload_time": "2019-04-23T02:59:45",
            "url": "https://files.pythonhosted.org/packages/df/e0/1259051b79c37ba47ecdcc8b9960aa4fef8e12e0000032464785161f84c2/YTClient-1.0.0.tar.gz"
        }
    ]
}