Skip to content

Commit 24415bb

Browse files
#4 Add/Update doc
1 parent ca6aade commit 24415bb

File tree

4 files changed

+185
-1
lines changed

4 files changed

+185
-1
lines changed

docs/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,5 +21,7 @@ CleverAge\CacheProcessBundle\CleverAgeCacheProcessBundle::class => ['all' => tru
2121

2222
## Reference
2323

24+
- [Adapter](reference/adapter.md)
2425
- Tasks
25-
- TODO
26+
- [GetTask](reference/tasks/get_task.md)
27+
- [SetTask](reference/tasks/set_task.md)

docs/reference/adapter.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
Adapter
2+
===============
3+
4+
Create cache adapter.
5+
6+
Reference
7+
--------------
8+
9+
* **Adapter Service Interface**: `CleverAge\CacheProcessBundle\Adapter\AdapterInterface`
10+
11+
Options
12+
-------
13+
14+
| Code | Type | Required | Default | Description |
15+
|-----------|----------|:--------:|---------|------------------------------------------------------------|
16+
| `code` | `string` | **X** | | Service identifier, used by Task adapter option |
17+
| `adapter` | `string` | **X** | | `Symfony\Component\Cache\Adapter\AdapterInterface` service |
18+
19+
Examples
20+
--------
21+
22+
```php
23+
<?php
24+
25+
declare(strict_types=1);
26+
27+
namespace App\Adapter;
28+
29+
use CleverAge\CacheProcessBundle\Adapter\Adapter;
30+
use Symfony\Component\Cache\Adapter\ArrayAdapter;
31+
32+
class MemoryAdapter extends Adapter
33+
{
34+
public function __construct()
35+
{
36+
$cache = new ArrayAdapter();
37+
parent::__construct($cache, 'memory');
38+
}
39+
}
40+
```
41+
42+
```yaml
43+
services:
44+
app.cleverage_cache_process.adapter.memory:
45+
class: App\Adapter\MemoryAdapter
46+
tags:
47+
- { name: cleverage.cache.adapter }
48+
```

docs/reference/tasks/get_task.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
GetTask
2+
===============
3+
4+
Get data from cache adapter.
5+
6+
Adapter reference
7+
--------------
8+
9+
* [Documentation](../adapter.md)
10+
11+
Task reference
12+
--------------
13+
14+
* **Task Service**: `CleverAge\CacheProcessBundle\Task\GetTask`
15+
16+
Accepted inputs
17+
---------------
18+
19+
`array`: inputs are merged with task defined options.
20+
21+
Possible outputs
22+
----------------
23+
24+
`mixed` or `null`: the content of the cache key.
25+
26+
Options
27+
-------
28+
29+
| Code | Type | Required | Default | Description |
30+
|-----------|----------|:--------:|----------|----------------------------------------------------------------------------|
31+
| `adapter` | `string` | **X** | | `CleverAge\CacheProcessBundle\Adapter\AdapterInterface` service identifier |
32+
| `key` | `string` | **X** | | index where retrieving data |
33+
34+
Examples
35+
--------
36+
37+
```yaml
38+
# Task configuration level
39+
code:
40+
service: '@CleverAge\CacheProcessBundle\Task\GetTask'
41+
options:
42+
adapter: 'memory'
43+
key: 'key2'
44+
```

docs/reference/tasks/set_task.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
SetTask
2+
===============
3+
4+
Set data on cache adapter.
5+
6+
Adapter reference
7+
--------------
8+
9+
* [Documentation](../adapter.md)
10+
11+
Task reference
12+
--------------
13+
14+
* **Task Service**: `CleverAge\CacheProcessBundle\Task\SetTask`
15+
16+
Accepted inputs
17+
---------------
18+
19+
`array`: inputs are merged with task defined options.
20+
21+
Possible outputs
22+
----------------
23+
24+
none
25+
26+
Options
27+
-------
28+
29+
| Code | Type | Required | Default | Description |
30+
|-----------|----------|:--------:|----------|----------------------------------------------------------------------------|
31+
| `adapter` | `string` | **X** | | `CleverAge\CacheProcessBundle\Adapter\AdapterInterface` service identifier |
32+
| `key` | `string` | **X** | | index where storing data |
33+
| `value` | `mixed` | **X** | | data to store |
34+
35+
Examples
36+
--------
37+
38+
```yaml
39+
# Task configuration level
40+
code:
41+
set:
42+
service: '@CleverAge\CacheProcessBundle\Task\SetTask'
43+
options:
44+
adapter: 'memory'
45+
key: 'key1'
46+
value:
47+
- column1: value1-1
48+
column2: value2-1
49+
column3: value3-1
50+
```
51+
52+
```yaml
53+
# Task configuration level
54+
code:
55+
data:
56+
service: '@CleverAge\ProcessBundle\Task\ConstantIterableOutputTask'
57+
outputs: [ format ]
58+
options:
59+
output:
60+
- key: 'key1'
61+
column1: value1-1
62+
column2: value2-1
63+
column3: value3-1
64+
- key: 'key2'
65+
column1: value1-2
66+
column2: value2-2
67+
column3: value3-2
68+
- key: 'key3'
69+
column1: ''
70+
column2: null
71+
column3: value3-3
72+
format:
73+
service: '@CleverAge\ProcessBundle\Task\TransformerTask'
74+
options:
75+
transformers:
76+
mapping:
77+
mapping:
78+
key:
79+
code: '[key]'
80+
value:
81+
code: '.'
82+
outputs: [ set ]
83+
84+
set:
85+
service: '@CleverAge\CacheProcessBundle\Task\SetTask'
86+
options:
87+
adapter: 'memory'
88+
key: '' # overrided by input'
89+
value: '' # overrided by input
90+
```

0 commit comments

Comments
 (0)