Compare commits
merge into: Continous_Integration_in_der_Praxis:main
Continous_Integration_in_der_Praxis:feature/add-authorization
Continous_Integration_in_der_Praxis:feature/add-commit-hash-to-index-metadata
Continous_Integration_in_der_Praxis:feature/add-executable-steps
Continous_Integration_in_der_Praxis:feature/add-get-files-endpoints
Continous_Integration_in_der_Praxis:feature/add-github-ci
Continous_Integration_in_der_Praxis:feature/add-http-image-upload
Continous_Integration_in_der_Praxis:feature/add-image-processing
Continous_Integration_in_der_Praxis:feature/add-logging
Continous_Integration_in_der_Praxis:feature/add-metadata-endpoint
Continous_Integration_in_der_Praxis:feature/add-more-image-steps
Continous_Integration_in_der_Praxis:feature/add-pipeline-endpoints
Continous_Integration_in_der_Praxis:feature/add-pipeline-loading
Continous_Integration_in_der_Praxis:feature/add-pipelines-to-metadata
Continous_Integration_in_der_Praxis:feature/add-rate-limiting
Continous_Integration_in_der_Praxis:feature/add-rate-limiting-to-readme
Continous_Integration_in_der_Praxis:feature/add-settings
Continous_Integration_in_der_Praxis:feature/add-storage-layer
Continous_Integration_in_der_Praxis:feature/fix-routes
Continous_Integration_in_der_Praxis:feature/general-cleanup
Continous_Integration_in_der_Praxis:feature/improve-code-stability
Continous_Integration_in_der_Praxis:feature/improve-pipeline-abstraction
Continous_Integration_in_der_Praxis:feature/make-middlewares-optional
Continous_Integration_in_der_Praxis:feature/restructure-pipelines
Continous_Integration_in_der_Praxis:feature/start-readme
Continous_Integration_in_der_Praxis:feature/update-config-output-format-options
Continous_Integration_in_der_Praxis:feature/update-gitignore
Continous_Integration_in_der_Praxis:feature/update-route-registration
Continous_Integration_in_der_Praxis:main
Continous_Integration_in_der_Praxis:pr-feature/add-authorization
Continous_Integration_in_der_Praxis:pr-feature/add-commit-hash-to-index-metadata
Continous_Integration_in_der_Praxis:pr-feature/add-executable-steps
Continous_Integration_in_der_Praxis:pr-feature/add-get-files-endpoints
Continous_Integration_in_der_Praxis:pr-feature/add-github-ci
Continous_Integration_in_der_Praxis:pr-feature/add-http-image-upload
Continous_Integration_in_der_Praxis:pr-feature/add-image-processing
Continous_Integration_in_der_Praxis:pr-feature/add-logging
Continous_Integration_in_der_Praxis:pr-feature/add-metadata-endpoint
Continous_Integration_in_der_Praxis:pr-feature/add-more-image-steps
Continous_Integration_in_der_Praxis:pr-feature/add-pipeline-endpoints
Continous_Integration_in_der_Praxis:pr-feature/add-pipeline-loading
Continous_Integration_in_der_Praxis:pr-feature/add-pipelines-to-metadata
Continous_Integration_in_der_Praxis:pr-feature/add-rate-limiting
Continous_Integration_in_der_Praxis:pr-feature/add-rate-limiting-to-readme
Continous_Integration_in_der_Praxis:pr-feature/add-settings
Continous_Integration_in_der_Praxis:pr-feature/add-storage-layer
Continous_Integration_in_der_Praxis:pr-feature/enhance-api-responses
Continous_Integration_in_der_Praxis:pr-feature/fix-routes
Continous_Integration_in_der_Praxis:pr-feature/general-cleanup
Continous_Integration_in_der_Praxis:pr-feature/improve-code-stability
Continous_Integration_in_der_Praxis:pr-feature/improve-pipeline-abstraction
Continous_Integration_in_der_Praxis:pr-feature/make-middlewares-optional
Continous_Integration_in_der_Praxis:pr-feature/restructure-pipelines
Continous_Integration_in_der_Praxis:pr-feature/start-readme
Continous_Integration_in_der_Praxis:pr-feature/update-config-output-format-options
Continous_Integration_in_der_Praxis:pr-feature/update-gitignore
Continous_Integration_in_der_Praxis:pr-feature/update-route-registration
FabianVowie:feature/add-authorization
FabianVowie:feature/add-commit-hash-to-index-metadata
FabianVowie:feature/add-executable-steps
FabianVowie:feature/add-get-files-endpoints
FabianVowie:feature/add-github-ci
FabianVowie:feature/add-http-image-upload
FabianVowie:feature/add-image-processing
FabianVowie:feature/add-logging
FabianVowie:feature/add-metadata-endpoint
FabianVowie:feature/add-more-image-steps
FabianVowie:feature/add-pipeline-endpoints
FabianVowie:feature/add-pipeline-loading
FabianVowie:feature/add-pipelines-to-metadata
FabianVowie:feature/add-rate-limiting
FabianVowie:feature/add-rate-limiting-to-readme
FabianVowie:feature/add-settings
FabianVowie:feature/add-storage-layer
FabianVowie:feature/fix-routes
FabianVowie:feature/general-cleanup
FabianVowie:feature/improve-code-stability
FabianVowie:feature/improve-pipeline-abstraction
FabianVowie:feature/make-middlewares-optional
FabianVowie:feature/restructure-pipelines
FabianVowie:feature/start-readme
FabianVowie:feature/update-config-output-format-options
FabianVowie:feature/update-gitignore
FabianVowie:feature/update-route-registration
FabianVowie:main
FabianVowie:pr-feature/add-authorization
FabianVowie:pr-feature/add-commit-hash-to-index-metadata
FabianVowie:pr-feature/add-executable-steps
FabianVowie:pr-feature/add-get-files-endpoints
FabianVowie:pr-feature/add-github-ci
FabianVowie:pr-feature/add-http-image-upload
FabianVowie:pr-feature/add-image-processing
FabianVowie:pr-feature/add-logging
FabianVowie:pr-feature/add-metadata-endpoint
FabianVowie:pr-feature/add-more-image-steps
FabianVowie:pr-feature/add-pipeline-endpoints
FabianVowie:pr-feature/add-pipeline-loading
FabianVowie:pr-feature/add-pipelines-to-metadata
FabianVowie:pr-feature/add-rate-limiting
FabianVowie:pr-feature/add-rate-limiting-to-readme
FabianVowie:pr-feature/add-settings
FabianVowie:pr-feature/add-storage-layer
FabianVowie:pr-feature/enhance-api-responses
FabianVowie:pr-feature/fix-routes
FabianVowie:pr-feature/general-cleanup
FabianVowie:pr-feature/improve-code-stability
FabianVowie:pr-feature/improve-pipeline-abstraction
FabianVowie:pr-feature/make-middlewares-optional
FabianVowie:pr-feature/restructure-pipelines
FabianVowie:pr-feature/start-readme
FabianVowie:pr-feature/update-config-output-format-options
FabianVowie:pr-feature/update-gitignore
FabianVowie:pr-feature/update-route-registration
pull from: Continous_Integration_in_der_Praxis:feature/add-commit-hash-to-index-metadata
Continous_Integration_in_der_Praxis:feature/add-authorization
Continous_Integration_in_der_Praxis:feature/add-commit-hash-to-index-metadata
Continous_Integration_in_der_Praxis:feature/add-executable-steps
Continous_Integration_in_der_Praxis:feature/add-get-files-endpoints
Continous_Integration_in_der_Praxis:feature/add-github-ci
Continous_Integration_in_der_Praxis:feature/add-http-image-upload
Continous_Integration_in_der_Praxis:feature/add-image-processing
Continous_Integration_in_der_Praxis:feature/add-logging
Continous_Integration_in_der_Praxis:feature/add-metadata-endpoint
Continous_Integration_in_der_Praxis:feature/add-more-image-steps
Continous_Integration_in_der_Praxis:feature/add-pipeline-endpoints
Continous_Integration_in_der_Praxis:feature/add-pipeline-loading
Continous_Integration_in_der_Praxis:feature/add-pipelines-to-metadata
Continous_Integration_in_der_Praxis:feature/add-rate-limiting
Continous_Integration_in_der_Praxis:feature/add-rate-limiting-to-readme
Continous_Integration_in_der_Praxis:feature/add-settings
Continous_Integration_in_der_Praxis:feature/add-storage-layer
Continous_Integration_in_der_Praxis:feature/fix-routes
Continous_Integration_in_der_Praxis:feature/general-cleanup
Continous_Integration_in_der_Praxis:feature/improve-code-stability
Continous_Integration_in_der_Praxis:feature/improve-pipeline-abstraction
Continous_Integration_in_der_Praxis:feature/make-middlewares-optional
Continous_Integration_in_der_Praxis:feature/restructure-pipelines
Continous_Integration_in_der_Praxis:feature/start-readme
Continous_Integration_in_der_Praxis:feature/update-config-output-format-options
Continous_Integration_in_der_Praxis:feature/update-gitignore
Continous_Integration_in_der_Praxis:feature/update-route-registration
Continous_Integration_in_der_Praxis:main
Continous_Integration_in_der_Praxis:pr-feature/add-authorization
Continous_Integration_in_der_Praxis:pr-feature/add-commit-hash-to-index-metadata
Continous_Integration_in_der_Praxis:pr-feature/add-executable-steps
Continous_Integration_in_der_Praxis:pr-feature/add-get-files-endpoints
Continous_Integration_in_der_Praxis:pr-feature/add-github-ci
Continous_Integration_in_der_Praxis:pr-feature/add-http-image-upload
Continous_Integration_in_der_Praxis:pr-feature/add-image-processing
Continous_Integration_in_der_Praxis:pr-feature/add-logging
Continous_Integration_in_der_Praxis:pr-feature/add-metadata-endpoint
Continous_Integration_in_der_Praxis:pr-feature/add-more-image-steps
Continous_Integration_in_der_Praxis:pr-feature/add-pipeline-endpoints
Continous_Integration_in_der_Praxis:pr-feature/add-pipeline-loading
Continous_Integration_in_der_Praxis:pr-feature/add-pipelines-to-metadata
Continous_Integration_in_der_Praxis:pr-feature/add-rate-limiting
Continous_Integration_in_der_Praxis:pr-feature/add-rate-limiting-to-readme
Continous_Integration_in_der_Praxis:pr-feature/add-settings
Continous_Integration_in_der_Praxis:pr-feature/add-storage-layer
Continous_Integration_in_der_Praxis:pr-feature/enhance-api-responses
Continous_Integration_in_der_Praxis:pr-feature/fix-routes
Continous_Integration_in_der_Praxis:pr-feature/general-cleanup
Continous_Integration_in_der_Praxis:pr-feature/improve-code-stability
Continous_Integration_in_der_Praxis:pr-feature/improve-pipeline-abstraction
Continous_Integration_in_der_Praxis:pr-feature/make-middlewares-optional
Continous_Integration_in_der_Praxis:pr-feature/restructure-pipelines
Continous_Integration_in_der_Praxis:pr-feature/start-readme
Continous_Integration_in_der_Praxis:pr-feature/update-config-output-format-options
Continous_Integration_in_der_Praxis:pr-feature/update-gitignore
Continous_Integration_in_der_Praxis:pr-feature/update-route-registration
FabianVowie:feature/add-authorization
FabianVowie:feature/add-commit-hash-to-index-metadata
FabianVowie:feature/add-executable-steps
FabianVowie:feature/add-get-files-endpoints
FabianVowie:feature/add-github-ci
FabianVowie:feature/add-http-image-upload
FabianVowie:feature/add-image-processing
FabianVowie:feature/add-logging
FabianVowie:feature/add-metadata-endpoint
FabianVowie:feature/add-more-image-steps
FabianVowie:feature/add-pipeline-endpoints
FabianVowie:feature/add-pipeline-loading
FabianVowie:feature/add-pipelines-to-metadata
FabianVowie:feature/add-rate-limiting
FabianVowie:feature/add-rate-limiting-to-readme
FabianVowie:feature/add-settings
FabianVowie:feature/add-storage-layer
FabianVowie:feature/fix-routes
FabianVowie:feature/general-cleanup
FabianVowie:feature/improve-code-stability
FabianVowie:feature/improve-pipeline-abstraction
FabianVowie:feature/make-middlewares-optional
FabianVowie:feature/restructure-pipelines
FabianVowie:feature/start-readme
FabianVowie:feature/update-config-output-format-options
FabianVowie:feature/update-gitignore
FabianVowie:feature/update-route-registration
FabianVowie:main
FabianVowie:pr-feature/add-authorization
FabianVowie:pr-feature/add-commit-hash-to-index-metadata
FabianVowie:pr-feature/add-executable-steps
FabianVowie:pr-feature/add-get-files-endpoints
FabianVowie:pr-feature/add-github-ci
FabianVowie:pr-feature/add-http-image-upload
FabianVowie:pr-feature/add-image-processing
FabianVowie:pr-feature/add-logging
FabianVowie:pr-feature/add-metadata-endpoint
FabianVowie:pr-feature/add-more-image-steps
FabianVowie:pr-feature/add-pipeline-endpoints
FabianVowie:pr-feature/add-pipeline-loading
FabianVowie:pr-feature/add-pipelines-to-metadata
FabianVowie:pr-feature/add-rate-limiting
FabianVowie:pr-feature/add-rate-limiting-to-readme
FabianVowie:pr-feature/add-settings
FabianVowie:pr-feature/add-storage-layer
FabianVowie:pr-feature/enhance-api-responses
FabianVowie:pr-feature/fix-routes
FabianVowie:pr-feature/general-cleanup
FabianVowie:pr-feature/improve-code-stability
FabianVowie:pr-feature/improve-pipeline-abstraction
FabianVowie:pr-feature/make-middlewares-optional
FabianVowie:pr-feature/restructure-pipelines
FabianVowie:pr-feature/start-readme
FabianVowie:pr-feature/update-config-output-format-options
FabianVowie:pr-feature/update-gitignore
FabianVowie:pr-feature/update-route-registration
61 Commits
main
...
feature/ad
25 changed files with 1500 additions and 103 deletions
-
5.gitignore
-
297README.md
-
3build.sh
-
21config/example.json
-
7go.mod
-
29go.sum
-
16lithium.md
-
47main.go
-
18main_test.go
-
28middlewares/authorization.go
-
50middlewares/authorization_test.go
-
43middlewares/ratelimiter.go
-
64middlewares/ratelimiter_test.go
-
99pipelines/executable_step.go
-
18pipelines/executable_step_test.go
-
61pipelines/pipeline.go
-
541pipelines/pipeline_test.go
-
39pipelines/step.go
-
3pipelines/step_test.go
-
81settings/settings.go
-
53settings/settings_test.go
-
57storage/storage.go
-
23storage/storage_test.go
-
BINtests/files/800x500.jpg
-
BINtests/files/900x900.jpg
@ -0,0 +1,297 @@ |
|||||
|
# 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 |
||||
|
|
||||
|
- [Go 1.17+](https://go.dev/) |
||||
|
- [_Docker_](https://docs.docker.com/) (optional) |
||||
|
|
||||
|
## Setup |
||||
|
|
||||
|
#### 1. Clone repository |
||||
|
|
||||
|
```shell |
||||
|
git clone git@gogs.informatik.hs-fulda.de:FabianVowie/Lithium.git |
||||
|
``` |
||||
|
|
||||
|
#### 2. Pull dependencies |
||||
|
|
||||
|
```shell |
||||
|
go get |
||||
|
``` |
||||
|
|
||||
|
#### 3. Build & start application |
||||
|
|
||||
|
```shell |
||||
|
go run . |
||||
|
``` |
||||
|
|
||||
|
**Run using [Docker](https://docs.docker.com/) container** |
||||
|
|
||||
|
```shell |
||||
|
docker run --rm -p 8000:8000 -v "$PWD":/usr/src/lithium -w /usr/src/lithium golang:1.17 go run . |
||||
|
``` |
||||
|
|
||||
|
## Testing |
||||
|
|
||||
|
```shell |
||||
|
go test ./... |
||||
|
``` |
||||
|
|
||||
|
### Run tests in verbose logging mode |
||||
|
|
||||
|
```shell |
||||
|
go test ./... -v |
||||
|
``` |
||||
|
|
||||
|
### Run tests in [Docker](https://docs.docker.com/) container |
||||
|
|
||||
|
```shell |
||||
|
docker run --rm -v "$PWD":/usr/src/lithium -w /usr/src/lithium golang:1.17 go test ./... |
||||
|
``` |
||||
|
|
||||
|
## Configuration |
||||
|
|
||||
|
Config options can be adjusted via the [`settings.json`](settings.json) file in the root directory. |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"endpoint": "0.0.0.0:8000", |
||||
|
"token": "changeme", |
||||
|
"rate_limiter": { |
||||
|
"requests_per_minute": 20, |
||||
|
"allowed_burst": 5 |
||||
|
}, |
||||
|
"storage_provider": { |
||||
|
"type": 0, |
||||
|
"base_path": "assets" |
||||
|
} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
## Rate Limiting |
||||
|
|
||||
|
By default, the rate limiting takes place on a per-route basis. When the limit for a specific route is hit, the response will return a status code `429: Too Many Requests`. |
||||
|
|
||||
|
| Headers | Explanation | |
||||
|
| --------------------- | -------------------------------- | |
||||
|
| X-Ratelimit-Limit | Allowed requests per minute | |
||||
|
| X-Ratelimit-Remaining | Remaining requests | |
||||
|
| X-Ratelimit-Reset | Seconds until requests replenish | |
||||
|
|
||||
|
## API |
||||
|
|
||||
|
### `GET` `/` |
||||
|
|
||||
|
Show application information. |
||||
|
|
||||
|
**Required headers**: |
||||
|
|
||||
|
```shell |
||||
|
Authorization: Bearer <Token> |
||||
|
``` |
||||
|
|
||||
|
**Example response**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"name": "Lithium", |
||||
|
"version": "0.1.0" |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
### `GET` `/{pipeline}` |
||||
|
|
||||
|
Show pipeline information. |
||||
|
|
||||
|
**Required headers**: |
||||
|
|
||||
|
```shell |
||||
|
Authorization: Bearer <Token> |
||||
|
``` |
||||
|
|
||||
|
**Example response**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"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 |
||||
|
} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
## Pipelines |
||||
|
|
||||
|
The project uses a pipeline system defined by [JSON](https://en.wikipedia.org/wiki/JSON) files located in the [config](config) folder. |
||||
|
Take a look at the [example pipeline configuration file](config/example.json). |
||||
|
|
||||
|
Available pipeline `type`s: `0` (Image), `1` (Video) |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"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. |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"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. |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"name": "step name", |
||||
|
"type": 0, |
||||
|
"options": {} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
#### Resizing images |
||||
|
|
||||
|
Resize an image by a given `width` and `height`. |
||||
|
|
||||
|
**Step definition**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"type": 0, |
||||
|
"options": { |
||||
|
"width": 1280, |
||||
|
"height": 720 |
||||
|
} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
#### Rotating images |
||||
|
|
||||
|
Rotate an image with a given `angle` in degrees. |
||||
|
|
||||
|
**Step definition**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"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**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"type": 2, |
||||
|
"options": { |
||||
|
"direction": "h" |
||||
|
} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
#### Grayscale |
||||
|
|
||||
|
Convert the colorspace of an image into grayscale. |
||||
|
|
||||
|
**Step definition**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"type": 3 |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
#### Fit |
||||
|
|
||||
|
Scales down the image to fit the specified maximum width and height. |
||||
|
|
||||
|
**Step definition**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"type": 4, |
||||
|
"options": { |
||||
|
"height": 300, |
||||
|
"width": 200 |
||||
|
} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
#### Invert |
||||
|
|
||||
|
Invert image colors. |
||||
|
|
||||
|
**Step definition**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"type": 5 |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
#### Blur |
||||
|
|
||||
|
Blur image using Gaussian functions. |
||||
|
|
||||
|
**Step definition**: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"type": 6, |
||||
|
"options": { |
||||
|
"sigma": 50.0 |
||||
|
} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
## Authors |
||||
|
|
||||
|
- [Fabian Vowie](https://gogs.informatik.hs-fulda.de/FabianVowie) |
||||
|
- [Roman Zipp](https://gogs.informatik.hs-fulda.de/roman.zipp) |
@ -0,0 +1,3 @@ |
|||||
|
#!/bin/bash |
||||
|
|
||||
|
GIT_COMMIT=$(git rev-parse --short HEAD); go build -ldflags "-X main.GitCommit=$GIT_COMMIT" |
@ -1,16 +0,0 @@ |
|||||
# Lithium |
|
||||
|
|
||||
Micro-service for file storage and processing. |
|
||||
|
|
||||
## Features |
|
||||
|
|
||||
- File storing with various providers |
|
||||
- S3 (or S3 compatible like MinIO) |
|
||||
- Locally (for development purposes) |
|
||||
- File processing "pipelines" for various formats |
|
||||
- Compression, Resizing for images |
|
||||
- Encoding for videos |
|
||||
- Remove metadata (e.g. EXIF) |
|
||||
- File-based configuration for pipelines |
|
||||
- JSON/YAML/TOML? |
|
||||
- Web api to store and retrieve files |
|
@ -0,0 +1,28 @@ |
|||||
|
package middlewares |
||||
|
|
||||
|
import ( |
||||
|
"net/http" |
||||
|
"strings" |
||||
|
) |
||||
|
|
||||
|
type AuthenticationMiddleware struct { |
||||
|
secret string |
||||
|
} |
||||
|
|
||||
|
func (middleware AuthenticationMiddleware) Middleware(next http.Handler) http.Handler { |
||||
|
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { |
||||
|
authToken := r.Header.Get("Authorization") |
||||
|
|
||||
|
if authToken == "" || strings.HasPrefix(authToken, "Bearer ") == false || authToken[7:] != middleware.secret { |
||||
|
http.Error(w, "Forbidden", http.StatusForbidden) |
||||
|
} else { |
||||
|
next.ServeHTTP(w, r) |
||||
|
} |
||||
|
}) |
||||
|
} |
||||
|
|
||||
|
func CreateAuthenticationMiddleware(secret string) AuthenticationMiddleware { |
||||
|
return AuthenticationMiddleware{ |
||||
|
secret, |
||||
|
} |
||||
|
} |
@ -0,0 +1,50 @@ |
|||||
|
package middlewares |
||||
|
|
||||
|
import ( |
||||
|
"net/http" |
||||
|
"net/http/httptest" |
||||
|
"testing" |
||||
|
|
||||
|
"github.com/bxcodec/faker/v3" |
||||
|
"github.com/stretchr/testify/assert" |
||||
|
) |
||||
|
|
||||
|
func TestAuthenticationMiddleware(t *testing.T) { |
||||
|
token := faker.Word() |
||||
|
middleware := CreateAuthenticationMiddleware(token) |
||||
|
|
||||
|
handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { |
||||
|
w.WriteHeader(http.StatusOK) |
||||
|
}) |
||||
|
|
||||
|
middlewareHandler := middleware.Middleware(handler) |
||||
|
|
||||
|
t.Run("AuthenticationMiddleware returns 403 response when authorization header is incorrect", func(t *testing.T) { |
||||
|
request, _ := http.NewRequest("GET", "/", nil) |
||||
|
responseRecorder := httptest.NewRecorder() |
||||
|
|
||||
|
middlewareHandler.ServeHTTP(responseRecorder, request) |
||||
|
|
||||
|
assert.Equal(t, 403, responseRecorder.Code) |
||||
|
}) |
||||
|
|
||||
|
t.Run("AuthenticationMiddleware returns 403 response when authorization header is missing Bearer prefix", func(t *testing.T) { |
||||
|
request, _ := http.NewRequest("GET", "/", nil) |
||||
|
request.Header.Set("Authorization", token) |
||||
|
responseRecorder := httptest.NewRecorder() |
||||
|
|
||||
|
middlewareHandler.ServeHTTP(responseRecorder, request) |
||||
|
|
||||
|
assert.Equal(t, 403, responseRecorder.Code) |
||||
|
}) |
||||
|
|
||||
|
t.Run("AuthenticationMiddleware continues when authorization header is correct", func(t *testing.T) { |
||||
|
request, _ := http.NewRequest("GET", "/", nil) |
||||
|
request.Header.Set("Authorization", "Bearer "+token) |
||||
|
responseRecorder := httptest.NewRecorder() |
||||
|
|
||||
|
middlewareHandler.ServeHTTP(responseRecorder, request) |
||||
|
|
||||
|
assert.Equal(t, 200, responseRecorder.Code) |
||||
|
}) |
||||
|
} |
@ -0,0 +1,43 @@ |
|||||
|
package middlewares |
||||
|
|
||||
|
import ( |
||||
|
"net/http" |
||||
|
|
||||
|
"github.com/throttled/throttled/store/memstore" |
||||
|
"github.com/throttled/throttled/v2" |
||||
|
) |
||||
|
|
||||
|
type RateLimiterMiddleware struct { |
||||
|
rateLimiter throttled.HTTPRateLimiter |
||||
|
} |
||||
|
|
||||
|
func (middleware RateLimiterMiddleware) Middleware(next http.Handler) http.Handler { |
||||
|
return middleware.rateLimiter.RateLimit(next) |
||||
|
} |
||||
|
|
||||
|
func CreateRateLimiterMiddleware(requestsPerMinute int, allowedBurst int) (*RateLimiterMiddleware, error) { |
||||
|
store, err := memstore.New(65536) |
||||
|
|
||||
|
if err != nil { |
||||
|
return nil, err |
||||
|
} |
||||
|
|
||||
|
quota := throttled.RateQuota{ |
||||
|
MaxRate: throttled.PerMin(requestsPerMinute), |
||||
|
MaxBurst: allowedBurst, |
||||
|
} |
||||
|
|
||||
|
rateLimiter, err := throttled.NewGCRARateLimiter(store, quota) |
||||
|
if err != nil { |
||||
|
return nil, err |
||||
|
} |
||||
|
|
||||
|
httpRateLimiter := throttled.HTTPRateLimiter{ |
||||
|
RateLimiter: rateLimiter, |
||||
|
VaryBy: &throttled.VaryBy{Path: true}, |
||||
|
} |
||||
|
|
||||
|
return &RateLimiterMiddleware{ |
||||
|
rateLimiter: httpRateLimiter, |
||||
|
}, nil |
||||
|
} |
@ -0,0 +1,64 @@ |
|||||
|
package middlewares |
||||
|
|
||||
|
import ( |
||||
|
"net/http" |
||||
|
"net/http/httptest" |
||||
|
"testing" |
||||
|
|
||||
|
"github.com/stretchr/testify/assert" |
||||
|
) |
||||
|
|
||||
|
func ExecuteRequest(middlewareHandler http.Handler) int { |
||||
|
request, _ := http.NewRequest("GET", "/", nil) |
||||
|
responseRecorder := httptest.NewRecorder() |
||||
|
|
||||
|
middlewareHandler.ServeHTTP(responseRecorder, request) |
||||
|
|
||||
|
return responseRecorder.Code |
||||
|
} |
||||
|
|
||||
|
func TestRateLimiterMiddleware(t *testing.T) { |
||||
|
handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { |
||||
|
w.WriteHeader(http.StatusOK) |
||||
|
}) |
||||
|
|
||||
|
t.Run("AuthorizationMiddleware returns 200 response when rate limit is not hit", func(t *testing.T) { |
||||
|
middleware, err := CreateRateLimiterMiddleware(1, 0) |
||||
|
assert.Nil(t, err) |
||||
|
|
||||
|
middlewareHandler := middleware.Middleware(handler) |
||||
|
|
||||
|
assert.Equal(t, 200, ExecuteRequest(middlewareHandler)) |
||||
|
}) |
||||
|
|
||||
|
t.Run("AuthorizationMiddleware returns 429 response when rate limit is hit", func(t *testing.T) { |
||||
|
middleware, err := CreateRateLimiterMiddleware(1, 0) |
||||
|
assert.Nil(t, err) |
||||
|
|
||||
|
middlewareHandler := middleware.Middleware(handler) |
||||
|
|
||||
|
assert.Equal(t, 200, ExecuteRequest(middlewareHandler)) |
||||
|
assert.Equal(t, 429, ExecuteRequest(middlewareHandler)) |
||||
|
}) |
||||
|
|
||||
|
t.Run("AuthorizationMiddleware returns 200 response when rate limit with burst is not hit", func(t *testing.T) { |
||||
|
middleware, err := CreateRateLimiterMiddleware(1, 1) |
||||
|
assert.Nil(t, err) |
||||
|
|
||||
|
middlewareHandler := middleware.Middleware(handler) |
||||
|
|
||||
|
assert.Equal(t, 200, ExecuteRequest(middlewareHandler)) |
||||
|
assert.Equal(t, 200, ExecuteRequest(middlewareHandler)) |
||||
|
}) |
||||
|
|
||||
|
t.Run("AuthorizationMiddleware returns 429 response when rate limit with burst is hit", func(t *testing.T) { |
||||
|
middleware, err := CreateRateLimiterMiddleware(1, 1) |
||||
|
assert.Nil(t, err) |
||||
|
|
||||
|
middlewareHandler := middleware.Middleware(handler) |
||||
|
|
||||
|
assert.Equal(t, 200, ExecuteRequest(middlewareHandler)) |
||||
|
assert.Equal(t, 200, ExecuteRequest(middlewareHandler)) |
||||
|
assert.Equal(t, 429, ExecuteRequest(middlewareHandler)) |
||||
|
}) |
||||
|
} |
@ -0,0 +1,81 @@ |
|||||
|
package settings |
||||
|
|
||||
|
import ( |
||||
|
"encoding/json" |
||||
|
"os" |
||||
|
"path/filepath" |
||||
|
|
||||
|
"github.com/spf13/afero" |
||||
|
) |
||||
|
|
||||
|
const ( |
||||
|
Local FileSystemType = iota |
||||
|
) |
||||
|
|
||||
|
type FileSystemType int |
||||
|
|
||||
|
type Settings struct { |
||||
|
Endpoint string `json:"endpoint"` |
||||
|
Token string `json:"token"` |
||||
|
RateLimiter RateLimiterSettings `json:"rate_limiter"` |
||||
|
StorageProvider StorageSettings `json:"storage_provider"` |
||||
|
} |
||||
|
|
||||
|
type StorageSettings struct { |
||||
|
Type FileSystemType `json:"type"` |
||||
|
BasePath string `json:"base_path"` |
||||
|
} |
||||
|
|
||||
|
type RateLimiterSettings struct { |
||||
|
RequestsPerMinute int `json:"requests_per_minute"` |
||||
|
AllowedBurst int `json:"allowed_burst"` |
||||
|
} |
||||
|
|
||||
|
func parseSettings(data []byte) Settings { |
||||
|
settings := Settings{} |
||||
|
|
||||
|
err := json.Unmarshal(data, &settings) |
||||
|
if err != nil { |
||||
|
return Settings{} |
||||
|
} |
||||
|
|
||||
|
return settings |
||||
|
} |
||||
|
|
||||
|
func LoadSettings(fileSystem afero.Fs) (Settings, error) { |
||||
|
workingDirectory, _ := os.Getwd() |
||||
|
path := filepath.Join(workingDirectory, "settings.json") |
||||
|
|
||||
|
// Load file and parse file
|
||||
|
data, err := afero.ReadFile(fileSystem, path) |
||||
|
|
||||
|
if err == nil { |
||||
|
return parseSettings(data), nil |
||||
|
} |
||||
|
|
||||
|
// If file does not exist, create default settings
|
||||
|
defaultSettings := Settings{ |
||||
|
Endpoint: "127.0.0.1:8000", |
||||
|
Token: "changeme", |
||||
|
RateLimiter: RateLimiterSettings{ |
||||
|
RequestsPerMinute: 20, |
||||
|
AllowedBurst: 5, |
||||
|
}, |
||||
|
StorageProvider: StorageSettings{ |
||||
|
Type: Local, |
||||
|
BasePath: "assets", |
||||
|
}, |
||||
|
} |
||||
|
|
||||
|
serializedSettings, err := json.MarshalIndent(defaultSettings, "", "\t") |
||||
|
if err != nil { |
||||
|
return Settings{}, err |
||||
|
} |
||||
|
|
||||
|
err = afero.WriteFile(fileSystem, path, serializedSettings, os.ModePerm) |
||||
|
if err != nil { |
||||
|
return Settings{}, err |
||||
|
} |
||||
|
|
||||
|
return defaultSettings, nil |
||||
|
} |
@ -0,0 +1,53 @@ |
|||||
|
package settings |
||||
|
|
||||
|
import ( |
||||
|
"os" |
||||
|
"path/filepath" |
||||
|
"testing" |
||||
|
|
||||
|
"github.com/spf13/afero" |
||||
|
"github.com/stretchr/testify/assert" |
||||
|
) |
||||
|
|
||||
|
func TestSettingsParsing(t *testing.T) { |
||||
|
const file string = `{ |
||||
|
"endpoint": "0.0.0.0:8000", |
||||
|
"token": "foobar", |
||||
|
"rate_limiter": { |
||||
|
"requests_per_minute": 20, |
||||
|
"allowed_burst": 5 |
||||
|
}, |
||||
|
"storage_provider": { |
||||
|
"type": 0, |
||||
|
"base_path": "assets" |
||||
|
} |
||||
|
}` |
||||
|
|
||||
|
t.Run("Settings parsing is successful", func(t *testing.T) { |
||||
|
settings := parseSettings([]byte(file)) |
||||
|
|
||||
|
assert.Equal(t, "0.0.0.0:8000", settings.Endpoint) |
||||
|
assert.Equal(t, "foobar", settings.Token) |
||||
|
assert.Equal(t, "assets", settings.StorageProvider.BasePath) |
||||
|
}) |
||||
|
} |
||||
|
|
||||
|
func TestSettingsLoading(t *testing.T) { |
||||
|
t.Run("Settings loading creates default settings.json when none is present", func(t *testing.T) { |
||||
|
fileSystem := afero.NewMemMapFs() |
||||
|
workingDirectory, _ := os.Getwd() |
||||
|
|
||||
|
path := filepath.Join(workingDirectory, "settings.json") |
||||
|
|
||||
|
// Settings file does not exist in the beginning
|
||||
|
doesFileExist, _ := afero.Exists(fileSystem, path) |
||||
|
assert.False(t, doesFileExist) |
||||
|
|
||||
|
_, err := LoadSettings(fileSystem) |
||||
|
assert.Nil(t, err) |
||||
|
|
||||
|
// Settings file should be present after calling LoadSettings
|
||||
|
doesFileExist, _ = afero.Exists(fileSystem, path) |
||||
|
assert.True(t, doesFileExist) |
||||
|
}) |
||||
|
} |
Before Width: 800 | Height: 500 | Size: 66 KiB After Width: 800 | Height: 500 | Size: 66 KiB |
Before Width: 900 | Height: 900 | Size: 128 KiB After Width: 900 | Height: 900 | Size: 128 KiB |
Write
Preview
Loading…
Cancel
Save
Reference in new issue