Metadata-Version: 1.0
Name: taskcluster_util
Version: 0.0.18
Summary: Taskcluster Utilities
Home-page: https://github.com/askeing/taskcluster-util-python
Author: Askeing Yen
Author-email: askeing@gmail.com
License: UNKNOWN
Description: taskcluster-util-python
        =======================
        .. image:: https://travis-ci.org/askeing/taskcluster-util-python.svg
            :target: https://travis-ci.org/askeing/taskcluster-util-python
        
        Python Taskcluster Utilities.
        
        
        Installation
        ------------
        
        To install **taskcluster_util**, simply:
        
        .. code-block:: bash
        
            $ pip install -U taskcluster_util
        
        
        Tools Usages
        ------------
        
        Temporary Credentials
        +++++++++++++++++++++
        
        You can get your temporary credentials from https://auth.taskcluster.net/ (using Persona with LDAP account).
        
        The temporary credentials will remain valid for 31 days.
        
        tc_credentials.json
        ~~~~~~~~~~~~~~~~~~~
        
        You can put the credentials into **tc_credentials.json** file under your home folder.
        
        .. code-block:: bash
        
        	$ <YOUR_EDITOR> ~/tc_credentials.json
        
        The file format will be:
        
        .. code-block::
        
        	{
        		"clientId": "<YOUR_CLIENTID>",
        		"accessToken": "<YOUR_ACCESSTOKEN>",
        		"certificate": <YOUR_CERTIFICATE>
        	}
        
        Here's a simple example:
        
        .. code-block::
        
        	{
        		"clientId": "foo-XXX",
        		"accessToken": "hello-world-XXX",
        		"certificate": {"version":1,"scopes":["*"],"start":1,"expiry":9,"seed":"hello","signature":"world="}
        	}
        
        
        taskcluster_download
        ++++++++++++++++++++
        
        Download artifacts from command line.
        
        .. code-block:: bash
        
            usage: taskcluster_download [-h] [--credentials CREDENTIALS]
                                        (-n NAMESPACE | -t TASK_ID) [-a ARITFACT_NAME]
                                        [-d DEST_DIR] [-v]
        
            The simple download tool for Taskcluster.
        
            optional arguments:
              -h, --help            show this help message and exit
              --credentials CREDENTIALS
                                    The credential JSON file
                                    (default: <YOUR_HOME>/tc_credentials.json)
              -n NAMESPACE, --namespace NAMESPACE
                                    The namespace of task
              -t TASK_ID, --taskid TASK_ID
                                    The taskId of task
              -v, --verbose         Turn on verbose output, with all the debug logger.
        
            Download Artifact:
              The artifact name and dest folder
        
              -a ARITFACT_NAME, --artifact ARITFACT_NAME
                                    The artifact name on Taskcluster
              -d DEST_DIR, --dest-dir DEST_DIR
                                    The dest folder (default: current working folder)
        
            The tc_credentials.json Template:
                {
                    "clientId": "",
                    "accessToken": "",
                    "certificate": {
                        "version":1,
                        "scopes":["*"],
                        "start":xxx,
                        "expiry":xxx,
                        "seed":"xxx",
                        "signature":"xxx"
                    }
                }
        
        
        taskcluster_traverse
        ++++++++++++++++++++
        
        Travese namespace and download artifacts from GUI.
        
        .. code-block:: bash
        
            usage: taskcluster_traverse [-h] [--credentials CREDENTIALS] [-n NAMESPACE]
                                        [-d DEST_DIR] [-v]
        
            The simple GUI traverse and download tool for Taskcluster.
        
            optional arguments:
              -h, --help            show this help message and exit
              --credentials CREDENTIALS
                                    The credential JSON file
                                    (default: <YOUR_HOME>/tc_credentials.json)
              -n NAMESPACE, --namespace NAMESPACE
                                    The namespace of task
              -d DEST_DIR, --dest-dir DEST_DIR
                                    The dest folder (default: current working folder)
              -v, --verbose         Turn on verbose output, with all the debug logger.
        
            The tc_credentials.json Template:
                {
                    "clientId": "",
                    "accessToken": "",
                    "certificate": {
                        "version":1,
                        "scopes":["*"],
                        "start":xxx,
                        "expiry":xxx,
                        "seed":"xxx",
                        "signature":"xxx"
                    }
                }
        
        
        SSL InsecurePlatformWarning
        ---------------------------
        
        If you got the following error message when running the tools, please install **requests[security]** package.
        
        .. code-block:: bash
        
            InsecurePlatformWarning: A true SSLContext object is not available.
            This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail.
            For more information, see https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning.
        
        
        Install package by pip install. Please note it's not required for Python 2.7.9+.
        
        .. code-block:: bash
        
            pip install requests[security]
        
        If you got **Setup script exited with error: command 'gcc' failed with exit status 1** error when install **requests[security]**, please install **libffi-dev**. (Ubuntu)
        
        .. code-block:: bash
        
            sudo apt-get install libffi-dev
        
        
        
        Release History
        ---------------
        
        0.0.18 (2015-10-30)
        +++++++++++++++++++
        
        - Move tc_credentials.json to User's Home folder.
        - Update README file.
        - Update usage.
        - Modify the Credentials input GUI of taskcluster_traverse.
        
        0.0.17 (2015-10-27)
        +++++++++++++++++++
        
        **Features and Improvements**
        
        - Add the credentials information.
        
        0.0.16 (2015-10-13)
        +++++++++++++++++++
        
        **Bugfixes**
        
        - Fix the issue of downloading public artifact when no credentials
        
        0.0.15 (2015-10-02)
        +++++++++++++++++++
        
        **Features and Improvements**
        
        - Upgrade the taskcluster library to 0.0.27, which fixed the bewit issue.
        - Download artifacts by Signed URL, not API method.
        
        0.0.14 (2015-10-01)
        +++++++++++++++++++
        
        **Bugfixes**
        
        - Fix the internal server error (cause by taskcluster v0.0.21).
        
        0.0.13 (2015-09-07)
        +++++++++++++++++++
        
        **Features and Improvements**
        
        - Refactoring.
        - Using the prograssbar package to display the download progress.
        - Add hooking point 'do_after_download' after downloading.
        
        0.0.12 (2015-09-04)
        +++++++++++++++++++
        
        **Bugfixes**
        
        - Fix some description error.
        
        0.0.11 (2015-09-04)
        +++++++++++++++++++
        
        **Features and Improvements**
        
        - Add taskcluster_traverse.
        - Modify setup.py, HISTORY, and README.
        - Add more function of TaskFinder.
        - Add Makefile and travis ci settings.
        - Add unittest cases.
        
        **Bugfixes**
        
        - Fix the temp folder deleted issue when downloading multiple times.
        
        0.0.10 (2015-08-04)
        +++++++++++++++++++
        
        **Features and Improvements**
        
        - Download artifacts from taskcluster.
        
        0.0.1 (2015-07-15)
        ++++++++++++++++++
        - Initiate the project.
        
Keywords: mozilla b2g firefoxos fxos firefox taskcluster utilities download
Platform: UNKNOWN
