Skip to content

Latest commit

 

History

History
152 lines (99 loc) · 5.23 KB

README.md

File metadata and controls

152 lines (99 loc) · 5.23 KB
Raw

The Gentoo Science Project Repository

pkgcheck contributions welcome chat on libera

This is an official mirror of the Gentoo Science ebuild repository, containing numerous scientific software packages.

See Project:Science for more information on the project.

Contents

  1. Installation
  1. Usage
  2. Contributing

Installation

As per the current Portage specification, ebuild repositories (a.k.a. overlays) can be managed via file collections under /etc/portage/repos.conf/, via the new plug-in sync system.

Eselect-repository Install

The overlay can be enabled via the repository extension of the Gentoo eselect utility.

emerge --ask --noreplace --verbose eselect-repository
eselect repository enable science

Eselect-repository Uninstall

To disable and remove the overlay, run:

eselect repository disable science
eselect repository remove science

Manual Install

To enable the overlay without the need for dedicated repository software, you need to have git installed:

emerge --ask --noreplace --verbose dev-vcs/git

Then you can simply download the science repository configuration file, science.conf:

wget https://gitweb.gentoo.org/proj/sci.git/plain/metadata/science.conf \
	-O /etc/portage/repos.conf/science

Manual Uninstall

To disable and remove the overlay, run:

rm /etc/portage/repos.conf/science
rm /var/db/repos/science -rf

Layman Install

You can also install the overlay via the layman overlay manager.

emerge --ask --noreplace --verbose app-portage/layman
layman --add science

Layman Uninstall

To delete the overlay, run:

layman --delete science

Using Packages from ::science

To start using the overlay you now only need to get the newest files, via:

emerge --sync science

To be able to install ::science packages you need to make sure that you are accepting the ~${ARCH} keyword for your respective architecture. This may already be the case globally on your system, and you can check whether this is the case by running:

grep "~$(portageq envvar ARCH)" /etc/portage/make.conf

If the above returns empty, you will need to instruct Portage to accept ~${ARCH} packages.

This can be done for ::science specifically:

mkdir -p /etc/portage/package.accept_keywords
printf '*/*::science ~%s' "$(portageq envvar ARCH)" >> /etc/portage/package.accept_keywords/science

If the above fails with mkdir: cannot create directory ‘/etc/portage/package.accept_keywords’: File exists this means you are using a file and not a directory, and you can instead run:

printf '*/*::science ~%s' "$(portageq envvar ARCH)" >> /etc/portage/package.accept_keywords

Alternatively, and only if you know what you are doing, you can accept ~${ARCH} packages globally:

printf 'ACCEPT_KEYWORDS="~%s"' "$(portageq envvar ARCH)" >> /etc/portage/make.conf

The downside of this approach is potentially higher instability, the advantage is that often ::science packages require ~${ARCH} packages from ::gentoo as well.

Contributing

If you fork, we will merge!
We welcome new contributors and are happy to include new packages.

Areas to contribute

Resources

For a brief introduction please see our contributing guide. Further helpful resources are:

Additionally, please make sure to add the Science Project as an additional maintainer to any new packages you submit. For an example, take a look at the metadata for the Numba package - dev-python/numba/metadata.xml

Support

You can ask for help on Libera IRC in #gentoo-science. Alternatively you can report bugs on the Gentoo Bugzilla.