Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit d62288f
Showing
39 changed files
with
6,076 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
# OS X | ||
.DS_Store | ||
|
||
# Xcode | ||
build/ | ||
html/ | ||
*.pbxuser | ||
!default.pbxuser | ||
*.mode1v3 | ||
!default.mode1v3 | ||
*.mode2v3 | ||
!default.mode2v3 | ||
*.perspectivev3 | ||
!default.perspectivev3 | ||
xcuserdata | ||
*.xccheckout | ||
*.moved-aside | ||
DerivedData | ||
*.hmap | ||
*.ipa | ||
*.dot |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
coverage_service: coveralls | ||
xcodeproj: Euclid.xcodeproj | ||
scheme: "Euclid (Mac)" | ||
source_directory: Sources/* | ||
ignore: | ||
- Tests/* |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
4.2 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
--hexgrouping ignore | ||
--decimalgrouping ignore |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
language: swift | ||
osx_image: xcode10.1 | ||
|
||
env: | ||
- LC_CTYPE=en_US.UTF-8 LANG=en_US.UTF-8 | ||
before_install: | ||
- rvm install ruby-2.4.2 | ||
install: | ||
- bundle install --without=documentation | ||
script: | ||
- set -o pipefail | ||
- xcodebuild -scheme "Euclid (Mac)" -sdk macosx clean build test | bundle exec xcpretty | ||
after_success: bundle exec slather |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
## [0.1.0](https://github.com/nicklockwood/Euclid/releases/tag/0.1.0) (2018-12-11) | ||
|
||
- First release |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
# Contributing to Euclid | ||
|
||
Are you interested in contributing to Euclid? Fantastic! | ||
|
||
Here's what you need to know: | ||
|
||
## Versioning | ||
|
||
Euclid follows the principles of [Semantic Versioning](http://semver.org/spec/v2.0.0.html) (semver), however since Euclid is still pre-1.0, the rules are a little less strict. In general, 0.0.x releases are for bug fixes and non-breaking changes, and 0.x.0 releases are for breaking changes. | ||
|
||
Since Euclid is an asset creation tool as well as a framework, "breaking changes" refers to the generated geometry as well as the API. Changes to the way geometry is generated or tessellated by a given function are considered to be breaking, even if they do not affect the framework API. | ||
|
||
## Your First Pull Request | ||
|
||
Making your first pull request can be scary. If you have trouble with any of the contribution rules, **make a pull request anyway**. A PR is the start of a process not the end of it. | ||
|
||
All types of PR are welcome, but please do read these guidelines carefully to avoid wasting your time and ours. If you are planning something big, or which might be controversial, it's a great idea to create an issue first to discuss it before writing a lot of code. | ||
|
||
Types of PR: | ||
|
||
* Documentation fixes - if you've found a typo, or incorrect comment, either in the README or a code comment, feel free to create a PR directly against the **master** branch. | ||
|
||
* Minor code fixes - a typo in a method name or a trivial bug fix should be made against the **master** branch. | ||
|
||
* Major code changes - significant refactors or new functionality should usually be raised as an issue first to avoid wasted effort on a PR that's unlikely to land. This is mainly for your own sake, not ours, so if you prefer to make suggestions in code form then that's fine too. As with fixes, PRs should be made against the **master** branch. | ||
|
||
## Copyright and Licensing | ||
|
||
Any new source files that you add should include the standard licence header used in all the existing files. You may include your own name as the author for files that you created or replaced. | ||
|
||
By contributing code to Euclid, you are implicitly agreeing to licence it under the terms described in the LICENSE.md file. Please do not submit code that you did not write or are not authorized to redistribute. | ||
|
||
Inclusion of 3rd party frameworks is **not** permitted, regardless of the license. Small sections of code copied from somewhere else *may* be acceptable, provided that the terms of the original license are compatible with Euclid's LICENSE.md, and that you include a comment linking back to the source. | ||
|
||
## Code Style | ||
|
||
Euclid's source code mostly follows the [Ray Wenderlich Style Guide](https://github.com/raywenderlich/swift-style-guide) very closely with the following exception: | ||
|
||
- Use the Xcode default of 4 spaces for indentation. | ||
|
||
## Documentation | ||
|
||
Code should be commented, but not excessively. In general, comments should follow the principle of *why, not what*, but it's acceptable to use "obvious" comments as headings to break up large blocks of code. Public methods and classes should be commented using the `///` headerdoc style. | ||
|
||
When making user-facing changes, please update the README.md file if applicable. There is no need to update CHANGELOG.md or bump the version number. | ||
|
||
## Tests | ||
|
||
All significant code changes should be accompanied by a test. | ||
|
||
Tests are run in [Travis CI](https://travis-ci.org/nicklockwood/Euclid) automatically on all pull requests, branches and tags. These are the same tests that run in Xcode at development time. | ||
|
||
## Code of Conduct | ||
|
||
There will be zero tolerance for rudeness or bullying. If you think somebody else's comment or pull request is stupid, keep it to yourself. If you are frustrated because your issue or pull request isn't getting the attention it deserves, feel free to post a comment like "any update on this?", but remember that we are all busy, and other peoples' priorites don't necessarily match yours. | ||
|
||
Abusive contributors will be blocked and/or reported, regardless of how valuable their code contributions may be. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
{ | ||
"name": "Euclid", | ||
"version": "0.1.0", | ||
"license": { | ||
"type": "MIT", | ||
"file": "LICENSE.md" | ||
}, | ||
"summary": "Swift library for creating and manipulating 3D geometry", | ||
"homepage": "https://github.com/nicklockwood/Euclid", | ||
"authors": "Nick Lockwood", | ||
"source": { | ||
"git": "https://github.com/nicklockwood/Euclid.git", | ||
"tag": "0.1.0" | ||
}, | ||
"source_files": "Sources", | ||
"requires_arc": true, | ||
"platforms": { | ||
"ios": "10.0", | ||
"osx": "10.12", | ||
"tvos": "10.0", | ||
"watchos": "3.0" | ||
} | ||
} |
Oops, something went wrong.