Metadata-Version: 1.1
Name: getb2g
Version: 2.11
Summary: Get the latest B2G nightly builds for a specific device
Home-page: http://github.com/ahal/getb2g
Author: Andrew Halberstadt, Mozilla
Author-email: halbersa@gmail.com
License: MPL 1.1/GPL 2.0/LGPL 2.1
Description: [Getb2g](https://github.com/ahal/getb2g)
        is a python package intended to make setting up a working B2G environment as easy as possible. It can download various configurations
        (e.g emulator, unagi, panda, etc.) as well as extraneaous resources such as tests and symbols. It is an alternative to building B2G
        from scratch which can sometimes be a large barrier to entry for those not familiar with B2G development.
        
        # Installation
        
        Install setuptools if you don't have it already:
        
            curl -O http://python-distribute.org/distribute_setup.py
            python distribute_setup.py
        
        Install pip if you don't have it already:
        
            easy_install pip
        
        Install getb2g:
        
            pip install getb2g
        
        Note on python packages: getb2g has several dependent packages that will also be installed alongside it. Doing the above will install
        all those packages in your global package index. This makes it easy to get into situations where you have several libraries that depend
        on different versions of the same package. It is easy to get into python version hell. To avoid hell, I'd recommend using a virtual
        environment. See [virtualenv](https://pypi.python.org/pypi/virtualenv) and [virtualenvwrapper](https://bitbucket.org/dhellmann/virtualenvwrapper)
        (an optional tool to help manage virtual environments) for more details.
        
        # Usage
        
        getb2g is used from the command line.
        
        The most basic usage is:
        
            getb2g
        
        You will be prompted for a device to configure. An educated guess will be made for extraneous resources depending on the choice you
        select. Run:
        
            getb2g --help
        
        to see more options. All of these options are optional and are mostly just a convenience to circumvent the interactive prompt.
        Here are some examples of other command lines you can use:
        
            # sets up an emulator build
            getb2g --prepare-emulator
        
            # sets up a panda build and only a panda build (no tests, symbols, etc)
            getb2g --prepare-panda --only
        
            # sets up a unagi build based off the mozilla-b2g18 branch
            getb2g --prepare-unagi --metadata branch=mozilla-b2g18
        
            # set up a b2g gecko build from a specific build directory on ftp.mozilla.org
            getb2g --prepare-gecko --metadata build_dir='https://ftp.mozilla.org/pub/mozilla.org/b2g/tinderbox-builds/mozilla-central-ics_armv7a_gecko/1366715435/'
        
            # set up an eng variant of a inari build
            getb2g --prepare-inari --metadata variant=eng
        
            # provide a user name and password and never get prompted
            getb2g --prepare-emulator --no-prompt --metadata user=<username> --metadata password=<password>
        
        # Authentication
        
        Many of the resources require authentication because their packages contain proprietary software. If you are attempting to download one such resource, you
        will be prompted to enter the proper credentials. If you do not know the credentials, I apologize.
        
        By default, your username and password will not be saved. If you want getb2g to remember your passwords, simply use the --store option.
        With this set, any passwords you enter during the session will be stored locally for later use. Note that passwords are not encrypted
        before hand, so anyone with access to your computer may be able to see them.
        
        If you want getb2g to forget everything you previously stored, simply run 'rm ~/.getb2g/storage.db'
        
Platform: Any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
