Fabian Vowie
49990196f6
|
3 years ago | |
---|---|---|
.github/workflows | 3 years ago | |
config | 3 years ago | |
middlewares | 3 years ago | |
pipelines | 3 years ago | |
settings | 3 years ago | |
storage | 3 years ago | |
tests/files | 3 years ago | |
.gitignore | 3 years ago | |
README.md | 3 years ago | |
go.mod | 3 years ago | |
go.sum | 3 years ago | |
lithium.log | 3 years ago | |
main.go | 3 years ago | |
main_test.go | 3 years ago | |
settings.json | 3 years ago |
README.md
Lithium
Micro-service for file storage and processing written in Go.
Features
- Image processing pipelines for various transformations
- Web API for storing & retrieving files
Requirements
Setup
1. Clone repository
git clone git@gogs.informatik.hs-fulda.de:FabianVowie/Lithium.git
2. Pull dependencies
go get
3. Build & start application
go run .
Run using Docker container
docker run --rm -p 8000:8000 -v "$PWD":/usr/src/lithium -w /usr/src/lithium golang:1.17 go run .
Testing
go test ./...
Run tests in verbose logging mode
go test ./... -v
Run tests in Docker container
docker run --rm -v "$PWD":/usr/src/lithium -w /usr/src/lithium golang:1.17 go test ./...
API
GET
/
Show application information.
Required headers:
Authorization: Bearer <Token>
Example response:
{
"name": "Lithium",
"version": "0.1.0"
}
GET
/{pipeline}
Show pipeline information.
Required headers:
Authorization: Bearer <Token>
Example response:
{
"name": "example pipeline",
"slug": "example",
"type": 0,
"remove_metadata": false,
"steps": [
{
"name": "resize image",
"type": 0,
"options": {
"width": 1280,
"height": 720,
"upscale": false
}
}
],
"output": {
"format": "jpg",
"quality": 90
}
}
Configuration
Config options can be adjusted via the settings.json
file in the root directory.
{
"endpoint": "0.0.0.0:8000",
"token": "changeme",
"storage_provider": {
"type": 0,
"base_path": "assets"
}
}
Pipelines
The project uses a pipeline system defined by JSON files located in the config folder. Take a look at the example pipeline configuration file.
Available pipeline type
s: 0
(Image), 1
(Video)
{
"name": "example pipeline",
"slug": "example",
"type": 0,
"removeMetadata": false,
"steps": [],
"output": {}
}
Images pipeline
The image pipeline offers the following additional output options.
Available format
types: jpg
(or jpeg
), png
, gif
, tif
(or tiff
) and bmp
The quality
field can contain any integer between 1 and 100.
{
"output": {
"format": "jpg",
"quality": 90
}
}
Available pipeline steps
Each pipeline step consists of an optional name
, a predefined type
and configurable options
.
See the available options below for more information.
{
"name": "step name",
"type": 0,
"options": {}
}
Resizing images
Resize an image by a given width
and height
.
Step definition:
{
"type": 0,
"options": {
"width": 1280,
"height": 720
}
}
Rotating images
Rotate an image with a given angle
in degrees.
Step definition:
{
"type": 1,
"options": {
"angle": 90.0
}
}
Flipping images
Flip an image with a given direction.
Allowed values for the direction
option are "h"
(horizontal), "v"
(vertical)
Step definition:
{
"type": 2,
"options": {
"direction": "h"
}
}
Grayscale
Convert the colorspace of an image into grayscale.
Step definition:
{
"type": 3
}
Fit
Scales down the image to fit the specified maximum width and height.
Step definition:
{
"type": 4,
"options": {
"height": 300,
"width": 200
}
}
Invert
Invert image colors.
Step definition:
{
"type": 5
}
Blur
Blur image using Gaussian functions.
Step definition:
{
"type": 6,
"options": {
"sigma": 50.0
}
}