Skip to content

Commit ac7767e

Browse files
author
Anton Shabovta
committed
Project Initialized
0 parents  commit ac7767e

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+4126
-0
lines changed

Diff for: ‎.gitignore

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
/.idea
2+
/vendor
3+
/build

Diff for: ‎CHANGELOG.md

+22
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Changelog
2+
3+
All Notable changes to `Ensign` will be documented in this file.
4+
5+
Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
6+
7+
## NEXT - YYYY-MM-DD
8+
9+
### Added
10+
- Nothing
11+
12+
### Deprecated
13+
- Nothing
14+
15+
### Fixed
16+
- Nothing
17+
18+
### Removed
19+
- Nothing
20+
21+
### Security
22+
- Nothing

Diff for: ‎CONDUCT.md

+74
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Contributor Code of Conduct
2+
3+
## Our Pledge
4+
5+
In the interest of fostering an open and welcoming environment, we as
6+
contributors and maintainers pledge to make participation in our project and
7+
our community a harassment-free experience for everyone, regardless of age, body
8+
size, disability, ethnicity, gender identity and expression, level of experience,
9+
nationality, personal appearance, race, religion, or sexual identity and
10+
orientation.
11+
12+
## Our Standards
13+
14+
Examples of behavior that contributes to creating a positive environment
15+
include:
16+
17+
* Using welcoming and inclusive language
18+
* Being respectful of differing viewpoints and experiences
19+
* Gracefully accepting constructive criticism
20+
* Focusing on what is best for the community
21+
* Showing empathy towards other community members
22+
23+
Examples of unacceptable behavior by participants include:
24+
25+
* The use of sexualized language or imagery and unwelcome sexual attention or
26+
advances
27+
* Trolling, insulting/derogatory comments, and personal or political attacks
28+
* Public or private harassment
29+
* Publishing others' private information, such as a physical or electronic
30+
address, without explicit permission
31+
* Other conduct which could reasonably be considered inappropriate in a
32+
professional setting
33+
34+
## Our Responsibilities
35+
36+
Project maintainers are responsible for clarifying the standards of acceptable
37+
behavior and are expected to take appropriate and fair corrective action in
38+
response to any instances of unacceptable behavior.
39+
40+
Project maintainers have the right and responsibility to remove, edit, or
41+
reject comments, commits, code, wiki edits, issues, and other contributions
42+
that are not aligned to this Code of Conduct, or to ban temporarily or
43+
permanently any contributor for other behaviors that they deem inappropriate,
44+
threatening, offensive, or harmful.
45+
46+
## Scope
47+
48+
This Code of Conduct applies both within project spaces and in public spaces
49+
when an individual is representing the project or its community. Examples of
50+
representing a project or community include using an official project e-mail
51+
address, posting via an official social media account, or acting as an appointed
52+
representative at an online or offline event. Representation of a project may be
53+
further defined and clarified by project maintainers.
54+
55+
## Enforcement
56+
57+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
58+
reported by contacting the project team at `[email protected]`. All
59+
complaints will be reviewed and investigated and will result in a response that
60+
is deemed necessary and appropriate to the circumstances. The project team is
61+
obligated to maintain confidentiality with regard to the reporter of an incident.
62+
Further details of specific enforcement policies may be posted separately.
63+
64+
Project maintainers who do not follow or enforce the Code of Conduct in good
65+
faith may face temporary or permanent repercussions as determined by other
66+
members of the project's leadership.
67+
68+
## Attribution
69+
70+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
71+
available at [http://contributor-covenant.org/version/1/4][version]
72+
73+
[homepage]: http://contributor-covenant.org
74+
[version]: http://contributor-covenant.org/version/1/4/

Diff for: ‎CONTRIBUTING.md

+32
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Contributing
2+
3+
Contributions are **welcome** and will be fully **credited**.
4+
5+
We accept contributions via Pull Requests on [Github](https://github.com/phpinnacle/ensign).
6+
7+
8+
## Pull Requests
9+
10+
- **[PSR-2 Coding Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** - Check the code style with ``$ composer check-style`` and fix it with ``$ composer fix-style``.
11+
12+
- **Add tests!** - Your patch won't be accepted if it doesn't have tests.
13+
14+
- **Document any change in behaviour** - Make sure the `README.md` and any other relevant documentation are kept up-to-date.
15+
16+
- **Consider our release cycle** - We try to follow [SemVer v2.0.0](http://semver.org/). Randomly breaking public APIs is not an option.
17+
18+
- **Create feature branches** - Don't ask us to pull from your master branch.
19+
20+
- **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.
21+
22+
- **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please [squash them](http://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages) before submitting.
23+
24+
25+
## Running Tests
26+
27+
``` bash
28+
$ composer test
29+
```
30+
31+
32+
**Happy coding**!

Diff for: ‎ISSUE_TEMPLATE.md

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
## Detailed description
2+
3+
Provide a detailed description of the change or addition you are proposing.
4+
5+
Make it clear if the issue is a bug, an enhancement or just a question.
6+
7+
## Context
8+
9+
Why is this change important to you? How would you use it?
10+
11+
How can it benefit other users?
12+
13+
## Possible implementation
14+
15+
Not obligatory, but suggest an idea for implementing addition or change.
16+
17+
## Your environment
18+
19+
Include as many relevant details about the environment you experienced the bug in and how to reproduce it.
20+
21+
* Version used (e.g. PHP 7.0, PHP 7.1.2):
22+
* Operating system and version (e.g. Ubuntu 16.04, Windows 7):
23+
* Link to your project or gist, code sample
24+
* Other important for issuer reproduce information

Diff for: ‎LICENSE.md

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# The MIT License (MIT)
2+
3+
Copyright (c) 2017 PHPinnacle <[email protected]>
4+
5+
> Permission is hereby granted, free of charge, to any person obtaining a copy
6+
> of this software and associated documentation files (the "Software"), to deal
7+
> in the Software without restriction, including without limitation the rights
8+
> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
> copies of the Software, and to permit persons to whom the Software is
10+
> furnished to do so, subject to the following conditions:
11+
>
12+
> The above copyright notice and this permission notice shall be included in
13+
> all copies or substantial portions of the Software.
14+
>
15+
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21+
> THE SOFTWARE.

Diff for: ‎PULL_REQUEST_TEMPLATE.md

+39
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
## Description
2+
3+
Describe your changes in detail.
4+
5+
## Motivation and context
6+
7+
Why is this change required? What problem does it solve?
8+
9+
If it fixes an open issue, please link to the issue here (if you write `fixes #num`
10+
or `closes #num`, the issue will be automatically closed when the pull is accepted.)
11+
12+
## How has this been tested?
13+
14+
Please describe in detail how you tested your changes.
15+
16+
Include details of your testing environment, and the tests you ran to
17+
see how your change affects other areas of the code, etc.
18+
19+
## Types of changes
20+
21+
What types of changes does your code introduce? Put an `x` in all the boxes that apply:
22+
- [ ] Bug fix (non-breaking change which fixes an issue)
23+
- [ ] New feature (non-breaking change which adds functionality)
24+
- [ ] Breaking change (fix or feature that would cause existing functionality to change)
25+
26+
## Checklist:
27+
28+
Go over all the following points, and put an `x` in all the boxes that apply.
29+
30+
Please, please, please, don't send your pull request until all of the boxes are ticked. Once your pull request is created, it will trigger a build on our [continuous integration](http://www.phptherightway.com/#continuous-integration) server to make sure your [tests and code style pass](https://help.github.com/articles/about-required-status-checks/).
31+
32+
- [ ] I have read the **[CONTRIBUTING](CONTRIBUTING.md)** document.
33+
- [ ] My pull request addresses exactly one patch/feature.
34+
- [ ] I have created a branch for this patch/feature.
35+
- [ ] Each individual commit in the pull request is meaningful.
36+
- [ ] I have added tests to cover my changes.
37+
- [ ] If my change requires a change to the documentation, I have updated it accordingly.
38+
39+
If you're unsure about any of these, don't hesitate to ask. We're here to help!

Diff for: ‎README.md

+83
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# PHPinnacle Ensign
2+
3+
[![Latest Version on Packagist][ico-version]][link-packagist]
4+
[![Software License][ico-license]](LICENSE.md)
5+
[![Coverage Status][ico-scrutinizer]][link-scrutinizer]
6+
[![Quality Score][ico-code-quality]][link-code-quality]
7+
[![Total Downloads][ico-downloads]][link-downloads]
8+
9+
This is where your description should go. Try and limit it to a paragraph or two, and maybe throw in a mention of what
10+
PSRs you support to avoid any confusion with users and contributors.
11+
12+
## Install
13+
14+
Via Composer
15+
16+
``` bash
17+
$ composer require phpinnacle/ensign
18+
```
19+
20+
## Basic Usage
21+
22+
```php
23+
<?php
24+
25+
require __DIR__ . '/vendor/autoload.php';
26+
27+
Amp\Loop::run(function () {
28+
ensign_signal('upper', function ($text) {
29+
return strtoupper($text);
30+
});
31+
32+
ensign_signal('lower', function ($text) {
33+
return strtolower($text);
34+
});
35+
36+
$hello = yield ensign_dispatch('upper', 'hello');
37+
$world = yield ensign_dispatch('lower', 'WORLD');
38+
39+
echo sprintf('%s %s!', $hello, $world);
40+
});
41+
```
42+
43+
More examples can be found in `examples` directory.
44+
45+
## Change log
46+
47+
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
48+
49+
## Testing
50+
51+
``` bash
52+
$ composer test
53+
```
54+
55+
## Contributing
56+
57+
Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.
58+
59+
## Security
60+
61+
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
62+
63+
## Credits
64+
65+
- [PHPinnacle][link-author]
66+
- [All Contributors][link-contributors]
67+
68+
## License
69+
70+
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
71+
72+
[ico-version]: https://img.shields.io/packagist/v/phpinnacle/ensign.svg?style=flat-square
73+
[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square
74+
[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/phpinnacle/ensign.svg?style=flat-square
75+
[ico-code-quality]: https://img.shields.io/scrutinizer/g/phpinnacle/ensign.svg?style=flat-square
76+
[ico-downloads]: https://img.shields.io/packagist/dt/phpinnacle/ensign.svg?style=flat-square
77+
78+
[link-packagist]: https://packagist.org/packages/phpinnacle/ensign
79+
[link-scrutinizer]: https://scrutinizer-ci.com/g/phpinnacle/ensign/code-structure
80+
[link-code-quality]: https://scrutinizer-ci.com/g/phpinnacle/ensign
81+
[link-downloads]: https://packagist.org/packages/phpinnacle/ensign
82+
[link-author]: https://github.com/phpinnacle
83+
[link-contributors]: ../../contributors

Diff for: ‎composer.json

+54
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
{
2+
"name": "phpinnacle/ensign",
3+
"type": "library",
4+
"description": "PHPinnacle Signal Dispatcher",
5+
"keywords": [
6+
"phpinnacle", "async", "signal dispatcher"
7+
],
8+
"homepage": "https://github.com/phpinnacle/ensign",
9+
"license": "MIT",
10+
"authors": [
11+
{
12+
"name": "PHPinnacle",
13+
"email": "[email protected]",
14+
"homepage": "https://phpinnacle.com",
15+
"role": "Developer"
16+
}
17+
],
18+
"require": {
19+
"php": "^7.2",
20+
"amphp/amp": "^2.0"
21+
},
22+
"require-dev": {
23+
"psr/container": "^1.0",
24+
"phpunit/phpunit" : "^6.0",
25+
"squizlabs/php_codesniffer": "^2.3"
26+
},
27+
"autoload": {
28+
"psr-4": {
29+
"PHPinnacle\\Ensign\\": "src"
30+
},
31+
"files": [
32+
"src/functions.php",
33+
"src/async.php"
34+
]
35+
},
36+
"autoload-dev": {
37+
"psr-4": {
38+
"PHPinnacle\\Ensign\\Tests\\": "tests"
39+
}
40+
},
41+
"scripts": {
42+
"test": "phpunit",
43+
"check-style": "phpcs -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 src tests",
44+
"fix-style": "phpcbf -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 src tests"
45+
},
46+
"extra": {
47+
"branch-alias": {
48+
"dev-master": "1.0-dev"
49+
}
50+
},
51+
"config": {
52+
"sort-packages": true
53+
}
54+
}

0 commit comments

Comments
 (0)