Metadata-Version: 1.1
Name: apt-select
Version: 2.2.1
Summary: Ubuntu Archive Mirror reporting tool for apt sources configuration
Home-page: https://github.com/jblakeman/apt-select
Author: John Blakeman
Author-email: john@johnblakeman.com
License: MIT
Description: apt-select
        ==========
        
        Find a fast, up-to-date Ubuntu Archive Mirror.
        
        Features
        --------
        
        * Tests latency to mirrors in a given country's mirror list at `mirrors.ubuntu.com <http://mirrors.ubuntu.com>`_.
            - 3 requests are sent to each mirror, minumum round trip time being used for rank.
        
        * Reports latency, status, and bandwidth capacity of the fastest mirrors in a ranked list.
            - Status and bandwidth are scraped from `launchpad <https://launchpad.net/ubuntu/+archivemirrors/>`_.
        
        * Generates `sources.list` file using new mirror.
            - New mirror can be chosen from a list or selected automatically using the top ranked mirror (default).
        
        Installation
        ------------
        
        Target most recent release::
        
            pip install apt-select
        
        or::
        
            pip3 install apt-select
        
        Target project master branch::
        
            pip install git+https://github.com/jblakeman/apt-select.git
        
        or::
        
            git clone https://github.com/jblakeman/apt-select
            python apt-select/setup.py install
        
        Invocation
        ----------
        ::
        
            $ apt-select --help
            usage: apt-select [-h] [-C [COUNTRY]] [-t [NUMBER]] [-m [STATUS] | -p]
                              [-c | -l]
        
            Find the fastest Ubuntu apt mirrors.
            Generate new sources.list file.
        
            optional arguments:
              -h, --help            show this help message and exit
              -C [COUNTRY], --country [COUNTRY]
                                    specify a country to test its list of mirrors
                                    used to match country list file names found at mirrors.ubuntu.com
                                    COUNTRY should follow ISO 3166-1 alpha-2 format
                                    default: US
              -t [NUMBER], --top-number [NUMBER]
                                    specify number of mirrors to return
                                    default: 1
              -m [STATUS], --min-status [STATUS]
                                    return mirrors with minimum status
                                    choices:
                                       up-to-date
                                       one-day-behind
                                       two-days-behind
                                       one-week-behind
                                       unknown
                                    default: up-to-date
              -p, --ping-only       rank mirror(s) by latency only, disregard status(es)
                                    cannot be used with -m/--min-status
              -c, --choose          choose mirror from a list
                                    requires -t/--top-num NUMBER where NUMBER > 1
              -l, --list            print list of mirrors only, don't generate file
                                    cannot be used with -c/--choose
        
            The exit code is 0 on success, 1 on error, and 4 if sources.list already has the chosen
            mirror and a new one was not generated.
        
        Examples
        --------
        
        Get the top mirror from the United Kingdom to generate a new `sources.list`:::
        
            apt-select --country GB
        
        Choose from the top 3 mirrors, including those last updated a week ago:::
        
            apt-select -c -t 3 -m one-week-behind
        
        Find the top 10 mirrors, output latency info only, and don't generate new `sources.list`:::
        
            apt-select -t 10 -p -l
        
        After new sources.list is generated in current working directory, backup and replace to update apt:::
        
            sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup && \
            sudo mv sources.list /etc/apt/
        
        Supported URI Types
        -------------------
        
        Currently, `http`, `https` and `ftp` are supported.
        
        `/etc/apt/sources.list` should contain sources in the following format:::
        
            [deb|deb-src] [http|https|ftp]://mirror.example.com/path [component1] [component2] [...]
        
        Dependencies
        ------------
        
        Python HTML parser, `BeautifulSoup <https://www.crummy.com/software/BeautifulSoup/>`_.
        
        HTTP Requests library, `requests <http://docs.python-requests.org/en/master/>`_.
        
Keywords: latency status rank reporting apt configuration
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Software Distribution
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
