delta/buildstream.git, branch chandan/toxic-man

setup.py: Do not error out when man directory is empty/missing

2019-01-25T23:50:49+00:00

If the `man` directory is empty, then it won't be copied in the source
distribution, and `list_man_pages()` will throw an exception when trying
to list files in a non-existent directory. This prevents us from
installing the BuildStream package when the man pages are not there.

The most common use-case for this is when we want to re-generate the man
pages but want to install the package before re-generating them.

setup.py, CONTRIBUTING.rst: Recommend using tox to generate man pages

2019-01-25T23:50:49+00:00

Simplify our docs, by requesting users to run `tox -e man` to update man
pages, instead of manually installing `click-man` and running the
command manually.

man: Refresh man pages

2019-01-25T23:50:49+00:00

Notable changes:

* New `source` and `artifact` command groups
* Man pages corresponding to obsolete commands, that were marked as
  hidden in Click, have now been removed.

Fixes #881.

tox.ini: Add environment to update man pages

2019-01-25T23:50:49+00:00

Previously, one had to manually install `click-man` package, and
remember to run the correct command. Now, we can simply run `tox -e man`
to update the man pages.

Merge branch 'tristan/cache-quota-max-only' into 'master'

2019-01-25T21:18:15+00:00

_artifactcache.py: Don't require the quota to be available on disk.

Closes #869 and #733

See merge request BuildStream/buildstream!1106

_artifactcache.py: Don't require the quota to be available on disk.

2019-01-25T18:35:36+00:00

Instead only rely on the headroom to be enough to protect against
out of space conditions. The headroom can become configurable as
a separate step is required.

The changes to achieve this are:

  * Rename ArtifactCache.has_quota_exceeded() to ArtifactCache.full().

  * ArtifactCache.full() now also reports True if the available
    space on the artifact cache volume is smaller than the headroom.

    This ensures jobs get triggered to cleanup the cache when
    reaching the end of the disk.

  * When loading the artifact quota, it is now only an error if
    the quota exceeds the overall disk space, not if it does not
    fit in the available space.

    It is still a warning if the quota does not fit in the
    available space on the artifact cache volume.

  * Updated scheduler.py and buildqueue.py for the API rename

  * tests: Updated the artifactcache/expiry.py test for its
    expectations in this regard.

    Added a new test to test an error when quota was specified to
    exceed total disk space, and adjusted the existing tests to
    expect a warning when the quota does not fit in the available
    space.

This fixes issue #733 and #869.

Merge branch 'jennis/add_new_profile_topic' into 'master'

2019-01-25T17:59:22+00:00

Add new 'scheduler' and 'load-selection' profiling topics

See merge request BuildStream/buildstream!1088

_profile.py: Update copyright statement

2019-01-25T16:35:21+00:00

_profile.py: Added a new profiling topic, load-selection

2019-01-25T16:35:21+00:00

profile_start() and profile_end() calls have been added to
Stream.load_selection()

_profile.py: Added a new profiling topic, scheduler

2019-01-25T16:35:21+00:00

profile_start() and profile_end() calls have been incorporated into
Scheduler.run()