Changelogs » Apt-smart




- Add support for Linux Mint
- Add -U, --ubuntu to opt in Ubuntu mode for Linux Mint to deal with upstream Ubuntu mirror instead of Linux Mint mirror. e.g. --auto-change-mirror --ubuntu will auto-change Linux Mint's upstream Ubuntu mirror

.. _Release 7.1.0:



- Fix install_sources_list() for Python 3
- Fix --change-mirror
- fix Travis CI  `io.UnsupportedOperation:fileno` error by changing the way to run test cases containing smart_update()
- More test cases

.. _Release 7.0.7:



- Readme & help about proxy setting
- Deal with the [options] in sources.list by stripping it from sources.list, and then get it back when generating new sources.list ,
- Add a warning: custom mirror file's path and filename must NOT contain whitespace
- Add -R, --create-chroot=local_dir_absolute_path to create chroot with the best mirror in a local directory with absolute_path
- More test cases

.. _Release 7.0.6:



- Add -F, --file-to-read=local_file_absolute_path (path and filename must NOT contain whitespace) to read a local absolute path file containing custom mirror URLs (one URL per line) to add custom mirrors to rank.
So now you can use e.g. `-l -F ~/mirrors.txt` options to add some custom mirrors to rank with mirrors in official mirror list.

.. _Release 7.0.5:



- Fix error on EOL release
- Check OLD_RELEASES_URL's MirrorStatus to confirm if it is EOL, to fix

.. _Release 7.0.4:



- Fix `--url-char-len` option to specify the length of chars in mirrors' URL to display when using `--list-mirrors`,
so that now you can use e.g. `-l -L 29` options to narrow down the table of ranked mirrors when you want to paste it to somewhere the table displayed badly.

.. _Release 7.0.3:



- Add :attr:url_char_len to specify the length of chars in mirrors' URL to display when using `--list-mirrors`,
so that now you can use e.g. `-l -L 29` options to narrow down the table of ranked mirrors when you want to paste it to somewhere the table displayed badly.

.. _Release 7.0.2:,1...7.0.2



- Better output format when use `--list-mirrors`

.. _Release 7.0.1:



- Rename the project and module to ``apt-smart``
- For Ubuntu, new mirrors discovery mechanism: at first it queries ``MIRROR_SELECTION_URL``, and ``MIRRORS_URL`` as fallback.
- For Debian, new mirrors discovery mechanism: get mirrors within the country which the user is in.
- New mechanism of determining whether a mirror is up-to-date: download the InRelease file and parse the ``Date`` value in it.
- New and more robust ``distribution_codename`` using APT sources.list
- Enable retry when ``fetch_url`` is timeout for bad connections.
- Drop Python 2.6 support and add Python 3.7
- Drop max_mirrors limit since we can smartly get mirrors within the user's country.

.. _Release 7.0:



- Bug fix for Ubuntu keyring selection that prevented
``ubuntu-archive-removed-keys.gpg`` from being used.
- Bug fix for ``coerce_release()`` when given a release number.
- Moved pathnames of Debian and Ubuntu keyring files to constants.
- Added logging to enable debugging of keyring selection process.
- Added proper tests for keyring selection and release coercion.

.. _Release 6.1:



Enable the creation of Ubuntu <= 12.04 chroots on Ubuntu >= 17.04 hosts by
working around (what I am convinced is) a bug in ``debootstrap`` which picks
the wrong keyring when setting up chroots of old releases. For more information
refer to issue `8`_.

I've bumped the major version number for this release because the highly
specific ``apt_smart.eol`` module changed into the much more generic
``apt_smart.releases`` module. Also the ``release_label`` property was

.. _Release 6.0:
.. _8:



Use ``_ without placing our full trust in it like
older versions of ``apt-smart`` did 😇.

Feedback in issue `6`_ suggested that ``_ is
working properly (again) and should be preferred over scraping Launchpad.
However I prefer for ``apt-smart`` to be a reliable "do what I mean"
program and ``_ has proven to be unreliable in
the past (see the discussion in `6`_). As a compromise I've changed the Ubuntu
mirror discovery as follows:

1. Discover Ubuntu mirrors on Launchpad.

2. Try to discover mirrors using ``_ and iff
successful, narrow down the list produced in step 1 based on the URLs
reported in step 2.

3. Rank the discovered / narrowed down mirrors and pick the best one.

The reason why I've decided to add this additional complexity is because it has
bothered me in the past that Ubuntu mirror discovery was slow and this does
help a lot. Also, why not use a service provided by Ubuntu to speed things up?

Unrelated to the use of ``_ I've also bumped the
``executor`` requirement (twice) in order to pull in upstream improvements
discussed in `executor issue 10`_ and `executor issue 15`_.

.. _Release 5.2:
.. _6:
.. _executor issue 10:
.. _executor issue 15:



Work on release 5.1 started with the intention of publishing a 5.0.2 bug fix
release for the EOL detection of Debian LTS releases reported in `5`_, however
unrelated changes were required to stabilize the test suite. This explains how
5.0.2 became 5.1 😇.

When I started working on resolving the issue reported in `5`_ it had been
quite a while since the previous release (233 days) and so some technical debt
had accumulated in the project, causing the test suite to break. Most
significantly, Travis CI switched their workers from Ubuntu 12.04 to 14.04.

Here's a detailed overview of changes:

