diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..008b61e --- /dev/null +++ b/.editorconfig @@ -0,0 +1,27 @@ +# http://editorconfig.org + +root = true + +[*] +charset = utf-8 +insert_final_newline = true +trim_trailing_whitespace = true + +[*.go] +indent_style = tab +indent_size = 8 + +[*.tmpl] +indent_style = tab +indent_size = 2 + +[Makefile] +indent_style = tab + +[*.{less,yml}] +indent_style = space +indent_size = 2 + +[*.js] +indent_style = space +indent_size = 4 diff --git a/.lgtm b/.lgtm new file mode 100644 index 0000000..dbb2964 --- /dev/null +++ b/.lgtm @@ -0,0 +1,2 @@ +self_approval_off = false +ignore_maintainers_file = true diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..752e020 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,186 @@ +# Contribution Guidelines + +## Introduction + +This document explains how to contribute changes to the Gitea +project. It assumes you have followed the [installation +instructions](https://github.com/go-gitea/docs/tree/master/en-US/installation) + +Sensitive security-related issues should be reported to +[security@gitea.io](mailto:security@gitea.io). + +## Bug reports + +Please search the issues on the issue tracker with a variety of keywords +to ensure your bug is not already reported. + +If unique, [open an issue](https://github.com/go-gitea/gitea/issues/new) +and answer the questions so we can understand and reproduce the +problematic behavior. + +The burden is on you to convince us that it is actually a bug +in Gitea. This is easiest to do when you write clear, concise +instructions so we can reproduce the behavior (even if it seems +obvious). The more detailed and specific you are, the faster +we will be able to help you. Check out [How to Report Bugs +Effectively](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html). + +Please be kind, remember that Gitea comes at no cost to you, and you're +getting free help. + +## Discuss your design + +The project welcomes submissions but please let everyone know what +you're working on if you want to change or add something to the Gitea +repositories. + +Before starting to write something new for the Gitea project, please +[file an issue](https://github.com/go-gitea/gitea/issues/new). +Significant changes must go through the [change proposal +process](https://github.com/go-gitea/proposals) before they can be +accepted. + +This process gives everyone a chance to validate the design, helps +prevent duplication of effort, and ensures that the idea fits inside +the goals for the project and tools. It also checks that the design is +sound before code is written; the code review tool is not the place for +high-level discussions. + +## Testing redux + +Before sending code out for review, run all the tests for the whole +tree to make sure the changes don't break other usage and keep the +compatibility on upgrade: + +After running for a while, the command should print + +``` +ALL TESTS PASSED +``` +## Vendoring + +We keep a cached copy of dependencies within the `vendor/` directory, +managing updates via [govendor](http://github.com/kardianos/govendor). + +Pull requests should only include `vendor/` updates if they are +part of the same change, be it a bugfix or a feature addition. + +The `vendor/` update needs to be justified as part of the PR description, +and must be verified by the reviewers and/or merger to always reference +an existing upstream commit. + +## Code review + +Changes to Gitea must be reviewed before they are accepted, no matter +who makes the change even if an owners or a maintainer. We use github's +pull request workflow to do that and use [lgtm](http://lgtm.co) to ensure +every PR is reviewed by at least 2 maintainers. + +Please try to make your pull request easy to review for us. Please read the +["How to get faster PR reviews"](https://github.com/kubernetes/kubernetes/blob/master/docs/devel/faster_reviews.md), +guide, it got useful tips for any project you may want to contribute. See some +of the points: + +- Make small pull requests. The smaller, the faster to review and the more + likely it will be merged soon. +- Don't make changes unrelated to your PR. Maybe there are typos on some + comments, maybe refactoring would welcome on a function... but if that is not + related to you PR, please make *another* PR for that. +- Split big pull requests in multiple. An incremental change will be faster to + review than a huge PR. + +## Sign your work + +The sign-off is a simple line at the end of the explanation for the +patch. Your signature certifies that you wrote the patch or otherwise +have the right to pass it on as an open-source patch. The rules are +pretty simple: If you can certify [DCO](DCO), then you just add a line +to every git commit message: + +``` +Signed-off-by: Joe Smith +``` + +Please use your real name, we really dislike pseudonyms or anonymous +contributions. We are in the opensource world without secrets. If you +set your `user.name` and `user.email` git configs, you can sign your +commit automatically with `git commit -s`. + +## Contributors + +Everyone who sent a PR to Gitea that gets accepted will +be as a contributor. Please send a PR to add your name to +[CONTRIBUTORS](CONTRIBUTORS). For the format, see the +[CONTRIBUTORS](CONTRIBUTORS). + +## Maintainers + +To make sure every PR have been checked, we make a team maintainers. Any +PR MUST be reviewed and by at least two maintainers before it can +get merged. Maintainers should be a contributor of gitea(or gogs) and +contributed at least 4 accepted PRs. And a contributor should apply as a +maintainer in [gitter Gitea develop](https://gitter.im/go-gitea/develop). +And the owners or the team maintainer could invite the contributor. A +maintainer should spend some time on code reviews. If some maintainer +have no time to do that, he should apply to leave maintainers team and +we will give him an honor to be as a member of advisor team. Of course, +if an advisor have time to code view, welcome it back to maintainers team. +If some one have no time to code view and forget to leave the maintainers, +the owners have the power to move him from maintainers team to advisors +team. + +## Owners + +Since Gitea is a pure community organization without any company +support, to keep the development healthly We will elect the owners every +year. Every time we will elect three owners. All the contributers could +vote for three owners, one is the main owner, the other two are assistant +owners. When the new owners have been elected, the old owners MUST move +the power to the new owners. If some owner don't obey these rules, +the other owners are allowed to revoke his owner status. + +After the election, the new owners should say he agrees with these +rules on the [CONTRIBUTING](CONTRIBUTING.md) on the [Gitter Gitea +Channel](https://gitter.im/go-gitea/gitea). Below is the word to speak + +``` +I'm glad to be an owner of Gitea, +I agree with [CONTRIBUTING](CONTRIBUTING.md). +I will spend part of my time on gitea +and lead the development of gitea. +``` + +For a honor to the owners, this document will add the history owners +below: + +2016-11-04 ~ 2017-12-31 + +- lunny +- tboerger +- bkcsoft + +## Versions + +Gitea has one master as a tip branch and have many version branch +such as v0.9. v0.9 is a release branch and we will tag v0.9.0 both for +binary download. If v0.9.0 have some bugs, we will accept PR on v0.9 +and publish v0.9.1 and merge bug PR to master. + +Branch master is a tip version, so if you wish a production usage, +please download the latest release tag version. All the branch will be +protected via github, All the PRs to all the branches should be review +by two maintainers and pass the automatic tests. + +## Copyright + +Code that you contribute should use the standard copyright header: + +``` +// Copyright 2016 - 2017 The Gitea Authors. All rights reserved. +// Use of this source code is governed by a MIT-style +// license that can be found in the LICENSE file. +``` + +Files in the repository are copyright the year they are added and the +year they are last changed. If the copyright author is changed, just +copy the head below the old one. diff --git a/CONTRIBUTORS b/CONTRIBUTORS new file mode 100644 index 0000000..65db519 --- /dev/null +++ b/CONTRIBUTORS @@ -0,0 +1,9 @@ +Andrey Nering (@andreynering) +Kim Carlbäcker (@bkcsoft) +LefsFlare (@LefsFlarey) +Lunny Xiao (@lunny) +Rachid Zarouali (@xinity) +Rémy Boulanouar (@DblK) +Sandro Santilli (@strk) +Thibault Meyer (@0xbaadf00d) +Thomas Boerger (@tboerger) diff --git a/DCO b/DCO new file mode 100644 index 0000000..3aca339 --- /dev/null +++ b/DCO @@ -0,0 +1,36 @@ +Developer Certificate of Origin +Version 1.1 + +Copyright (C) 2004, 2006 The Linux Foundation and its contributors. +660 York Street, Suite 102, +San Francisco, CA 94110 USA + +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. + + +Developer's Certificate of Origin 1.1 + +By making a contribution to this project, I certify that: + +(a) The contribution was created in whole or in part by me and I + have the right to submit it under the open source license + indicated in the file; or + +(b) The contribution is based upon previous work that, to the best + of my knowledge, is covered under an appropriate open source + license and I have the right under that license to submit that + work with modifications, whether created in whole or in part + by me, under the same open source license (unless I am + permitted to submit under a different license), as indicated + in the file; or + +(c) The contribution was provided directly to me by some other + person who certified (a), (b) or (c) and I have not modified + it. + +(d) I understand and agree that this project and the contribution + are public and that a record of the contribution (including all + personal information I submit with it, including my sign-off) is + maintained indefinitely and may be redistributed consistent with + this project or the open source license(s) involved. \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..a8d4b49 --- /dev/null +++ b/LICENSE @@ -0,0 +1,20 @@ +Copyright (c) 2016 The Gitea Authors +Copyright (c) 2015 The Gogs Authors + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/MAINTAINERS b/MAINTAINERS new file mode 100644 index 0000000..9a54274 --- /dev/null +++ b/MAINTAINERS @@ -0,0 +1,10 @@ +Andrey Nering (@andreynering) +Kim Carlbäcker (@bkcsoft) +LefsFlare (@LefsFlarey) +Lunny Xiao (@lunny) +Matthias Loibl (@metalmatze) +Rachid Zarouali (@xinity) +Rémy Boulanouar (@DblK) +Sandro Santilli (@strk) +Thibault Meyer (@0xbaadf00d) +Thomas Boerger (@tboerger) diff --git a/README.md b/README.md index 948e8c7..cc7b4c8 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,40 @@ -# homebrew-gitea -Homebrew repository to install Gitea on macOS +# Gitea: Homebrew + +[![Join the chat at https://gitter.im/kleister/kleister](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/kleister/kleister) + +Homebrew repository to install Gitea on macOS. + +## Prepare + +```bash +brew tap go-gitea/gitea +``` + +## Install + +### gitea + +```bash +brew install gitea +gitea -h +``` + +## Contributing + +Fork -> Patch -> Push -> Pull Request + +## Authors + +* [Maintainers](https://github.com/orgs/go-gitea/people) +* [Contributors](https://github.com/go-gitea/gitea/graphs/contributors) + +## License + +This project is under the MIT License. See the [LICENSE](LICENSE) file for the +full license text. + +## Copyright + +``` +Copyright (c) 2016 The Gitea Authors +``` diff --git a/gitea.rb b/gitea.rb new file mode 100644 index 0000000..7c6911f --- /dev/null +++ b/gitea.rb @@ -0,0 +1,50 @@ +require "formula" + +class Gitea < Formula + homepage "https://github.com/go-gitea/gitea" + head "https://github.com/go-gitea/gitea.git" + + stable do + url "http://dl.gitea.io/gitea/1.0.0/gitea-1.0.0-darwin-amd64" + sha256 `curl -s http://dl.gitea.io/gitea/1.0.0/gitea-1.0.0-darwin-amd64.sha256`.split(" ").first + version "1.0.0" + end + + devel do + url "http://dl.gitea.io/gitea/master/gitea-master-darwin-amd64" + sha256 `curl -s http://dl.gitea.io/gitea/master/gitea-master-darwin-amd64.sha256`.split(" ").first + version "master" + end + + head do + url "https://github.com/go-gitea/gitea.git", :branch => "master" + + depends_on "go" => :build + depends_on "mercurial" => :build + depends_on "bzr" => :build + depends_on "git" => :build + end + + test do + system "#{bin}/gitea", "--version" + end + + def install + if build.head? + mkdir_p buildpath/File.join("src", "code.gitea.io") + ln_s buildpath, buildpath/File.join("src", "code.gitea.io", "gitea") + + ENV.append_path "PATH", File.join(buildpath, "bin") + + ENV["GOPATH"] = buildpath + ENV["GOHOME"] = buildpath + ENV["TAGS"] = "sqlite" + + system("make", "build") + + bin.install "#{buildpath}/bin/gitea" => "gitea" + else + bin.install "#{buildpath}/gitea-master-darwin-amd64" => "gitea" + end + end +end