https://github.com/informaticsmatters/smi-format-support
A DataTier Format-Support Implementation for CSV
https://github.com/informaticsmatters/smi-format-support
squonk2
Last synced: about 1 month ago
JSON representation
A DataTier Format-Support Implementation for CSV
- Host: GitHub
- URL: https://github.com/informaticsmatters/smi-format-support
- Owner: InformaticsMatters
- License: mit
- Created: 2021-05-25T14:29:11.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2022-04-13T14:25:10.000Z (about 4 years ago)
- Last Synced: 2025-03-20T21:49:02.668Z (about 1 year ago)
- Topics: squonk2
- Language: Python
- Homepage:
- Size: 60.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# smi-format-support
[](https://github.com/InformaticsMatters/smi-format-support/actions/workflows/build.yaml)
[](https://github.com/InformaticsMatters/smi-format-support/actions/workflows/publish-latest.yaml)
[](https://github.com/InformaticsMatters/smi-format-support/actions/workflows/publish-tag.yaml)
[](https://github.com/InformaticsMatters/smi-format-support/actions/workflows/publish-stable.yaml)
---
A repository for the **Informatics Matters DataTier dataset
smi-format-support container image implementations**.
## Building
You should be able to build your format-support image using `docker`: -
$ docker build . -t ${PWD##*/}:latest
Or `docker-compose`: -
$ IMAGE_NAME=${PWD##*/} docker-compose build
## Testing
Familiarise yourself with `TESTING.md`, which describes the testing strategy
For more information on the tests for this repo, see [test/readme.md]
A simple shell script cas been written to run all the tests. The command is: -
$ ./test/runtests.sh
The remaining text in this file has been left unmodified from the template for information.
## Required image tags
The DataTier Manager will only execute formatter images tagged `:stable`
so you **MUST** ultimately produce an image with this tag. You are also
encouraged to produce a `:latest` tag and any specific tags that satisfy your
own needs (with formats like `1.0.0-rc.1`, `1.0.0` and `2021.1`).
> This repository's built-in GitHub Actions (see the next section)
will do all this for you.
## Built-in GitHub Actions
The template contains a number of [GitHub Actions] that will automatically
build the container image and also publish `:latest` and any tags you make to
Docker Hub.
This relies on your docker registry mirroring your repository. If your docker
repository name does not mirror your GitHub repository name then you will need
to adjust these actions. For example, if you create a GitHub repository
from this one and call it 'XYZ/my-support-template' then you must be able to
push docker images to 'xyz/my-support-template:latest'. If not, you will need
to edit the workflow files to satisfy your needs.
> Your images must be published to Docker Hub.
The following built-in actions are: -
1. **For every commit to main** an Action builds the docker image and
pushes it using the image tag `:latest`.
This is accomplished by the `publish-latest.yaml` Action.
2. **For every repository tag** an Action builds the docker image and
pushes it with the image tag `:`
This is accomplished by the `publish-tag.yaml` Action.
- If the tag looks like a _formal_ release, i.e. is a 2 or 3-digit number
like `2021.1` or `1.0.0` an Action builds the docker image and
pushes it using the image tag `:` and the tag `:stable`
This is accomplished by the `publish-stable.yaml` Action.
3. **For every commit on a branch**, or a pull request to main, an Action
runs that just builds the docker image - but does not push it.
This is accomplished by the `build.yaml` Action.
In order for the above Actions to succeed you will need to define the following
GitHub Repository (or Organisation) **secrets**: -
- `DOCKERHUB_USERNAME` A Docker Hub user
- `DOCKERHUB_TOKEN` A Docker Hub user password or, ideally, access token
> Repositories created in the InformaticsMatters organisation
are already presented with these secrets as they are already
defined at the Organisation level.
## Updating the badge links
Don't forget to replace the `InformaticsMatters/format-support-template`
values in the above badge links with the name of your own repository, otherwise
your badges will reflect the template repository's state, not yours.
---
[github actions]: https://github.com/features/actions