Skip to content

Commit fac9ea9

Browse files
SomeRandomiOSDevSomeRandomiOSDev
authored
Merge pull request #7 from SomeRandomiOSDev/Updates
Regenerated using the latest from ProjectTemplate
2 parents 0a450d8 + 0b0ca5f commit fac9ea9

19 files changed

+737
-285
lines changed

‎.github/CODE_OF_CONDUCT.md

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
We as members, contributors, and leaders pledge to make participation in our
6+
community a harassment-free experience for everyone, regardless of age, body
7+
size, visible or invisible disability, ethnicity, sex characteristics, gender
8+
identity and expression, level of experience, education, socio-economic status,
9+
nationality, personal appearance, race, caste, color, religion, or sexual
10+
identity and orientation.
11+
12+
We pledge to act and interact in ways that contribute to an open, welcoming,
13+
diverse, inclusive, and healthy community.
14+
15+
## Our Standards
16+
17+
Examples of behavior that contributes to a positive environment for our
18+
community include:
19+
20+
* Demonstrating empathy and kindness toward other people
21+
* Being respectful of differing opinions, viewpoints, and experiences
22+
* Giving and gracefully accepting constructive feedback
23+
* Accepting responsibility and apologizing to those affected by our mistakes,
24+
and learning from the experience
25+
* Focusing on what is best not just for us as individuals, but for the overall
26+
community
27+
28+
Examples of unacceptable behavior include:
29+
30+
* The use of sexualized language or imagery, and sexual attention or advances of
31+
any kind
32+
* Trolling, insulting or derogatory comments, and personal or political attacks
33+
* Public or private harassment
34+
* Publishing others' private information, such as a physical or email address,
35+
without their explicit permission
36+
* Other conduct which could reasonably be considered inappropriate in a
37+
professional setting
38+
39+
## Enforcement Responsibilities
40+
41+
Community leaders are responsible for clarifying and enforcing our standards of
42+
acceptable behavior and will take appropriate and fair corrective action in
43+
response to any behavior that they deem inappropriate, threatening, offensive,
44+
or harmful.
45+
46+
Community leaders have the right and responsibility to remove, edit, or reject
47+
comments, commits, code, wiki edits, issues, and other contributions that are
48+
not aligned to this Code of Conduct, and will communicate reasons for moderation
49+
decisions when appropriate.
50+
51+
## Scope
52+
53+
This Code of Conduct applies within all community spaces, and also applies when
54+
an individual is officially representing the community in public spaces.
55+
Examples of representing our community include using an official e-mail address,
56+
posting via an official social media account, or acting as an appointed
57+
representative at an online or offline event.
58+
59+
## Enforcement
60+
61+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
62+
reported to the community leaders responsible for enforcement at
63+
[email protected]. All complaints will be reviewed and investigated
64+
promptly and fairly.
65+
66+
All community leaders are obligated to respect the privacy and security of the
67+
reporter of any incident.
68+
69+
## Enforcement Guidelines
70+
71+
Community leaders will follow these Community Impact Guidelines in determining
72+
the consequences for any action they deem in violation of this Code of Conduct:
73+
74+
### 1. Correction
75+
76+
**Community Impact**: Use of inappropriate language or other behavior deemed
77+
unprofessional or unwelcome in the community.
78+
79+
**Consequence**: A private, written warning from community leaders, providing
80+
clarity around the nature of the violation and an explanation of why the
81+
behavior was inappropriate. A public apology may be requested.
82+
83+
### 2. Warning
84+
85+
**Community Impact**: A violation through a single incident or series of
86+
actions.
87+
88+
**Consequence**: A warning with consequences for continued behavior. No
89+
interaction with the people involved, including unsolicited interaction with
90+
those enforcing the Code of Conduct, for a specified period of time. This
91+
includes avoiding interactions in community spaces as well as external channels
92+
like social media. Violating these terms may lead to a temporary or permanent
93+
ban.
94+
95+
### 3. Temporary Ban
96+
97+
**Community Impact**: A serious violation of community standards, including
98+
sustained inappropriate behavior.
99+
100+
**Consequence**: A temporary ban from any sort of interaction or public
101+
communication with the community for a specified period of time. No public or
102+
private interaction with the people involved, including unsolicited interaction
103+
with those enforcing the Code of Conduct, is allowed during this period.
104+
Violating these terms may lead to a permanent ban.
105+
106+
### 4. Permanent Ban
107+
108+
**Community Impact**: Demonstrating a pattern of violation of community
109+
standards, including sustained inappropriate behavior, harassment of an
110+
individual, or aggression toward or disparagement of classes of individuals.
111+
112+
**Consequence**: A permanent ban from any sort of public interaction within the
113+
community.
114+
115+
## Attribution
116+
117+
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118+
version 2.1, available at
119+
[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
120+
121+
Community Impact Guidelines were inspired by
122+
[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
123+
124+
For answers to common questions about this code of conduct, see the FAQ at
125+
[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
126+
[https://www.contributor-covenant.org/translations][translations].
127+
128+
[homepage]: https://www.contributor-covenant.org
129+
[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
130+
[Mozilla CoC]: https://github.com/mozilla/diversity
131+
[FAQ]: https://www.contributor-covenant.org/faq
132+
[translations]: https://www.contributor-covenant.org/translations

‎.github/CONTRIBUTING.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
## Before getting started
2+
3+
I just want to say a special thanks for looking to improve this project. I truly love the open source community and it wouldn't be what it is today without people like you.
4+
5+
# How to contribute
6+
7+
There are three main ways in which you contribute:
8+
9+
1. Open a [Bug Report](https://github.com/SomeRandomiOSDev/KeyValueObservation/issues/new?assignees=SomeRandomiOSDev&labels=bug&template=BUG_REPORT.yml&title=%5BBUG%5D%3A+).
10+
2. Open a [Feature Request](https://github.com/SomeRandomiOSDev/KeyValueObservation/issues/new?assignees=SomeRandomiOSDev&labels=enhancement&template=FEATURE_REQUEST.yml&title=%5BFEATURE%5D%3A+).
11+
3. Create a [Pull Request](https://github.com/SomeRandomiOSDev/KeyValueObservation/compare/main...main?expand=1&template=PULL_REQUEST_TEMPLATE.md).
12+
13+
> If none of these really suit your needs, you could also open a [blank issue](https://github.com/SomeRandomiOSDev/KeyValueObservation/issues/new).
14+
15+
If you need further guidance or have additional questions, you can always reach out at
16+
17+
- [email protected]
18+
19+
Please also note we have a [code of conduct](#code-of-conduct), please follow it in all your interactions with the project.
20+
21+
## Getting started
22+
23+
For contributing via *Bug Reports* or *Feature Requests* contribuing is as simple as opening that specific issue.
24+
25+
> We use GitHub issue forms for submitting these types of issues. For reference, those form templates can be found [here](ISSUE_TEMPLATE/BUG_REPORT.yml) for Bug Reports and [here](ISSUE_TEMPLATE/FEATURE_REQUEST.yml) for Feature Requests.
26+
27+
For contributing via *Pull Requests*, we ask the following of you prior to opening a `pull request` to help maintain code standards and quality (many of these are enforced with workflows, but who wants to push subsequent commits for a single PR?):
28+
29+
- Please try and follow the implicit code conventions and naming schemes present within the project.
30+
- The builds for all platforms should succeed, along with all of the unit tests for each platform.
31+
- Any new code added should be accompanied by appropriate unit test code to cover (virtually) all cases and paths through that code. The code coverage for this project shouldn't decrease by a significant amount, but increases in code coverage are always welcome and appreciated.
32+
- Any new public APIs added should be accompanied by documentation in code, and as appropriate, in the [README](../README.md) file and in the Documentation Catalog.
33+
- Since this project is available via [CocoaPods](https://cocoapods.org), it should lint successfully for both `pod lib lint` and `pod lib lint --use-libraries` using the latest version of the `pod` utility.
34+
35+
> Tip: It's strongly recommended to use the [workflowtests.sh](../scripts/workflowtests.sh) script for testing all of the various builds & linting as this script is a mirror of the workflows that are ran for `pull requests`.
36+
37+
For further guidance about requirements for `pull requests`, please see the [Pull Request Guidelines](PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md) document.
38+
39+
## Code of Conduct
40+
41+
As far as it pertains to contributions to this project, we do not and will not discriminate against people on any grouds aside from those contributions. Furthermore, discrimination from other persons will not be tolerated in any capacity.
42+
43+
We may, at our own discretion, remove, block from commenting/contributing, or otherwise persons who violate these guideline or those laid out below in order to maintain and inclusive productive community.
44+
45+
For the full text of these guidelines, please read the [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) document.

‎.github/CONTRIBUTORS.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Contributors
2+
3+
## Special thanks for all the people who have contributed this project so far:
4+
5+
I would like to give a special thanks to all of the people below who have contributed to this project and to all of those who will contribute to it moving forward.
6+
7+
> None so far; you could be the first! See the section below on how to contribute.
8+
>
9+
> To the first person contributing to this project, please remove this block and replace it with your information using the following format: `- [Your Name](https://github.com/YourGitHubUsername)`
10+
11+
## I would like to join this list! How can I help the project?
12+
13+
We appreciate your enthusiam and would love to have your contribution! We are constantly looking for ways to improve this project and often suffer from (code) writers block, sometimes stagnating progress. That's where you come in! Whether you're reporting bugs, suggesting features, or writing code yourself, we want it!
14+
15+
For more information on how to contribute (and have your name show up here), please refer to our [CONTRIBUTING](CONTRIBUTING.md) guide.

‎.github/ISSUE_TEMPLATE/BUG_REPORT.yml

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
name: Bug Report
2+
description: Create a report to help us improve this project!
3+
title: "[BUG]: "
4+
labels: ["bug"]
5+
assignees:
6+
- SomeRandomiOSDev
7+
8+
body:
9+
- type: markdown
10+
attributes:
11+
value: "Thanks for taking the time to fill out this bug report!"
12+
13+
- type: textarea
14+
id: expected-behavior
15+
attributes:
16+
label: "Expected Behavior"
17+
description: "A clear and concise description of what you expected to happen."
18+
placeholder: "What was supposed to happen?"
19+
validations:
20+
required: true
21+
22+
- type: textarea
23+
id: actual-behavior
24+
attributes:
25+
label: "Actual Behavior"
26+
description: "A clear and concise description of what actually happened."
27+
placeholder: "What actually happened?"
28+
validations:
29+
required: true
30+
31+
- type: textarea
32+
id: steps
33+
attributes:
34+
label: "Steps To Reproduce"
35+
placeholder: |
36+
1. Do this...
37+
2. Do that...
38+
...
39+
validations:
40+
required: true
41+
42+
- type: input
43+
id: project-version
44+
attributes:
45+
label: "Project Version"
46+
description: "The version of the project where this issue occurred."
47+
placeholder: "0.1.5, a7df908, username/issue-branch, ..."
48+
validations:
49+
required: true
50+
51+
- type: checkboxes
52+
id: os
53+
attributes:
54+
label: "The OS/Variant where this issue occurs."
55+
description: "If \"Other\" is selected, please provide the additional OS in the \"Additional Context\" section."
56+
options:
57+
- label: "iOS"
58+
- label: "macOS"
59+
- label: "tvOS"
60+
- label: "watchOS"
61+
- label: "Mac Catalyst"
62+
- label: "Other (Please specify in \"Additional Context\" section)"
63+
validations:
64+
required: true
65+
66+
- type: input
67+
id: xcode-version
68+
attributes:
69+
label: "The version of Xcode that was used when this issue appeared."
70+
placeholder: "12.1.1, 13.0 Beta 4, Build 13A1030d, ..."
71+
validations:
72+
required: true
73+
74+
- type: checkboxes
75+
id: environment
76+
attributes:
77+
label: "What was the environment in which the issue appeared?"
78+
options:
79+
- label: "KeyValueObservation.xcodeproj"
80+
- label: "Carthage"
81+
- label: "CocoaPods"
82+
- label: "Other (Please specify in \"Additional Context\" section)"
83+
validations:
84+
required: true
85+
86+
- type: textarea
87+
id: additional-context
88+
attributes:
89+
label: "Additional Context"
90+
description: |
91+
Add any other context about the problem (e.g. screenshots, links, logs, references, sample projects, etc.)
92+
93+
Tip: You can attach files here by clicking this area to highlight it and then dragging files in.
94+
validations:
95+
required: false

‎.github/ISSUE_TEMPLATE/FEATURE_REQUEST.yml

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
name: Feature Request
2+
description: Suggest your awesome idea for this project!
3+
title: "[FEATURE]: "
4+
labels: ["enhancement"]
5+
assignees:
6+
- SomeRandomiOSDev
7+
8+
body:
9+
- type: markdown
10+
attributes:
11+
value: "Thanks for taking the time to fill out this feature request!"
12+
13+
- type: textarea
14+
id: existing-problem
15+
attributes:
16+
label: "Is your feature request related to a problem?"
17+
description: "A clear and concise description of what the problem is."
18+
placeholder: "e.g. I'm already frustrated when [...]"
19+
validations:
20+
required: false
21+
22+
- type: textarea
23+
id: solution
24+
attributes:
25+
label: "Describe the solution you'd like."
26+
placeholder: "e.g It would be a lot better if [...]"
27+
validations:
28+
required: true
29+
30+
- type: textarea
31+
id: alternatives
32+
attributes:
33+
label: "Describe alternatives you've considered."
34+
validations:
35+
required: false
36+
37+
- type: input
38+
id: current-progress
39+
attributes:
40+
label: "Have you already worked out some solution or have a PoC?"
41+
description: "Please provide the repo where we can find your work."
42+
placeholder: "e.g. username/partial-solution"
43+
validations:
44+
required: false
45+
46+
- type: textarea
47+
id: additional-context
48+
attributes:
49+
label: "Additional Context"
50+
description: |
51+
Add any other context about the feature request here (e.g. screenshots, links, references, sample projects, etc.)
52+
53+
Tip: You can attach files here by clicking this area to highlight it and then dragging files in.
54+
validations:
55+
required: false

‎.github/ISSUE_TEMPLATE/config.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
blank_issues_enabled: true

‎.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Pull Request Process
2+
3+
## Before submitting a pull request
4+
5+
Please review the [guidelines for contributing](../CONTRIBUTING.md) to this repository and remove this and all lines above this one prior to submitting your `pull request`.
6+
7+
## Description
8+
9+
A brief description of your `pull request`.
10+
11+
## Checklist
12+
13+
Ensure that your `pull request` has followed all the steps below:
14+
15+
- [ ] Code compilation.
16+
- [ ] All tests passing.
17+
- [ ] Added new unit tests, if applicable.
18+
- [ ] Extended the documentation (including README), if applicable.
19+
- [ ] Updated version in KeyValueObservation.podspec following [semver](https://semver.org) guidelines.
20+
- [ ] Ran [workflowtests.sh](../../scripts/workflowtests.sh) and passed.
21+
- [ ] Added myself to the [CONTRIBUTORS](../CONTRIBUTORS.md) file.
22+
23+
## Proposed changes
24+
25+
A detailed explaination of your changes and why these should be added to this project.
26+
27+
If this is related to one or more [issues](https://github.com/SomeRandomiOSDev/KeyValueObservation/issues), please add `closes #XXXX` (or any other [acceptable notation](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)) to link this pull request to them.
28+
29+
## Additional Info
30+
31+
Any other relevant information that needs to be known about this `pull request` (e.g. "tvOS 14.0 and up", "Requires Xcode 13", etc.).

0 commit comments

Comments
 (0)