Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gentoo/sci
[MIRROR] Gentoo Science Overlay
https://github.com/gentoo/sci
ebuild gentoo hacktoberfest overlay science
Last synced: about 14 hours ago
JSON representation
[MIRROR] Gentoo Science Overlay
- Host: GitHub
- URL: https://github.com/gentoo/sci
- Owner: gentoo
- Created: 2012-02-19T14:28:58.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-05-22T11:28:11.000Z (6 months ago)
- Last Synced: 2024-05-22T12:38:00.950Z (6 months ago)
- Topics: ebuild, gentoo, hacktoberfest, overlay, science
- Language: Shell
- Homepage: https://gitweb.gentoo.org/proj/sci.git
- Size: 37.4 MB
- Stars: 150
- Watchers: 29
- Forks: 165
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: licenses/AMD
Awesome Lists containing this project
README
# The [Gentoo Science Project](https://wiki.gentoo.org/wiki/Project:Science) Repository
[](https://github.com/gentoo/sci/actions?query=workflow%3Apkgcheck)
[](https://github.com/gentoo/sci#guide)
[](https://web.libera.chat/#gentoo-science)
**This is an official mirror of the Gentoo Science [ebuild repository](https://wiki.gentoo.org/wiki/Ebuild_repository), containing numerous scientific software packages.**
*See [Project:Science](https://wiki.gentoo.org/wiki/Project:Science) for more information on the project.*
### Contents
1. [Installation](#install)
- [Eselect](#install-eselect)
- [Manual](#install-manual)
- [Layman](#install-layman)
2. [Usage](#usage)
3. [Contributing](#contributing)
As per the current [Portage specification](https://dev.gentoo.org/~zmedico/portage/doc/man/portage.5.html), ebuild repositories (a.k.a. overlays) can be managed via file collections under `/etc/portage/repos.conf/`, via the new [plug-in sync system](https://wiki.gentoo.org/wiki/Project:Portage/Sync).
### Eselect-repository Install
The overlay can be enabled via the `repository` extension of the Gentoo `eselect` utility.
```console
emerge --ask --noreplace --verbose eselect-repository
eselect repository enable science
```
### Eselect-repository Uninstall
To disable and remove the overlay, run:
```console
eselect repository disable science
eselect repository remove science
```
To enable the overlay without the need for dedicated repository software, you need to have `git` installed:
```console
emerge --ask --noreplace --verbose dev-vcs/git
````
Then you can simply download the science repository configuration file, [science.conf](metadata/science.conf):
```console
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:
```console
rm /etc/portage/repos.conf/science
rm /var/db/repos/science -rf
```
You can also install the overlay via the [layman](https://wiki.gentoo.org/wiki/Layman) overlay manager.
```console
emerge --ask --noreplace --verbose app-portage/layman
layman --add science
```
### Layman Uninstall
To delete the overlay, run:
```console
layman --delete science
```
### Using Packages from `::science`
To start using the overlay you now only need to get the newest files, via:
```console
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:
```console
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:
```console
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:
```console
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:
```console
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.
*If you fork, we will merge!*
We welcome new contributors and are happy to include new packages.
### Areas to contribute
- [Current open bugs](https://bugs.gentoo.org/buglist.cgi?no_redirect=1&quicksearch=[science+overlay])
### Resources
For a brief introduction please see our [contributing guide](CONTRIBUTING.md). Further helpful resources are:
- Gentoo Developers Manual - https://devmanual.gentoo.org/ (taking precedence over any other information found here)
- Contributing to Gentoo - https://wiki.gentoo.org/wiki/Contributing_to_Gentoo
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](dev-python/numba) package - [dev-python/numba/metadata.xml](dev-python/numba/metadata.xml)
## Support
You can ask for help on [Libera IRC](https://www.gentoo.org/get-involved/irc-channels/) in [**#gentoo-science**](https://web.libera.chat/#gentoo-science).
Alternatively you can report bugs on the [Gentoo Bugzilla](https://bugs.gentoo.org/).