Skip to content

Commit

Permalink
Initial public release
Browse files Browse the repository at this point in the history
This is the first public release of kas.

Signed-off-by: Daniel Wagner <daniel.wagner@siemens.com>
  • Loading branch information
Daniel Wagner committed Jun 14, 2017
0 parents commit daf0aba
Show file tree
Hide file tree
Showing 20 changed files with 1,774 additions and 0 deletions.
7 changes: 7 additions & 0 deletions .gitignore
@@ -0,0 +1,7 @@
*.pyc
build
ebs-yocto
ebs-yocto_dependencies
kas-*
kas.egg-info
.vscode
2 changes: 2 additions & 0 deletions CHANGELOG.md
@@ -0,0 +1,2 @@
0.9.0
- initial public release
113 changes: 113 additions & 0 deletions CONTRIBUTING.md
@@ -0,0 +1,113 @@
Contributing to kas
===================

Contributions to kas are always welcome. This document explains the
general requirements on contributions and the recommended preparation
steps. It also sketches the typical integration process of patches.


Contribution Checklist
----------------------

- use git to manage your changes [*recomended*]

- follow Python coding style outlined in pep8 [**required**]

- add the required copyright header to each new file introduced, see
[licensing information](LICENSE) [**required**]

- structure patches logically, in small steps [**required**]
- one separable functionality/fix/refactoring = one patch
- do not mix those there in a single patch
- after each patch, the tree still has to build and work, i.e. do not add
even temporary breakages inside a patch series (helps when tracking down
bugs)
- use `git rebase -i` to restructure a patch series

- base patches on top of latest master or - if there are dependencies - on next
(note: next is an integration branch that may change non-linearly)

- test patches sufficiently (obvious, but...) [**required**]
- no regressions are caused in affected code
- the world is still spinning

- add signed-off to all patches [**required**]
- to certify the "Developer's Certificate of Origin", see below
- check with your employer when not working on your own!

- post patches to mailing list [**required**]
- use `git format-patch/send-email` if possible
- send patches inline, do not append them
- no HTML emails!
- CC people who you think should look at the patches, e.g.
- affected maintainers (see areas of responsibility below)
- someone who wrote a change that is fixed or reverted by you now
- who commented on related changes in the recent past
- who otherwise has expertise and is interested in the topic
- pull requests on github are only optional

- post follow-up version(s) if feedback requires this

- send reminder if nothing happened after about a week


Developer's Certificate of Origin 1.1
-------------------------------------

When signing-off a patch for this project like this

Signed-off-by: Random J Developer <random@developer.example.org>

using your real name (no pseudonyms or anonymous contributions), you declare the
following:

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.


Contribution Integration Process
--------------------------------

1. patch reviews performed on mailing list
* at least by maintainers, but everyone is invited
* feedback has to consider design, functionality and style
* simpler and clearer code preferred, even if original code works fine

2. accepted patches merged into next branch

3. further testing done by community, including CI build tests and code
analyzer runs

4. if no new problems or discussions showed up, acceptance into master
* grace period for master: about 3 days
* urgent fixes may be applied sooner

github facilities are not used for the review process so that people can follow
all changes and related discussions at a single stop, the mailing list. This
may change in the future if github should improve their email integration.


Send patches to: kas-devel@googlegroups.com

https://groups.google.com/d/forum/kas-devel
20 changes: 20 additions & 0 deletions Dockerfile
@@ -0,0 +1,20 @@
# This image builds Yocto 2.2 jobs using the kas tool

FROM ubuntu:16.04

ENV LOCALE=en_US.UTF-8
RUN apt-get update && apt-get install -y locales && \
sed -i -e "s/# $LOCALE.*/$LOCALE UTF-8/" /etc/locale.gen && \
dpkg-reconfigure --frontend=noninteractive locales

RUN apt-get -y install gawk wget git-core diffstat unzip \
texinfo gcc-multilib build-essential \
chrpath socat cpio python python3 \
libsdl1.2-dev xterm tar bzip2 curl \
dosfstools mtools parted syslinux tree \
python3-pip bc gosu
COPY . /kas
RUN pip3 install /kas

COPY docker-entrypoint /docker-entrypoint
ENTRYPOINT ["/docker-entrypoint"]
21 changes: 21 additions & 0 deletions LICENSE
@@ -0,0 +1,21 @@
kas - setup tool for bitbake based projects

Copyright (c) Siemens AG, 2017

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.

0 comments on commit daf0aba

Please sign in to comment.