To help you get started, we've collected the most common ways that easybuild is being used within popular public projects.

easybuilders / easybuild-framework / test / framework / filetools.py View on Github

self.assertEqual(len(downloads), 1)

        # non-existing files result in None return value
        self.assertEqual(ft.download_file(fn, 'file://%s/nosuchfile' % test_dir, target_location), None)

        # install broken proxy handler for opening local files
        # this should make urlopen use this broken proxy for downloading from a file:// URL
        proxy_handler = std_urllib.ProxyHandler({'file': 'file://%s/nosuchfile' % test_dir})
        std_urllib.install_opener(std_urllib.build_opener(proxy_handler))

        # downloading over a broken proxy results in None return value (failed download)
        # this tests whether proxies are taken into account by download_file
        self.assertEqual(ft.download_file(fn, source_url, target_location), None, "download over broken proxy fails")

        # modify existing download so we can verify re-download
        ft.write_file(target_location, '')

        # restore a working file handler, and retest download of local file
        std_urllib.install_opener(std_urllib.build_opener(std_urllib.FileHandler()))
        res = ft.download_file(fn, source_url, target_location)
        self.assertEqual(res, target_location, "'download' of local file works after removing broken proxy")

        # existing file was re-downloaded, so a backup should have been created of the existing file
        downloads = glob.glob(target_location + '*')
        self.assertEqual(len(downloads), 2)
        backup = [d for d in downloads if os.path.basename(d) != fn][0]
        self.assertEqual(ft.read_file(backup), '')
        self.assertEqual(ft.compute_checksum(target_location), ft.compute_checksum(os.path.join(toy_source_dir, fn)))

        # make sure specified timeout is parsed correctly (as a float, not a string)
        opts = init_config(args=['--download-timeout=5.3'])
        init_config(build_options={'download_timeout': opts.download_timeout})

View more ways to use easybuild

EasyBuild is a software build and installation framework that allows you to manage (scientific) software on High Performance Computing (HPC) systems in an efficient way.

Sources

The EasyBuild sources are spread across different GitHub repositories:

• the main easybuild repository hosts the documentation and the easybuild Python metapackage
• the easybuild-framework repository hosts the source code of the EasyBuild framework
• the easybuild-easyblocks repository hosts easyblocks, i.e. implementations of install procedures
• the easybuild-easyconfigs repository hosts easyconfigs, i.e. EasyBuild specification files

Corresponding Python packages are available via PyPi:

Documentation

Read the fine manual (RTFM!) at .

Getting started

The recommended way of installing EasyBuild is using pip. You should configure EasyBuild to behave as you prefer, subsequently.

That is all that is needed to get started with installing (scientific) software with ease. Take a look at the typical workflow example in the EasyBuild documentation that shows how to make EasyBuild build and install WRF with a single command.

Quick demo for the impatient

After installing EasyBuild, you can build and install HPL on top of a compiler toolchain that consists of open source components (GCC, OpenMPI, etc.) by running the following commands:

$ module load EasyBuild
$ export EASYBUILD_PREFIX=/tmp/$USER  # example installation prefix
$ eb HPL-2.3-foss-2019b.eb --robot

This should install a module file for HPL which you can load to start using it:

$ export MODULEPATH=$EASYBUILD_PREFIX/modules/all:$MODULEPATH
$ module load HPL

For more information on using EasyBuild, see the EasyBuild documentation

Contact info

You can get in contact with the EasyBuild community in different ways:

Mailing list

An EasyBuild mailinglist is available to subscribe to.

This list is used by both users and developers of EasyBuild, so if you have any questions or suggestions, you can post them there.

Only members can post to this mailinglist. To request membership, see .

Slack

Contact the EasyBuild community via Slack: , self-request an invite via .

Twitter

The EasyBuild team also has a Twitter feed: @easy_build.

Disclaimer

EasyBuild has mostly been used and tested on x86_64-based Linux systems (RedHat-based, Debian, SuSE, ...), but can be easily extended for other platforms. Limited provisions for other Unix-based operating systems (e.g., Mac OS X) are also available.

License

EasyBuild was created by the High-Performance Computing team at Ghent University, is currently maintained by the EasyBuild community, and is made available under the GNU General Public License (GPL) version 2.

Acknowledgements

EasyBuild was created with support of Ghent University , the Flemish Supercomputer Centre (VSC) , the Hercules foundation and the Department of Economy, Science and Innovation (EWI) .