- Bug fix for EOL detection of Debian LTS releases (reported in `5`_).
- Bug fix for trivial string matching issue in test suite (caused by a naively
written test).
- Bug fix for recursive ``repr()`` calls potentially causing infinite
recursion, depending on logging level (see e.g. build 395421319_).
- Updated bundled EOL dates based on distro-info-data available in Ubuntu 18.04.
- Added this changelog to the documentation, including a link in the readme.
- Make sure the ``test_gather_eol_dates`` test method runs on Travis CI (by
installing the distro-info-data_ package). This exposed a Python 3
incompatibility (in build 395410569_) that has since been resolved.
- Include documentation in source distributions (````).
- Silence flake8 complaining about bogus D402 issues.
- Add license='MIT' key to ```` script.
- Bumped copyright to 2018.

.. _Release 5.1:
.. _5:
.. _395421319:
.. _distro-info-data:
.. _395410569:



Bug fix release for invalid enumeration value (oops).

.. _Release 5.0.1:



Reliable end of life (EOL) detection.

Recently I ran into the issue that the logic to check whether a release is EOL
(that works by checking if the security mirror serves a ``Release.gpg`` file
for the release) failed on me. More specifically the following URL existed at
the time of writing (2017-11-01) even though Ubuntu 12.04 went EOL back in

At the same time issue `1`_ and pull request `2`_ were also indications that
the EOL detection was fragile and error prone. This potential fragility had
bugged me ever since publishing `apt-smart` and this week I finally
finished a more robust and deterministic EOL detection scheme.

This release includes pull requests `2`_ and `4`_,  fixing issues `1`_ and
`3`_. Here's a detailed overview of changes:

- Addition: Allow optional arguments to ``apt-get update`` (`3`_, `4`_).

- I simplified and improved the feature requested in issue `3`_ and
implemented in pull request `4`_ by switching from an optional list
argument to 'star-args' and applying the same calling convention to
``smart_update()`` as well.

- This is backwards incompatible with the implementation in pull request
`4`_ (which I merged into the ``dev`` branch but never published to PyPI)
and it's also technically backwards incompatible in the sense that keyword
arguments could previously be given to ``smart_update()`` as positional
arguments. This explains why I'm bumping the major version number.

- Bug fix for incorrect marking of EOL when HTTP connections fail (`2`_).
- Refactoring: Apply timeout handling to HTTP response bodies.
- Refactoring: Distinguish 404 from other HTTP errors:

- This change enhances ``validate_mirror()`` by making a distinction between
a confirmed HTTP 404 response versus other error conditions which may be of
a more transient nature.
- The goal of this change is to preserve the semantics requested in issue
`1`_ and implemented in pull request `2`_ without needing the additional
HTTP request performed by ``can_connect_to_mirror()``.
- Because ``validate_mirror()`` previously returned a boolean but now returns
an enumeration member this change is technically backwards incompatible,
then again ``validate_mirror()`` isn't specifically intended for callers
because it concerns internal logic of apt-smart. I'm nevertheless
bumping the major version number.

- Refactoring: Improve HTTP request exception handling:

- 404 responses and timeouts are no longer subject to retrying.
- The exception ``apt_smart.http.NotFoundError`` is now raised on
HTTP 404 responses. Other unexpected HTTP response codes raise
- The specific distinction between 404 and !200 was made because the 404
response has become significant in checking for EOL status.

.. _Release 5.0:
.. _1:
.. _2:
.. _3:
.. _4:



Robust validation of available mirrors (backwards incompatible).

.. _Release 4.0:



Made mirror comparison more robust.

.. _Release 3.1:



Added Debian archive support (with old releases):

- Addition: Added Debian archive support (old releases).
- Improvement: Don't bother validating archive / old-releases mirror.
- Refactoring: Moved URLs to backend specific modules.

.. _Release 3.0:



Restored Python 3 compatibility, improved robustness:

- Improvement: Make the ``is_available`` and ``is_updating`` properties of the
``CandidateMirror`` class more robust.
- Bug fix: I suck at Unicode in Python (most people do :-p).
- Cleanup: Remove unused import from test suite.

.. _Release 2.1:



Generation of ``sources.list`` files and chroot creation.

Detailed overview of changes:

- Addition: Added a simple ``debootstrap`` wrapper.
- Addition: Programmatic /etc/apt/sources.list generation
- Bug fix for ``check_suite_available()``.
- Bug fix: Never apply Ubuntu's old release handling to Debian.
- Bug fix: Never remove ``/var/lib/apt/lists/lock file``.
- Improvement: Enable stable mirror selection
- Improvement: Make it possible to override distributor ID and codename
- Improvement: Render interactive spinner during mirror ranking.
- Refactoring: Generalize AptMirrorUpdater initializer (backwards incompatible!)
- Refactoring: Generalize backend module loading
- Refactoring: Modularize ``/etc/apt/sources.list`` writing.

.. _Release 2.0:



Improved Ubuntu mirror discovery, added an automated test suite, and more.

The bump to version 1.0 isn't so much intended to communicate that this
is now mature software, it's just that I made several backwards
incompatible changes in order to improve the modularity of the code
base, make it easier to develop automated tests, maintain platform
support, etc :-).

A more detailed overview of (significant) changes:

- Improved Ubuntu mirror discovery (by scraping Launchpad instead).
- Extracted mirror discovery to separate (backend specific) modules.
- Extracted HTTP handling to a separate module.
- Enable Control-C to interrupt concurrent connection tests.
- Expose limit in Python API and command line interface and make limit optional by passing 0.
- Bug fix for Python 3 incompatibility: Stop using ``sys.maxint`` :-).

.. _Release 1.0:



Avoid 'nested' smart updates (the old code worked fine but gave confusing
output and performed more work than necessary, which bothered me :-).

.. _Release 0.3.1:



Make smart update understand EOL suites

.. _Release 0.3:



Bug fix: Replace ```` as well.

.. _Release 0.2:



Bug fix: Explicitly terminate multiprocessing pool.

.. _Release 0.1.2:



Initial release (added ````).

.. _Release 0.1.1: