Skip to content

Commit e9574c3

Browse files
njoubert-cleveragenjoubert-cleverage
committed
#3 Update README. Add docs, CHANGELOG & CONTRIBUTING.
1 parent 6d5a7f4 commit e9574c3

File tree

7 files changed

+170
-2
lines changed

7 files changed

+170
-2
lines changed

Diff for: ‎.gitignore

+7
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,9 @@
11
/composer.lock
22
/vendor
3+
.env
4+
.idea
5+
/phpunit.xml
6+
.phpunit.result.cache
7+
.phpunit.cache
8+
.php-cs-fixer.cache
9+
coverage-report

Diff for: ‎CHANGELOG.md

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
v2.0
2+
------
3+
4+
## BC breaks
5+
6+
### Changes
7+
8+
### Fixes
9+
10+
v1.0.1
11+
------
12+
13+
### Fixes
14+
15+
* Fixed dependencies after removing sidus/base-bundle from the base process bundle
16+
17+
v1.0.0
18+
------
19+
20+
* Initial release

Diff for: ‎CONTRIBUTING.md

+52
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
Contributing
2+
============
3+
4+
First of all, **thank you** for contributing, **you are awesome**!
5+
6+
Here are a few rules to follow in order to ease code reviews, and discussions before
7+
maintainers accept and merge your work.
8+
9+
You MUST run the quality & test suites.
10+
11+
You SHOULD write (or update) unit tests.
12+
13+
You SHOULD write documentation.
14+
15+
Please, write [commit messages that make sense](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html),
16+
and [rebase your branch](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) before submitting your Pull Request.
17+
18+
One may ask you to [squash your commits](https://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html)
19+
too. This is used to "clean" your Pull Request before merging it (we don't want
20+
commits such as `fix tests`, `fix 2`, `fix 3`, etc.).
21+
22+
Thank you!
23+
24+
## Running the quality & test suites
25+
26+
Tests suite uses Docker environments in order to be idempotent to OS's. More than this
27+
PHP version is written inside the Dockerfile; this assures to test the bundle with
28+
the same resources. No need to have PHP installed.
29+
30+
You only need Docker set it up.
31+
32+
To allow testing environments more smooth we implemented **Makefile**.
33+
You have two commands available:
34+
35+
```bash
36+
make quality
37+
```
38+
39+
```bash
40+
make tests
41+
```
42+
43+
## Deprecations notices
44+
45+
When a feature should be deprecated, or when you have a breaking change for a future version, please :
46+
* [Fill an issue](https://github.com/cleverage/flysystem-process-bundle/issues/new)
47+
* Add TODO comments with the following format: `@TODO deprecated v2.0`
48+
* Trigger a deprecation error: `@trigger_error('This feature will be deprecated in v2.0', E_USER_DEPRECATED);`
49+
50+
You can check which deprecation notice is triggered in tests
51+
* `make bash`
52+
* `SYMFONY_DEPRECATIONS_HELPER=0 ./vendor/bin/phpunit`

Diff for: ‎LICENSE

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2015-2019 Clever-Age
3+
Copyright (c) Clever-Age
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

Diff for: ‎README.md

+19-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,22 @@
11
CleverAge/FlysystemProcessBundle
22
=======================
33

4-
See process bundle documentation
4+
This bundle is a part of the [CleverAge/ProcessBundle](https://github.com/cleverage/process-bundle) project.
5+
It provides [Flysystem](https://flysystem.thephpleague.com/docs/) library integration on Process bundle.
6+
7+
Compatible with [Symfony stable version and latest Long-Term Support (LTS) release](https://symfony.com/releases).
8+
9+
## Documentation
10+
11+
For usage documentation, see:
12+
[docs/index.md](doc/index.md)
13+
14+
## Support & Contribution
15+
16+
For general support and questions, please use [Github](https://github.com/cleverage/flysystem-process-bundle/issues).
17+
If you think you found a bug or you have a feature idea to propose, feel free to open an issue after looking at the [contributing](CONTRIBUTING.md) guide.
18+
19+
## License
20+
21+
This bundle is under the MIT license.
22+
For the whole copyright, see the [LICENSE](LICENSE) file distributed with this source code.

Diff for: ‎docs/index.md

+27
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
## Prerequisite
2+
3+
CleverAge/ProcessBundle must be [installed](https://github.com/cleverage/process-bundle/blob/main/docs/01-quick_start.md#installation.
4+
5+
## Installation
6+
7+
Make sure Composer is installed globally, as explained in the [installation chapter](https://getcomposer.org/doc/00-intro.md)
8+
of the Composer documentation.
9+
10+
Open a command console, enter your project directory and install it using composer:
11+
12+
```bash
13+
composer require cleverage/flysystem-process-bundle
14+
```
15+
16+
Remember to add the following line to config/bundles.php (not required if Symfony Flex is used)
17+
18+
```php
19+
CleverAge\FlysystemProcessBundle\CleverAgeFlysystemProcessBundle::class => ['all' => true],
20+
```
21+
22+
## Reference
23+
24+
- Tasks
25+
- [FileFetchTask]
26+
- [ListContentTask]
27+
- [RemoveFileTask]

Diff for: ‎docs/reference/tasks/_template.md

+44
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
TaskName
2+
========
3+
4+
_Describe main goal an use cases of the task_
5+
6+
Task reference
7+
--------------
8+
9+
* **Service**: `ClassName`
10+
11+
Accepted inputs
12+
---------------
13+
14+
_Description of allowed types_
15+
16+
Possible outputs
17+
----------------
18+
19+
_Description of possible types_
20+
21+
Options
22+
-------
23+
24+
| Code | Type | Required | Default | Description |
25+
| ---- | ---- | :------: | ------- | ----------- |
26+
| `code` | `type` | **X** _or nothing_ | `default value` _if available_ | _description_ |
27+
28+
Examples
29+
--------
30+
31+
_YAML samples and explanations_
32+
33+
* Example 1
34+
- details
35+
- details
36+
37+
```yaml
38+
# Task configuration level
39+
code:
40+
service: '@service_ref'
41+
options:
42+
a: 1
43+
b: 2
44+
```

0 commit comments

Comments
 (0)