Skip to main content

Creates a self-contained package-management installation, without root access.

This allows you to install a pre-defined set of packages to a directory and then execute commands using the packages installed in that directory.

Supports Windows, OS X and Linux.

On Windows and OS X, local versions of chocolatey and brew are installed respectively, with packages installing to the specified folder. Commands are executed with environment variables set such that the locally installed packages will be used by any software built or installed using the psq-travis-container-exec wrapper. Only the host architecture is supported.

On Linux, `proot <http://proot.me>`_ is used to “containerize” a downloaded linux distribution, where the package manage operates only on the directory in which the downloaded linux distribution exists. This allows you to install packages using apt-get or yum without touching other system files. proot allow allows for different architectures to be specified as well, which are emulated transparently using the qemu-user-mode tool.

Status

| Travis CI (Ubuntu) | AppVeyor (Windows) | Coverage | PyPI | Licence | |——————–|——————–|———-|——|———| |`|Travis| <http://travis-ci.org/polysquare/polysquare-travis-container>`_|`|AppVeyor| <https://ci.appveyor.com/project/smspillaz/polysquare-travis-container-vd3yj>`_|`|Coveralls| <http://coveralls.io/polysquare/polysquare-travis-container>`_|`|PyPIVersion| <https://pypi.python.org/pypi/polysquare-travis-container>`_`|PyPIPythons| <https://pypi.python.org/pypi/polysquare-travis-container>`_|`|License| <http://github.com/polysquare/polysquare-travis-container>`_|

Caveats

64 bit executables cannot be emulated on a 32 bit architecture.

Installation

polysquare-travis-container can be installed using using pip from PyPI

Creating a container

Containers can be created with psq-travis-container-create:

usage: psq-travis-container-create [-h] [--distro {Fedora,
                                                   Debian,
                                                   Ubuntu,
                                                   Windows,
                                                   OSX}]
                                   [--release RELEASE]
                                   [--arch {ppc,x86_64,x86,arm}]
                                   [--repositories REPOSITORIES]
                                   [--packages PACKAGES]
                                   CONTAINER_DIRECTORY

Create a Travis CI container If an arg is specified in more than one place,
then command-line values override environment variables which override
defaults.

positional arguments:
  CONTAINER_DIRECTORY   Directory to place container in

optional arguments:
  -h, --help            show this help message and exit
  --distro {Fedora,Debian,Ubuntu,Windows,OSX}
                        Distribution name to create container of
                        [env var: CONTAINER_DISTRO]
  --release RELEASE     Distribution release to create container of
                        [env var: CONTAINER_RELEASE]
  --arch {ppc,x86_64,x86,arm}
                        Architecture (all architectures other than the
                        system architecture will be emulated with qemu)
                        [env var: CONTAINER_ARCH]
  --repositories REPOSITORIES
                        A file containing a list of repositories to add
                        before installing packages.  Special keywords will
                        control the operation of this file: {release}: The
                        distribution release (eg, precise) {ubuntu}: Ubuntu
                        archive URL {launchpad}: Launchpad PPA URL header
                        (eg, http://ppa.launchpad.net)
  --packages PACKAGES   A file containing a list of packages to install

The distribution filesystem itself is placed in a subdirectory of CONTAINER_DIRECTORY, so multiple distribution configurations can be placed in a single CONTAINER_DIRECTORY. A mini-distribution of proot will also be placed in CONTAINER_DIRECTORY. This directory should be cached, for instance:

cache:
  directories:
  - CONTAINER_DIRECTORY

Packages will only be installed if the container is being created and not restored from the cache. To install additional packages, the travis caches should be deleted.

Special directories like /tmp and /home are linked automatically, so you can run binaries or scripts directly from the project root.

Using a container

To run a command inside a container, use psq-travis-container-exec:

usage: psq-travis-container-exec [-h] [--distro {Fedora,
                                                 Debian,
                                                 Ubuntu,
                                                 Windows,
                                                 OSX}]
                                 [--release RELEASE]
                                 [--arch {ppc,x86_64,x86,arm}] --cmd
                                 [CMD [CMD ...]]
                                 CONTAINER_DIRECTORY

Use a Travis CI container If an arg is specified in more than one place,
then command-line values override environment variables which override
defaults.

positional arguments:
  CONTAINER_DIRECTORY   Directory to place container in

optional arguments:
  -h, --help            show this help message and exit
  --distro {Fedora,Debian,Ubuntu,Windows,OSX}
                        Distribution name to create container of
                        [env var: CONTAINER_DISTRO]
  --release RELEASE     Distribution release to create container of
                        [env var: CONTAINER_RELEASE]
  --arch {ppc,x86_64,x86,arm}
                        Architecture (all architectures other than the
                        system architecture will be emulated with qemu)
                        [env var: CONTAINER_ARCH]
  -- [CMD [CMD ...]]    Command to run inside of container

Executables in CMD are resolved relative to the distribution container, so running bash would run CONTAINER_DIR/bin/bash and not /bin/bash inside travis.

The --container, --release and --arch options are used to select a pre-existing distribution container set up with psq-travis-container-create.

Metadata

Release files for polysquare-travis-container 0.0.42

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for polysquare-travis-container 0.0.42
File Size Uploaded Provenance Actions
polysquare-travis-container-0.0.42.tar.gz 34.2 kB Without provenance Details for polysquare-travis-container-0.0.42.tar.gz

Release files / polysquare-travis-container-0.0.42.tar.gz

Download URL polysquare-travis-container-0.0.42.tar.gz
Size 34.2 kB
Tags Source
SHA-256 checksum
How to use checksums
df7bcc1da1c032bc41e8f0125274252ab761788cb37eacfd8e3b0f7bef3de8c5
BLAKE2b-256 checksum
How to use checksums
92500c0b5ff622c237113fbbea7879d5f3e4977934d906f710962876cd793577
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for polysquare-travis-container 0.0.42

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.42 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page