diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 0000000..c5eefb5 --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,49 @@ +# Reference to configuration - https://github.blog/2017-07-06-introducing-code-owners/ +# Relevant https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners + +# This file is used to set permission per team or user to allow auto-merging + +# Maintainers +* @kreyren @RXT0112/maintainers + +# Documentation maintainers +/docs/ @RXT0112/documentators + +# Dependencies +Cargo.toml @dependabot-preview +requirements.txt @dependabot-preview + +# Legal team +LICENSE.md @kreyren + +# Rustlang maintainers +*.rs @RXT0112/rustlang +Cargo.toml @RXT0112/rustlang + +# Python maintainers +*.py @RXT0112/python +requirements.txt @RXT0112/python + +# Vlang maintainers +*.v @RXT0112/vlang + +# Clang maintainers +*.c @RXT0112/clang + +# CPP maintainers +*.cpp @RXT0112/cpp + +# Shell maintainers +*.sh @RXT0112/shell + +# Bash maintainers +*.bash @RXT0112/bash + +# Brainfuck maintainers +*.br @RXT0112/brainfuck + +# java maintainers +*.jar @RXT0112/java + +# csharp maintainers +*.cs @RXT0112/csharp \ No newline at end of file diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 0000000..92156ad --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,5 @@ +# Contributing guideliness + +FIXME: Preamble needed + +FIXME: Do not assign translate variables in fixme messages \ No newline at end of file diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..9dc70b1 --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,19 @@ +# These are supported funding model platforms + +# Limited on 4 github-sponsor enabled accounts +github: kreyren + +# Patreon of rustlang developers and important contributors (http://aturon.github.io/sponsor/) +patreon: RiXotStudio leodasvacas matklad QuietMisdreavus xanewok stjepang japaric newrustacean hellorust retep998 tomaka + +# misc +open_collective: rixotstudio +ko_fi: rixotstudio +tidelift: RiXotStudio/RiXotStudio +community_bridge: rixotstudio +liberapay: RiXotStudio +issuehunt: rixotstudio +otechie: rixotstudio + +# Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] +custom: https://my.fsf.org/join diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..0e160b1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,33 @@ +--- +name: Bug report +about: if Something is not working as expected +title: 'bug:' +labels: 'bug' +assignees: '@Zernit/bugwranglers' +--- + +### Describe the bug + + +text + +### To Reproduce + + +1. ... +2. ... + +### Expected behavior + + +text + +### Additional context + + +text + +### What do you expect to happend to solve this issue? + + +text diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..2035089 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,10 @@ +# Disable blank issues +blank_issues_enabled: false + +contact_links: + - name: IRC + url: https://webchat.freenode.net/#zernit + about: For simple questions and brainstorming + - name: Discord + url: https://discord.gg/5V4psY + about: Community maintained support in Zernit section \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..9d36953 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,20 @@ +--- +name: Feature request +about: For feature proposals +title: 'REQUEST:' +labels: 'feature-request' +assignees: '@Zernit/bugwranglers' +--- + +### Describe the feature + + + + +### Expected behavior + + + + +### Additional context + diff --git a/.github/ISSUE_TEMPLATE/legal-request.md b/.github/ISSUE_TEMPLATE/legal-request.md new file mode 100644 index 0000000..48756f9 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/legal-request.md @@ -0,0 +1,8 @@ +--- +name: Legal request +about: To propose changes in the license +labels: 'license' +assignees: '@Zernit/legal-team' +--- + + diff --git a/.github/ISSUE_TEMPLATE/other.md b/.github/ISSUE_TEMPLATE/other.md new file mode 100644 index 0000000..3d55bf8 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/other.md @@ -0,0 +1,9 @@ +--- +name: Other +about: If none of the above fits your request +labels: 'assign-me' +assignees: '@Zernit/helpers' + +--- + + diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md new file mode 100644 index 0000000..385e916 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/question.md @@ -0,0 +1,10 @@ +--- +name: Question +about: In case you need upstream help +title: 'Q:' +labels: 'question' +assignees: '@Zernit/helpers' + +--- + + diff --git a/.github/README.md b/.github/README.md new file mode 100644 index 0000000..72dcb33 --- /dev/null +++ b/.github/README.md @@ -0,0 +1,16 @@ +**NOTICE:** This project in in "init phase" so everything will be remade into a new orphen branch once methods for quality assurance, documentation, automatization and code is decided to be used as a foundation for new commits + +fixme: Source the header in different markdown file to make GitHub README different from GitLab + +fixme: Change the name based on repository used. + +# Zernit (RXT0112) + +System manager of WIP_NAME designed to work cross-platform and using multiple programming languages depending on which one provides the most efficiency per required runtime. + +fixme: Change the URL based on the website used
+[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/RXT0112/RXT0112) + +fixme: Add prety button
+https://codesandbox.io/s/github/RXT0112/RXT0112 + diff --git a/.github/custom-actions/sourcehub-layer/Dockerfile b/.github/custom-actions/sourcehub-layer/Dockerfile new file mode 100644 index 0000000..fa0188a --- /dev/null +++ b/.github/custom-actions/sourcehub-layer/Dockerfile @@ -0,0 +1,8 @@ +# Container image that runs your code +FROM alpine:3.10 + +# Copies your code file from your action repository to the filesystem path `/` of the container +COPY entrypoint.sh /entrypoint.sh + +# Code file to execute when the docker container starts up (`entrypoint.sh`) +ENTRYPOINT ["/entrypoint.sh"] diff --git a/.github/custom-actions/sourcehub-layer/LICENSE b/.github/custom-actions/sourcehub-layer/LICENSE new file mode 100644 index 0000000..de88db8 --- /dev/null +++ b/.github/custom-actions/sourcehub-layer/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2019 GitHub Actions + +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/.github/custom-actions/sourcehub-layer/README.md b/.github/custom-actions/sourcehub-layer/README.md new file mode 100644 index 0000000..01cba30 --- /dev/null +++ b/.github/custom-actions/sourcehub-layer/README.md @@ -0,0 +1,23 @@ +# Hello world docker action + +This action prints "Hello World" to the log or "Hello" + the name of a person to greet. To learn how this action was built, see "[Creating a Docker container action](https://help.github.com/en/articles/creating-a-docker-container-action)" in the GitHub Help documentation. + +## Inputs + +### `who-to-greet` + +**Required** The name of the person to greet. Default `"World"`. + +## Outputs + +### `time` + +The time we greeted you. + +## Example usage + +```yaml +uses: actions/hello-world-docker-action@master +with: + who-to-greet: 'Mona the Octocat' +``` diff --git a/.github/custom-actions/sourcehub-layer/action.yml b/.github/custom-actions/sourcehub-layer/action.yml new file mode 100644 index 0000000..769ceb7 --- /dev/null +++ b/.github/custom-actions/sourcehub-layer/action.yml @@ -0,0 +1,17 @@ +# FIXME: Hook https://man.sr.ht/builds.sr.ht/api.md so that we can use sourcehub in GitHub action + +name: 'Hello World' +description: 'Greet someone and record the time' +inputs: + who-to-greet: # id of input + description: 'Who to greet' + required: true + default: 'World' +outputs: + time: # id of output + description: 'The time we greeted you' +runs: + using: 'docker' + image: 'Dockerfile' + args: + - ${{ inputs.who-to-greet }} diff --git a/.github/custom-actions/sourcehub-layer/entrypoint.sh b/.github/custom-actions/sourcehub-layer/entrypoint.sh new file mode 100755 index 0000000..e4cfd97 --- /dev/null +++ b/.github/custom-actions/sourcehub-layer/entrypoint.sh @@ -0,0 +1,5 @@ +#!/bin/sh -l + +echo "Hello $1" +time=$(date) +echo ::set-output name=time::$time diff --git a/.github/label-pr.yml b/.github/label-pr.yml new file mode 100644 index 0000000..371fb6b --- /dev/null +++ b/.github/label-pr.yml @@ -0,0 +1,49 @@ +# Programming language specific +- regExp: ".*\\.rs+$" + labels: ["rustlang"] + +- regExp: ".*\\.py+$" + labels: ["python"] + +- regExp: ".*\\.c+$" + labels: ["c-lang"] + +- regExp: ".*\\.cpp+$" + labels: ["CPP"] + +- regExp: ".*\\.sh+$" + labels: ["shell"] + +- regExp: ".*\\.bash+$" + labels: ["bash"] + +- regExp: ".*\\.br+$" + labels: ["brainfuck"] + +- regExp: ".*\\.jar+$" + labels: ["java"] + +- regExp: ".*\\.v+$" + labels: ["vlang"] + +- regExp: ".*\\.cs+$" + labels: ["csharp"] + +- regExp: "^/tests/.*" + labels: ["tests"] + +- regExp: "^/benches/.*" + labels: ["benches"] + +- regExp: "^/LICENSE/.*" + labels: ["license"] + +- regExp: ".*\\.md+$" + labels: ["markdown"] + +- regExp: "^(Cargo\\.toml|requirements\\.txt)$" + labels: ["dependencies"] + +# Repository specific +- regExp: "^/docs/.*" + labels: ["docs"] \ No newline at end of file diff --git a/.github/labels.yml b/.github/labels.yml new file mode 100644 index 0000000..b7345f9 --- /dev/null +++ b/.github/labels.yml @@ -0,0 +1,112 @@ +# This file handles labels on GitHub + +# Priority handling +- name: P - SHTF + color: ae00ff + description: "Stop whatever you are doing and focus on this" + +- name: P - Very High + color: ff2f00 + description: "FIXME" + +- name: P - High + color: 910f00 + description: "FIXME" + +- name: P - Med + color: ffd000 + description: "FIXME" + +- name: P - Low + color: b3ff00 + description: "FIXME" + +- name: P - Very Low + color: 73ff00 + description: "FIXME" + +# MISC +- name: bug + color: d73a4a + description: "Something isn't working" + + - name: question + color: 7300ff + description: "For questions" + +- name: feature-request + color: 03fc5a + description: "Feature requests" + +- name: docs + color: 0075ca + description: "Improvements or additions to documentation" + +- name: duplicate + color: cfd8d7 + description: "This issue or pull request already exists" + +- name: enhancement + color: a22eef + description: "Proposal for code improvement" + +- name: license + color: 1a7546 + description: "Relevant to licensing" + +- name: dependencies + color: ca0ef0 + description: "Relevant to dependencies" + +- name: tests + color: 8d0fd6 + description: "Relevant to tests" + +- name: benches + color: cc1250 + description: "Relevant to benchmarks" + +# Programming language specific +- name: python + color: 00aeff + description: "Relevant to python" + +- name: rustlang + color: f58142 + description: "Relevant to rustlang" + +- name: c-lang + color: 427bf5 + description: "Relevant to c-lang" + +- name: brainfuck + color: f542c5 + description: "Relevant to brainfuck" + +- name: shell + color: 74e63c + description: "Relevant to shell" + +- name: bash + color: 9dff00 + description: "Relevant to bash" + +- name: CCP + color: 009dff + description: "Relevant to CCP" + +- name: vlang + color: 03cafc + description: "Relevant to vlang" + +- name: csharp + color: 08400a + description: "Relevant to csharp" + +- name: java + color: ad690a + description: "Relevant to java" + +- name: markdown + color: 454545 + description: "Relevant to markdown" diff --git a/.github/workflows.disabled/test.yml b/.github/workflows.disabled/test.yml new file mode 100644 index 0000000..1dcb01a --- /dev/null +++ b/.github/workflows.disabled/test.yml @@ -0,0 +1,9 @@ +on: [push] + +jobs: + hello_world_job: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Hello world action step + uses: ./.github/custom-actions/sourcehub-layer \ No newline at end of file diff --git a/.github/workflows/CPP.yml b/.github/workflows/CPP.yml new file mode 100644 index 0000000..c6d5ca8 --- /dev/null +++ b/.github/workflows/CPP.yml @@ -0,0 +1,176 @@ +# Workflow for cpp +name: cpp + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.cpp' + +jobs: + # Linting + lint-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Installing dependencies.. + run: if ! apt list --installed | grep -qP ".*cppcheck.*"; then sudo apt install -y cppcheck; fi + - name: Linting.. + run: cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.cpp$''); do cppcheck "$file"; done + # Kernel specific builds + build-macos-gcc-cpp: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-cpp + build-windows-gcc-cpp: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-cpp + build-macos-clang-cpp: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-cpp + build-windows-clang-cpp: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-cpp + + # Docker builds + ## Debian - testing + build-gcc-cpp-debian: + runs-on: ubuntu-latest + steps: + - uses: docker://debian/testing:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-cpp + build-clang-cpp-debian: + runs-on: ubuntu-latest + steps: + - uses: docker://debian/testing:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-cpp + ## Fedora - latest + build-gcc-cpp-fedora: + runs-on: ubuntu-latest + steps: + - uses: docker://fedora/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-cpp + build-clang-cpp-fedora: + runs-on: ubuntu-latest + steps: + - uses: docker://fedora/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-cpp + ## Archlinux - latest + build-gcc-cpp-archlinux: + runs-on: ubuntu-latest + steps: + - uses: docker://archlinux/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-cpp + build-clang-cpp-archlinux: + runs-on: ubuntu-latest + steps: + - uses: docker://archlinux/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-cpp + ## Gentoo stage3-amd64 + build-gcc-cpp-gentoo: + runs-on: ubuntu-latest + steps: + - uses: docker://gentoo/stage3-amd64:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-cpp + build-clang-cpp-gentoo: + runs-on: ubuntu-latest + steps: + - uses: docker://gentoo/stage3-amd64:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-cpp + ## Exherbo + build-gcc-cpp-exherbo: + runs-on: ubuntu-latest + steps: + - uses: docker://exherbo/exherbo_ci:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-cpp + build-clang-cpp-exherbo: + runs-on: ubuntu-latest + steps: + - uses: docker://exherbo/exherbo_ci:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-cpp + + # Run tests + ## Exherbo (Linux representative) + check-exherbo-gcc-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - run: make check-gcc-cpp + check-exherbo-clang-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - run: make check-clang-cpp + ## Windows + check-windows-gcc-cpp: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - run: make check-gcc-cpp + check-windows-clang-cpp: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - run: make check-clang-cpp + ## Darwin + check-darwin-gcc-cpp: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - run: make check-gcc-cpp + check-darwin-clang-cpp: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - run: make check-clang-cpp + + # Benchmarks + ## Exherbo + bench-exherbo-gcc-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - name: running benchmarks.. + run: make bench-gcc-cpp + bench-exherbo-clang-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - name: running benchmarks.. + run: make bench-clang-cpp \ No newline at end of file diff --git a/.github/workflows/Jekyll.yml b/.github/workflows/Jekyll.yml new file mode 100644 index 0000000..4e9a787 --- /dev/null +++ b/.github/workflows/Jekyll.yml @@ -0,0 +1,22 @@ +# Workflow for CPP +name: Jekyll + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - 'docs/**' + +jobs: + jekyll: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Get dependencies (FIXME-UPSTREAM) + run: sudo gem install jekyll + + - name: Building.. + # FIXME: Avoid using `cd` + run: cd docs && jekyll build diff --git a/.github/workflows/Jekyll_publish.yml b/.github/workflows/Jekyll_publish.yml new file mode 100644 index 0000000..4797f90 --- /dev/null +++ b/.github/workflows/Jekyll_publish.yml @@ -0,0 +1,31 @@ +# Workflow for CPP +name: Jekyll Publish + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + push: + branches: + - master + - init-new + paths: + - 'docs/_posts/**' + +jobs: + jekyll: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Get dependencies (FIXME-UPSTREAM) + run: sudo gem install jekyll + + - name: Building.. + # FIXME: Avoid using `cd` + run: cd docs && jekyll build + + - name: Deploying.. + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + GITHUB_REPOSITORY: ${{ secrets.GITHUB_REPOSITORY }} + GITHUB_ACTOR: ${{ secrets.GITHUB_ACTOR }} + uses: BryanSchuetz/jekyll-deploy-gh-pages@master diff --git a/.github/workflows/Vlang.yml b/.github/workflows/Vlang.yml new file mode 100644 index 0000000..8b2a09f --- /dev/null +++ b/.github/workflows/Vlang.yml @@ -0,0 +1,91 @@ +# Workflow for vlang +name: vlang + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.v' + +jobs: + # Kernel specific builds + build-ubuntu-vlang: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Install dependencies + run: | + if ! command -v v >/dev/null; then + wget https://github.com/vlang/v/releases/latest/download/v_linux.zip -O "$HOME/.cache/vlang.zip" + [ ! -d /opt/vlang ] && mkdir /opt/vlang + [ ! -d "$HOME/.cache/" ] && mkdir "$HOME/.cache/" + [ ! -f /opt/vlang/v ] && unzip "$HOME/.cache/vlang.zip" -d /opt/vlang/v + [ ! -x /usr/bin/v ] && ln -sf /usr/bin/v /opt/vlang/v + fi + - name: Building.. + run: make build-vlang + build-darwin-vlang: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: Install dependencies + run: | + if ! command -v v >/dev/null; then + wget https://github.com/vlang/v/releases/latest/download/v_linux.zip -O "$HOME/.cache/vlang.zip" + [ ! -d /opt/vlang ] && mkdir /opt/vlang + [ ! -d "$HOME/.cache/" ] && mkdir "$HOME/.cache/" + [ ! -f /opt/vlang/v ] && unzip "$HOME/.cache/vlang.zip" -d /opt/vlang/v + [ ! -x /usr/bin/v ] && ln -sf /usr/bin/v /opt/vlang/v + fi + - name: Building.. + run: make build-vlang + build-windows-vlang: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: Install dependencies + run: | + ECHO fixme + EXIT + - name: Building.. + run: make build-vlang + + # Docker builds + build-vlang-debian: + runs-on: ubuntu-latest + steps: + - uses: docker://debian/testing:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-vlang + + build-vlang-fedora: + runs-on: ubuntu-latest + steps: + - uses: docker://fedora/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-vlang + + # Run tests + check-vlang: + runs-on: ${{ matrix.os }} + strategy: + matrix: + os: [macos-latest, windows-latest, ubuntu-18.04] + steps: + - uses: actions/checkout@v2 + - name: running tests.. + run: make check-vlang + + # Benchmarks + bench-vlang: + runs-on: ${{ matrix.os }} + strategy: + matrix: + os: [macos-latest, windows-latest, ubuntu-18.04] + steps: + - uses: actions/checkout@v2 + - name: running benchmarks.. + run: make bench-vlang \ No newline at end of file diff --git a/.github/workflows/bash.yml b/.github/workflows/bash.yml new file mode 100644 index 0000000..d15ac9b --- /dev/null +++ b/.github/workflows/bash.yml @@ -0,0 +1,67 @@ +name: Bash + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.bash' + - "tools/dockerfreeze" + +jobs: + # Linting + lint: + runs-on: ubuntu-latest + container: debian:stable + steps: + - name: Installing dependencies.. + run: | + # Sync repos + # Check for git + if ! apt list --installed 2>/dev/null | grep -qP "^git\/stable.*"; then + # Check if we can install git + if ! apt list | grep -qP "^git\/stable.*"; then + apt update + elif apt list | grep -qP "^git\/stable.*"; then + true + else + exit 255 + fi + # Install git + apt install -y git + elif apt list --installed 2>/dev/null | grep -qP "^git\/stable.*"; then + true + else + exit 255 + fi + # Check for shellcheck + if ! apt list --installed 2>/dev/null | grep -qP "^shellcheck\s{1}-.*"; then + # Check if we can install shellcheck + if ! apt list | grep -qP "^shellcheck\s{1}-.*"; then + apt update + elif apt list | grep -qP "^shellcheck\s{1}-.*"; then + true + else + exit 255 + fi + # Install shellcheck + apt install -y shellcheck + elif apt list --installed 2>/dev/null | grep -qP "^shellcheck\s{1}-.*"; then + true + else + exit 255 + fi + - name: Pulling git dir.. + uses: actions/checkout@v2 + - name: Processing files.. + # Make sure that bash is used + shell: bash + run: | + cd "$GITHUB_WORKSPACE" + + # Process files + ## NOTICE: Do not use for loop to avoid pitfall https://mywiki.wooledge.org/BashPitfalls#pf1 + git --git-dir="$GITHUB_WORKSPACE/.git" ls-files -z -- '*.bash' tools/dockerfreeze | while IFS= read -rd '' file; do + printf 'linting bash file %s\n' "$file" + shellcheck --external-sources --shell=bash "$file" + done \ No newline at end of file diff --git a/.github/workflows/clang.yml b/.github/workflows/clang.yml new file mode 100644 index 0000000..2343a8a --- /dev/null +++ b/.github/workflows/clang.yml @@ -0,0 +1,208 @@ +# Workflow for CPP +name: C + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.c' + +jobs: + # Linting + lint: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Installing dependencies.. + run: if ! apt-list --installed cppcheck | grep -q ".*cppcheck.*"; then sudo apt install -y cppcheck; fi + - name: Linting.. + run: cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.c$'); do cppcheck "$file"; done + ## Valgrind test on gcc + valgrind-gcc: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Installing dependencies.. + run: if ! apt list --installed | grep -q ".*valgrind.*"; then sudo apt install -y valgrind; fi + - name: Linting.. + run: | + make build-gcc-c + # NOTICE: This requires to input the arguments invidually + # FIXME: Use regex to gather arguments + valgrind --leak-check=full -v build/build-gcc-c/zernit-gcc-c -h -unexpected + ## Valgrind on clang + valgrind-clang: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Installing dependencies.. + run: if ! apt list --installed | grep -qP ".*valgrind.*"; then sudo apt install -y valgrind; fi + - name: Linting.. + run: | + make build-clang-c + # NOTICE: This requires to input the arguments invidually + # FIXME: Use regex to gather arguments + valgrind --leak-check=full -v build/build-clang-c/zernit-clang-c -h -unexpected + # Kernel specific builds + build-macos-gcc-c: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-c + build-windows-gcc-c: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-c + build-macos-clang-c: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: Building.. + run: make build-clang-c + build-windows-clang-c: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: Downloading dependencies.. + run: Invoke-WebRequest -OutFile LLVM-3.7.0-win64.exe https://releases.llvm.org/3.7.0/LLVM-3.7.0-win64.exe + - name: Install dependencies.. + run: | + echo FIXME_INSTALL_CLANG + EXIT + - name: Building.. + run: make build-clang-c + + # Docker builds + ## Debian - testing + build-gcc-c-debian: + runs-on: ubuntu-latest + steps: + - uses: docker://debian/testing:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-c + build-clang-c-debian: + runs-on: ubuntu-latest + steps: + - uses: docker://debian/testing:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-c + ## Fedora - latest + build-gcc-c-fedora: + runs-on: ubuntu-latest + steps: + - uses: docker://fedora/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-c + build-clang-c-fedora: + runs-on: ubuntu-latest + steps: + - uses: docker://fedora/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-c + ## Archlinux - latest + build-gcc-c-archlinux: + runs-on: ubuntu-latest + steps: + - uses: docker://archlinux/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-c + build-clang-c-archlinux: + runs-on: ubuntu-latest + steps: + - uses: docker://archlinux/latest:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-c + ## Gentoo stage3-amd64 + build-gcc-c-gentoo: + runs-on: ubuntu-latest + steps: + - uses: docker://gentoo/stage3-amd64:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-c + build-clang-c-gentoo: + runs-on: ubuntu-latest + steps: + - uses: docker://gentoo/stage3-amd64:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-c + ## Exherbo + build-gcc-c-exherbo: + runs-on: ubuntu-latest + steps: + - uses: docker://exherbo/exherbo_ci:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-gcc-c + build-clang-c-exherbo: + runs-on: ubuntu-latest + steps: + - uses: docker://exherbo/exherbo_ci:latest + - uses: actions/checkout@v2 + - name: building.. + run: make build-clang-c + + # Run tests + ## Exherbo (Linux representative) + check-exherbo-gcc-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - run: make check-gcc-c + check-exherbo-clang-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - run: make check-clang-c + ## Windows + check-windows-gcc-cpp: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - run: make check-gcc-c + check-windows-clang-cpp: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - run: make check-clang-c + ## Darwin + check-darwin-gcc-cpp: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - run: make check-gcc-c + check-darwin-clang-cpp: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - run: make check-clang-c + + # Benchmarks + ## Exherbo + bench-exherbo-gcc-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - name: running benchmarks.. + run: make bench-gcc-cpp + bench-exherbo-clang-cpp: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://exherbo/exherbo_ci:latest + - name: running benchmarks.. + run: make bench-clang-cpp \ No newline at end of file diff --git a/.github/workflows/dockerfile.yml b/.github/workflows/dockerfile.yml new file mode 100644 index 0000000..d4a22e7 --- /dev/null +++ b/.github/workflows/dockerfile.yml @@ -0,0 +1,30 @@ +name: Dockerfile + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.Dockerfile' + +jobs: + # Linting + lint: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Installing dependencies.. + run: | + # Fix untill hadolint it available by downstream + if ! apt-cache search hadolint | grep -qP "^hadolint -"; then + # Install hadolint if not already installed through apt + if ! apt list --installed | grep -qP "^hadolint -"; then + if ! apt-cache search hadolint | grep -qP "^hadolint -.*"; then { if command -v wget >/dev/null; then apt install -y wget; fi ;} && wget https://github.com/hadolint/hadolint/releases/download/v1.17.5/hadolint-Linux-x86_64 -O /usr/bin/hadolint && { [ ! -x hadolint ] && chmod +x /usr/bin/hadolint ;}; elif apt-cache search hadolint | grep -qP "^hadolint -.*"; then apt install -y hadolint; fi + fi + fi + - name: Linting.. + run: | + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.Dockerfile$'); do + printf 'checking dockerfile %s using hadolint\n' "$file" + hadolint "$file" + done \ No newline at end of file diff --git a/.github/workflows/greetings.yml b/.github/workflows/greetings.yml new file mode 100644 index 0000000..0cd985f --- /dev/null +++ b/.github/workflows/greetings.yml @@ -0,0 +1,13 @@ +name: ConaIsa + +on: [pull_request, issues] + +jobs: + greeting: + runs-on: ubuntu-latest + steps: + - uses: actions/first-interaction@v1 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + issue-message: 'FIXME: Message for issues' + pr-message: 'FIXME: Message for merge requests' diff --git a/.github/workflows/label-maker.yml b/.github/workflows/label-maker.yml new file mode 100644 index 0000000..daa0d4f --- /dev/null +++ b/.github/workflows/label-maker.yml @@ -0,0 +1,23 @@ +name: ConaIsa + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '*.labels\.yml$' + +jobs: + labeler: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v1 + - name: Assigning labels + if: success() + uses: crazy-max/ghaction-github-labeler@v1 + with: + yaml_file: .github/labels.yml + skip_delete: false + dry_run: false + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} \ No newline at end of file diff --git a/.github/workflows/labeler.yml b/.github/workflows/labeler.yml new file mode 100644 index 0000000..a2faa24 --- /dev/null +++ b/.github/workflows/labeler.yml @@ -0,0 +1,19 @@ +# Workflow to associate labels automatically +name: Label management + +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + +jobs: + label: + runs-on: ubuntu-latest + steps: + # We need to checkout the repository to access the configured file (.github/label-pr.yml) + - uses: actions/checkout@v2 + - name: Labeler + uses: docker://decathlon/pull-request-labeler-action:2.0.0 + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + # Here we can override the path for the action configuration. If none is provided, default one is `.github/label-pr.yml` + CONFIG_PATH: ${{ secrets.GITHUB_WORKSPACE }}/.github/label-pr.yml \ No newline at end of file diff --git a/.github/workflows/markdown.yml b/.github/workflows/markdown.yml new file mode 100644 index 0000000..eee009b --- /dev/null +++ b/.github/workflows/markdown.yml @@ -0,0 +1,23 @@ +name: Markdown + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.md' + +jobs: + # Linting + lint: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Installing dependencies.. + run: if ! command -v markdownlint; then sudo npm install -g markdownlint-cli; fi + - name: Linting.. + run: | + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.md$'); do + printf 'linting markdown file %s' "$file" + markdownlint "$file" --ignore node_modules + done \ No newline at end of file diff --git a/.github/workflows/python.yml b/.github/workflows/python.yml new file mode 100644 index 0000000..54d97df --- /dev/null +++ b/.github/workflows/python.yml @@ -0,0 +1,391 @@ +# Workflow for python +name: Python + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.py' + - 'requirements.txt' + +jobs: + # Linting 3.5 + lint-linux-python-3_5: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.5 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-macos-python-3_5: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.5 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-windows-python-3_5: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.5 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + security-check-python-3_5: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.5 + - name: Installing python dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Installing linting dependencies + run: | + if apt list --installed | grep -qP "^bandit -"; then sudo apt install -y bandit; fi + - name: Linting.. + run: | + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do + printf 'checking python file %s for security issues\n' "$file" + bandit "$file" + done + + # Linting 3.6 + lint-linux-python-3_6: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.6 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-macos-python-3_6: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.6 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-window-python-3_6: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.6 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + security-check-python-3_6: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.6 + - name: Installing python dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Installing linting dependencies + run: | + if apt list --installed | grep -qP "^bandit -"; then sudo apt install -y bandit; fi + - name: Linting.. + run: | + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do + printf 'checking python file %s for security issues\n' "$file" + bandit "$file" + done + + # Linting 3.7 + lint-linux-python-3_7: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.7 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-macos-python-3_7: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.7 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-windows-python-3_7: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.7 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + security-check-python-3_7: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.7 + - name: Installing python dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Installing linting dependencies + run: | + if apt list --installed | grep -qP "^bandit -"; then sudo apt install -y bandit; fi + - name: Linting.. + run: | + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do + printf 'checking python file %s for security issues\n' "$file" + bandit "$file" + done + + # Linting 3.8 + lint-linux-python-3_8: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.8 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-macos-python-3_8: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.8 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + lint-windows-python-3_8: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.8 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint with flake8 + run: | + pip install flake8 + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pip install pytest + # FIXME: False triggers on files which names continues after set extension + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do pytest "$file"; done + security-check-python-3_8: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Configuring backend.. + uses: actions/setup-python@v1 + with: + python-version: 3.8 + - name: Installing python dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Installing linting dependencies + run: | + if apt list --installed | grep -qP "^bandit -"; then sudo apt install -y bandit; fi + - name: Linting.. + run: | + cd "$GITHUB_WORKSPACE" && for file in $(git ls-tree --name-only -r ${{ github.sha }} | grep '\.py$'); do + printf 'checking python file %s for security issues\n' "$file" + bandit "$file" + done \ No newline at end of file diff --git a/.github/workflows/rustlang.yml b/.github/workflows/rustlang.yml new file mode 100644 index 0000000..cf6a619 --- /dev/null +++ b/.github/workflows/rustlang.yml @@ -0,0 +1,84 @@ +# Workflow for Rustlang +name: Rustlang + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.rs' + - Cargo.toml + +jobs: + # Kernel specific builds + ubuntu-build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Building.. + run: cargo build + macos-build: + runs-on: macos-latest + steps: + - uses: actions/checkout@v2 + - name: Building.. + run: cargo build + windows-build: + runs-on: windows-latest + steps: + - uses: actions/checkout@v2 + - name: Building.. + run: cargo build + + # Docker builds + debian-build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://debian:testing + - name: Building.. + run: cargo build + fedora-build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://fedora:latest + - name: Building.. + run: cargo build + fedora-next-build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://fedora:rawhide + - name: Building.. + run: cargo build + archlinux-build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://archlinux:latest + - name: Building.. + run: cargo build + gentoo-build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: docker://gentoo/stage3-amd64:latest + - name: Building.. + run: cargo build + + # Run tests + check: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Testing.. + run: cargo test + + # Benchmarks + bench: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Benchmarking.. + run: cargo bench \ No newline at end of file diff --git a/.github/workflows/shell.yml b/.github/workflows/shell.yml new file mode 100644 index 0000000..d08a13b --- /dev/null +++ b/.github/workflows/shell.yml @@ -0,0 +1,66 @@ +name: Shell + +# Relevant to events - https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows +on: + pull_request: + types: [synchronize, opened, reopened, ready_for_review] + paths: + - '**.sh' + +jobs: + # Linting + lint: + runs-on: ubuntu-latest + container: debian:stable + steps: + - name: Installing dependencies.. + run: | + # Sync repos + # Check for git + if ! apt list --installed 2>/dev/null | grep -qP "^git\/stable.*"; then + # Check if we can install git + if ! apt list | grep -qP "^git\/stable.*"; then + apt update + elif apt list | grep -qP "^git\/stable.*"; then + true + else + exit 255 + fi + # Install git + apt install -y git + elif apt list --installed 2>/dev/null | grep -qP "^git\/stable.*"; then + true + else + exit 255 + fi + # Check for shellcheck + if ! apt list --installed 2>/dev/null | grep -qP "^shellcheck\s{1}-.*"; then + # Check if we can install shellcheck + if ! apt list | grep -qP "^shellcheck\s{1}-.*"; then + apt update + elif apt list | grep -qP "^shellcheck\s{1}-.*"; then + true + else + exit 255 + fi + # Install shellcheck + apt install -y shellcheck + elif apt list --installed 2>/dev/null | grep -qP "^shellcheck\s{1}-.*"; then + true + else + exit 255 + fi + - name: Pulling git dir.. + uses: actions/checkout@v2 + - name: Processing files.. + # Make sure that bash is used + shell: bash + run: | + cd "$GITHUB_WORKSPACE" + + # Process files + ## NOTICE: Do not use for loop to avoid pitfall https://mywiki.wooledge.org/BashPitfalls#pf1 + git --git-dir="$GITHUB_WORKSPACE/.git" ls-files -z -- '*.sh' | while IFS= read -rd '' file; do + printf 'linting shell file %s\n' "$file" + shellcheck --external-sources --shell=sh "$file" + done \ No newline at end of file diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml new file mode 100644 index 0000000..1446c9a --- /dev/null +++ b/.github/workflows/stale.yml @@ -0,0 +1,17 @@ +name: Staler + +on: + schedule: + - cron: "0 0 * * *" + +jobs: + stale: + runs-on: ubuntu-latest + steps: + - uses: actions/stale@v1 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + stale-issue-message: 'Stale issue message' + stale-pr-message: 'Stale pull request message' + stale-issue-label: 'no-issue-activity' + stale-pr-label: 'no-pr-activity' diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..15f9149 --- /dev/null +++ b/.gitignore @@ -0,0 +1,18 @@ +# FIXME: Move in '.git/info/exclude' once branch is determined ? + +# Autogenerated by Cargo no need to keep in repo +Cargo.lock + +# Exclude all backup files +*.bak +*.bk + +# Exclude build result +/target +/build + +# Ignore vendor files +/vendor + +# Do not include clap benches in the commits +/benches/rustlang/claprs* \ No newline at end of file diff --git a/.gitpod.yml b/.gitpod.yml new file mode 100644 index 0000000..db1dc1c --- /dev/null +++ b/.gitpod.yml @@ -0,0 +1,33 @@ +image: + file: gitpod/debian.Dockerfile + + +# FIXME: Change gitpod user on GITPOD_GIT_USER_NAME env value +tasks: + # Does not accept Quotation without '|' ? + - init: | + printf 'FIXME: %s\n' "Get rid of me" + command: | + printf 'FIXME: %s\n' "This is a hotfix for https://github.com/gitpod-io/gitpod/issues/1252 manipulating PS1 env var" + # FIXME: The color of second line does not transfer to the environment unless Ctrl+C is pressed + export PS1="\033[1m\e[38;5;201m[ \t : \w : EXIT \$? ]\033[0m\e[38;5;011m\n\u@gitpod \\$ \[$(tput sgr0)\]" + # ^^^^^^^ - bolt + # ^^^^^^^^^^^^ - Purple color + # ^^^^^^ - remove bolt + # ^^^^^^^^^^^ - Gold color + clear + +vscode: + extensions: + - kalitaalexey.vscode-rust@0.4.2:iw09QffwKU6Xcxr7C2zalA== + - Swellaby.vscode-rust-test-adapter@0.11.0:Xg+YeZZQiVpVUsIkH+uiiw== + - bungcip.better-toml@0.3.2:3QfgGxxYtGHfJKQU7H0nEw== + - hbenl.vscode-test-explorer@2.15.0:koqDUMWDPJzELp/hdS/lWw== + - belfz.search-crates-io@1.2.1:kSLnyrOhXtYPjQpKnMr4eQ== + - serayuzgur.crates@0.4.7:HMkoguLcXp9M3ud7ac3eIw== + - timonwong.shellcheck@0.9.0:hsU/Rd39aqPYowTqL+DbXg== + - krosf.vscode-valgrind@0.0.1:YTn5lOY8OnPKJYDqJPr/Sg== + - matklad.rust-analyzer@0.1.20200217:zozmBmOg1N91pRISIsYXBg== + - exiasr.hadolint@0.3.0:/FkAW3eTb+z9O7VZAyAa0w== + - DavidAnson.vscode-markdownlint@0.34.0:l4DL7iPpo7DdhfUHIUtcuQ== + - yzhang.markdown-all-in-one@2.7.0:5+DmuGcePw8L9PtfgOAAHg== \ No newline at end of file diff --git a/.hadolint.yaml b/.hadolint.yaml new file mode 100644 index 0000000..35e92e0 --- /dev/null +++ b/.hadolint.yaml @@ -0,0 +1,12 @@ +ignored: + - DL3007 # Usage of latest version is expected + - DL3008 # Pinning specific version on apt is not sane + - DL3015 # We don't mind recommended packages + - DL4001 # Allow usage of curl and wget + - DL4006 # False-trigger on /bin/sh usage? + +trustedRegistries: + - docker.io + - debian + - gitpod + - hadolint \ No newline at end of file diff --git a/.markdownlint.json b/.markdownlint.json new file mode 100644 index 0000000..1fd1b51 --- /dev/null +++ b/.markdownlint.json @@ -0,0 +1,8 @@ +// FIXME-LINT(18032020): Outputs invalid errors in gitpod + +{ + // We do not need newlines on EOF + "single-trailing-newline": false, + // We don't care fore line lenght due to the softwrap + "line-length": false +} \ No newline at end of file diff --git a/.theia/README.md b/.theia/README.md new file mode 100644 index 0000000..3361ffd --- /dev/null +++ b/.theia/README.md @@ -0,0 +1,3 @@ +Configuration directory for [theia](https://github.com/eclipse-theia/theia) + +Theia is also used by gitpod \ No newline at end of file diff --git a/.theia/settings.json b/.theia/settings.json new file mode 100644 index 0000000..5b902c0 --- /dev/null +++ b/.theia/settings.json @@ -0,0 +1,19 @@ +{ + "editor.wordWrap": "on", + // To show invisibles + "editor.renderWhitespace": "all", + "editor.tabSize": 2, + "editor.tabCompletion": "on", + "setup.dontask": true, + // rustlang + "crates.upToDateDecorator": "", + "rust.wait_to_build": 0, + // FIXME: Expand nproc command here + // NOTICE: Gitpod is currently (130220) limited on 8 threads + // FIXME: We are unable to shot datatype helpers (https://github.com/gitpod-io/gitpod/issues/1200) + "rust.jobs": 8, + "rust.build_on_save": true, + "rust.target_dir": "build/rustlang", + "rust-analyzer.displayInlayHints": true, + "rust-analyzer.highlightingOn": true, +} \ No newline at end of file diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000..5efb31b --- /dev/null +++ b/.travis.yml @@ -0,0 +1,247 @@ +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# FIXME-LINT(18032020): Outputs wrong highlights in gitpod +# Based in part upon 'travis.yml' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/.travis.yml), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +sudo: required + +# Use matrix to run tests on different environments +matrix: + include: + + ## BUILD ## + + # Exherbo Linux + # Exherbo with GCC + - name: "Exherbo Linux with GCC" + os: linux + dist: bionic + group: exherbo + cache: + directories: + - /var/db/paludis + env: + DOCKER="exherbo_ci:latest" + VARIANT="exherbo" + TOOL="build" + COMPILER_C="gcc" + COMPILER_CXX="g++" + + # Exherbo with Clang + - name: "Exherbo Linux with Clang" + os: linux + dist: bionic + group: exherbo + cache: + directories: + - /var/db/paludis + env: + DOCKER="exherbo_ci:latest" + VARIANT="exherbo" + TOOL="build" + COMPILER_C="clang" + COMPILER_CXX="clang++" + + # Ubuntu Linux + # Ubuntu 19.10 (Eoan Ermine) with GCC + - name: "Ubuntu 19.10 (Eoan Ermine) with GCC" + os: linux + cache: + directories: + - /var/cache/apt/ + dist: bionic + group: travis_latest + env: + DOCKER="ubuntu:eoan" + VARIANT="ubuntu-19.10" + TOOL="build" + COMPILER_C="gcc" + COMPILER_CXX="g++" + REPOSITORY="https://github.com/RXT0112/Zernit.git" + PACKAGES="git make cargo rustc" + + # Ubuntu 19.10 (Eoan Ermine) with Clang + - name: "Ubuntu 19.10 (Eoan Ermine) with Clang" + os: linux + cache: + directories: + - /var/cache/apt/ + dist: bionic + group: travis_latest + env: + DOCKER="ubuntu:eoan" + VARIANT="ubuntu-19.10" + TOOL="build" + COMPILER_C="clang" + COMPILER_CXX="clang++" + REPOSITORY="https://github.com/RXT0112/Zernit.git" + PACKAGES="git make cargo rustc" + + # Debian Linux + # Debian Testing + - name: "Debian Testing with GCC" + os: linux + dist: bionic + group: travis_latest + env: + DOCKER="debian:testing" + VARIANT="debian-testing" + TOOL="build" + COMPILER_C="gcc" + COMPILER_CXX="g++" + REPOSITORY="https://github.com/RXT0112/Zernit.git" + PACKAGES="rustc cargo git make pkg-config libssl-dev" + - name: "Debian Testing with Clang" + os: linux + dist: bionic + group: travis_latest + env: + DOCKER="debian:testing" + VARIANT="debian-testing" + TOOL="build" + COMPILER_C="clang" + COMPILER_CXX="clang++" + REPOSITORY="https://github.com/RXT0112/Zernit.git" + PACKAGES="rustc cargo git make pkg-config libssl-dev" + + # # Debian Sid + # - name: "Debian Sid with GCC" + # os: linux + # dist: bionic + # group: travis_latest + # env: + # DOCKER="debian:sid" + # VARIANT="debian" + # TOOL="build" + # COMPILER_C="gcc" + # COMPILER_CXX="g++" + # REPOSITORY="https://github.com/RXT0112/Zernit.git" + # PACKAGES="rustc cargo build-essentials make" + + # - name: "Debian Sid with Clang" + # os: linux + # dist: bionic + # group: travis_latest + # env: + # DOCKER="debian:sid" + # VARIANT="debian" + # TOOL="build" + # COMPILER_C="clang" + # COMPILER_CXX="clang++" + # REPOSITORY="https://github.com/RXT0112/Zernit.git" + # PACKAGES="rustc cargo build-essentials make" + + # # FreeBSD + # # FreeBSD 12.0-RELEASE + # - name: "FreeBSD 12.0-RELEASE with Clang" + # os: linux + # dist: bionic + # group: travis_latest + # env: + # QEMU="FreeBSD" + # VARIANT="12.0-RELEASE" + # TOOL="build" + # COMPILER_C="clang" + # COMPILER_CXX="clang++" + + # - name: "FreeBSD 12.0-RELEASE with GCC" + # os: linux + # dist: bionic + # group: travis_latest + # env: + # QEMU="FreeBSD" + # VARIANT="12.0-RELEASE" + # TOOL="build" + # COMPILER_C="gcc" + # COMPILER_CXX="g++" + + # FIXME: MacOS needs refactor of C programs to be compatible (https://travis-ci.org/Kreyrock/Kreyrock/jobs/620509927?utm_medium=notification&utm_source=github_status) + # MacOS X + ## MacOS 10.14 + - name: "MacOS 10.14, xcode11.2 with clang" + os: osx + cache: + - /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula + osx_image: xcode11.2 + compiler: clang + group: travis_latest + env: + TOOL="build" + + - name: "MacOS 10.14, xcode11.2 with gcc" + os: osx + cache: + - /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula + osx_image: xcode11.2 + compiler: gcc + group: travis_latest + env: + TOOL="build" + + ## MacOS 10.14.4 + - name: "MacOS 10.14.4, xcode10.3 with clang" + os: osx + cache: + - /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula + osx_image: xcode10.3 + compiler: clang + group: travis_latest + env: + TOOL="build" + + - name: "MacOS 10.14.4, xcode10.3 with gcc" + os: osx + cache: + - /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula + osx_image: xcode10.3 + compiler: gcc + group: travis_latest + env: + TOOL="build" + + ## MacOS 10.13 + - name: "MacOS 10.13, xcode9.4 with clang" + os: osx + cache: + - /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula + osx_image: xcode9.4 + compiler: clang + group: travis_latest + env: + TOOL="build" + + - name: "MacOS 10.13, xcode9.4 with gcc" + os: osx + cache: + - /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula + osx_image: xcode9.4 + compiler: gcc + group: travis_latest + env: + TOOL="build" + + # Others + # Default linux + - name: "Linux, default check" + os: linux + dist: bionic + group: travis_latest + env: + TOOL="check" + + # Windows + # - name: "Windows build" + # os: windows + # env: + # TOOL="build" + +before-install: + - QA/travis-ci/before-install.sh + +install: + - QA/travis-ci/install.sh + +script: + - QA/travis-ci/test.sh + - QA/travis-ci/build.sh \ No newline at end of file diff --git a/Cargo.toml b/Cargo.toml new file mode 100644 index 0000000..933f7b7 --- /dev/null +++ b/Cargo.toml @@ -0,0 +1,28 @@ +# Reference https://doc.rust-lang.org/cargo/reference/manifest.html + +[package] +name = "zernit" +description = "FIXME: description needed" +keywords = ["system-manager"] +version = "0.0.0" +authors = ["Kreyren "] +edition = "2018" + +# FIXME: Implement automation that bumps the dependencies in a new commit to make it easier to track dependency-caused issues +[dependencies] +# FIXME: Replace with latest once development is in gold +clap = "2.33.0" +# Used for repository management as alternative to 'make' +cargo-make = "0.28.0" +# Used for reading toml files +toml = "0.5.6" +# Custom logging solution +zernit-logger = { path = "src/libs/rustlang/zernit-logger" } + +[dev-dependencies] +# Used for benchmarking +criterion = "0.3.1" + +[[bench]] +name = "example_bench" +harness = false \ No newline at end of file diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..7c4e324 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,3 @@ +This project's license is located in the LICENSE directory, please refer there for more informations. + +License is transleted through crowdsourcing where file with name EN-LICENSE is the original license. \ No newline at end of file diff --git a/LICENSE/EN-LICENSE.md b/LICENSE/EN-LICENSE.md new file mode 100644 index 0000000..7ff5d43 --- /dev/null +++ b/LICENSE/EN-LICENSE.md @@ -0,0 +1,200 @@ + + +# RXT ZERNIT LICENSE (RXT0112-LICENSE) + + +Version 16032020053025CET, 20 January 2020 + + +Copyright (C) 2019-2020 [Jacob Hrbek](mailto:kreyren@rixotstudio.cz) + +Redistribution of this license is not allowed unless explicitly stated in the license itself assuming provided conditions met. + +FIXME: This license needs method to handle indexing where A. -> 1A. -> 1. indexing is preffered + + +

Preamble

+ +FIXME: Configure Markdown-lint to allow bare urls here + +This license is made to protect the intellectual property and direct workflow of project codenamed as **RXT0112** also known as **Zernit** publicly represented on hyperlink https://github.com/RXT0112/Zernit and understood as original repository where this license is developed based on [GPL-3 license](https://www.gnu.org/licenses/gpl-3.0.en.html) and [Free Software Foundation](https://www.fsf.org) philosophy adapted for commercial use with the intention to avoid segmentation while providing sustainable business plan to provide open-source software for everyone. + +License is designed to be community maintained where only the authorized personel further identified in this file are permitted to make changes in the original repository in which this license has been created. +These authorized personel can be also clarified in file located in `.github/CODEOWNERS` with syntax explanation on hyperlink https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners to appropriate GitHub Team or personal to allow making changes in this file which has to be archived using `git` which is version-control system for tracking changes in source code further explained by it's maintainers on hyperlink https://git-scm.com/. + +This file is written in markdown syntax further explained on hyperlink https://en.wikipedia.org/wiki/Markdown. + +## 0. TERMINOLOGY + +This section is dedicated to provide explanation of used terms in this file. + +You are encouraged to contribute in case required explanation of used terms is missing or is not sufficient. + +### A. Comments + +Comments are a feature in markdown syntax that do not render the appropriate section specified by this syntax on the final version and is not meant to be a part of final version due it's usage for development of this license. + +To elaborate further every comment is prefixed with `` which can be applied through multiple lines. + +Example of comments: + + + +Notice that said example is not rendered in the final version. + +#### I. FIXME comments + +FIXME comments are lines in this documment prefixed with `FIXME:` which are also considered as not part of the final form of this document due to it's usage to direct development of this license. + +Example of FIXME comment: + +FIXME: Hello, i'm example of FIXME comment + +### B. Source code + +Source code is a collection of text recognized by compiler that are used to perform specified action in the hardware itself. + +### Repositories + +Repositories are a method to provide source code for public which are in our case provided on GitHub presented under hyperlink https://www.github.com/RXT0112/Zernit as of 16.02.2020. + +### Upstream + +Upstream is original creator of said directory or files used on this project not to be confused with original creator who is understood to be upstrem for this project. + +### Paths + +Unless it is not obvious paths are representing physicall files or directories in this repository for example: + +path `src/bin/main.rs` points to file located in repository use + +### Original Creator (or 'OC' for short) + +Original Creator of this repository is `Jacob Hrbek `. + +FIXME: Limit my power as you see appropriate, this is done to avoid unexpected abuse of the license in early development which could have kill the project. - Kreyren + +OC reserves absolute right for whole repository to decide hierarchy of parties associated in this repository, change of read and write access and revoking of the license for any party with or without provided reason. + +### Repository Managers + +Repository Managers are defined as service with the ability to provide our project for the general public in on-line form. + +### Merge Request + +Also wrongly named as 'Pull Requst' by many repository managers is method to submit new changes in the target repository. + +#### Draft Merge Requests + +Referencing https://github.blog/2019-02-14-introducing-draft-pull-requests/ for upstream (GitHub, Inc.) explanation. + +In short this is merge request which is being worked on before it can be submitted for review and considered for merge in target repository. + +### Forks + +Forks are repository manager's features that allows anyone to make a copy of a repository in their specified profile. + +## CONDITIONS + +### Conflicts with local laws + +This license explicitly does not allow any use of RXT0112's intellectual property in a scenario where license implementation conflicts with local laws in the area of use of said intellectual property. + +For the license to grant expected permission you are required to inform the project about said conflicts with proper references and/or submit a merge request with required improvements to allow these expected permissions. + +### Your agreenment + +You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify, use or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by using, modifying or distributing the intellectual property of project RXT0112 (or any work based on the Program), you indicate your acceptance of this License to do so, and in all of its terms and conditions. + +### Nimmy condition + + +The forked repositories are not allowed to be renamed on "Nimmy". + +### Source code handling + +You are expected to keep the source-code open and accesible to all contributors, maintainers and general public. We do not grant you the permission to make the source code private. + +### Contributions + +Everyone is allowed to fork this repository as long as the source code stays public with the intention to provide a contribution to the original repository. + +Creating standalone forks alike creating standalone fork with the intention to provide unique features that are not developed with the intention to contribute the changes in original repository are not allowed and OC reserves an explicit permission to revoke license of those who violate this condition to the extent permitted by the law with the intention to avoid segmentation. +- If the difference between original repository and standalone fork is a feature which is not beneficial to the original repository decided by OC then the standalone fork is allowed for the period of which this still meets this requirement. + +Contributions of new features are expected to be submitted in a form of new merge request set as draft until reviw is requested by switching the contribution from draft to open. + + +Contributor has the right to specify his own license assuming following methods used: +- License specified as comment in the header (or at the top) of the file which will apply only for specified file + +This clarification has to follow this syntax: + +```none +Created by Jon Doe using LICENSE (hyperlink://on.theLicense.wow) in 2020 +``` + +- `LICENSE` or `LICENSE.md` file created in the root of directory which will be applied for the whole directory. + +All affiliated parties that changed content provided in original repository are required to place following signature in their commit messages to prove that they agree with terms provided in said license and the terms in following versions which they have the right to influence. + +```none +Signed-off-by: Jon Doe +``` + +### Methods used to maintain this license + +This license is based on rolling release development which means that version is made by using following syntax HHMMSSDDMMYY which represents the day on which the license has been updated where the most recent version always replaces the previous version. + +Example of syntax used for versioning: + +**18061016022020** meaning **16th February of the year 2020 at 18 hours, 6 minutes and 10 seconds** + +## Your permission + +These permissions are granted as part of our ongoing effort to comply with Free Software Foundation's philosophy, it's as of 17/02/20 is not perfect based on majority of FSF members discussed in https://forum.members.fsf.org/t/help-me-with-gpl-3-inspired-license-designed-for-commercial-use-and-to-avoid-segmentation/1953/59 and we encourage contribution and challenges if you have a better solution since it's in our best interest to provide best possible environment for further development and end-user satisfaction. + +### Use of intellectual property for personal use + +Assuming that conditions in this license are not breached then you are allowed to use intellectual property of project RXT0112 for personal use unless stated otherwise by other license which use is specified in contributing condition. + +### Permission to modify the intellectual property + +You are allowed to perform any changes to the intellectual property that does not include features that are suitable for original repository. + +You have the right to modify and/or maintain specific section of a project in original repository with official support and guidance from the project for free as long as your contribution passes code quality checks (excluding false trigger caused by a bug) and review from other contributors. + +You have the right to use your contribution outside of original repository if maintainers of original repository does not allow for the feature to be implemented. + +### Distribution of malware + +We do not grant you a permission to distribute our intellectual property with a malicious code that is directly and/or indirectly made to harm the end-user which includes handling of end-user's data without explicit permission by the end-user. + +### Usage by whitehat hackers + +You have the right to use intellectual property with the intention to fix security issues in our project and other systems as long as your work does not directly harm our project. + +White hat hackers are also welcomed by the project and their work is highly appreciated. + +### Usage in weapons + +We do not grant you a permission to use our intellectual property as a part of a mechanism that is designed to cause a harm to a living organism. + +## Warranty + +This program is provided without any warranty unless required by law in which case the party which requires said implementation of law in this license is required to inform the project for said laws to be implemented in this license so that the the program can be used legally in their area as stated in conditions above. + +Warranty can also be specified based on invidual contract or agreenment with party that requires it. + +## Additional notices + +The license has following syntax `Version 18022020173356, 20 January 2020` where the 20th January 2020 is the date where the license has been created. \ No newline at end of file diff --git a/LICENSE/README.md b/LICENSE/README.md new file mode 100644 index 0000000..b0f4446 --- /dev/null +++ b/LICENSE/README.md @@ -0,0 +1,3 @@ +This directory contains license used for the whole repository unless defined otherwise in the license itself. + +Everyone has the right to propose new changes for review with reasoning to why they should be adapted. \ No newline at end of file diff --git a/LICENSE/license-abstract.md b/LICENSE/license-abstract.md new file mode 100644 index 0000000..c809bc9 --- /dev/null +++ b/LICENSE/license-abstract.md @@ -0,0 +1,102 @@ +The licensing has been discussed in FSF which is due to the activity and info provided getting out of hand for me to process all the informations and resolve duplicate questions thus this file has been created hopefully being usable for the project in the future. + +# What is this? +Summary: This is project codenamed as RXT0112 with assigned name Zernit currently hosted on https://github.com/RXT0112/Zernit which is expected to be system/package-manager that is expected to supports any downstream on any kernel with custom dowsntream method. + +Project supports all programming languages and it's file hiearchy has been adapted for this workflow +- currently with issues in cargo (rustlang crate manager and compiler) and vlang that are currently in works. + +Project currently has 248 checks that trigger based on files changed designed to ensure code quality with option to make custom solution where needed. + +Developed with optional GUI to allow software modding (i.e game modding using GUI) +- Due to the usage of games it is designed to allow proprietary software with option to help developers to convert their code on open-source where it would make sense. + +Project requires redistribution of downstream so that end-user would be able to download the instructions +- Using mirrors of official downstream +- Using P2P of official and unofficial instructions (using blockchain-like structure so that end-user would be able to download the required instructions without limitations on our end) +- Allows 3rd party sources so that everyone can make their own packages, mods, etc.. + +Project is planned to have mentoring program for end-users/contributors for free to learn programming language and how to contribute/use the software properly +- Mentoring program will have IRC to Discord to Matrix.org to zulip bridge set up in case end-user requires help through chat +- Forum is expected to be set up for complicated issues only +- Documentation is hosted using jekyll which will be referenced during support in case it mensions the solution with additional support in case the content is not fully understood. + - If the content is not fully understood or documentation is missing required info the supportee will be encouraged to make a contribution (inspired by archlinux/gentoo) + +Project expects stable economy that would allow bug bounties and optional method to pay contributors for their productivity. + +Original creator plans on making OSS hardware which is expected to be covered by this project as well. + +Business plan that would allow for a stable profit is preferred. + +This project is designed to be compatible with four freedoms mensioned on https://www.gnu.org/philosophy/free-sw.en.html + +## Issues + +### Mentoring program +Inspired by exherbo.org approach this project does not expect help-vampires that expects babysitting that would cost the project it's resources +- End-users that are willing to learn and are asking relevant informations are always welcomed and for these we designed this program +- Mentoring program is expected to be for free to avoid placing a paywall on end-user's competence and to avoid mentors rushing through with the education to maximalize their profit while sacrificing the end-user's education. +- Original creator has community of students that are already following this ideology of free education and are expected to perform as mentors on this project. + +Based on my understanding and info provided by exherbo and my experience with them i believe that exherbo has implemented what i would call “filtering mechanism” which makes the distro not usable or pain to use for users (confusing the end-user with wrong info, banning end-users, etc… ) and keeps only contributors and developers capable of maintaining it. +Since to use the distro you need an access to repositories and know how to make the downstream in case you encounter blocking bug (which happens a lot) and the initial installation using tarball seems to be made to make the initial compilation painful to do due to the blocks, banned features without which the package manager won’t resolve the packages and requires configuration of /etc/paludis which may take hours-weeks to do without proper documentation and guidance. +For example there were few users enraged by this that they made https://web.archive.org/web/20190302155000/https://exherbo.com/ and pages purposely spreading false informations about the creator one of which is still up https://bryanostergaard.com/ (the creator is friendly and nice guy don’t believe the info provided on mensioned websites). +Which is what inspired this approach, but i want to make it more user-friendly to avoid confused users that are just not willing to learn how to use the software properly that would otherwise cause a segmentation of them making weird forks that has code quality issues and breaks the software in a way that fixes their issue by breaking other X functions. + +### Segmentation +Referencing ripple project on https://github.com/osuripple/lets/pull/5 this project is expected to have a method to avoid segmentation of the project to comply with four freedoms it has been developed as such: +- Standalone forks are not allowed unless upstream prevents a feature to be implemented. +- Contribution forks are welcomed assuming that contributor makes a draft merge request to the original repository for the porpose of code-quality and direct upstream support +- Competent and trusted contributors will be able to get write access to relevant files, but reviews will be encouraged even with this access. + +### Redistribution +Malware in distributed files is a concern +- Digital distribution is expected to be handled by upstream +- There is expected to be set of rules maintained by upstream and community to ensure that the digital distribution is safe to use + - Project will issue a warning to third party if these rules are not met and do it's best to help with compliance with these rules + - If third party does not comply with these rules even after it has been warned the project will take legal action. +- Digital distribution will always have checksums + - in case upstream gets compromised + - in case repository hoster gets compromised + - in case end-user downloads corrupted file +- Physicall distribution is expected to be handled by upstream and authorised parties + - There is expected to be set of rules maintaned by upstream and community to ensure safety of these physicall copies + - From business point of view upstream expects cut from profit + - Will be bundled with checksum hosted on remote in case the physical device gets corrupted or mishandled +Project is rolling release with version control +- Physical distribution of rolling releases is not allowed to avoid unsable software distribution and outdated software. + +### Profit +Project is expected to have stable economy to sustain bug bounties, it's activity and ideally improve wealth of original creator. +- Project is expected to be paid for commercial use +- Project considers paid license for non-contributing members assuming it being implemented in a way that would motivate end-users from being help-vampires without sacrificing four freedoms +- Support provided by the project is expected to be always free. + - It was discussed that offering priority based on end-user's support of the project could be prioritized + - i.e person who donates with money have priority over regular person and person who actively contributes in the source code would have priority over those who donate (possible to reduce help-vampires) +- Project accepts donations +- Project accepts sponsorships +- Project is designed to be for sale for X amount of time inspired by OpenSUSE's approach where original creator would stay in charge to avoid new owner from changing it's components. +- In general more funds without sacrificing four freedoms the better. + +## Solutions + +### Code-quality +Currently project has around 248 tests set up with expectation on 811 that are going to trigger based on files edited to help with project maintainance. + +Project has set up hierarchy for reviewers that are expected to review merge requests before being merged (sourced from original creator's community for a kick-start) + +mensioned mentoring project and method to handle contribution forks + +### Other plans + +#### Free hosting +Project is expected to provide free hosting as a part of mentoring program and to support new developers. (requires funds to handle the server cost) +- VPN hosting not allowed +- Cryptocurrency mining not allowed +- Setting up a rendering farm not allowed + +#### OSS hardware development +Project's business plan is expected to handle OSS hardware development +- Currently Portable device (https://github.com/kreyware/RXT0117) and aircraft (https://github.com/kreycraft0) assuming cooperation with EAA (https://www.eaa.org/eaa) in the works. + + diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..6a4ea53 --- /dev/null +++ b/Makefile @@ -0,0 +1,132 @@ +# FIXME: in-code docs needed + +# FIXME: Windows doesn't support makefiles natively -> if you have a better method then please MR it or make an issue + +## Syntax capture ## + +all: + @ printf '%s\n' "Unknown option '$1' parsed in target all" + @ exit 2 + +## BUILD ## +# All build targets are expected in 'build/build-LANG' where 'LANG' is the unique identifier of the language used +# FIXME: Replace 'exit 1' with helpful messages + +build: build-rustlang build-clang-c build-gcc-c build-gcc-ccp build-clang build-brainfuck build-python build-vlang build-golang + @ printf 'WARN: %s\n' "You are abould to build all targets on multilang project" + +# FIXME: Build in '$repodir/build/build-rustlang' instead of '$repodir/target' for multilang support +build-rustlang: + @ cargo build --verbose + +# FIXME: Add logic +build-clang-c: + @ # Make a build directory + @ [ ! -d build ] && { mkdir build || exit 1 ;} || exit 0 + @ [ ! -d build/build-clang-c ] && { mkdir build/build-clang-c || exit 1 ;} || exit 0 + + @ # Compilation + @ [ ! -f build/build-clang-c/zernit-clang-c ] && { clang src/bin/main.c -o build/build-clang-c/zernit-clang-c || exit 1 ;} || exit 0 + @ printf '%s\n' "Compilation of target for clang-c finished" + +build-gcc-c: + @ # Make a build directory + @ [ ! -d build ] && { mkdir build || exit 1 ;} || exit 0 + @ [ ! -d build/target-gcc-c ] && { mkdir build/build-gcc-c || exit 1 ;} || exit 0 + + @ # Compilation + @ [ ! -f build/build-gcc-c/zernit-gcc-c ] && { gcc src/bin/main.c -o build/build-gcc-c/zernit-gcc-c || exit 1 ;} || exit 0 + @ printf '%s\n' "Compilation of target for gcc-c finished" + +# FIXME: Replace 'exit 1' with helpful messages +build-gcc-ccp: + @ # Make a build directory + @ [ ! -d build ] && { mkdir build || exit 1 ;} + @ [ ! -d build/target-gcc ] && { mkdir build/build-gcc || exit 1 ;} + + @ # Compilation + @ [ ! -f build/build-gcc ] && { gcc src/bin/main.c -o build/build-gcc/gcc-zernit || exit 1 ;} + @ printf '%s\n' "Compilation of target for gcc finished" + +build-clang-ccp: + @ printf 'FIXME: %s\n' "translate zernit in clang" + @ exit 1 + +build-brainfuck: + @ printf 'FIXME: %s\n' "translate zernit in brainfuck" + @ exit 1 + +# FIXME: requires python3.6+ and pip3 +build-python: + @ pip3 install -r requirements.txt + +build-vlang: + @ [ ! -d build ] && mkdir build + @ [ ! -d build/build-vlang ] && mkdir build/build-vlang + @ /opt/vlang/v -o build/build-vlang/zernit-vlang src/bin/main.v + +build-golang: + @ [ ! -d build ] && mkdir build + @ [ ! -d build/build-golang ] && mkdir build/build-golang + @ go build -o build/build-golang/zernit-golang src/bin/main.go + +## CHECK/TESTS ## + +check: + @ printf 'FIXME: %s\n' "Check all targets if executed" + @ exit 1 + +check-gcc-c: + @ printf 'FIXME: %s\n' "Add tests for gc" + @ exit 1 + +check-clang-c: + @ printf 'FIXME: %s\n' "Add tests for gcc" + @ exit 1 + +check-gcc-ccp: + @ printf 'FIXME: %s\n' "Add tests for clang" + @ exit 1 + +check-python: + @ printf 'FIXME: %s\n' "Add tests for python" + @ exit 1 + +check-rustlang: + @ printf 'FIXME: %s\n' "Add tests for rustlang" + @ exit 1 + +check-brainfuck: + @ printf 'FIXME: %s\n' "Add tests for brainfuck" + @ exit 1 + +check-shell: + @ printf 'FIXME: %s\n' "Add tests for shell" + @ exit 1 + +check-bash: + @ printf 'FIXME: %s\n' "Add tests for bash" + @ exit 1 + +check-vlang: + @ printf 'FIXME: %s\n' "Add tests for vlang" + @ exit 1 + +## BENCHES ## + +# FIXME: Run all benches if this is executed +bench: bench-rustlang + +# FIXME: Run vendor and +bench-rustlang: + @ cargo bench + +## CLEAN ## + +clean: clean-vendor clean-benches + @ [ -d build ] && { rm -rf build || exit 1 ;} || exit 0 + @ printf '%s\n' "Build directory has been cleaned" + +clean-vendor: + @ # FIXME: Output helpful message if directory doesn't exists + @ [ -d vendor ] && { rm -rf vendor || exit 1 ;} || exit 0 \ No newline at end of file diff --git a/QA/README.md b/QA/README.md new file mode 100644 index 0000000..1c81c53 --- /dev/null +++ b/QA/README.md @@ -0,0 +1 @@ +Backend for Quality Assurance \ No newline at end of file diff --git a/QA/circle-ci/config.yml b/QA/circle-ci/config.yml new file mode 100644 index 0000000..b1030ba --- /dev/null +++ b/QA/circle-ci/config.yml @@ -0,0 +1,10 @@ + version: 2.1 + orbs: + shellcheck: circleci/shellcheck@1.3.15 + jobs: + build: + docker: + - image: circleci/node:4.8.2 # the primary container, where your job's commands are run + steps: + - checkout # check out the code in the project directory + - run: make check diff --git a/QA/common/qemu_debian.sh b/QA/common/qemu_debian.sh new file mode 100755 index 0000000..c9e9420 --- /dev/null +++ b/QA/common/qemu_debian.sh @@ -0,0 +1,13 @@ +#!/bin/sh + +die() { printf 'FATAL: %s\n' "$1" && exit 1 ;} + +[ ! -e debian.qcow ] && { qemu-img create -f qcow2 debian.qcow 20G || die 1 ;} + +#qemu-system-x86_64 -drive format=raw,file=test.img + +#qemu-system-x86_64 -hda debian.qcow -m 640, file=test.img + +#qemu-system-x86_64 -hda ubuntu.qcow -boot d file=test.img -m 640 + +qemu-system-x86_64 -hda debian.qcow -boot d -cdrom debian-10.2.0-amd64-netinst.iso -m 640 \ No newline at end of file diff --git a/QA/common/qemu_ubuntu.sh b/QA/common/qemu_ubuntu.sh new file mode 100755 index 0000000..72fe8c5 --- /dev/null +++ b/QA/common/qemu_ubuntu.sh @@ -0,0 +1,9 @@ +#!/bin/sh + +die() { printf 'FATAL: %s\n' "$1" && exit 1 ;} + +[ ! -e ubuntu.qcow ] && { qemu-img create -f qcow2 ubuntu.qcow 20G || die 1 ;} + +wget http://releases.ubuntu.com/19.10/ubuntu-19.10-desktop-amd64.iso + +qemu-system-x86_64 -hda ubuntu.qcow -boot d -cdrom ubuntu-19.10-desktop-amd64.iso -m 640 \ No newline at end of file diff --git a/QA/docker/dockerfiles/Debian/debian_gcc.Dockerfile b/QA/docker/dockerfiles/Debian/debian_gcc.Dockerfile new file mode 100644 index 0000000..bec7dea --- /dev/null +++ b/QA/docker/dockerfiles/Debian/debian_gcc.Dockerfile @@ -0,0 +1,29 @@ +FROM debian/debian:testing + +USER root + +# Define libraries +RUN sh -c " \ +fixme() { printf 'FIXME: %s\n' "$1" ;} \ +warn() { printf 'WARN: %s\n' "$1" ;} \ +die() { \ + printf 'FATAL: %s\n' "$1" \ + exit 1 \ +}" + +# Install dependencies +RUN apt install -y meson cppcheck gcc libfuse3-dev gcc libcap-devgit ninja-build bison libtool autoconf pkg-config libcap-dev indent libattr1-dev fakeroot uthash-dev gzip rsync autopoint shellcheck || die "Unable to install all dependencies" + +# Install shfmt (Hack!) +RUN sh -c " \ +if [ "$(apt-cache search libfuse3-dev | grep -o "shfmt")" != "shfmt" ]; then \ + if [ ! -e /usr/bin/shfmt ]; then \ + wget https://github.com/mvdan/sh/releases/download/v3.0.0-beta1/shfmt_v3.0.0-beta1_linux_amd64 -O /usr/bin/shfmt \ + [ ! -x /usr/bin/shfmt ] && chmod +x /usr/bin/shfmt \ + elif [ ! -e /usr/bin/shfmt ]; then \ + fi \ +elif [ "$(apt-cache search libfuse3-dev | grep -o "shfmt")" = "shfmt" ]; then \ + apt install -y shfmt || die "Unable to install shfmt" \ +else \ + die "Unexpected happend in shfmt hack" \ +fi" \ No newline at end of file diff --git a/QA/docker/dockerfiles/Exherbo/exherbo_clang.Dockerfile b/QA/docker/dockerfiles/Exherbo/exherbo_clang.Dockerfile new file mode 100644 index 0000000..aeaa3e4 --- /dev/null +++ b/QA/docker/dockerfiles/Exherbo/exherbo_clang.Dockerfile @@ -0,0 +1,33 @@ +FROM exherbo/exherbo_ci:latest + +USER root + +# Export paludis-config +RUN rm -r /etc/paludis && git clone https://github.com/Kreyrock/paludis-config.git /etc/paludis + +# Sync repos +RUN cave sync + +# Add required repositories +RUN [ ! -e /etc/paludis/repositories/alip.conf ] && cave resolve -x1 repository/alip +RUN [ ! -e /etc/paludis/repositories/compnerd.conf ] && cave resolve -x1 repository/compnerd +RUN [ ! -e /etc/paludis/repositories/virtualization.conf ] && cave resolve -x1 repository/virtualization +RUN [ ! -e /etc/paludis/repositories/danyspin97.conf ] && cave resolve -x1 repository/danyspin97 +RUN [ ! -e /etc/paludis/repositories/python.conf ] && cave resolve -x1 repository/python +RUN [ ! -e /etc/paludis/repositories/perl.conf ] && cave resolve -x1 repository/perl +RUN [ ! -e /etc/paludis/repositories/hasufell.conf ] && cave resolve -x1 repository/hasufell + +# Install build dependencies +RUN cave resolve sys-devel/meson sys-devel/clang sys-fs/fuse dev-scm/git sys-devel/ninja sys-devel/bison sys-devel/libtool sys-devel/autoconf dev-util/pkg-config sys-apps/fakeroot app-arch/gzip net-misc/rsync sys-devel/autoconf -x + +# Install test dependencies +RUN cave resolve dev-util/cppcheck dev-util/indent dev-util/shellcheck -x + +# Purge unwanted packages +RUN cave purge -x + +# Remove build instructions +RUN sh -c " \ +if [ -d /var/db/paludis ]; then \ + rm -r /var/db/paludis || die "Unable to remove" +" \ No newline at end of file diff --git a/QA/docker/dockerfiles/Exherbo/exherbo_gcc.Dockerfile b/QA/docker/dockerfiles/Exherbo/exherbo_gcc.Dockerfile new file mode 100644 index 0000000..3b1e831 --- /dev/null +++ b/QA/docker/dockerfiles/Exherbo/exherbo_gcc.Dockerfile @@ -0,0 +1,30 @@ +FROM exherbo/exherbo_ci:latest + +USER root + +# Export paludis-config +RUN rm -r /etc/paludis && git clone https://github.com/Kreyrock/paludis-config.git /etc/paludis + +# Sync repos +RUN cave sync + +# Add required repositories +RUN [ ! -e /etc/paludis/repositories/alip.conf ] && cave resolve -x1 repository/alip +RUN [ ! -e /etc/paludis/repositories/compnerd.conf ] && cave resolve -x1 repository/compnerd +RUN [ ! -e /etc/paludis/repositories/virtualization.conf ] && cave resolve -x1 repository/virtualization +RUN [ ! -e /etc/paludis/repositories/danyspin97.conf ] && cave resolve -x1 repository/danyspin97 +RUN [ ! -e /etc/paludis/repositories/python.conf ] && cave resolve -x1 repository/python +RUN [ ! -e /etc/paludis/repositories/perl.conf ] && cave resolve -x1 repository/perl +RUN [ ! -e /etc/paludis/repositories/hasufell.conf ] && cave resolve -x1 repository/hasufell + +# Install build dependencies +RUN cave resolve sys-devel/meson sys-devel/gcc sys-fs/fuse dev-scm/git sys-devel/ninja sys-devel/bison sys-devel/libtool sys-devel/autoconf dev-util/pkg-config sys-apps/fakeroot app-arch/gzip net-misc/rsync sys-devel/autoconf -x + +# Install test dependencies +RUN cave resolve dev-util/cppcheck dev-util/indent dev-util/shellcheck -x + +# Purge unwanted packages +RUN cave purge -x + +# Remove build instructions +RUN rm -r /var/db/paludis \ No newline at end of file diff --git a/QA/sourcehut/README.md b/QA/sourcehut/README.md new file mode 100644 index 0000000..3af231d --- /dev/null +++ b/QA/sourcehut/README.md @@ -0,0 +1,3 @@ +This is legacy after sourcehut tests that are now blocked by https://github.com/RXT0112/Zernit/issues/51 + +We decided to stub this here since sourcehut it cool and we would like to use it if these problems are resolved. \ No newline at end of file diff --git a/QA/sourcehut/rustlang.yml b/QA/sourcehut/rustlang.yml new file mode 100644 index 0000000..b0ed5cc --- /dev/null +++ b/QA/sourcehut/rustlang.yml @@ -0,0 +1,26 @@ +image: archlinux +packages: + - meson + - scdoc + - wayland-protocols + - wlroots-git + - wayland + - libxkbcommon + - cairo + - cargo + - pango + - gdk-pixbuf2 + - pixman + - libinput + - xorg-server-xwayland +sources: + - https://github.com/RXT0112/Zernit +tasks: + - build: | + cd Zernit + if git --no-pager diff --name-only origin/master | grep -q ".*.rs$"; then cargo build; fi + complete-build + - bench: | + cd Zernit + if git --no-pager diff --name-only origin/master | grep -q ".*.rs$"; then cargo bench; fi + complete-build \ No newline at end of file diff --git a/QA/tests/HELL/README.md b/QA/tests/HELL/README.md new file mode 100644 index 0000000..1359301 --- /dev/null +++ b/QA/tests/HELL/README.md @@ -0,0 +1,13 @@ +# HELL - Quality assurance for (WIP name) + +Welcome to HELL! + +![](https://media.giphy.com/media/2U1WOzgmZVw2Y/giphy.gif) + +HELL is used for the quality assurance for (WIP name) + +FIXME: Documentation here + +TODO +- ban echo +- ban cd \ No newline at end of file diff --git a/QA/tests/HELL/backend/configure_backend.sh b/QA/tests/HELL/backend/configure_backend.sh new file mode 100755 index 0000000..e3d42e9 --- /dev/null +++ b/QA/tests/HELL/backend/configure_backend.sh @@ -0,0 +1,191 @@ +#!/bin/sh +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'before-install' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/before-install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +: ' + This file is used to configure backend depending on expected workflow. This is for example installing dependencies for tests. + + This file expects following variables: + - KERNEL = Used kernel (linux) + - VARIANT = Name of used distribution (debian) + - IDENTIFIER = name of codename or version ("bullseye" or "11") + + In case DOCKER images are used: + - DOCKER = Name of used docker container (exherbo/exherbo_ci:latest) + + In case QEMU is used: + - QEMU = Name of (FIXME, not implemented) + + TODO + - Implement building of DOCKER images + - Implement QEMU +' + +# Configure backend +if [ "$KERNEL" = linux ]; then + # Install all dependencies + info "Installing dependencies for on $KERNEL for $VARIANT-$IDENTIFIER" + + case "$VARIANT-$IDENTIFIER" in + ubuntu-bionic|ubuntu-18.04) + # Install all dependencies + apt install -y \ + meson cppcheck libcap-dev clang libfuse3-dev gcc git ninja-build bison libtool autoconf pkg-config libcap-dev indent fakeroot libattr1-dev uthash-dev gzip rsync autopoint uthash-dev shellcheck \ + || die "Unable to install all dependencies for $VARIANT-$IDENTIFIER" + + # libfuse3-dev hack + if [ "$(apt-cache search libfuse3-dev | grep -o "libfuse3-dev")" != "libfuse3-dev" ]; then + warn "libfuse3-dev is not available on $VARIANT-$IDENTIFIER, trying to resolve manually" + + apt install -y ninja-build || die 1 "Unable to install dependencies for hack" + + mkdir "$HOME/build/fuse3" + + fixme "Export latest fuse3 instead of hard-coded?" + if [ ! -e "$HOME/build/fuse3/fuse-3.6.2.tar.xz" ]; then + wget https://github.com/libfuse/libfuse/releases/download/fuse-3.6.2/fuse-3.6.2.tar.xz -O "$HOME/build/fuse3/fuse-3.6.2.tar.xz" || die 1 "Unable to fetch fuse" + elif [ -e "$HOME/build/fuse3/fuse-3.6.2.tar.xz" ]; then + info "File '$HOME/build/fuse3/fuse-3.6.2.tar.xz' is already fetched" + else + die 255 "Fetching fuse3 tarball" + fi + + fixme "Sanitize tarball export (do not export if the tarball already exists)" + tar xpf "$HOME/build/fuse3/fuse-3.6.2.tar.xz" --directory="$HOME/build/fuse3/" + + # FIXME: Sanitize - Do not create a build dir if it already exists + mkdir "$HOME/build/fuse3/fuse-3.6.2/build" + + fixme "Do not use 'cd'" + cd "$HOME/build/fuse3/fuse-3.6.2/build" || die 1 "Unable to change directory in '$HOME/build/fuse3/fuse-3.6.2/build'" + + meson .. --prefix /usr || die 1 "Meson failed, (FIXME: more info required)" + + ninja || die 1 "ninja failed, (FIXME: more info required)" + + ninja install || die 1 "ninja install failed, (FIXME: more info required)" + elif [ "$(apt-cache search libfuse3-dev | grep -o "libfuse3-dev")" = "libfuse3-dev" ]; then + info "libfuse3-dev is available on this $VARIANT-$IDENTIFIER, no need to install it manually" + apt install -y libfuse3-dev || die 1 "Unable to install libfuse3-dev" + else + die 255 "libfuse3-dev in $VARIANT" + fi + + # Hack fof shfmt + if [ "$(apt-cache search shfmt | grep -o "shfmt")" != "shfmt" ]; then + warn "This system doesn't have shfmt in build instructions, trying to resolve.." + + if [ -e /usr/bin/shfmt ]; then + info "shfmt is already installed, skipping hack" + + elif [ ! -e /usr/bin/shfmt ]; then + info "shfmt is not installed, installing.." + + # Sanitized in if statement's expression + wget https://github.com/mvdan/sh/releases/download/v3.0.0-beta1/shfmt_v3.0.0-beta1_linux_amd64 -O /usr/bin/shfmt + + # Make sure that it is executable + [ ! -x /usr/bin/shfmt ] && chmod +x /usr/bin/shfmt + else + die 255 "shfmt hack in $VARIANT" + fi + elif [ "$(apt-cache search shfmt | grep -o "shfmt")" = "shfmt" ]; then + info "shfmt is available on this $VARIANT, no need to install it manually" + apt install -y shfmt + else + die 255 "shfmt hack in ubuntu" + fi + ;; + ubuntu-*) + apt install -y \ + meson cppcheck libcap-dev clang libfuse3-dev gcc git ninja-build bison libtool autoconf pkg-config libcap-dev indent fakeroot libattr1-dev uthash-dev gzip rsync autopoint uthash-dev shellcheck \ + || die 1 "Unable to install all dependencies for $VARIANT-$IDENTIFIER" + + # Hack fof shfmt + if [ "$(apt-cache search shfmt | grep -o "shfmt")" != "shfmt" ]; then + warn "This system doesn't have shfmt in build instructions, trying to resolve.." + + if [ -e /usr/bin/shfmt ]; then + info "shfmt is already installed, skipping hack" + elif [ ! -e /usr/bin/shfmt ]; then + info "shfmt is not installed, installing.." + wget https://github.com/mvdan/sh/releases/download/v3.0.0-beta1/shfmt_v3.0.0-beta1_linux_amd64 -O /usr/bin/shfmt + [ ! -x /usr/bin/shfmt ] && chmod +x /usr/bin/shfmt + else + die 255 "shfmt hack in $VARIANT" + fi + elif [ "$(apt-cache search shfmt | grep -o "shfmt")" = "shfmt" ]; then + info "shfmt is available on this $VARIANT, no need to install it manually" + apt install -y shfmt + else + die 255 "shfmt hack in $VARIANT" + fi + ;; + *) die 2 "Unsupported VARIANT-IDENTIFIER - $VARIANT-$IDENTIFIER" + esac + + # Docker backend + if [ -n "$DOCKER" ]; then + info "Preparing the environment to run docker image '$DOCKER'" + + # Install docker dependencies + info "Installing dependencies for docker" + + case "$VARIANT-$IDENTIFIER" in + ubuntu*|debian*) + apt install -y docker-io || die 1 "Unable to install docker dependencies on $VARIANT-$IDENTIFIER" + ;; + *) die 2 "Unsupported VARIABLE-IDENTIFIER has been parsed in resoluting docker dependencies" + esac + + case "$VARIANT-$IDENTIFIER" in + debian*|ubuntu*|exherbo*) + docker run -d --name "$DOCKER" || die 1 "Unable to run docker image '$DOCKER' on $VARIANT-$IDENTIFIER" + ;; + *) die "Unsupported VARIANT-IDENTIFIER has been parsed - $VARIANT-$IDENTIRIER" + esac + + # Get docker image + case "$DOCKER_IMAGE" in + */*:*|*/*) # Fetch docker image from dockerhub + die fixme "Implement using docker images from dockerhub" + build_*) # Build docker images + info "Preparing to build docker image ${DOCKERIMAGE#build_}" + case ${DOCKER_IMAGE#build_} in + exherbo) + die fixme "Implement building exherbo docker image" + ;; + *) die 255 "DOCKER_IMAGE - build" + esac + ;; + *) die 255 "DOCKER_IMAGE" + esac + + # In case Docker is not used + elif [ -z "$DOCKER" ]; then + info "Docker is not used, skipping configuration" + else + die 255 "Docker backend in $KERNEL" + fi + + if [ -n "$QEMU" ]; then + die fixme "Implement tests on QEMU using linux" + elif [ -z "$QEMU" ]; then + info "QEMU is not used, skipping configuration" + else + die 255 "QEMU in $KERNEL" + fi + +elif [ "$KERNEL" = darwin ]; then + # Homebrew takes lots of time on runtime due to the cleanup used, this is a hotfix (https://travis-ci.community/t/macosx-brew-update-takes-too-much-time/6295) + HOMEBREW_NO_INSTALL_CLEANUP=1 brew update || die "Unable to update brew repositories" + + info "Installing dependencies on $KERNEL" + brew install shellcheck cppcheck shfmt || die "Unable to install dependencies on $KERNEL" +elif [ "$KERNEL" = freebsd ]; then + fixme "$KERNEL is not implemented" +else + die "Unsupported KERNEL used - $KERNEL" +fi \ No newline at end of file diff --git a/QA/tests/HELL/backend/get-variables.sh b/QA/tests/HELL/backend/get-variables.sh new file mode 100755 index 0000000..a9ac51d --- /dev/null +++ b/QA/tests/HELL/backend/get-variables.sh @@ -0,0 +1,18 @@ +#!/bin/sh +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'before-install' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/before-install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +# Get KERNEL Variable +if [ -z "$KERNEL"]; then + case "$(uname -s)" in + Linux) KERNEL=linux ;; + Darwin KERNEL=darwin ;; + *) die 255 "Unsupported output of 'uname -s' has been parsed - $(uname -s)" + esac +elif [ -n "$KERNEL"]; then + warn "Variable 'KERNEL' is overwritten on '$KERNEL'" +else + die 255 "Getting KERNEL variable" +fi \ No newline at end of file diff --git a/QA/tests/HELL/backend/output.sh b/QA/tests/HELL/backend/output.sh new file mode 100755 index 0000000..143dc41 --- /dev/null +++ b/QA/tests/HELL/backend/output.sh @@ -0,0 +1,72 @@ +#!/bin/sh +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'before-install' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/before-install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +: ' + This file is used for sourcing + + Used for output of various messages + - die Outputs a message and exits + - warn Output a warning + - info Output info +' + +# Outputs a message and exits +# SYNOPSIS: die [num] (message) +die() { + err_code="$1" + message="$2" + + case "$err_code" in + 0) true ;; + 1) + if [ -z "$message" ]; then + case $LANG in + en*) printf 'FATAL: %s\n' "Script returned true" ;; + # Do not transtale, default message + *) printf 'FATAL: %s\n' "Script returned true" + esac + elif [ -n "$message" ]; then + case $LANG in + en*) printf 'FATAL: %s\n' "$mesage" ;; + # Do not transtale, default message + *) printf 'FATAL: %s\n' "$message" + esac + else + printf 'FATAL: %s\n' "Unexpected happend in die 1" + exit 255 + fi + exit $err_code + ;; + 3) + # FIXME: Implement translate + # FIXME: Implement message handling + printf 'FATAL: %s\n' "This script is expected to be invoked as root" + ;; + 255) + # FIXME: Implement translate + # FIXME: Implement output for blank $message + + printf 'FATAL: %s\n' "Unexpected happend in $message" + exit $err_code + ;; + fixme) + # FIXME: Translate + # FIXME: Handle scenarios where message is not parsed + printf 'FIXME: $s\n' "$message" + ;; + *) printf 'FATAL: %s\n' "Unexpected argument '$err_code' has been parsed in 'die()'" ; exit 255 + esac + + unset err_code message +} + +warn() { printf 'WARN: %s\n' "$1" ;} +info() { printf 'INFO: %s\n' "$1" ;} +fixme() { + case $1 in + *) printf 'FIXME: %s\n' "$2" + esac +} \ No newline at end of file diff --git a/QA/tests/HELL/hell.sh b/QA/tests/HELL/hell.sh new file mode 100755 index 0000000..57a5fd6 --- /dev/null +++ b/QA/tests/HELL/hell.sh @@ -0,0 +1,17 @@ +#!/bin/sh +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'before-install' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/before-install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +# NOT_PRODUCTION_READY +printf 'WARN: %s\n' "This file is not production ready, USE ON YOUR OWN RISK!" + +# Get output messages +. QA/tests/HELL/backend/output.sh + +# Get Variables +. QA/tests/HELL/backend/get-variables.sh + +# Configure backend +. QA/tests/HELL/backend/configure_backend.sh \ No newline at end of file diff --git a/QA/tests/README.md b/QA/tests/README.md new file mode 100644 index 0000000..179a3fd --- /dev/null +++ b/QA/tests/README.md @@ -0,0 +1,5 @@ +# Quality Assurance of (WIP name) + +- Check for `shift` and force `shift 1` +- https://github.com/koalaman/shellcheck/wiki/Directive#source -> Check shellcheck version +- Force using '$var' instead of '${var}' where possible diff --git a/QA/tests/backend.sh b/QA/tests/backend.sh new file mode 100644 index 0000000..08a2b24 --- /dev/null +++ b/QA/tests/backend.sh @@ -0,0 +1,274 @@ +#!/bin/sh +# shellcheck disable=SC1117 +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'before-install' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/before-install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +: ' + This file expects following variables: + - KERNEL = Used kernel + - VARIANT = Name of used distribution (lower-case) + - IDENTIFIER = name of codename or version + + In case DOCKER images are used: + - DOCKER = Name of used docker container + + In case QEMU is used: + - QEMU = Name of (FIXME, not implemented) + + TODO + - Implement building of DOCKER images +' + +# SYNOPSIS: die [num] (message) +die() { + err_code="$1" + message="$2" + + case "$err_code" in + 0) true ;; + 1) + if [ -z "$message" ]; then + case $LANG in + en*) printf 'FATAL: %s\n' "Script returned true" ;; + # Do not transtale, default message + *) printf 'FATAL: %s\n' "Script returned true" + esac + elif [ -n "$message" ]; then + case $LANG in + en*) printf 'FATAL: %s\n' "$mesage" ;; + # Do not transtale, default message + *) printf 'FATAL: %s\n' "$message" + esac + else + printf 'FATAL: %s\n' "Unexpected happend in die 1" + exit 255 + fi + exit $err_code + ;; + 3) + # FIXME: Implement translate + # FIXME: Implement message handling + printf 'FATAL: %s\n' "This script is expected to be invoked as root" + ;; + 255) + # FIXME: Implement translate + # FIXME: Implement output for blank $message + + printf 'FATAL: %s\n' "Unexpected happend in $message" + exit $err_code + ;; + fixme) + # FIXME: Translate + # FIXME: Handle scenarios where message is not parsed + printf 'FIXME: $s\n' "$message" + ;; + *) printf 'FATAL: %s\n' "Unexpected argument '$err_code' has been parsed in 'die()'" ; exit 255 + esac + + unset err_code message +} + +warn() { printf 'WARN: %s\n' "$1" ;} +info() { printf 'INFO: %s\n' "$1" ;} +fixme() { + case $1 in + *) printf 'FIXME: %s\n' "$2" + esac +} + +# Configure backend +if [ "$KERNEL" = linux ]; then + # Install all dependencies + info "Installing dependencies for on $KERNEL for $VARIANT-$IDENTIFIER" + + case "$VARIANT-$IDENTIFIER" in + ubuntu-bionic|ubuntu-18.04) + # Install all dependencies + apt install -y \ + meson cppcheck libcap-dev clang libfuse3-dev gcc git ninja-build bison libtool autoconf pkg-config libcap-dev indent fakeroot libattr1-dev uthash-dev gzip rsync autopoint uthash-dev shellcheck \ + || die "Unable to install all dependencies for $VARIANT-$IDENTIFIER" + + # libfuse3-dev hack + if [ "$(apt-cache search libfuse3-dev | grep -o "libfuse3-dev")" != "libfuse3-dev" ]; then + warn "libfuse3-dev is not available on $VARIANT-$IDENTIFIER, trying to resolve manually" + + apt install -y ninja-build || die 1 "Unable to install dependencies for hack" + + mkdir "$HOME/build/fuse3" + + fixme "Export latest fuse3 instead of hard-coded?" + if [ ! -e "$HOME/build/fuse3/fuse-3.6.2.tar.xz" ]; then + wget https://github.com/libfuse/libfuse/releases/download/fuse-3.6.2/fuse-3.6.2.tar.xz -O "$HOME/build/fuse3/fuse-3.6.2.tar.xz" || die 1 "Unable to fetch fuse" + elif [ -e "$HOME/build/fuse3/fuse-3.6.2.tar.xz" ]; then + info "File '$HOME/build/fuse3/fuse-3.6.2.tar.xz' is already fetched" + else + die 255 "Fetching fuse3 tarball" + fi + + fixme "Sanitize tarball export (do not export if the tarball already exists)" + tar xpf "$HOME/build/fuse3/fuse-3.6.2.tar.xz" --directory="$HOME/build/fuse3/" + + # FIXME: Sanitize - Do not create a build dir if it already exists + mkdir "$HOME/build/fuse3/fuse-3.6.2/build" + + fixme "Do not use 'cd'" + cd "$HOME/build/fuse3/fuse-3.6.2/build" || die 1 "Unable to change directory in '$HOME/build/fuse3/fuse-3.6.2/build'" + + meson .. --prefix /usr || die 1 "Meson failed, (FIXME: more info required)" + + ninja || die 1 "ninja failed, (FIXME: more info required)" + + ninja install || die 1 "ninja install failed, (FIXME: more info required)" + elif [ "$(apt-cache search libfuse3-dev | grep -o "libfuse3-dev")" = "libfuse3-dev" ]; then + info "libfuse3-dev is available on this $VARIANT-$IDENTIFIER, no need to install it manually" + apt install -y libfuse3-dev || die 1 "Unable to install libfuse3-dev" + else + die 255 "libfuse3-dev in $VARIANT" + fi + + # Hack fof shfmt + if [ "$(apt-cache search shfmt | grep -o "shfmt")" != "shfmt" ]; then + warn "This system doesn't have shfmt in build instructions, trying to resolve.." + + if [ -e /usr/bin/shfmt ]; then + info "shfmt is already installed, skipping hack" + + elif [ ! -e /usr/bin/shfmt ]; then + info "shfmt is not installed, installing.." + + # Sanitized in if statement's expression + wget https://github.com/mvdan/sh/releases/download/v3.0.0-beta1/shfmt_v3.0.0-beta1_linux_amd64 -O /usr/bin/shfmt + + # Make sure that it is executable + [ ! -x /usr/bin/shfmt ] && chmod +x /usr/bin/shfmt + else + die 255 "shfmt hack in $VARIANT" + fi + elif [ "$(apt-cache search shfmt | grep -o "shfmt")" = "shfmt" ]; then + info "shfmt is available on this $VARIANT, no need to install it manually" + apt install -y shfmt + else + die 255 "shfmt hack in ubuntu" + fi + ;; + ubuntu-*) + apt install -y \ + meson cppcheck libcap-dev clang libfuse3-dev gcc git ninja-build bison libtool autoconf pkg-config libcap-dev indent fakeroot libattr1-dev uthash-dev gzip rsync autopoint uthash-dev shellcheck \ + || die 1 "Unable to install all dependencies for $VARIANT-$IDENTIFIER" + + # Hack fof shfmt + if [ "$(apt-cache search shfmt | grep -o "shfmt")" != "shfmt" ]; then + warn "This system doesn't have shfmt in build instructions, trying to resolve.." + + if [ -e /usr/bin/shfmt ]; then + info "shfmt is already installed, skipping hack" + elif [ ! -e /usr/bin/shfmt ]; then + info "shfmt is not installed, installing.." + wget https://github.com/mvdan/sh/releases/download/v3.0.0-beta1/shfmt_v3.0.0-beta1_linux_amd64 -O /usr/bin/shfmt + [ ! -x /usr/bin/shfmt ] && chmod +x /usr/bin/shfmt + else + die 255 "shfmt hack in $VARIANT" + fi + elif [ "$(apt-cache search shfmt | grep -o "shfmt")" = "shfmt" ]; then + info "shfmt is available on this $VARIANT, no need to install it manually" + apt install -y shfmt + else + die 255 "shfmt hack in $VARIANT" + fi + ;; + *) die 2 "Unsupported VARIANT-IDENTIFIER - $VARIANT-$IDENTIFIER" + esac + + # Docker backend + if [ -n "$DOCKER" ]; then + info "Preparing the environment to run docker image '$DOCKER'" + + # Install docker dependencies + info "Installing dependencies for docker" + + case "$VARIANT-$IDENTIFIER" in + ubuntu*|debian*) + apt install -y docker-io || die 1 "Unable to install docker dependencies on $VARIANT-$IDENTIFIER" + ;; + *) die 2 "Unsupported VARIABLE-IDENTIFIER has been parsed in resoluting docker dependencies" + esac + + case "$VARIANT-$IDENTIFIER" in + debian*|ubuntu*|exherbo*) + docker run -d --name "$DOCKER" || die 1 "Unable to run docker image '$DOCKER' on $VARIANT-$IDENTIFIER" + ;; + *) die "Unsupported VARIANT-IDENTIFIER has been parsed - $VARIANT-$IDENTIRIER" + esac + + # Get docker image + case "$DOCKER_IMAGE" in + */*:*|*/*) # Fetch docker image from dockerhub + die fixme "Implement using docker images from dockerhub" + build_*) # Build docker images + info "Preparing to build docker image ${DOCKERIMAGE#build_}" + case ${DOCKER_IMAGE#build_} in + exherbo) + die fixme "Implement building exherbo docker image" + ;; + *) die 255 "DOCKER_IMAGE - build" + esac + ;; + *) die 255 "DOCKER_IMAGE" + esac + + # In case Docker is not used + elif [ -z "$DOCKER" ]; then + info "Docker is not used, skipping configuration" + else + die 255 "Docker backend in $KERNEL" + fi + + if [ -n "$QEMU" ]; then + die fixme "Implement tests on QEMU using linux" + elif [ -z "$QEMU" ]; then + info "QEMU is not used, skipping configuration" + else + die 255 "QEMU in $KERNEL" + fi + +elif [ "$KERNEL" = darwin ]; then + # Homebrew takes lots of time on runtime due to the cleanup used, this is a hotfix (https://travis-ci.community/t/macosx-brew-update-takes-too-much-time/6295) + HOMEBREW_NO_INSTALL_CLEANUP=1 brew update || die "Unable to update brew repositories" + + info "Installing dependencies on $KERNEL" + brew install shellcheck cppcheck shfmt || die "Unable to install dependencies on $KERNEL" +elif [ "$KERNEL" = freebsd ]; then + fixme "$KERNEL is not implemented" +else + die "Unsupported KERNEL used - $KERNEL" +fi + +# Run tests +if [ "$TEST" = core ]; then + info "Performing core tests.." + make check || die 1 "Tests failed" +elif [ "$TEST" = extensive ]; then + info "Performing extensive tests" + fixme "Implement extensive tests" + make fullcheck || die 1 "Tests failed" +elif [ "$TEST" = skip ]; then + info "Variable 'TEST' stores value 'skip', skipping tests" +elif [ "$TEST" = '' ]; then + warn "Variable 'TEST' is not set, skipping tests" +else + die 255 "Performing tests" +fi + +# Build +if [ "$BUILD" = all ]; then + info "Performing build on kernel '$KERNEL' using $VARIANT-$IDENTIFIER" + make SKIPSIGN=true || die 1 "Build failed" +elif [ "$BUILD" = skip ]; then + info "Variable 'BUILD' stores valie 'skip', skipping build" +elif [ "$BUILD" = '' ]; then + warn "Variable 'BUILD' is not set, skipping build" +else + die 255 "Building on $KERNEL" +fi \ No newline at end of file diff --git a/QA/tests/check.sh b/QA/tests/check.sh new file mode 100755 index 0000000..fdcd1b1 --- /dev/null +++ b/QA/tests/check.sh @@ -0,0 +1,116 @@ +#!/bin/sh + +die() { + err_code="$1" + message="$2" + + case $err_code in + 1) + printf 'FATAL: %s\n' "$message" + exit "$err_code" + ;; + lintfail) + printf 'FATAL: %s\n' "Linting file '$file', failed.." + exit 1 + ;; + 255) + printf 'FATAL: %s\n' "$message" + exit "$err_code" + ;; + *) + printf 'FATAL: %s\n' "Unrecognized error code argument has been parsed in die function in QA/tests/shell/check.sh" + exit 255 + esac + + unset err_code message +} + +fixme() { + argument="$1" + + case $argument in + LintNotImplemented) printf 'FIXME: %s\n' "Unable to check file '$file', $identifier linting is not implemented" ;; + *) printf 'FIXME: %s\n' "$*" + esac + + unset argument +} + +# shellcheck disable=SC2044 # HOTFIX! +for file in $(find . -not \( \ +-path './.git' -prune -o \ +-path './vendor' -prune -o \ +-name 'LICENSE' -prune -o \ +-name '.gitignore' -prune -o \ +-name 'os-release' -prune -o \ +-name '.keepinfodir' -prune -o \ +-name 'include-bedrock' -prune -o \ +-name 'lock' -prune \ +\) -type f); do + + # Identify file + # FIXME: In theory we can use 'file' for this instead + case "$file" in + *.c) identifier="C" ;; + *.sh) identifier="shell" ;; + *.bash) identifier="bash" ;; + *.yml) identifier="yaml" ;; + *.md) identifier="markdown" ;; + *.png) identifier="png" ;; + *.zsh) identifier="zsh" ;; + *.conf) identifier="config" ;; + *.fish) identifier="fish" ;; + *.gpg) identifier="gpg" ;; + *.service) identifier="service" ;; + *.donotcheck|*.disabled) identifier="DoNotCheck" ;; + *.json) identifier="json" ;; + *.Dockerfile) identifier="dockerfile" ;; + *.xml) identifier="xml" ;; + *.fetchnext) identifier="fetchnext" ;; + */Makefile) identifier="makefile" ;; + *.bak) identifier="backup" ;; + *) + case "$(head -n1 "$file")" in + '#!/'*'/bash'|'#!/'*' bash') identifier="bash" ;; + '#!/'*'/sh'|'#!/'*' sh') identifier="shell" ;; + '#compdef'*) identifier="zsh" ;; + *) die 255 "Unexpected file '$file' has been parsed in tests, unable to resolve for tests" + esac + esac + + # Output message about checked file + printf "checking $identifier file %s\\n" "${file#./}" + + # Test file based on identifier + case "$identifier" in + C) + cppcheck --error-exitcode=1 "$file" || die lintfail + ;; + markdown|yaml|config|makefile|service|gpg|json|xml|dockerfile) + fixme LintNotImplemented + ;; + backup|png) + true # Do not check these + ;; + DoNotCheck) + printf 'INFO: %s\n' "File $file is set to be ignored by tests" + ;; + fetchnext) + printf 'INFO: %s\n' "fetchnext files are stub" + ;; + bash) + shellcheck -x -s bash "$file" || die lintfail + ;; + shell) + shellcheck -x -s bash "$file" || die lintfail + ;; + zsh) + # zsh are apparently tested agains bash in shellcheck (FIXME: Sanity-check) + shellcheck -x -s bash "$file" || die lintfail + ;; + fish) + fixme LintNotImplemented + ;; + *) die 255 "Unknown identifier for file '$file' has been parsed, unable to resolve.." + esac +done \ No newline at end of file diff --git a/QA/tests/shell/shellizator.bash.disabled b/QA/tests/shell/shellizator.bash.disabled new file mode 100755 index 0000000..06b8fef --- /dev/null +++ b/QA/tests/shell/shellizator.bash.disabled @@ -0,0 +1,25 @@ +#!/usr/bin/env bash +# This file has to be bash since we are using non-POSIX regex + # Make it POSIX-compatible - using awk? perl? + +# shellcheck source=src/slash-bedrock/lib/shell/common-code.sh +. /bedrock/lib/shell/common-code.sh + +file="$1" +syntax_err="$2" + +# Die if more then one argument has been parsed +[ -n "$syntax_err" ] && die 1 "Wrong argumnet '$syntax_err' has been parsed in 'shellizator.sh'" + +# Shift arguments +while [ $# -gt 1 ]; do shift 1; done + +# Convert ${var} -> $var where possible (https://regex101.com/r/J7vfQC/5) +sed -i -E 's:([\/\=\ \"\>\-]|^)(\$)\{([a-zA-Z0-9_]+)\}([\,\ \"\n\,\/\!\:\\\-\.]):\1\2\3\4:' "$file" || die 1 "Unable to convert '\${var}' to '\$var' in $file" + +# Convert `if [ "${TRAVIS_OS_NAME}" == "linux" -a "${DOCKER}" == "" -a "${QEMU}" == "" ] ; then` in `if [ "${TRAVIS_OS_NAME}" == "linux" ] && [ "${DOCKER}" == "" ] && [ "${QEMU}" == "" ] ; then` + +fixme "Implement shellizator if fixing" + +# Remove unnecesary spaces in if statements after the `]` and before 'then' (https://regex101.com/r/XhNCZd/1) +sed -i -E 's:(if[^;]+)\s(\;\sthen):\1\2:gm' "$file" || die 1 "Unable to remove unnecesary spaces in if statements" diff --git a/QA/travis-ci/before-install.sh b/QA/travis-ci/before-install.sh new file mode 100755 index 0000000..37676bf --- /dev/null +++ b/QA/travis-ci/before-install.sh @@ -0,0 +1,214 @@ +#!/bin/bash +# shellcheck disable=SC1117 +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'before-install' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/before-install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +# shellcheck source=QA/travis-ci/travis-common.sh +. "QA/travis-ci/travis-common.sh" + +# shellcheck source=QA/travis-ci/get-container.sh +. "QA/travis-ci/get-container.sh" + +fixme "Travis - before-install.sh disables SC1117 as hotfix" + +# Linux as-is +if [ "$TRAVIS_OS_NAME" = linux ] && [ -z "$DOCKER" ] && [ -z "$QEMU" ]; then + + # Nothing else to do + true + +# Linux via Docker +elif [ "$TRAVIS_OS_NAME" = linux ] && [ -n "$DOCKER" ] && [ -z "$QEMU" ]; then + # The build machine therefore needs a sufficient amount of RAM! + [ -e "$CONTAINER" ] && sudo docker rm -f "$CONTAINER" + sudo docker run -d \ + --name "$CONTAINER" \ + --tmpfs /var/cache/pbuilder:rw,exec,dev,size=4g \ + --tmpfs /var/lib/mock:rw,exec,dev,size=4g \ + --cap-add=SYS_ADMIN --cap-add=NET_ADMIN \ + --security-opt apparmor:unconfined \ + -v "$(pwd):/travis" -w /travis \ + "$DOCKER" tail -f /dev/null + sudo docker ps + +# Exherbo via Docker +elif [ "$TRAVIS_OS_NAME" = 'Exherbo Linux' ] && [ -n "$DOCKER" ] && [ -z "$QEMU" ]; then + # The build machine therefore needs a sufficient amount of RAM! + [ -e "$CONTAINER" ] && sudo docker rm -f "$CONTAINER" + + # Run docker + sudo docker run -d \ + --name "$CONTAINER" \ + --cap-add=SYS_ADMIN --cap-add=NET_ADMIN \ + --security-opt apparmor:unconfined \ + -v "$(pwd):/travis" -w /travis \ + +# FreeBSD via QEMU +# QA: Convert on POSIX-compatible +elif [ "$TRAVIS_OS_NAME" = linux ] && [ "$QEMU" = FreeBSD ]; then + + if [ -n "$VARIANT" ]; then + sudo mkdir -p /vservers/qemu-freebsd + sudo chown "$USER:$USER" /vservers/qemu-freebsd + mkdir -p /vservers/qemu-freebsd/mnt + cd /vservers/qemu-freebsd || die "Unable to change directory in '/vservers/qemu-freebsd'" + + # Download image + imageName="FreeBSD-$VARIANT-amd64.raw" + if [ -e "$imageName.xz" ] && [ ! -e "$imageName" ]; then + printf '%s\n' "Extracting existing $imageName.xz ..." + xz -T0 -dk "$imageName.xz" + elif [ ! -e "$imageName.xz" ] || [ ! -e "$imageName" ]; then + imageURL="https://download.freebsd.org/ftp/releases/VM-IMAGES/$VARIANT/amd64/Latest/$imageName.xz" + info "Downloading FreeBSD VM image from $imageURL ..." + curl "$imageURL" | tee "$imageName.xz.tmp" | xz -T0 -d - ">$imageName" + mv "$imageName.xz.tmp" "$imageName.xz" || die "Unable to rename $imageName.xz.tmp in $imageName.xz" + fi + + # Modify FreeBSD image + pushd /vservers/qemu-freebsd/ + + # Grow image + truncate -s 128G "$imageName" + echo -e "w\nY\nY\n" | LANG=C gdisk "$imageName" + parted -s "$imageName" resizepart 3 100% + parted -s "$imageName" print + + # Mount + ls -l "$imageName" + mountPoint="$(pwd)/mnt" + + sudo umount "$mountPoint" 2>/dev/null || true + LOOPDEVS="$(sudo losetup -j "$imageName" | awk '{ print $1 }' | sed -e "s/:$//g")" + for loopdev in $LOOPDEVS ;do + sudo losetup -d "$loopdev" || true + done + + sudo losetup -P -f "$imageName" + sudo losetup -j "$imageName" + LOOPDEV="$(sudo losetup -j "$imageName" | awk '{ print $1 }' | sed -e "s/:$//g")" + + echo "sudo fuse-ufs2/fuse-ufs/fuse-ufs ${LOOPDEV}p3 $mountPoint -o rw" + sudo fuse-ufs2/fuse-ufs/fuse-ufs "${LOOPDEV}p3" "$mountPoint" -o rw + + # Modify + # Set up networking: + sudo cp "$mountPoint/etc/rc.conf" . + sudo bash -c "( + echo \"sshd_enable=\\\"YES\\\"\" + echo \"ifconfig_vtnet0=\\\"DHCP\\\"\" + echo \"ifconfig_vtnet1=\\\"inet 192.168.100.100 netmask 255.255.255.0\\\"\" + echo \"nfs_client_enable=\\\"YES\\\"\" + echo \"rpc_lockd_enable=\\\"YES\\\"\" + echo \"rpc_statd_enable=\\\"YES\\\"\" + ) >>$mountPoint/etc/rc.conf" + + # Make sure that FreeBSD uses the latest packages: + sudo sed -e 's#"pkg+http://pkg.FreeBSD.org/${ABI}/quarterly"#"pkg+http://pkg.FreeBSD.org/${ABI}/latest"#g' -i "$mountPoint/etc/pkg/FreeBSD.conf" + + # Make sure that the /usr/ports directory is there. + sudo mkdir -p "$mountPoint/usr/ports" + + # Add SSH public key authentication: + sudo mkdir -p "$mountPoint/root/.ssh" + sudo chmod 700 "$mountPoint/root/.ssh" + if [ ! -e "$HOME/.ssh/id_rsa" ]; then + ssh-keygen -t rsa -b 4096 -P "" -f "$HOME/.ssh/id_rsa" + fi + sudo cp "$HOME/.ssh/id_rsa.pub" "$mountPoint/root/.ssh/authorized_keys" + sudo chmod 600 "$mountPoint/root/.ssh/authorized_keys" + + sudo bash -c "echo \"PermitRootLogin prohibit-password\" >>$mountPoint/etc/ssh/sshd_config" + # sudo tail -n 6 ${mountPoint}/etc/ssh/sshd_config + + # Set up NFS: + sudo mkdir -p "$mountPoint/travis" + sudo sed -e "/^.*\/travis.*$/d" -i~ "$mountPoint/etc/fstab" + sudo bash -c "( echo \"192.168.100.1:/travis /travis nfs rw,soft,async,noatime,nfsv3,rsize=65536,wsize=65536 0 0\" ; echo \"tmpfs /usr/ports tmpfs rw 0 0\" ) >>$mountPoint/etc/fstab" + sudo cat "$mountPoint/etc/fstab" + + # Unmount + sudo umount "$mountPoint" + sudo losetup -d "$LOOPDEV" + + popd + + # Host-only networking + sudo ip link add br0 type bridge || true + sudo ip addr flush dev br0 + sudo ip addr add 192.168.100.1/24 brd 192.168.100.255 dev br0 + sudo ip tuntap add mode tap + sudo ip link set tap0 master br0 + sudo ip link set dev br0 up + sudo ip link set dev tap0 up + sudo iptables -A INPUT -i tap0 -s 192.168.100.0/24 -j ACCEPT + sudo iptables -A OUTPUT -o tap0 -d 192.168.100.0/24 -j ACCEPT + sudo iptables -A INPUT -i br0 -s 192.168.100.0/24 -j ACCEPT + sudo iptables -A OUTPUT -o br0 -d 192.168.100.0/24 -j ACCEPT + sudo iptables -A FORWARD -s 192.168.100.0/24 -d 192.168.100.0/24 + # sudo dnsmasq --interface=br0 --bind-interfaces \ + # --dhcp-range=192.168.100.2,192.168.100.254 || true + + + # NFS + sudo mkdir -p /travis + sudo mount --bind "$(pwd)" /travis + sudo bash -c "echo \"/travis 192.168.100.0/24(rw,no_root_squash)\" >/etc/exports" + env LANG=C.UTF-8 ci/retry -t "$RETRY_MAXTRIALS" -p "$RETRY_PAUSE" -- sudo apt-get install -y qemu-kvm nfs-kernel-server + sudo exportfs -v + sudo service nfs-kernel-server restart + + # ====== Start VM ===================================================== + sudo killall -q qemu-system-x86_64 || true + ssh-keygen -R "[localhost]:8829" -f ~/.ssh/known_hosts + # Non-KVM execution: qemu-system-x86_64 \ + sudo qemu-system-x86_64 -machine type=pc,accel=kvm -nographic \ + -m 6144 -cpu host -smp "$(nproc)" \ + -drive "if=virtio,media=disk,file=/vservers/qemu-freebsd/$imageName,format=raw" \ + -netdev user,id=mynet0,hostfwd=tcp:127.0.0.1:8829-:22 -device virtio-net-pci,netdev=mynet0 \ + -netdev tap,id=network0,ifname=tap0,script=no,downscript=no -device virtio-net-pci,netdev=network0,mac=00:00:00:00:00:00 \ + & + + ready=0 + trials=20 ; sleep=15 + i=0 ; while [ "$i" -lt "$trials" ]; do + # QA: Convert on POSIX compatible + # shellcheck disable=2219 + let i=$i+1 + echo "$i/$trials: Waiting for VM to boot ..." + sleep "$sleep" + if ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost hostname; then + ready=1 + break + fi + done + if [ $ready -eq 0 ]; then + echo >&2 "VM did not boot properly!" + exit 1 + fi + + # Download fuse-ufs2 + # if [ ! -d fuse-ufs2/ ]; then + # info "Downloading fuse-ufs2 ..." + # git clone https://github.com/dreibh/fuse-ufs2 -b dreibh/ubuntu-disco-fix + # # git clone https://github.com/mkatiyar/fuse-ufs2 + # fi + + # Get repository + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + git clone https://github.com/Kreyrock/Kreyrock.git + + unset imageName imageURL + fi + +# MacOS X +elif [ "$TRAVIS_OS_NAME" = osx ]; then + + # Nothing to be done here. + true + +else + die "Invalid setting of TRAVIS_OS_NAME=$TRAVIS_OS_NAME, DOCKER=$DOCKER, QEMU=$QEMU!" +fi diff --git a/QA/travis-ci/build.sh b/QA/travis-ci/build.sh new file mode 100755 index 0000000..f48ff9d --- /dev/null +++ b/QA/travis-ci/build.sh @@ -0,0 +1,36 @@ +#!/usr/bin/env bash +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later + +# shellcheck source=QA/travis-ci/travis-common.sh +. "QA/travis-ci/travis-common.sh" + +# shellcheck source=QA/travis-ci/get-container.sh +. "QA/travis-ci/get-container.sh" + +# Skip build if not set up +case "$TOOL" in + *build*) true ;; + *) die 0 "Skipping build as instructed" +esac + +# Linux as-is +if [ "$TRAVIS_OS_NAME" = linux ] && [ -z "$DOCKER" ] && [ -z "$QEMU" ]; then + make --directory="/travis/Zernit" build-rustlang + +# Linux via Docker +elif [ "$TRAVIS_OS_NAME" = linux ] && [ -n "$DOCKER" ] && [ -z "$QEMU" ]; then + sudo docker exec "$CONTAINER" make --directory="/travis/Zernit" build-rustlang + +# MacOS X +elif [ "$TRAVIS_OS_NAME" = osx ]; then + make build-rustlang + +elif [ "$TRAVIS_OS_NAME" = "linux" ] && [ "$QEMU" = "FreeBSD" ]; then + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + make check + +else + die "Invalid setting of TRAVIS_OS_NAME=$TRAVIS_OS_NAME, DOCKER=$DOCKER, QEMU=$QEMU!" + +fi diff --git a/QA/travis-ci/get-container.sh b/QA/travis-ci/get-container.sh new file mode 100644 index 0000000..f73b9d2 --- /dev/null +++ b/QA/travis-ci/get-container.sh @@ -0,0 +1,36 @@ +#!/bin/sh +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'before-install' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/before-install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +# shellcheck source=QA/travis-ci/travis-common.sh +. "QA/travis-ci/travis-common.sh" + +if [ -n "$DOCKER" ]; then + + # Check configuration + if [ -z "$VARIANT" ] ; then + die "Variable VARIANT is not set" + fi + if [ -z "$TOOL" ] ; then + die "Variable TOOL is not set" + fi + + # Get name of package + fixme "Output package name based on repository name" + PACKAGE="Zernit" + + # Set container name + CONTAINER=$(printf '%s\n' "$PACKAGE-$DOCKER-$TOOL" | sed -e "s/:/_/g") + if [ -n "$COMPILER_C" ]; then + CONTAINER="$CONTAINER-$COMPILER_C" + fi + export CONTAINER + +elif [ -z "$DOCKER" ]; then + info "Docker is not used" + +else + die 256 "Unexpected happend while processing DOCKER variable" +fi diff --git a/QA/travis-ci/install.sh b/QA/travis-ci/install.sh new file mode 100755 index 0000000..f2281d1 --- /dev/null +++ b/QA/travis-ci/install.sh @@ -0,0 +1,132 @@ +#!/usr/bin/env bash +# shellcheck disable=SC1117 +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'install.sh' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/install), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +# shellcheck source=QA/travis-ci/travis-common.sh +. "QA/travis-ci/travis-common.sh" + +# shellcheck source=QA/travis-ci/get-container.sh +. "QA/travis-ci/get-container.sh" + +fixme "Travis - install.sh is disabling SC1117 as hotfix" + +# Linux as-is +if [ "$TRAVIS_OS_NAME" = linux ] && [ -z "$DOCKER" ] && [ -z "$QEMU" ]; then + + # Update repositories based on available package manager + if command -v apt >/dev/null; then + sudo apt update || die 1 "Unable to update repositories on VARIANT '$VARIANT'" + elif command -v cave >/dev/null; then + cave sync || die 1 "Unable to update repositories on paludis" + else + die 256 "Unsupported package manager has been used" + fi + + # Install dependencies based on variant used + case "$VARIANT" in + ubuntu-*|debian-*) + # Install dependencies + if [ -n "$PACKAGES" ]; then + sudo apt install -y "$PACKAGES" || die 1 "Unable to install following packages: '$PACKAGES'" + elif [ -z "$PACKAGES" ]; then + info "Dependencies are not specified in PACKAGES variable" + else + die 256 "Unexpected happend while processing PACKAGES variable" + fi + ;; + *) die 2 "Unsupported variant '$VARIANT' has been parsed" + esac + + # Do not clean repositories since docker images are not saved + +# Linux via Docker +elif [ "$TRAVIS_OS_NAME" = linux ] && [ -n "$DOCKER" ] && [ -z "$QEMU" ]; then + + fixme "Fix duplicates of repository update" + + case "$VARIANT" in + ubuntu-*|debian-*) + # Update repositories + docker exec "$CONTAINER" apt update || die 1 "Unable to update repositories on '$VARIANT' using DOCKER '$DOCKER'" + + # Install dependencies + if [ -n "$PACKAGES" ]; then + # NOTICE: DO not double quote PACKAGES + docker exec "$CONTAINER" apt install -y $PACKAGES || die 1 "Unable to install following packages on '$CONTAINER': '$PACKAGES'" + elif [ -z "$PACKAGES" ]; then + true + else + die 256 "Resolving packages for '$CONTAINER'" + fi + ;; + *) die 256 "Unsupported variant '$VARIANT' has been parsed in DOCKER '$DOCKER'" + esac + + info "Fetching repository for $VARIANT" + + sudo docker exec "$CONTAINER" git clone "$REPOSITORY" || die 1 "Unable to fetch '$REPOSITORY'" + +# MacOS X +elif [ "$TRAVIS_OS_NAME" = osx ]; then + # Homebrew takes lots of time on runtime due to the cleanup used, this is a hotfix (https://travis-ci.community/t/macosx-brew-update-takes-too-much-time/6295) + HOMEBREW_NO_INSTALL_CLEANUP=1 brew update || die "Unable to update brew" + + info "Installing dependencies" + + if [ -n "$PACKAGES" ]; then + brew install $PACKAGES || die "Unable to install dependencies on $TRAVIS_OS_NAME" + elif [ -z "$PACKAGES" ]; then + true + else + die 256 "Unexpected happend while installing packages on '$TRAVIS_OS_NAME'" + fi + +# FreeBSD via QEMU +elif [ "$TRAVIS_OS_NAME" = "linux" ] && [ "$QEMU" = "FreeBSD" ]; then + if [ -n "$VARIANT" ]; then + # Install packages + # Ensure the file system is true (fuse-ufs2 in write mode is unreliable!) + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + "mount -fr / ; fsck -y /dev/gpt/rootfs ; mount -fw / ; df -h" + + # Basic dependencies: + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + env ASSUME_ALWAYS_YES=yes pkg update + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + env ASSUME_ALWAYS_YES=yes pkg install -y bash autoconf meson cppcheck fusefs-libs3 gcc git ninja bison libtool autoconf pkg-config indent fakeroot gzip rsync autopoint shellcheck + + # Bash shell: + # Use bash, and make sure it is available under /bin/bash. + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + chsh -s /usr/local/bin/bash + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + ln -s /usr/local/bin/bash /bin/bash || true + + # Ports collection: + # This is the slow method via portsnap: + # --- ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + # --- "portsnap --interactive fetch extract | grep -v ^/usr/ports" + # Using Git is much faster: + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + "rm -rf /usr/ports ; git clone --depth=1 --filter=tree:0 https://github.com/freebsd/freebsd-ports /usr/ports" + + # Package's dependencies: + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + "cd /travis/freebsd/*/ && ( make build-depends-list && make run-depends-list ) | sed -e 's/^.*\///g' -e 's/glib20/glib/g' | sort -u | xargs -r env ASSUME_ALWAYS_YES=yes pkg install -y" + + echo "===== The FreeBSD VM is ready! =====" + + elif [ -z "$VARIANT" ]; then + die "Variable VARIANT is not set for FreeBSD via QEMU which is fatal, This should be set in travis.yml" + + else + die "Unexpected in FreeBSD using QEMU" + + fi +else + die "Invalid setting of TRAVIS_OS_NAME=$TRAVIS_OS_NAME, DOCKER=$DOCKER, QEMU=$QEMU!" + +fi diff --git a/QA/travis-ci/retry.sh b/QA/travis-ci/retry.sh new file mode 100755 index 0000000..c199235 --- /dev/null +++ b/QA/travis-ci/retry.sh @@ -0,0 +1,54 @@ +#!/bin/sh +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later +# Based in part upon 'retry.sh' from rsplib (https://raw.githubusercontent.com/dreibh/rsplib/master/ci/retry), which is: +# Copyright (C) 2018-2019 by Thomas Dreibholz as GPLv3 or any other GPL at your option + +set -e + +. QA/travis-ci/travis-common.sh + +maxTrials=3 +pause=10 + +while [ $# -gt 1 ] ; do + case "$1" in + -t|--tries) + maxTrials="$2" + shift 2 + ;; + -p|--pause) + pause="$2" + shift 2 + ;; + --) + shift + break + ;; + *) + die "Usage: $0 [-t|--trials max_trials] [-p|--pause seconds] -- command ..." + esac +done + + +attempts=1 +result=1 +command="$*" +while [ "$result" -ne 0 ] && [ "$attempts" -le "$maxTrials" ]; do + if [ "$attempts" -gt 1 ]; then + printf '%s\n' "Sleeping ${pause}s ..." + sleep "$pause" + fi + info "Trying $attempts/$maxTrials: $command" + sh -c "$command" && result=$? || result=$? + if [ "$result" -eq 127 ]; then + # Command not found => no need for a retry! + exit "$result" + elif [ "$result" -ne 0 ]; then + # Attempt failed + attempts="$((attempts=attempts+1))" + fi +done + + +exit "$result" diff --git a/QA/travis-ci/test.sh b/QA/travis-ci/test.sh new file mode 100755 index 0000000..eed8547 --- /dev/null +++ b/QA/travis-ci/test.sh @@ -0,0 +1,35 @@ +#!/usr/bin/env bash +# Copyright 2019 Jacob Hrbek +# Distributed under the terms of the GNU General Public License v3 (https://www.gnu.org/licenses/gpl-3.0.en.html) or later + +# shellcheck source=QA/travis-ci/travis-common.sh +. "QA/travis-ci/travis-common.sh" + +# shellcheck source=QA/travis-ci/get-container.sh +. "QA/travis-ci/get-container.sh" + +case "$TOOL" in + *check*) true ;; + *) die 0 "Skipping tests as instructed" +esac + +# Linux as-is +if [ "$TRAVIS_OS_NAME" = linux ] && [ -z "$DOCKER" ] && [ -z "$QEMU" ]; then + make test-rustlang + +# Linux via Docker +elif [ "$TRAVIS_OS_NAME" = linux ] && [ -n "$DOCKER" ] && [ -z "$QEMU" ]; then + sudo docker exec "$CONTAINER" make --directory="/travis/Zernit" test-rustlang + +# MacOS X +elif [ "$TRAVIS_OS_NAME" = osx ]; then + make --directory="/Users/travis/build/Kreyrock/Kreyrock" check + +elif [ "$TRAVIS_OS_NAME" = "linux" ] && [ "$QEMU" = "FreeBSD" ]; then + ssh -p 8829 -oStrictHostKeyChecking=no -i "$HOME/.ssh/id_rsa" root@localhost \ + make check + +else + die "Invalid setting of TRAVIS_OS_NAME=$TRAVIS_OS_NAME, DOCKER=$DOCKER, QEMU=$QEMU!" + +fi diff --git a/QA/travis-ci/travis-common.sh b/QA/travis-ci/travis-common.sh new file mode 100755 index 0000000..b4fd34b --- /dev/null +++ b/QA/travis-ci/travis-common.sh @@ -0,0 +1,17 @@ +#!/bin/sh +# Simplified error handling +die() { + printf 'FATAL: %s\n' "$2" + exit "$1" +} +# Simplified QA handling +fixme() { + printf 'FIXME: %s\n' "$1" +} +# Simplified info messages +info() { + printf 'INFO: %s\n' "$1" +} +warn() { + printf 'WARN: %s\n' "$1" +} \ No newline at end of file diff --git a/bandit.yml b/bandit.yml new file mode 100644 index 0000000..0a1f880 --- /dev/null +++ b/bandit.yml @@ -0,0 +1,2 @@ +# Configuration file for bandit (security check for python) + diff --git a/benches/README.md b/benches/README.md new file mode 100644 index 0000000..f27eb74 --- /dev/null +++ b/benches/README.md @@ -0,0 +1,5 @@ +Directory for benchmarks of the source + +FIXME: Add benchmarks + +FIXME: Differenciate benchmarks per programming language i.e benches/rustlang/example_bench.rs \ No newline at end of file diff --git a/benches/example_bench.rs b/benches/example_bench.rs new file mode 100644 index 0000000..8c6c2c7 --- /dev/null +++ b/benches/example_bench.rs @@ -0,0 +1,22 @@ +use criterion::{black_box, criterion_group, criterion_main, Criterion}; + +/* + This is base benchmark made for consistency + + FIXME-BENCH: Make cargo to recognize `benches/rustlang` path instead of `benches/` +*/ + +fn fibonacci(n: u64) -> u64 { + match n { + 0 => 1, + 1 => 1, + n => fibonacci(n-1) + fibonacci(n-2), + } +} + +fn criterion_benchmark(c: &mut Criterion) { + c.bench_function("fib 20", |b| b.iter(|| fibonacci(black_box(20)))); +} + +criterion_group!(benches, criterion_benchmark); +criterion_main!(benches); \ No newline at end of file diff --git a/docker/README.md b/docker/README.md new file mode 100644 index 0000000..0b3ecd6 --- /dev/null +++ b/docker/README.md @@ -0,0 +1 @@ +Directory for various Dockerfiles \ No newline at end of file diff --git a/docs.new/README.md b/docs.new/README.md new file mode 100644 index 0000000..572217f --- /dev/null +++ b/docs.new/README.md @@ -0,0 +1,11 @@ +Stub for new website implementation + +Expecting +- User database to handle the workflow +- Method to host repositories + - sourcehut implementation +- Social-network like platform so that users can communicate with each other + +efficency is a concer when php 8.0 and golang seems to be the best candidates + +for golang https://github.com/gogs/gogs could be forked? \ No newline at end of file diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100755 index 0000000..b841658 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,8 @@ +.jekyll-cache/ +!.gitignore +!.gitmodules +*~ + +components/ + +_site/ diff --git a/docs/.gitpod.yml b/docs/.gitpod.yml new file mode 100644 index 0000000..a92ddaf --- /dev/null +++ b/docs/.gitpod.yml @@ -0,0 +1,9 @@ +image: + file: gitpod/gitpod.Dockerfile + +ports: + - port: 4000 + onOpen: open-preview + +tasks: + - init: gem install jekyll \ No newline at end of file diff --git a/docs/LICENSE.md b/docs/LICENSE.md new file mode 100644 index 0000000..38c6bf2 --- /dev/null +++ b/docs/LICENSE.md @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) [year] [fullname] + +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/docs/Makefile b/docs/Makefile new file mode 100644 index 0000000..41d7da5 --- /dev/null +++ b/docs/Makefile @@ -0,0 +1,22 @@ +SRC = $(wildcard lib/*/*.js) +HTML = $(wildcard lib/*/*.html) +TEMPLATES = $(HTML:.html=.js) +LESS = $(wildcard lib/*/*.less) +CSS = $(LESS:.less=.css) + +build: components $(SRC) $(TEMPLATES) $(CSS) + @component build --verbose --out . --name assets + +components: component.json + @component install + +%.js: %.html + @component convert $< + +%.css: %.less + @lessc $< $@ + +clean: + rm -fr build components $(TEMPLATES) + +.PHONY: clean diff --git a/docs/README.md b/docs/README.md new file mode 100755 index 0000000..3d8432b --- /dev/null +++ b/docs/README.md @@ -0,0 +1,68 @@ +## The "What ?" and the "Why ?" + +**Carte** is a simple Jekyll based documentation website for APIs. It is designed as a boilerplate to build your own documentation and is heavily inspired from [Swagger](http://swagger.wordnik.com/) and [I/O docs](http://www.mashery.com/product/io-docs). Fork it, add specifications for your APIs calls and customize the theme. Go ahead, see if we care. + +We built **Carte** because the existing options (Swagger and the likes) were trying to do too much and did not match our needs: + +1. Most of our API calls are sending JSON objects, as opposed to a series of parameters, +1. Being able to query the real API is nice, but running anything but `GET` calls can get tricky ("What do you mean I deleted my stuff? I was just trying out the API calls!"), +1. Overall, setting up a separate server for what really requires a good static documentation seemed overkill. + +The real value of **Carte** is its structure for describing APIs, not its underlying technical stack (or lack-thereof). In a nutshell; **we built a static template for your API documentation, feel free to re-use it**. + +## Install + +It' Jekyll god dammit: + +1. Clone this repository on your local, +1. [Install Jekyll](https://github.com/mojombo/jekyll/wiki/install), +1. Go at the root of the repository and run ```jekyll serve --watch```, +1. Go to http://localhost:4000, +1. [Great success! High five!](http://www.youtube.com/watch?v=wWWyJwHQ-4E) + +## How to... + +### Adding a new API call + +You can add a new API call by simply adding a new post in the `_posts` folder. Jekyll by default forces you to specify a date in the file path: it makes us sad pandas too, but you'll have to stick to this format. You can use dates to control the order in which API calls are displayed in the interface. + +Each API call can define a few values in its YAML header: + +Variable | Mandatory | Default | Description +--- | --- | --- | --- +``title`` | Y | - | A short description of what that calls does. +``path`` | N | - | The URL for the API call, including potential parameters. +``type`` | N | - | Set it to `PUT`, `GET`, `POST`, `DELETE` or nothing (for parts of your documentation that do not relate to an actual API call). + +A typical header: + +``` +--- +path: '/stuff/:id' +title: 'Delete a thing' +type: 'DELETE' + +layout: nil +--- +``` + +We then describe the request and response (or whatever else you wish to talk about) in the body of our post. Check the placeholders present in the `_posts` folder to get an idea of what it can look like. + +### Grouping calls + +Adding a category to your YAML header will allows you to group methods in the navigation. It is particularly helpful as you start having a lot of methods and need to organize them. For example: + +``` +--- +category: Stuff +path: '/stuff/:id' +title: 'Delete a thing' +type: 'DELETE' + +layout: nil +--- +``` + +### Edit the design + +The default UI is mostly described through the `css/style.css` file and a couple short jQuery scripts in the `/_layouts/default.html` layout. Hack it to oblivion. diff --git a/docs/_config.yml b/docs/_config.yml new file mode 100755 index 0000000..60febca --- /dev/null +++ b/docs/_config.yml @@ -0,0 +1,6 @@ +--- +exclude: ['README.markdown', 'gitpod'] +permalink: ':title' +pygments: true +safe: false +title: 'Zernit' \ No newline at end of file diff --git a/docs/_includes/nav.html b/docs/_includes/nav.html new file mode 100644 index 0000000..5a9f88b --- /dev/null +++ b/docs/_includes/nav.html @@ -0,0 +1,19 @@ +

{{ site.title }}

+ \ No newline at end of file diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html new file mode 100755 index 0000000..4e637e1 --- /dev/null +++ b/docs/_layouts/default.html @@ -0,0 +1,17 @@ + + + {{ site.title }} + + + + + + + + {{ content }} + + + + + + \ No newline at end of file diff --git a/docs/_posts/2020-02-06-review.md b/docs/_posts/2020-02-06-review.md new file mode 100644 index 0000000..15f548e --- /dev/null +++ b/docs/_posts/2020-02-06-review.md @@ -0,0 +1,9 @@ +--- +category: Maintainance +title: 'Review process' +layout: nil +--- + +FIXME-DOCS: preamble + +1. Everything has to pass tests unless the merge request is not causing the test failure \ No newline at end of file diff --git a/docs/_posts/2020-02-16-fsf_compliance.md b/docs/_posts/2020-02-16-fsf_compliance.md new file mode 100644 index 0000000..ad7a926 --- /dev/null +++ b/docs/_posts/2020-02-16-fsf_compliance.md @@ -0,0 +1,30 @@ +--- +category: About +title: 'Four freedoms compliance' +layout: nil +--- + +Disclaimer: This is still part of ongoing effort to make this repository FSF approved while allow for sustainable business plan assuming this repository being expected to be used for commercial use. +Content provided in this post is subject to change and contributions are welcommed where we are welcomming challenges about these decisions and requests to adapt license for your workflow. + +Based on feedback from majority of Free Software Foundation members based on discussion in https://forum.members.fsf.org/t/help-me-with-gpl-3-inspired-license-designed-for-commercial-use-and-to-avoid-segmentation/1953/59 this repository does not comply with four freedoms as follows where we are doing our best on ongoing effort to make this project compliant while allowing sustainable business plan: + +- The freedom to run the program as you wish, for any purpose (freedom 0). + +Usage of software is restricted by the license to direct the workflow in original repository since segmentation as example provided with ripple project on https://github.com/osuripple/lets/pull/5 to avoid segmentation alike https://github.com/light-ripple and many others that based on our point of view only sabotages the original project. + +- The freedom to study how the program works, and change it so it does your computing as you wish (freedom 1). Access to the source code is a precondition for this. + +We believe that this is not restricted since the project is open-source and you are allowed to perform any changes where the features that can be merged in original project are required to be merged where we will grant you write access based on proved competence to maintian said part with planned option to get paid for this service. + +If the fork does not have a feature that could be merged in the project itself then we allow this fork. + +- The freedom to redistribute copies so you can help others (freedom 2). + +This is restricted since spread of malware of outdated versions of this project is a concern. + +License is planned to contain conditions to avoid this unwanted behavior. + +- The freedom to distribute copies of your modified versions to others (freedom 3). By doing this you can give the whole community a chance to benefit from your changes. Access to the source code is a precondition for this. + +This is not restricted for standalone forks as long as said repositories are not containing features that project finds usefull in which scenario we will provide an official way for said feature to be merged in our upstream without restricting your right to have access in said code assuming that you are competent enough to perform such maintainance. If not we do our best to teach you. \ No newline at end of file diff --git a/docs/assets.css b/docs/assets.css new file mode 100644 index 0000000..7c58699 --- /dev/null +++ b/docs/assets.css @@ -0,0 +1,639 @@ +/*! normalize.css v2.1.0 | MIT License | git.io/normalize */ + +/* ========================================================================== + HTML5 display definitions + ========================================================================== */ + +/** + * Correct `block` display not defined in IE 8/9. + */ + +article, +aside, +details, +figcaption, +figure, +footer, +header, +hgroup, +main, +nav, +section, +summary { + display: block; +} + +/** + * Correct `inline-block` display not defined in IE 8/9. + */ + +audio, +canvas, +video { + display: inline-block; +} + +/** + * Prevent modern browsers from displaying `audio` without controls. + * Remove excess height in iOS 5 devices. + */ + +audio:not([controls]) { + display: none; + height: 0; +} + +/** + * Address styling not present in IE 8/9. + */ + +[hidden] { + display: none; +} + +/* ========================================================================== + Base + ========================================================================== */ + +/** + * 1. Set default font family to sans-serif. + * 2. Prevent iOS text size adjust after orientation change, without disabling + * user zoom. + */ + +html { + font-family: sans-serif; /* 1 */ + -webkit-text-size-adjust: 100%; /* 2 */ + -ms-text-size-adjust: 100%; /* 2 */ +} + +/** + * Remove default margin. + */ + +body { + margin: 0; +} + +/* ========================================================================== + Links + ========================================================================== */ + +/** + * Address `outline` inconsistency between Chrome and other browsers. + */ + +a:focus { + outline: thin dotted; +} + +/** + * Improve readability when focused and also mouse hovered in all browsers. + */ + +a:active, +a:hover { + outline: 0; +} + +/* ========================================================================== + Typography + ========================================================================== */ + +/** + * Address variable `h1` font-size and margin within `section` and `article` + * contexts in Firefox 4+, Safari 5, and Chrome. + */ + +h1 { + font-size: 2em; + margin: 0.67em 0; +} + +/** + * Address styling not present in IE 8/9, Safari 5, and Chrome. + */ + +abbr[title] { + border-bottom: 1px dotted; +} + +/** + * Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome. + */ + +b, +strong { + font-weight: bold; +} + +/** + * Address styling not present in Safari 5 and Chrome. + */ + +dfn { + font-style: italic; +} + +/** + * Address differences between Firefox and other browsers. + */ + +hr { + -moz-box-sizing: content-box; + box-sizing: content-box; + height: 0; +} + +/** + * Address styling not present in IE 8/9. + */ + +mark { + background: #ff0; + color: #000; +} + +/** + * Correct font family set oddly in Safari 5 and Chrome. + */ + +code, +kbd, +pre, +samp { + font-family: monospace, serif; + font-size: 1em; +} + +/** + * Improve readability of pre-formatted text in all browsers. + */ + +pre { + white-space: pre-wrap; +} + +/** + * Set consistent quote types. + */ + +q { + quotes: "\201C" "\201D" "\2018" "\2019"; +} + +/** + * Address inconsistent and variable font size in all browsers. + */ + +small { + font-size: 80%; +} + +/** + * Prevent `sub` and `sup` affecting `line-height` in all browsers. + */ + +sub, +sup { + font-size: 75%; + line-height: 0; + position: relative; + vertical-align: baseline; +} + +sup { + top: -0.5em; +} + +sub { + bottom: -0.25em; +} + +/* ========================================================================== + Embedded content + ========================================================================== */ + +/** + * Remove border when inside `a` element in IE 8/9. + */ + +img { + border: 0; +} + +/** + * Correct overflow displayed oddly in IE 9. + */ + +svg:not(:root) { + overflow: hidden; +} + +/* ========================================================================== + Figures + ========================================================================== */ + +/** + * Address margin not present in IE 8/9 and Safari 5. + */ + +figure { + margin: 0; +} + +/* ========================================================================== + Forms + ========================================================================== */ + +/** + * Define consistent border, margin, and padding. + */ + +fieldset { + border: 1px solid #c0c0c0; + margin: 0 2px; + padding: 0.35em 0.625em 0.75em; +} + +/** + * 1. Correct `color` not being inherited in IE 8/9. + * 2. Remove padding so people aren't caught out if they zero out fieldsets. + */ + +legend { + border: 0; /* 1 */ + padding: 0; /* 2 */ +} + +/** + * 1. Correct font family not being inherited in all browsers. + * 2. Correct font size not being inherited in all browsers. + * 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome. + */ + +button, +input, +select, +textarea { + font-family: inherit; /* 1 */ + font-size: 100%; /* 2 */ + margin: 0; /* 3 */ +} + +/** + * Address Firefox 4+ setting `line-height` on `input` using `!important` in + * the UA stylesheet. + */ + +button, +input { + line-height: normal; +} + +/** + * Address inconsistent `text-transform` inheritance for `button` and `select`. + * All other form control elements do not inherit `text-transform` values. + * Correct `button` style inheritance in Chrome, Safari 5+, and IE 8+. + * Correct `select` style inheritance in Firefox 4+ and Opera. + */ + +button, +select { + text-transform: none; +} + +/** + * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` + * and `video` controls. + * 2. Correct inability to style clickable `input` types in iOS. + * 3. Improve usability and consistency of cursor style between image-type + * `input` and others. + */ + +button, +html input[type="button"], /* 1 */ +input[type="reset"], +input[type="submit"] { + -webkit-appearance: button; /* 2 */ + cursor: pointer; /* 3 */ +} + +/** + * Re-set default cursor for disabled elements. + */ + +button[disabled], +html input[disabled] { + cursor: default; +} + +/** + * 1. Address box sizing set to `content-box` in IE 8/9. + * 2. Remove excess padding in IE 8/9. + */ + +input[type="checkbox"], +input[type="radio"] { + box-sizing: border-box; /* 1 */ + padding: 0; /* 2 */ +} + +/** + * 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome. + * 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome + * (include `-moz` to future-proof). + */ + +input[type="search"] { + -webkit-appearance: textfield; /* 1 */ + -moz-box-sizing: content-box; + -webkit-box-sizing: content-box; /* 2 */ + box-sizing: content-box; +} + +/** + * Remove inner padding and search cancel button in Safari 5 and Chrome + * on OS X. + */ + +input[type="search"]::-webkit-search-cancel-button, +input[type="search"]::-webkit-search-decoration { + -webkit-appearance: none; +} + +/** + * Remove inner padding and border in Firefox 4+. + */ + +button::-moz-focus-inner, +input::-moz-focus-inner { + border: 0; + padding: 0; +} + +/** + * 1. Remove default vertical scrollbar in IE 8/9. + * 2. Improve readability and alignment in all browsers. + */ + +textarea { + overflow: auto; /* 1 */ + vertical-align: top; /* 2 */ +} + +/* ========================================================================== + Tables + ========================================================================== */ + +/** + * Remove most spacing between table cells. + */ + +table { + border-collapse: collapse; + border-spacing: 0; +} + + + +/* GENERAL */ +html, +body { + height: 100%; +} + +body { + background: #fff; +} + +body, +input, +textarea { + color: #191919; + font: 14px/140% 'Open Sans', Arial, sans-serif; +} + +a { + color: #119bdf; + text-decoration: none; +} +a:hover { + color: #29aeef; + text-decoration: underline; +} + +h1, +h2, +h3, +h4, +p, +ul, +code { + margin: 0 0 20px; +} + +code { + font-family: 'Monaco', monospace, sans-serif; +} + +/* SIDEBAR */ +#sidebar { + background: #191919; + color: #fff; + float: left; + height: 100%; + overflow: auto; + position: fixed; + top: 0; + width: 240px; +} + +#sidebar h1 { + background: #111; + font-size: 14px; + margin: 0; + padding: 20px; + text-transform: uppercase; +} + +#sidebar h2 { + color: #888; + font-size: 14px; + margin: 0; +} + +#sidebar ul { + list-style: none; + margin: 0; + padding: 0; +} + +#sidebar ul#links { + padding: 20px; +} + +#sidebar ul ul { + padding-left: 20px; +} + +#sidebar ul li a { + color: #fff; + display: block; + padding: 0 0 15px; +} +#sidebar ul li a:active, +#sidebar ul li a.active { + text-decoration: underline; +} + +#sidebar input { + background: #111; + border: 0; + border-radius: 2px; + -moz-border-radius: 2px; + -webkit-border-radius: 2px; + box-shadow: inset 0 0 5px rgba(0, 0, 0, 0.2); + -moz-box-shadow: inset 0 1px 5px rgba(0, 0, 0, 0.2); + -webkit-box-shadow: inset 0 1px 5px rgba(0, 0, 0, 0.2); + color: #ddd; + margin-bottom: 20px; + padding: 5px 10px; +} +#sidebar input:active, +#sidebar input:focus { + border-color: #ccc; + box-shadow: inset 0 0 5px rgba(0, 0, 0, 0.1); + -moz-box-shadow: inset 0 1px 5px rgba(0, 0, 0, 0.1); + -webkit-box-shadow: inset 0 1px 5px rgba(0, 0, 0, 0.1); + outline: none; +} + +/* References */ +#content { + padding: 20px; + padding-left: 260px; + max-width: 700px; +} + +#content .control { + cursor: pointer; + font-size: 12px; + margin-left: 15px; +} + +#content article { + clear: both; + margin: 15px 0; +} + +#content article > a { + background: #333; + border-radius: 2px; + -moz-border-radius: 2px; + -webkit-border-radius: 2px; + cursor: pointer; + display: block; + padding: 15px; +} +#content article > a:hover { + background: #222; + text-decoration: none; +} + +#content a h2 { + color: #fff; + font-size: 18px; + font-weight: normal; + margin: 0; +} + +#content a h2 code { + float: right; + font-size: 14px; +} + +#content a h2 code b { + border-radius: 2px; + -moz-border-radius: 2px; + -webkit-border-radius: 2px; + color: #fff; + font-weight: normal; + padding: 3px 6px; +} + +/* Default */ +#content article { + border-color: #e2e7ea; +} + +#content article a h2 code { + color: #657e8b; +} + +#content article a h2 code b { + background: #657e8b; + text-transform: uppercase; +} + +/* GET */ +#content article.GET a h2 code { + color: #119bdf; +} + +#content article.GET a h2 code b { + background: #119bdf; +} + +/* POST */ +#content article.POST a h2 code { + color: #52ce0e; +} + +#content article.POST a h2 code b { + background: #52ce0e; +} + +/* PUT */ +#content article.PUT a h2 code { + color: #e08f10; +} + +#content article.PUT a h2 code b { + background: #e08f10; +} + +/* DELETE */ +#content article.DELETE a h2 code { + color: #e02a10; +} + +#content article.DELETE a h2 code b { + background: #e02a10; +} + +/* Reference's body */ +#content h3 { +} + +#content .body { + border-top: 1px solid #eef1f2; + display: block; + padding: 15px 15px 0; +} + +#content .body code { + border: 1px solid #e2e7ea; + background: #eef1f2; + border-radius: 2px; + -moz-border-radius: 2px; + -webkit-border-radius: 2px; + color: #546974; + padding: 0 1px; +} + +#content .body p > code { + display: block; + padding: 15px; + white-space: pre; +} \ No newline at end of file diff --git a/docs/assets.js b/docs/assets.js new file mode 100644 index 0000000..88f95c8 --- /dev/null +++ b/docs/assets.js @@ -0,0 +1,9721 @@ + +/** + * hasOwnProperty. + */ + +var has = Object.prototype.hasOwnProperty; + +/** + * Require the given path. + * + * @param {String} path + * @return {Object} exports + * @api public + */ + +function require(path, parent, orig) { + var resolved = require.resolve(path); + + // lookup failed + if (null == resolved) { + orig = orig || path; + parent = parent || 'root'; + var err = new Error('Failed to require "' + orig + '" from "' + parent + '"'); + err.path = orig; + err.parent = parent; + err.require = true; + throw err; + } + + var module = require.modules[resolved]; + + // perform real require() + // by invoking the module's + // registered function + if (!module.exports) { + module.exports = {}; + module.client = module.component = true; + module.call(this, module.exports, require.relative(resolved), module); + } + + return module.exports; +} + +/** + * Registered modules. + */ + +require.modules = {}; + +/** + * Registered aliases. + */ + +require.aliases = {}; + +/** + * Resolve `path`. + * + * Lookup: + * + * - PATH/index.js + * - PATH.js + * - PATH + * + * @param {String} path + * @return {String} path or null + * @api private + */ + +require.resolve = function(path) { + var index = path + '/index.js'; + + var paths = [ + path, + path + '.js', + path + '.json', + path + '/index.js', + path + '/index.json' + ]; + + for (var i = 0; i < paths.length; i++) { + var path = paths[i]; + if (has.call(require.modules, path)) return path; + } + + if (has.call(require.aliases, index)) { + return require.aliases[index]; + } +}; + +/** + * Normalize `path` relative to the current path. + * + * @param {String} curr + * @param {String} path + * @return {String} + * @api private + */ + +require.normalize = function(curr, path) { + var segs = []; + + if ('.' != path.charAt(0)) return path; + + curr = curr.split('/'); + path = path.split('/'); + + for (var i = 0; i < path.length; ++i) { + if ('..' == path[i]) { + curr.pop(); + } else if ('.' != path[i] && '' != path[i]) { + segs.push(path[i]); + } + } + + return curr.concat(segs).join('/'); +}; + +/** + * Register module at `path` with callback `definition`. + * + * @param {String} path + * @param {Function} definition + * @api private + */ + +require.register = function(path, definition) { + require.modules[path] = definition; +}; + +/** + * Alias a module definition. + * + * @param {String} from + * @param {String} to + * @api private + */ + +require.alias = function(from, to) { + if (!has.call(require.modules, from)) { + throw new Error('Failed to alias "' + from + '", it does not exist'); + } + require.aliases[to] = from; +}; + +/** + * Return a require function relative to the `parent` path. + * + * @param {String} parent + * @return {Function} + * @api private + */ + +require.relative = function(parent) { + var p = require.normalize(parent, '..'); + + /** + * lastIndexOf helper. + */ + + function lastIndexOf(arr, obj) { + var i = arr.length; + while (i--) { + if (arr[i] === obj) return i; + } + return -1; + } + + /** + * The relative require() itself. + */ + + function localRequire(path) { + var resolved = localRequire.resolve(path); + return require(resolved, parent, path); + } + + /** + * Resolve relative to the parent. + */ + + localRequire.resolve = function(path) { + // resolve deps by returning + // the dep in the nearest "deps" + // directory + if ('.' != path.charAt(0)) { + var segs = parent.split('/'); + var i = lastIndexOf(segs, 'deps') + 1; + if (!i) i = 0; + path = segs.slice(0, i + 1).join('/') + '/deps/' + path; + return path; + } + return require.normalize(p, path); + }; + + /** + * Check if module is defined at `path`. + */ + + localRequire.exists = function(path) { + return has.call(require.modules, localRequire.resolve(path)); + }; + + return localRequire; +}; + +require.register("component-jquery/index.js", function(exports, require, module){ +/*! + * jQuery JavaScript Library v1.7.3pre + * http://jquery.com/ + * + * Copyright 2011, John Resig + * Dual licensed under the MIT or GPL Version 2 licenses. + * http://jquery.org/license + * + * Includes Sizzle.js + * http://sizzlejs.com/ + * Copyright 2011, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * + * Date: Thu May 3 11:06:50 2012 -0700 + */ +(function( window, undefined ) { + +// Use the correct document accordingly with window argument (sandbox) +var document = window.document, + navigator = window.navigator, + location = window.location; +var jQuery = (function() { + +// Define a local copy of jQuery +var jQuery = function( selector, context ) { + // The jQuery object is actually just the init constructor 'enhanced' + return new jQuery.fn.init( selector, context, rootjQuery ); + }, + + // Map over jQuery in case of overwrite + _jQuery = window.jQuery, + + // Map over the $ in case of overwrite + _$ = window.$, + + // A central reference to the root jQuery(document) + rootjQuery, + + // A simple way to check for HTML strings or ID strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + quickExpr = /^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/, + + // Check if a string has a non-whitespace character in it + rnotwhite = /\S/, + + // Used for trimming whitespace + trimLeft = /^\s+/, + trimRight = /\s+$/, + + // Match a standalone tag + rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>)?$/, + + // JSON RegExp + rvalidchars = /^[\],:{}\s]*$/, + rvalidescape = /\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, + rvalidtokens = /"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, + rvalidbraces = /(?:^|:|,)(?:\s*\[)+/g, + + // Useragent RegExp + rwebkit = /(webkit)[ \/]([\w.]+)/, + ropera = /(opera)(?:.*version)?[ \/]([\w.]+)/, + rmsie = /(msie) ([\w.]+)/, + rmozilla = /(mozilla)(?:.*? rv:([\w.]+))?/, + + // Matches dashed string for camelizing + rdashAlpha = /-([a-z]|[0-9])/ig, + rmsPrefix = /^-ms-/, + + // Used by jQuery.camelCase as callback to replace() + fcamelCase = function( all, letter ) { + return ( letter + "" ).toUpperCase(); + }, + + // Keep a UserAgent string for use with jQuery.browser + userAgent = navigator.userAgent, + + // For matching the engine and version of the browser + browserMatch, + + // The deferred used on DOM ready + readyList, + + // The ready event handler + DOMContentLoaded, + + // Save a reference to some core methods + toString = Object.prototype.toString, + hasOwn = Object.prototype.hasOwnProperty, + push = Array.prototype.push, + slice = Array.prototype.slice, + trim = String.prototype.trim, + indexOf = Array.prototype.indexOf, + + // [[Class]] -> type pairs + class2type = {}; + +jQuery.fn = jQuery.prototype = { + constructor: jQuery, + init: function( selector, context, rootjQuery ) { + var match, elem, ret, doc; + + // Handle $(""), $(null), or $(undefined) + if ( !selector ) { + return this; + } + + // Handle $(DOMElement) + if ( selector.nodeType ) { + this.context = this[0] = selector; + this.length = 1; + return this; + } + + // The body element only exists once, optimize finding it + if ( selector === "body" && !context && document.body ) { + this.context = document; + this[0] = document.body; + this.selector = selector; + this.length = 1; + return this; + } + + // Handle HTML strings + if ( typeof selector === "string" ) { + // Are we dealing with HTML string or an ID? + if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = quickExpr.exec( selector ); + } + + // Verify a match, and that no context was specified for #id + if ( match && (match[1] || !context) ) { + + // HANDLE: $(html) -> $(array) + if ( match[1] ) { + context = context instanceof jQuery ? context[0] : context; + doc = ( context ? context.ownerDocument || context : document ); + + // If a single string is passed in and it's a single tag + // just do a createElement and skip the rest + ret = rsingleTag.exec( selector ); + + if ( ret ) { + if ( jQuery.isPlainObject( context ) ) { + selector = [ document.createElement( ret[1] ) ]; + jQuery.fn.attr.call( selector, context, true ); + + } else { + selector = [ doc.createElement( ret[1] ) ]; + } + + } else { + ret = jQuery.buildFragment( [ match[1] ], [ doc ] ); + selector = ( ret.cacheable ? jQuery.clone(ret.fragment) : ret.fragment ).childNodes; + } + + return jQuery.merge( this, selector ); + + // HANDLE: $("#id") + } else { + elem = document.getElementById( match[2] ); + + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE and Opera return items + // by name instead of ID + if ( elem.id !== match[2] ) { + return rootjQuery.find( selector ); + } + + // Otherwise, we inject the element directly into the jQuery object + this.length = 1; + this[0] = elem; + } + + this.context = document; + this.selector = selector; + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || rootjQuery ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( jQuery.isFunction( selector ) ) { + return rootjQuery.ready( selector ); + } + + if ( selector.selector !== undefined ) { + this.selector = selector.selector; + this.context = selector.context; + } + + return jQuery.makeArray( selector, this ); + }, + + // Start with an empty selector + selector: "", + + // The current version of jQuery being used + jquery: "1.7.3pre", + + // The default length of a jQuery object is 0 + length: 0, + + // The number of elements contained in the matched element set + size: function() { + return this.length; + }, + + toArray: function() { + return slice.call( this, 0 ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + return num == null ? + + // Return a 'clean' array + this.toArray() : + + // Return just the object + ( num < 0 ? this[ this.length + num ] : this[ num ] ); + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems, name, selector ) { + // Build a new jQuery matched element set + var ret = this.constructor(); + + if ( jQuery.isArray( elems ) ) { + push.apply( ret, elems ); + + } else { + jQuery.merge( ret, elems ); + } + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + ret.context = this.context; + + if ( name === "find" ) { + ret.selector = this.selector + ( this.selector ? " " : "" ) + selector; + } else if ( name ) { + ret.selector = this.selector + "." + name + "(" + selector + ")"; + } + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + // (You can seed the arguments with an array of args, but this is + // only used internally.) + each: function( callback, args ) { + return jQuery.each( this, callback, args ); + }, + + ready: function( fn ) { + // Attach the listeners + jQuery.bindReady(); + + // Add the callback + readyList.add( fn ); + + return this; + }, + + eq: function( i ) { + i = +i; + return i === -1 ? + this.slice( i ) : + this.slice( i, i + 1 ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ), + "slice", slice.call(arguments).join(",") ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map(this, function( elem, i ) { + return callback.call( elem, i, elem ); + })); + }, + + end: function() { + return this.prevObject || this.constructor(null); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: [].sort, + splice: [].splice +}; + +// Give the init function the jQuery prototype for later instantiation +jQuery.fn.init.prototype = jQuery.fn; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[0] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + target = arguments[1] || {}; + // skip the boolean and the target + i = 2; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !jQuery.isFunction(target) ) { + target = {}; + } + + // extend jQuery itself if only one argument is passed + if ( length === i ) { + target = this; + --i; + } + + for ( ; i < length; i++ ) { + // Only deal with non-null/undefined values + if ( (options = arguments[ i ]) != null ) { + // Extend the base object + for ( name in options ) { + src = target[ name ]; + copy = options[ name ]; + + // Prevent never-ending loop + if ( target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { + if ( copyIsArray ) { + copyIsArray = false; + clone = src && jQuery.isArray(src) ? src : []; + + } else { + clone = src && jQuery.isPlainObject(src) ? src : {}; + } + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend({ + noConflict: function( deep ) { + if ( window.$ === jQuery ) { + window.$ = _$; + } + + if ( deep && window.jQuery === jQuery ) { + window.jQuery = _jQuery; + } + + return jQuery; + }, + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Hold (or release) the ready event + holdReady: function( hold ) { + if ( hold ) { + jQuery.readyWait++; + } else { + jQuery.ready( true ); + } + }, + + // Handle when the DOM is ready + ready: function( wait ) { + // Either a released hold or an DOMready/load event and not yet ready + if ( (wait === true && !--jQuery.readyWait) || (wait !== true && !jQuery.isReady) ) { + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( !document.body ) { + return setTimeout( jQuery.ready, 1 ); + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.fireWith( document, [ jQuery ] ); + + // Trigger any bound ready events + if ( jQuery.fn.trigger ) { + jQuery( document ).trigger( "ready" ).off( "ready" ); + } + } + }, + + bindReady: function() { + if ( readyList ) { + return; + } + + readyList = jQuery.Callbacks( "once memory" ); + + // Catch cases where $(document).ready() is called after the + // browser event has already occurred. + if ( document.readyState === "complete" ) { + // Handle it asynchronously to allow scripts the opportunity to delay ready + return setTimeout( jQuery.ready, 1 ); + } + + // Mozilla, Opera and webkit nightlies currently support this event + if ( document.addEventListener ) { + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", jQuery.ready, false ); + + // If IE event model is used + } else if ( document.attachEvent ) { + // ensure firing before onload, + // maybe late but safe also for iframes + document.attachEvent( "onreadystatechange", DOMContentLoaded ); + + // A fallback to window.onload, that will always work + window.attachEvent( "onload", jQuery.ready ); + + // If IE and not a frame + // continually check to see if the document is ready + var toplevel = false; + + try { + toplevel = window.frameElement == null; + } catch(e) {} + + if ( document.documentElement.doScroll && toplevel ) { + doScrollCheck(); + } + } + }, + + // See test/unit/core.js for details concerning isFunction. + // Since version 1.3, DOM methods and functions like alert + // aren't supported. They return false on IE (#2968). + isFunction: function( obj ) { + return jQuery.type(obj) === "function"; + }, + + isArray: Array.isArray || function( obj ) { + return jQuery.type(obj) === "array"; + }, + + isWindow: function( obj ) { + return obj != null && obj == obj.window; + }, + + isNumeric: function( obj ) { + return !isNaN( parseFloat(obj) ) && isFinite( obj ); + }, + + type: function( obj ) { + return obj == null ? + String( obj ) : + class2type[ toString.call(obj) ] || "object"; + }, + + isPlainObject: function( obj ) { + // Must be an Object. + // Because of IE, we also have to check the presence of the constructor property. + // Make sure that DOM nodes and window objects don't pass through, as well + if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { + return false; + } + + try { + // Not own constructor property must be Object + if ( obj.constructor && + !hasOwn.call(obj, "constructor") && + !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { + return false; + } + } catch ( e ) { + // IE8,9 Will throw exceptions on certain host objects #9897 + return false; + } + + // Own properties are enumerated firstly, so to speed up, + // if last one is own, then all properties are own. + + var key; + for ( key in obj ) {} + + return key === undefined || hasOwn.call( obj, key ); + }, + + isEmptyObject: function( obj ) { + for ( var name in obj ) { + return false; + } + return true; + }, + + error: function( msg ) { + throw new Error( msg ); + }, + + parseJSON: function( data ) { + if ( typeof data !== "string" || !data ) { + return null; + } + + // Make sure leading/trailing whitespace is removed (IE can't handle it) + data = jQuery.trim( data ); + + // Attempt to parse using the native JSON parser first + if ( window.JSON && window.JSON.parse ) { + return window.JSON.parse( data ); + } + + // Make sure the incoming data is actual JSON + // Logic borrowed from http://json.org/json2.js + if ( rvalidchars.test( data.replace( rvalidescape, "@" ) + .replace( rvalidtokens, "]" ) + .replace( rvalidbraces, "")) ) { + + return ( new Function( "return " + data ) )(); + + } + jQuery.error( "Invalid JSON: " + data ); + }, + + // Cross-browser xml parsing + parseXML: function( data ) { + if ( typeof data !== "string" || !data ) { + return null; + } + var xml, tmp; + try { + if ( window.DOMParser ) { // Standard + tmp = new DOMParser(); + xml = tmp.parseFromString( data , "text/xml" ); + } else { // IE + xml = new ActiveXObject( "Microsoft.XMLDOM" ); + xml.async = "false"; + xml.loadXML( data ); + } + } catch( e ) { + xml = undefined; + } + if ( !xml || !xml.documentElement || xml.getElementsByTagName( "parsererror" ).length ) { + jQuery.error( "Invalid XML: " + data ); + } + return xml; + }, + + noop: function() {}, + + // Evaluates a script in a global context + // Workarounds based on findings by Jim Driscoll + // http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context + globalEval: function( data ) { + if ( data && rnotwhite.test( data ) ) { + // We use execScript on Internet Explorer + // We use an anonymous function so that context is window + // rather than jQuery in Firefox + ( window.execScript || function( data ) { + window[ "eval" ].call( window, data ); + } )( data ); + } + }, + + // Convert dashed to camelCase; used by the css and data modules + // Microsoft forgot to hump their vendor prefix (#9572) + camelCase: function( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); + }, + + nodeName: function( elem, name ) { + return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase(); + }, + + // args is for internal usage only + each: function( object, callback, args ) { + var name, i = 0, + length = object.length, + isObj = length === undefined || jQuery.isFunction( object ); + + if ( args ) { + if ( isObj ) { + for ( name in object ) { + if ( callback.apply( object[ name ], args ) === false ) { + break; + } + } + } else { + for ( ; i < length; ) { + if ( callback.apply( object[ i++ ], args ) === false ) { + break; + } + } + } + + // A special, fast, case for the most common use of each + } else { + if ( isObj ) { + for ( name in object ) { + if ( callback.call( object[ name ], name, object[ name ] ) === false ) { + break; + } + } + } else { + for ( ; i < length; ) { + if ( callback.call( object[ i ], i, object[ i++ ] ) === false ) { + break; + } + } + } + } + + return object; + }, + + // Use native String.trim function wherever possible + trim: trim ? + function( text ) { + return text == null ? + "" : + trim.call( text ); + } : + + // Otherwise use our own trimming functionality + function( text ) { + return text == null ? + "" : + text.toString().replace( trimLeft, "" ).replace( trimRight, "" ); + }, + + // results is for internal usage only + makeArray: function( array, results ) { + var ret = results || []; + + if ( array != null ) { + // The window, strings (and functions) also have 'length' + // Tweaked logic slightly to handle Blackberry 4.7 RegExp issues #6930 + var type = jQuery.type( array ); + + if ( array.length == null || type === "string" || type === "function" || type === "regexp" || jQuery.isWindow( array ) ) { + push.call( ret, array ); + } else { + jQuery.merge( ret, array ); + } + } + + return ret; + }, + + inArray: function( elem, array, i ) { + var len; + + if ( array ) { + if ( indexOf ) { + return indexOf.call( array, elem, i ); + } + + len = array.length; + i = i ? i < 0 ? Math.max( 0, len + i ) : i : 0; + + for ( ; i < len; i++ ) { + // Skip accessing in sparse arrays + if ( i in array && array[ i ] === elem ) { + return i; + } + } + } + + return -1; + }, + + merge: function( first, second ) { + var i = first.length, + j = 0; + + if ( typeof second.length === "number" ) { + for ( var l = second.length; j < l; j++ ) { + first[ i++ ] = second[ j ]; + } + + } else { + while ( second[j] !== undefined ) { + first[ i++ ] = second[ j++ ]; + } + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, inv ) { + var ret = [], retVal; + inv = !!inv; + + // Go through the array, only saving the items + // that pass the validator function + for ( var i = 0, length = elems.length; i < length; i++ ) { + retVal = !!callback( elems[ i ], i ); + if ( inv !== retVal ) { + ret.push( elems[ i ] ); + } + } + + return ret; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var value, key, ret = [], + i = 0, + length = elems.length, + // jquery objects are treated as arrays + isArray = elems instanceof jQuery || length !== undefined && typeof length === "number" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ; + + // Go through the array, translating each of the items to their + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret[ ret.length ] = value; + } + } + + // Go through every key on the object, + } else { + for ( key in elems ) { + value = callback( elems[ key ], key, arg ); + + if ( value != null ) { + ret[ ret.length ] = value; + } + } + } + + // Flatten any nested arrays + return ret.concat.apply( [], ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // Bind a function to a context, optionally partially applying any + // arguments. + proxy: function( fn, context ) { + if ( typeof context === "string" ) { + var tmp = fn[ context ]; + context = fn; + fn = tmp; + } + + // Quick check to determine if target is callable, in the spec + // this throws a TypeError, but we will just return undefined. + if ( !jQuery.isFunction( fn ) ) { + return undefined; + } + + // Simulated bind + var args = slice.call( arguments, 2 ), + proxy = function() { + return fn.apply( context, args.concat( slice.call( arguments ) ) ); + }; + + // Set the guid of unique handler to the same of original handler, so it can be removed + proxy.guid = fn.guid = fn.guid || proxy.guid || jQuery.guid++; + + return proxy; + }, + + // Multifunctional method to get and set values of a collection + // The value/s can optionally be executed if it's a function + access: function( elems, fn, key, value, chainable, emptyGet, pass ) { + var exec, + bulk = key == null, + i = 0, + length = elems.length; + + // Sets many values + if ( key && typeof key === "object" ) { + for ( i in key ) { + jQuery.access( elems, fn, i, key[i], 1, emptyGet, value ); + } + chainable = 1; + + // Sets one value + } else if ( value !== undefined ) { + // Optionally, function values get executed if exec is true + exec = pass === undefined && jQuery.isFunction( value ); + + if ( bulk ) { + // Bulk operations only iterate when executing function values + if ( exec ) { + exec = fn; + fn = function( elem, key, value ) { + return exec.call( jQuery( elem ), value ); + }; + + // Otherwise they run against the entire set + } else { + fn.call( elems, value ); + fn = null; + } + } + + if ( fn ) { + for (; i < length; i++ ) { + fn( elems[i], key, exec ? value.call( elems[i], i, fn( elems[i], key ) ) : value, pass ); + } + } + + chainable = 1; + } + + return chainable ? + elems : + + // Gets + bulk ? + fn.call( elems ) : + length ? fn( elems[0], key ) : emptyGet; + }, + + now: function() { + return ( new Date() ).getTime(); + }, + + // Use of jQuery.browser is frowned upon. + // More details: http://docs.jquery.com/Utilities/jQuery.browser + uaMatch: function( ua ) { + ua = ua.toLowerCase(); + + var match = rwebkit.exec( ua ) || + ropera.exec( ua ) || + rmsie.exec( ua ) || + ua.indexOf("compatible") < 0 && rmozilla.exec( ua ) || + []; + + return { browser: match[1] || "", version: match[2] || "0" }; + }, + + sub: function() { + function jQuerySub( selector, context ) { + return new jQuerySub.fn.init( selector, context ); + } + jQuery.extend( true, jQuerySub, this ); + jQuerySub.superclass = this; + jQuerySub.fn = jQuerySub.prototype = this(); + jQuerySub.fn.constructor = jQuerySub; + jQuerySub.sub = this.sub; + jQuerySub.fn.init = function init( selector, context ) { + if ( context && context instanceof jQuery && !(context instanceof jQuerySub) ) { + context = jQuerySub( context ); + } + + return jQuery.fn.init.call( this, selector, context, rootjQuerySub ); + }; + jQuerySub.fn.init.prototype = jQuerySub.fn; + var rootjQuerySub = jQuerySub(document); + return jQuerySub; + }, + + browser: {} +}); + +// Populate the class2type map +jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +}); + +browserMatch = jQuery.uaMatch( userAgent ); +if ( browserMatch.browser ) { + jQuery.browser[ browserMatch.browser ] = true; + jQuery.browser.version = browserMatch.version; +} + +// Deprecated, use jQuery.browser.webkit instead +if ( jQuery.browser.webkit ) { + jQuery.browser.safari = true; +} + +// IE doesn't match non-breaking spaces with \s +if ( rnotwhite.test( "\xA0" ) ) { + trimLeft = /^[\s\xA0]+/; + trimRight = /[\s\xA0]+$/; +} + +// All jQuery objects should point back to these +rootjQuery = jQuery(document); + +// Cleanup functions for the document ready method +if ( document.addEventListener ) { + DOMContentLoaded = function() { + document.removeEventListener( "DOMContentLoaded", DOMContentLoaded, false ); + jQuery.ready(); + }; + +} else if ( document.attachEvent ) { + DOMContentLoaded = function() { + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( document.readyState === "complete" ) { + document.detachEvent( "onreadystatechange", DOMContentLoaded ); + jQuery.ready(); + } + }; +} + +// The DOM ready check for Internet Explorer +function doScrollCheck() { + if ( jQuery.isReady ) { + return; + } + + try { + // If IE is used, use the trick by Diego Perini + // http://javascript.nwbox.com/IEContentLoaded/ + document.documentElement.doScroll("left"); + } catch(e) { + setTimeout( doScrollCheck, 1 ); + return; + } + + // and execute any waiting functions + jQuery.ready(); +} + +return jQuery; + +})(); + + +// String to Object flags format cache +var flagsCache = {}; + +// Convert String-formatted flags into Object-formatted ones and store in cache +function createFlags( flags ) { + var object = flagsCache[ flags ] = {}, + i, length; + flags = flags.split( /\s+/ ); + for ( i = 0, length = flags.length; i < length; i++ ) { + object[ flags[i] ] = true; + } + return object; +} + +/* + * Create a callback list using the following parameters: + * + * flags: an optional list of space-separated flags that will change how + * the callback list behaves + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible flags: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( flags ) { + + // Convert flags from String-formatted to Object-formatted + // (we check in cache first) + flags = flags ? ( flagsCache[ flags ] || createFlags( flags ) ) : {}; + + var // Actual callback list + list = [], + // Stack of fire calls for repeatable lists + stack = [], + // Last fire value (for non-forgettable lists) + memory, + // Flag to know if list was already fired + fired, + // Flag to know if list is currently firing + firing, + // First callback to fire (used internally by add and fireWith) + firingStart, + // End of the loop when firing + firingLength, + // Index of currently firing callback (modified by remove if needed) + firingIndex, + // Add one or several callbacks to the list + add = function( args ) { + var i, + length, + elem, + type, + actual; + for ( i = 0, length = args.length; i < length; i++ ) { + elem = args[ i ]; + type = jQuery.type( elem ); + if ( type === "array" ) { + // Inspect recursively + add( elem ); + } else if ( type === "function" ) { + // Add if not in unique mode and callback is not in + if ( !flags.unique || !self.has( elem ) ) { + list.push( elem ); + } + } + } + }, + // Fire callbacks + fire = function( context, args ) { + args = args || []; + memory = !flags.memory || [ context, args ]; + fired = true; + firing = true; + firingIndex = firingStart || 0; + firingStart = 0; + firingLength = list.length; + for ( ; list && firingIndex < firingLength; firingIndex++ ) { + if ( list[ firingIndex ].apply( context, args ) === false && flags.stopOnFalse ) { + memory = true; // Mark as halted + break; + } + } + firing = false; + if ( list ) { + if ( !flags.once ) { + if ( stack && stack.length ) { + memory = stack.shift(); + self.fireWith( memory[ 0 ], memory[ 1 ] ); + } + } else if ( memory === true ) { + self.disable(); + } else { + list = []; + } + } + }, + // Actual Callbacks object + self = { + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + var length = list.length; + add( arguments ); + // Do we need to add the callbacks to the + // current firing batch? + if ( firing ) { + firingLength = list.length; + // With memory, if we're not firing then + // we should call right away, unless previous + // firing was halted (stopOnFalse) + } else if ( memory && memory !== true ) { + firingStart = length; + fire( memory[ 0 ], memory[ 1 ] ); + } + } + return this; + }, + // Remove a callback from the list + remove: function() { + if ( list ) { + var args = arguments, + argIndex = 0, + argLength = args.length; + for ( ; argIndex < argLength ; argIndex++ ) { + for ( var i = 0; i < list.length; i++ ) { + if ( args[ argIndex ] === list[ i ] ) { + // Handle firingIndex and firingLength + if ( firing ) { + if ( i <= firingLength ) { + firingLength--; + if ( i <= firingIndex ) { + firingIndex--; + } + } + } + // Remove the element + list.splice( i--, 1 ); + // If we have some unicity property then + // we only need to do this once + if ( flags.unique ) { + break; + } + } + } + } + } + return this; + }, + // Control if a given callback is in the list + has: function( fn ) { + if ( list ) { + var i = 0, + length = list.length; + for ( ; i < length; i++ ) { + if ( fn === list[ i ] ) { + return true; + } + } + } + return false; + }, + // Remove all callbacks from the list + empty: function() { + list = []; + return this; + }, + // Have the list do nothing anymore + disable: function() { + list = stack = memory = undefined; + return this; + }, + // Is it disabled? + disabled: function() { + return !list; + }, + // Lock the list in its current state + lock: function() { + stack = undefined; + if ( !memory || memory === true ) { + self.disable(); + } + return this; + }, + // Is it locked? + locked: function() { + return !stack; + }, + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( stack ) { + if ( firing ) { + if ( !flags.once ) { + stack.push( [ context, args ] ); + } + } else if ( !( flags.once && memory ) ) { + fire( context, args ); + } + } + return this; + }, + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + + + +var // Static reference to slice + sliceDeferred = [].slice; + +jQuery.extend({ + + Deferred: function( func ) { + var doneList = jQuery.Callbacks( "once memory" ), + failList = jQuery.Callbacks( "once memory" ), + progressList = jQuery.Callbacks( "memory" ), + state = "pending", + lists = { + resolve: doneList, + reject: failList, + notify: progressList + }, + promise = { + done: doneList.add, + fail: failList.add, + progress: progressList.add, + + state: function() { + return state; + }, + + // Deprecated + isResolved: doneList.fired, + isRejected: failList.fired, + + then: function( doneCallbacks, failCallbacks, progressCallbacks ) { + deferred.done( doneCallbacks ).fail( failCallbacks ).progress( progressCallbacks ); + return this; + }, + always: function() { + deferred.done.apply( deferred, arguments ).fail.apply( deferred, arguments ); + return this; + }, + pipe: function( fnDone, fnFail, fnProgress ) { + return jQuery.Deferred(function( newDefer ) { + jQuery.each( { + done: [ fnDone, "resolve" ], + fail: [ fnFail, "reject" ], + progress: [ fnProgress, "notify" ] + }, function( handler, data ) { + var fn = data[ 0 ], + action = data[ 1 ], + returned; + if ( jQuery.isFunction( fn ) ) { + deferred[ handler ](function() { + returned = fn.apply( this, arguments ); + if ( returned && jQuery.isFunction( returned.promise ) ) { + returned.promise().then( newDefer.resolve, newDefer.reject, newDefer.notify ); + } else { + newDefer[ action + "With" ]( this === deferred ? newDefer : this, [ returned ] ); + } + }); + } else { + deferred[ handler ]( newDefer[ action ] ); + } + }); + }).promise(); + }, + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + if ( obj == null ) { + obj = promise; + } else { + for ( var key in promise ) { + obj[ key ] = promise[ key ]; + } + } + return obj; + } + }, + deferred = promise.promise({}), + key; + + for ( key in lists ) { + deferred[ key ] = lists[ key ].fire; + deferred[ key + "With" ] = lists[ key ].fireWith; + } + + // Handle state + deferred.done( function() { + state = "resolved"; + }, failList.disable, progressList.lock ).fail( function() { + state = "rejected"; + }, doneList.disable, progressList.lock ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( firstParam ) { + var args = sliceDeferred.call( arguments, 0 ), + i = 0, + length = args.length, + pValues = new Array( length ), + count = length, + pCount = length, + deferred = length <= 1 && firstParam && jQuery.isFunction( firstParam.promise ) ? + firstParam : + jQuery.Deferred(), + promise = deferred.promise(); + function resolveFunc( i ) { + return function( value ) { + args[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments, 0 ) : value; + if ( !( --count ) ) { + deferred.resolveWith( deferred, args ); + } + }; + } + function progressFunc( i ) { + return function( value ) { + pValues[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments, 0 ) : value; + deferred.notifyWith( promise, pValues ); + }; + } + if ( length > 1 ) { + for ( ; i < length; i++ ) { + if ( args[ i ] && args[ i ].promise && jQuery.isFunction( args[ i ].promise ) ) { + args[ i ].promise().then( resolveFunc(i), deferred.reject, progressFunc(i) ); + } else { + --count; + } + } + if ( !count ) { + deferred.resolveWith( deferred, args ); + } + } else if ( deferred !== firstParam ) { + deferred.resolveWith( deferred, length ? [ firstParam ] : [] ); + } + return promise; + } +}); + + + + +jQuery.support = (function() { + + var support, + all, + a, + select, + opt, + input, + fragment, + tds, + events, + eventName, + i, + isSupported, + div = document.createElement( "div" ), + documentElement = document.documentElement; + + // Preliminary tests + div.setAttribute("className", "t"); + div.innerHTML = "
a"; + + all = div.getElementsByTagName( "*" ); + a = div.getElementsByTagName( "a" )[ 0 ]; + + // Can't get basic test support + if ( !all || !all.length || !a ) { + return {}; + } + + // First batch of supports tests + select = document.createElement( "select" ); + opt = select.appendChild( document.createElement("option") ); + input = div.getElementsByTagName( "input" )[ 0 ]; + + support = { + // IE strips leading whitespace when .innerHTML is used + leadingWhitespace: ( div.firstChild.nodeType === 3 ), + + // Make sure that tbody elements aren't automatically inserted + // IE will insert them into empty tables + tbody: !div.getElementsByTagName("tbody").length, + + // Make sure that link elements get serialized correctly by innerHTML + // This requires a wrapper element in IE + htmlSerialize: !!div.getElementsByTagName("link").length, + + // Get the style information from getAttribute + // (IE uses .cssText instead) + style: /top/.test( a.getAttribute("style") ), + + // Make sure that URLs aren't manipulated + // (IE normalizes it by default) + hrefNormalized: ( a.getAttribute("href") === "/a" ), + + // Make sure that element opacity exists + // (IE uses filter instead) + // Use a regex to work around a WebKit issue. See #5145 + opacity: /^0.55/.test( a.style.opacity ), + + // Verify style float existence + // (IE uses styleFloat instead of cssFloat) + cssFloat: !!a.style.cssFloat, + + // Make sure that if no value is specified for a checkbox + // that it defaults to "on". + // (WebKit defaults to "" instead) + checkOn: ( input.value === "on" ), + + // Make sure that a selected-by-default option has a working selected property. + // (WebKit defaults to false instead of true, IE too, if it's in an optgroup) + optSelected: opt.selected, + + // Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7) + getSetAttribute: div.className !== "t", + + // Tests for enctype support on a form(#6743) + enctype: !!document.createElement("form").enctype, + + // Makes sure cloning an html5 element does not cause problems + // Where outerHTML is undefined, this still works + html5Clone: document.createElement("nav").cloneNode( true ).outerHTML !== "<:nav>", + + // Will be defined later + submitBubbles: true, + changeBubbles: true, + focusinBubbles: false, + deleteExpando: true, + noCloneEvent: true, + inlineBlockNeedsLayout: false, + shrinkWrapBlocks: false, + reliableMarginRight: true, + pixelMargin: true + }; + + // jQuery.boxModel DEPRECATED in 1.3, use jQuery.support.boxModel instead + jQuery.boxModel = support.boxModel = (document.compatMode === "CSS1Compat"); + + // Make sure checked status is properly cloned + input.checked = true; + support.noCloneChecked = input.cloneNode( true ).checked; + + // Make sure that the options inside disabled selects aren't marked as disabled + // (WebKit marks them as disabled) + select.disabled = true; + support.optDisabled = !opt.disabled; + + // Test to see if it's possible to delete an expando from an element + // Fails in Internet Explorer + try { + delete div.test; + } catch( e ) { + support.deleteExpando = false; + } + + if ( !div.addEventListener && div.attachEvent && div.fireEvent ) { + div.attachEvent( "onclick", function() { + // Cloning a node shouldn't copy over any + // bound event handlers (IE does this) + support.noCloneEvent = false; + }); + div.cloneNode( true ).fireEvent( "onclick" ); + } + + // Check if a radio maintains its value + // after being appended to the DOM + input = document.createElement("input"); + input.value = "t"; + input.setAttribute("type", "radio"); + support.radioValue = input.value === "t"; + + input.setAttribute("checked", "checked"); + + // #11217 - WebKit loses check when the name is after the checked attribute + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + fragment = document.createDocumentFragment(); + fragment.appendChild( div.lastChild ); + + // WebKit doesn't clone checked state correctly in fragments + support.checkClone = fragment.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Check if a disconnected checkbox will retain its checked + // value of true after appended to the DOM (IE6/7) + support.appendChecked = input.checked; + + fragment.removeChild( input ); + fragment.appendChild( div ); + + // Technique from Juriy Zaytsev + // http://perfectionkills.com/detecting-event-support-without-browser-sniffing/ + // We only care about the case where non-standard event systems + // are used, namely in IE. Short-circuiting here helps us to + // avoid an eval call (in setAttribute) which can cause CSP + // to go haywire. See: https://developer.mozilla.org/en/Security/CSP + if ( div.attachEvent ) { + for ( i in { + submit: 1, + change: 1, + focusin: 1 + }) { + eventName = "on" + i; + isSupported = ( eventName in div ); + if ( !isSupported ) { + div.setAttribute( eventName, "return;" ); + isSupported = ( typeof div[ eventName ] === "function" ); + } + support[ i + "Bubbles" ] = isSupported; + } + } + + fragment.removeChild( div ); + + // Null elements to avoid leaks in IE + fragment = select = opt = div = input = null; + + // Run tests that need a body at doc ready + jQuery(function() { + var container, outer, inner, table, td, offsetSupport, + marginDiv, conMarginTop, style, html, positionTopLeftWidthHeight, + paddingMarginBorderVisibility, paddingMarginBorder, + body = document.getElementsByTagName("body")[0]; + + if ( !body ) { + // Return for frameset docs that don't have a body + return; + } + + conMarginTop = 1; + paddingMarginBorder = "padding:0;margin:0;border:"; + positionTopLeftWidthHeight = "position:absolute;top:0;left:0;width:1px;height:1px;"; + paddingMarginBorderVisibility = paddingMarginBorder + "0;visibility:hidden;"; + style = "style='" + positionTopLeftWidthHeight + paddingMarginBorder + "5px solid #000;"; + html = "
" + + "" + + "
"; + + container = document.createElement("div"); + container.style.cssText = paddingMarginBorderVisibility + "width:0;height:0;position:static;top:0;margin-top:" + conMarginTop + "px"; + body.insertBefore( container, body.firstChild ); + + // Construct the test element + div = document.createElement("div"); + container.appendChild( div ); + + // Check if table cells still have offsetWidth/Height when they are set + // to display:none and there are still other visible table cells in a + // table row; if so, offsetWidth/Height are not reliable for use when + // determining if an element has been hidden directly using + // display:none (it is still safe to use offsets if a parent element is + // hidden; don safety goggles and see bug #4512 for more information). + // (only IE 8 fails this test) + div.innerHTML = "
t
"; + tds = div.getElementsByTagName( "td" ); + isSupported = ( tds[ 0 ].offsetHeight === 0 ); + + tds[ 0 ].style.display = ""; + tds[ 1 ].style.display = "none"; + + // Check if empty table cells still have offsetWidth/Height + // (IE <= 8 fail this test) + support.reliableHiddenOffsets = isSupported && ( tds[ 0 ].offsetHeight === 0 ); + + // Check if div with explicit width and no margin-right incorrectly + // gets computed margin-right based on width of container. For more + // info see bug #3333 + // Fails in WebKit before Feb 2011 nightlies + // WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right + if ( window.getComputedStyle ) { + div.innerHTML = ""; + marginDiv = document.createElement( "div" ); + marginDiv.style.width = "0"; + marginDiv.style.marginRight = "0"; + div.style.width = "2px"; + div.appendChild( marginDiv ); + support.reliableMarginRight = + ( parseInt( ( window.getComputedStyle( marginDiv, null ) || { marginRight: 0 } ).marginRight, 10 ) || 0 ) === 0; + } + + if ( typeof div.style.zoom !== "undefined" ) { + // Check if natively block-level elements act like inline-block + // elements when setting their display to 'inline' and giving + // them layout + // (IE < 8 does this) + div.innerHTML = ""; + div.style.width = div.style.padding = "1px"; + div.style.border = 0; + div.style.overflow = "hidden"; + div.style.display = "inline"; + div.style.zoom = 1; + support.inlineBlockNeedsLayout = ( div.offsetWidth === 3 ); + + // Check if elements with layout shrink-wrap their children + // (IE 6 does this) + div.style.display = "block"; + div.style.overflow = "visible"; + div.innerHTML = "
"; + support.shrinkWrapBlocks = ( div.offsetWidth !== 3 ); + } + + div.style.cssText = positionTopLeftWidthHeight + paddingMarginBorderVisibility; + div.innerHTML = html; + + outer = div.firstChild; + inner = outer.firstChild; + td = outer.nextSibling.firstChild.firstChild; + + offsetSupport = { + doesNotAddBorder: ( inner.offsetTop !== 5 ), + doesAddBorderForTableAndCells: ( td.offsetTop === 5 ) + }; + + inner.style.position = "fixed"; + inner.style.top = "20px"; + + // safari subtracts parent border width here which is 5px + offsetSupport.fixedPosition = ( inner.offsetTop === 20 || inner.offsetTop === 15 ); + inner.style.position = inner.style.top = ""; + + outer.style.overflow = "hidden"; + outer.style.position = "relative"; + + offsetSupport.subtractsBorderForOverflowNotVisible = ( inner.offsetTop === -5 ); + offsetSupport.doesNotIncludeMarginInBodyOffset = ( body.offsetTop !== conMarginTop ); + + if ( window.getComputedStyle ) { + div.style.marginTop = "1%"; + support.pixelMargin = ( window.getComputedStyle( div, null ) || { marginTop: 0 } ).marginTop !== "1%"; + } + + if ( typeof container.style.zoom !== "undefined" ) { + container.style.zoom = 1; + } + + body.removeChild( container ); + marginDiv = div = container = null; + + jQuery.extend( support, offsetSupport ); + }); + + return support; +})(); + + + + +var rbrace = /^(?:\{.*\}|\[.*\])$/, + rmultiDash = /([A-Z])/g; + +jQuery.extend({ + cache: {}, + + // Please use with caution + uuid: 0, + + // Unique for each copy of jQuery on the page + // Non-digits removed to match rinlinejQuery + expando: "jQuery" + ( jQuery.fn.jquery + Math.random() ).replace( /\D/g, "" ), + + // The following elements throw uncatchable exceptions if you + // attempt to add expando properties to them. + noData: { + "embed": true, + // Ban all objects except for Flash (which handle expandos) + "object": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000", + "applet": true + }, + + hasData: function( elem ) { + elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; + return !!elem && !isEmptyDataObject( elem ); + }, + + data: function( elem, name, data, pvt /* Internal Use Only */ ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var privateCache, thisCache, ret, + internalKey = jQuery.expando, + getByName = typeof name === "string", + + // We have to handle DOM nodes and JS objects differently because IE6-7 + // can't GC object references properly across the DOM-JS boundary + isNode = elem.nodeType, + + // Only DOM nodes need the global jQuery cache; JS object data is + // attached directly to the object so GC can occur automatically + cache = isNode ? jQuery.cache : elem, + + // Only defining an ID for JS objects if its cache already exists allows + // the code to shortcut on the same path as a DOM node with no cache + id = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey, + isEvents = name === "events"; + + // Avoid doing any more work than we need to when trying to get data on an + // object that has no data at all + if ( (!id || !cache[id] || (!isEvents && !pvt && !cache[id].data)) && getByName && data === undefined ) { + return; + } + + if ( !id ) { + // Only DOM nodes need a new unique ID for each element since their data + // ends up in the global cache + if ( isNode ) { + elem[ internalKey ] = id = ++jQuery.uuid; + } else { + id = internalKey; + } + } + + if ( !cache[ id ] ) { + cache[ id ] = {}; + + // Avoids exposing jQuery metadata on plain JS objects when the object + // is serialized using JSON.stringify + if ( !isNode ) { + cache[ id ].toJSON = jQuery.noop; + } + } + + // An object can be passed to jQuery.data instead of a key/value pair; this gets + // shallow copied over onto the existing cache + if ( typeof name === "object" || typeof name === "function" ) { + if ( pvt ) { + cache[ id ] = jQuery.extend( cache[ id ], name ); + } else { + cache[ id ].data = jQuery.extend( cache[ id ].data, name ); + } + } + + privateCache = thisCache = cache[ id ]; + + // jQuery data() is stored in a separate object inside the object's internal data + // cache in order to avoid key collisions between internal data and user-defined + // data. + if ( !pvt ) { + if ( !thisCache.data ) { + thisCache.data = {}; + } + + thisCache = thisCache.data; + } + + if ( data !== undefined ) { + thisCache[ jQuery.camelCase( name ) ] = data; + } + + // Users should not attempt to inspect the internal events object using jQuery.data, + // it is undocumented and subject to change. But does anyone listen? No. + if ( isEvents && !thisCache[ name ] ) { + return privateCache.events; + } + + // Check for both converted-to-camel and non-converted data property names + // If a data property was specified + if ( getByName ) { + + // First Try to find as-is property data + ret = thisCache[ name ]; + + // Test for null|undefined property data + if ( ret == null ) { + + // Try to find the camelCased property + ret = thisCache[ jQuery.camelCase( name ) ]; + } + } else { + ret = thisCache; + } + + return ret; + }, + + removeData: function( elem, name, pvt /* Internal Use Only */ ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var thisCache, i, l, + + // Reference to internal data cache key + internalKey = jQuery.expando, + + isNode = elem.nodeType, + + // See jQuery.data for more information + cache = isNode ? jQuery.cache : elem, + + // See jQuery.data for more information + id = isNode ? elem[ internalKey ] : internalKey; + + // If there is already no cache entry for this object, there is no + // purpose in continuing + if ( !cache[ id ] ) { + return; + } + + if ( name ) { + + thisCache = pvt ? cache[ id ] : cache[ id ].data; + + if ( thisCache ) { + + // Support array or space separated string names for data keys + if ( !jQuery.isArray( name ) ) { + + // try the string as a key before any manipulation + if ( name in thisCache ) { + name = [ name ]; + } else { + + // split the camel cased version by spaces unless a key with the spaces exists + name = jQuery.camelCase( name ); + if ( name in thisCache ) { + name = [ name ]; + } else { + name = name.split( " " ); + } + } + } + + for ( i = 0, l = name.length; i < l; i++ ) { + delete thisCache[ name[i] ]; + } + + // If there is no data left in the cache, we want to continue + // and let the cache object itself get destroyed + if ( !( pvt ? isEmptyDataObject : jQuery.isEmptyObject )( thisCache ) ) { + return; + } + } + } + + // See jQuery.data for more information + if ( !pvt ) { + delete cache[ id ].data; + + // Don't destroy the parent cache unless the internal data object + // had been the only thing left in it + if ( !isEmptyDataObject(cache[ id ]) ) { + return; + } + } + + // Browsers that fail expando deletion also refuse to delete expandos on + // the window, but it will allow it on all other JS objects; other browsers + // don't care + // Ensure that `cache` is not a window object #10080 + if ( jQuery.support.deleteExpando || !cache.setInterval ) { + delete cache[ id ]; + } else { + cache[ id ] = null; + } + + // We destroyed the cache and need to eliminate the expando on the node to avoid + // false lookups in the cache for entries that no longer exist + if ( isNode ) { + // IE does not allow us to delete expando properties from nodes, + // nor does it have a removeAttribute function on Document nodes; + // we must handle all of these cases + if ( jQuery.support.deleteExpando ) { + delete elem[ internalKey ]; + } else if ( elem.removeAttribute ) { + elem.removeAttribute( internalKey ); + } else { + elem[ internalKey ] = null; + } + } + }, + + // For internal use only. + _data: function( elem, name, data ) { + return jQuery.data( elem, name, data, true ); + }, + + // A method for determining if a DOM node can handle the data expando + acceptData: function( elem ) { + if ( elem.nodeName ) { + var match = jQuery.noData[ elem.nodeName.toLowerCase() ]; + + if ( match ) { + return !(match === true || elem.getAttribute("classid") !== match); + } + } + + return true; + } +}); + +jQuery.fn.extend({ + data: function( key, value ) { + var parts, part, attr, name, l, + elem = this[0], + i = 0, + data = null; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = jQuery.data( elem ); + + if ( elem.nodeType === 1 && !jQuery._data( elem, "parsedAttrs" ) ) { + attr = elem.attributes; + for ( l = attr.length; i < l; i++ ) { + name = attr[i].name; + + if ( name.indexOf( "data-" ) === 0 ) { + name = jQuery.camelCase( name.substring(5) ); + + dataAttr( elem, name, data[ name ] ); + } + } + jQuery._data( elem, "parsedAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each(function() { + jQuery.data( this, key ); + }); + } + + parts = key.split( ".", 2 ); + parts[1] = parts[1] ? "." + parts[1] : ""; + part = parts[1] + "!"; + + return jQuery.access( this, function( value ) { + + if ( value === undefined ) { + data = this.triggerHandler( "getData" + part, [ parts[0] ] ); + + // Try to fetch any internally stored data first + if ( data === undefined && elem ) { + data = jQuery.data( elem, key ); + data = dataAttr( elem, key, data ); + } + + return data === undefined && parts[1] ? + this.data( parts[0] ) : + data; + } + + parts[1] = value; + this.each(function() { + var self = jQuery( this ); + + self.triggerHandler( "setData" + part, parts ); + jQuery.data( this, key, value ); + self.triggerHandler( "changeData" + part, parts ); + }); + }, null, value, arguments.length > 1, null, false ); + }, + + removeData: function( key ) { + return this.each(function() { + jQuery.removeData( this, key ); + }); + } +}); + +function dataAttr( elem, key, data ) { + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + + var name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase(); + + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = data === "true" ? true : + data === "false" ? false : + data === "null" ? null : + jQuery.isNumeric( data ) ? +data : + rbrace.test( data ) ? jQuery.parseJSON( data ) : + data; + } catch( e ) {} + + // Make sure we set the data so it isn't changed later + jQuery.data( elem, key, data ); + + } else { + data = undefined; + } + } + + return data; +} + +// checks a cache object for emptiness +function isEmptyDataObject( obj ) { + for ( var name in obj ) { + + // if the public data object is empty, the private is still empty + if ( name === "data" && jQuery.isEmptyObject( obj[name] ) ) { + continue; + } + if ( name !== "toJSON" ) { + return false; + } + } + + return true; +} + + + + +function handleQueueMarkDefer( elem, type, src ) { + var deferDataKey = type + "defer", + queueDataKey = type + "queue", + markDataKey = type + "mark", + defer = jQuery._data( elem, deferDataKey ); + if ( defer && + ( src === "queue" || !jQuery._data(elem, queueDataKey) ) && + ( src === "mark" || !jQuery._data(elem, markDataKey) ) ) { + // Give room for hard-coded callbacks to fire first + // and eventually mark/queue something else on the element + setTimeout( function() { + if ( !jQuery._data( elem, queueDataKey ) && + !jQuery._data( elem, markDataKey ) ) { + jQuery.removeData( elem, deferDataKey, true ); + defer.fire(); + } + }, 0 ); + } +} + +jQuery.extend({ + + _mark: function( elem, type ) { + if ( elem ) { + type = ( type || "fx" ) + "mark"; + jQuery._data( elem, type, (jQuery._data( elem, type ) || 0) + 1 ); + } + }, + + _unmark: function( force, elem, type ) { + if ( force !== true ) { + type = elem; + elem = force; + force = false; + } + if ( elem ) { + type = type || "fx"; + var key = type + "mark", + count = force ? 0 : ( (jQuery._data( elem, key ) || 1) - 1 ); + if ( count ) { + jQuery._data( elem, key, count ); + } else { + jQuery.removeData( elem, key, true ); + handleQueueMarkDefer( elem, type, "mark" ); + } + } + }, + + queue: function( elem, type, data ) { + var q; + if ( elem ) { + type = ( type || "fx" ) + "queue"; + q = jQuery._data( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !q || jQuery.isArray(data) ) { + q = jQuery._data( elem, type, jQuery.makeArray(data) ); + } else { + q.push( data ); + } + } + return q || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + fn = queue.shift(), + hooks = {}; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + } + + if ( fn ) { + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + jQuery._data( elem, type + ".run", hooks ); + fn.call( elem, function() { + jQuery.dequeue( elem, type ); + }, hooks ); + } + + if ( !queue.length ) { + jQuery.removeData( elem, type + "queue " + type + ".run", true ); + handleQueueMarkDefer( elem, type, "queue" ); + } + } +}); + +jQuery.fn.extend({ + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[0], type ); + } + + return data === undefined ? + this : + this.each(function() { + var queue = jQuery.queue( this, type, data ); + + if ( type === "fx" && queue[0] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + }); + }, + dequeue: function( type ) { + return this.each(function() { + jQuery.dequeue( this, type ); + }); + }, + // Based off of the plugin by Clint Helfers, with permission. + // http://blindsignals.com/index.php/2009/07/jquery-delay/ + delay: function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = setTimeout( next, time ); + hooks.stop = function() { + clearTimeout( timeout ); + }; + }); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, object ) { + if ( typeof type !== "string" ) { + object = type; + type = undefined; + } + type = type || "fx"; + var defer = jQuery.Deferred(), + elements = this, + i = elements.length, + count = 1, + deferDataKey = type + "defer", + queueDataKey = type + "queue", + markDataKey = type + "mark", + tmp; + function resolve() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + } + while( i-- ) { + if (( tmp = jQuery.data( elements[ i ], deferDataKey, undefined, true ) || + ( jQuery.data( elements[ i ], queueDataKey, undefined, true ) || + jQuery.data( elements[ i ], markDataKey, undefined, true ) ) && + jQuery.data( elements[ i ], deferDataKey, jQuery.Callbacks( "once memory" ), true ) )) { + count++; + tmp.add( resolve ); + } + } + resolve(); + return defer.promise( object ); + } +}); + + + + +var rclass = /[\n\t\r]/g, + rspace = /\s+/, + rreturn = /\r/g, + rtype = /^(?:button|input)$/i, + rfocusable = /^(?:button|input|object|select|textarea)$/i, + rclickable = /^a(?:rea)?$/i, + rboolean = /^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i, + getSetAttribute = jQuery.support.getSetAttribute, + nodeHook, boolHook, fixSpecified; + +jQuery.fn.extend({ + attr: function( name, value ) { + return jQuery.access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each(function() { + jQuery.removeAttr( this, name ); + }); + }, + + prop: function( name, value ) { + return jQuery.access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + name = jQuery.propFix[ name ] || name; + return this.each(function() { + // try/catch handles cases where IE balks (such as removing a property on window) + try { + this[ name ] = undefined; + delete this[ name ]; + } catch( e ) {} + }); + }, + + addClass: function( value ) { + var classNames, i, l, elem, + setClass, c, cl; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( j ) { + jQuery( this ).addClass( value.call(this, j, this.className) ); + }); + } + + if ( value && typeof value === "string" ) { + classNames = value.split( rspace ); + + for ( i = 0, l = this.length; i < l; i++ ) { + elem = this[ i ]; + + if ( elem.nodeType === 1 ) { + if ( !elem.className && classNames.length === 1 ) { + elem.className = value; + + } else { + setClass = " " + elem.className + " "; + + for ( c = 0, cl = classNames.length; c < cl; c++ ) { + if ( !~setClass.indexOf( " " + classNames[ c ] + " " ) ) { + setClass += classNames[ c ] + " "; + } + } + elem.className = jQuery.trim( setClass ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classNames, i, l, elem, className, c, cl; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( j ) { + jQuery( this ).removeClass( value.call(this, j, this.className) ); + }); + } + + if ( (value && typeof value === "string") || value === undefined ) { + classNames = ( value || "" ).split( rspace ); + + for ( i = 0, l = this.length; i < l; i++ ) { + elem = this[ i ]; + + if ( elem.nodeType === 1 && elem.className ) { + if ( value ) { + className = (" " + elem.className + " ").replace( rclass, " " ); + for ( c = 0, cl = classNames.length; c < cl; c++ ) { + className = className.replace(" " + classNames[ c ] + " ", " "); + } + elem.className = jQuery.trim( className ); + + } else { + elem.className = ""; + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isBool = typeof stateVal === "boolean"; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( i ) { + jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal ); + }); + } + + return this.each(function() { + if ( type === "string" ) { + // toggle individual class names + var className, + i = 0, + self = jQuery( this ), + state = stateVal, + classNames = value.split( rspace ); + + while ( (className = classNames[ i++ ]) ) { + // check each className given, space seperated list + state = isBool ? state : !self.hasClass( className ); + self[ state ? "addClass" : "removeClass" ]( className ); + } + + } else if ( type === "undefined" || type === "boolean" ) { + if ( this.className ) { + // store className if set + jQuery._data( this, "__className__", this.className ); + } + + // toggle whole className + this.className = this.className || value === false ? "" : jQuery._data( this, "__className__" ) || ""; + } + }); + }, + + hasClass: function( selector ) { + var className = " " + selector + " ", + i = 0, + l = this.length; + for ( ; i < l; i++ ) { + if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) > -1 ) { + return true; + } + } + + return false; + }, + + val: function( value ) { + var hooks, ret, isFunction, + elem = this[0]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) { + return ret; + } + + ret = elem.value; + + return typeof ret === "string" ? + // handle most common string cases + ret.replace(rreturn, "") : + // handle cases where value is null/undef or number + ret == null ? "" : ret; + } + + return; + } + + isFunction = jQuery.isFunction( value ); + + return this.each(function( i ) { + var self = jQuery(this), val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( isFunction ) { + val = value.call( this, i, self.val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + } else if ( typeof val === "number" ) { + val += ""; + } else if ( jQuery.isArray( val ) ) { + val = jQuery.map(val, function ( value ) { + return value == null ? "" : value + ""; + }); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + }); + } +}); + +jQuery.extend({ + valHooks: { + option: { + get: function( elem ) { + // attributes.value is undefined in Blackberry 4.7 but + // uses .value. See #6932 + var val = elem.attributes.value; + return !val || val.specified ? elem.value : elem.text; + } + }, + select: { + get: function( elem ) { + var value, i, max, option, + index = elem.selectedIndex, + values = [], + options = elem.options, + one = elem.type === "select-one"; + + // Nothing was selected + if ( index < 0 ) { + return null; + } + + // Loop through all the selected options + i = one ? index : 0; + max = one ? index + 1 : options.length; + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Don't return options that are disabled or in a disabled optgroup + if ( option.selected && (jQuery.support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null) && + (!option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" )) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + // Fixes Bug #2551 -- select.val() broken in IE after form.reset() + if ( one && !values.length && options.length ) { + return jQuery( options[ index ] ).val(); + } + + return values; + }, + + set: function( elem, value ) { + var values = jQuery.makeArray( value ); + + jQuery(elem).find("option").each(function() { + this.selected = jQuery.inArray( jQuery(this).val(), values ) >= 0; + }); + + if ( !values.length ) { + elem.selectedIndex = -1; + } + return values; + } + } + }, + + attrFn: { + val: true, + css: true, + html: true, + text: true, + data: true, + width: true, + height: true, + offset: true + }, + + attr: function( elem, name, value, pass ) { + var ret, hooks, notxml, + nType = elem.nodeType; + + // don't get/set attributes on text, comment and attribute nodes + if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( pass && name in jQuery.attrFn ) { + return jQuery( elem )[ name ]( value ); + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); + + // All attributes are lowercase + // Grab necessary hook if one is defined + if ( notxml ) { + name = name.toLowerCase(); + hooks = jQuery.attrHooks[ name ] || ( rboolean.test( name ) ? boolHook : nodeHook ); + } + + if ( value !== undefined ) { + + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + + } else if ( hooks && "set" in hooks && notxml && (ret = hooks.set( elem, value, name )) !== undefined ) { + return ret; + + } else { + elem.setAttribute( name, "" + value ); + return value; + } + + } else if ( hooks && "get" in hooks && notxml && (ret = hooks.get( elem, name )) !== null ) { + return ret; + + } else { + + ret = elem.getAttribute( name ); + + // Non-existent attributes return null, we normalize to undefined + return ret === null ? + undefined : + ret; + } + }, + + removeAttr: function( elem, value ) { + var propName, attrNames, name, l, isBool, + i = 0; + + if ( value && elem.nodeType === 1 ) { + attrNames = value.toLowerCase().split( rspace ); + l = attrNames.length; + + for ( ; i < l; i++ ) { + name = attrNames[ i ]; + + if ( name ) { + propName = jQuery.propFix[ name ] || name; + isBool = rboolean.test( name ); + + // See #9699 for explanation of this approach (setting first, then removal) + // Do not do this for boolean attributes (see #10870) + if ( !isBool ) { + jQuery.attr( elem, name, "" ); + } + elem.removeAttribute( getSetAttribute ? name : propName ); + + // Set corresponding property to false for boolean attributes + if ( isBool && propName in elem ) { + elem[ propName ] = false; + } + } + } + } + }, + + attrHooks: { + type: { + set: function( elem, value ) { + // We can't allow the type property to be changed (since it causes problems in IE) + if ( rtype.test( elem.nodeName ) && elem.parentNode ) { + jQuery.error( "type property can't be changed" ); + } else if ( !jQuery.support.radioValue && value === "radio" && jQuery.nodeName(elem, "input") ) { + // Setting the type on a radio button after the value resets the value in IE6-9 + // Reset value to it's default in case type is set after value + // This is for element creation + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + }, + // Use the value property for back compat + // Use the nodeHook for button elements in IE6/7 (#1954) + value: { + get: function( elem, name ) { + if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { + return nodeHook.get( elem, name ); + } + return name in elem ? + elem.value : + null; + }, + set: function( elem, value, name ) { + if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { + return nodeHook.set( elem, value, name ); + } + // Does not return so that setAttribute is also used + elem.value = value; + } + } + }, + + propFix: { + tabindex: "tabIndex", + readonly: "readOnly", + "for": "htmlFor", + "class": "className", + maxlength: "maxLength", + cellspacing: "cellSpacing", + cellpadding: "cellPadding", + rowspan: "rowSpan", + colspan: "colSpan", + usemap: "useMap", + frameborder: "frameBorder", + contenteditable: "contentEditable" + }, + + prop: function( elem, name, value ) { + var ret, hooks, notxml, + nType = elem.nodeType; + + // don't get/set properties on text, comment and attribute nodes + if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); + + if ( notxml ) { + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) { + return ret; + + } else { + return ( elem[ name ] = value ); + } + + } else { + if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) { + return ret; + + } else { + return elem[ name ]; + } + } + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + // elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set + // http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + var attributeNode = elem.getAttributeNode("tabindex"); + + return attributeNode && attributeNode.specified ? + parseInt( attributeNode.value, 10 ) : + rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ? + 0 : + undefined; + } + } + } +}); + +// Add the tabIndex propHook to attrHooks for back-compat (different case is intentional) +jQuery.attrHooks.tabindex = jQuery.propHooks.tabIndex; + +// Hook for boolean attributes +boolHook = { + get: function( elem, name ) { + // Align boolean attributes with corresponding properties + // Fall back to attribute presence where some booleans are not supported + var attrNode, + property = jQuery.prop( elem, name ); + return property === true || typeof property !== "boolean" && ( attrNode = elem.getAttributeNode(name) ) && attrNode.nodeValue !== false ? + name.toLowerCase() : + undefined; + }, + set: function( elem, value, name ) { + var propName; + if ( value === false ) { + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + // value is true since we know at this point it's type boolean and not false + // Set boolean attributes to the same name and set the DOM property + propName = jQuery.propFix[ name ] || name; + if ( propName in elem ) { + // Only set the IDL specifically if it already exists on the element + elem[ propName ] = true; + } + + elem.setAttribute( name, name.toLowerCase() ); + } + return name; + } +}; + +// IE6/7 do not support getting/setting some attributes with get/setAttribute +if ( !getSetAttribute ) { + + fixSpecified = { + name: true, + id: true, + coords: true + }; + + // Use this for any attribute in IE6/7 + // This fixes almost every IE6/7 issue + nodeHook = jQuery.valHooks.button = { + get: function( elem, name ) { + var ret; + ret = elem.getAttributeNode( name ); + return ret && ( fixSpecified[ name ] ? ret.nodeValue !== "" : ret.specified ) ? + ret.nodeValue : + undefined; + }, + set: function( elem, value, name ) { + // Set the existing or create a new attribute node + var ret = elem.getAttributeNode( name ); + if ( !ret ) { + ret = document.createAttribute( name ); + elem.setAttributeNode( ret ); + } + return ( ret.nodeValue = value + "" ); + } + }; + + // Apply the nodeHook to tabindex + jQuery.attrHooks.tabindex.set = nodeHook.set; + + // Set width and height to auto instead of 0 on empty string( Bug #8150 ) + // This is for removals + jQuery.each([ "width", "height" ], function( i, name ) { + jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { + set: function( elem, value ) { + if ( value === "" ) { + elem.setAttribute( name, "auto" ); + return value; + } + } + }); + }); + + // Set contenteditable to false on removals(#10429) + // Setting to empty string throws an error as an invalid value + jQuery.attrHooks.contenteditable = { + get: nodeHook.get, + set: function( elem, value, name ) { + if ( value === "" ) { + value = "false"; + } + nodeHook.set( elem, value, name ); + } + }; +} + + +// Some attributes require a special call on IE +if ( !jQuery.support.hrefNormalized ) { + jQuery.each([ "href", "src", "width", "height" ], function( i, name ) { + jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { + get: function( elem ) { + var ret = elem.getAttribute( name, 2 ); + return ret === null ? undefined : ret; + } + }); + }); +} + +if ( !jQuery.support.style ) { + jQuery.attrHooks.style = { + get: function( elem ) { + // Return undefined in the case of empty string + // Normalize to lowercase since IE uppercases css property names + return elem.style.cssText.toLowerCase() || undefined; + }, + set: function( elem, value ) { + return ( elem.style.cssText = "" + value ); + } + }; +} + +// Safari mis-reports the default selected property of an option +// Accessing the parent's selectedIndex property fixes it +if ( !jQuery.support.optSelected ) { + jQuery.propHooks.selected = jQuery.extend( jQuery.propHooks.selected, { + get: function( elem ) { + var parent = elem.parentNode; + + if ( parent ) { + parent.selectedIndex; + + // Make sure that it also works with optgroups, see #5701 + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + return null; + } + }); +} + +// IE6/7 call enctype encoding +if ( !jQuery.support.enctype ) { + jQuery.propFix.enctype = "encoding"; +} + +// Radios and checkboxes getter/setter +if ( !jQuery.support.checkOn ) { + jQuery.each([ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + get: function( elem ) { + // Handle the case where in Webkit "" is returned instead of "on" if a value isn't specified + return elem.getAttribute("value") === null ? "on" : elem.value; + } + }; + }); +} +jQuery.each([ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = jQuery.extend( jQuery.valHooks[ this ], { + set: function( elem, value ) { + if ( jQuery.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0 ); + } + } + }); +}); + + + + +var rformElems = /^(?:textarea|input|select)$/i, + rtypenamespace = /^([^\.]*)?(?:\.(.+))?$/, + rhoverHack = /(?:^|\s)hover(\.\S+)?\b/, + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|contextmenu)|click/, + rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + rquickIs = /^(\w*)(?:#([\w\-]+))?(?:\.([\w\-]+))?$/, + quickParse = function( selector ) { + var quick = rquickIs.exec( selector ); + if ( quick ) { + // 0 1 2 3 + // [ _, tag, id, class ] + quick[1] = ( quick[1] || "" ).toLowerCase(); + quick[3] = quick[3] && new RegExp( "(?:^|\\s)" + quick[3] + "(?:\\s|$)" ); + } + return quick; + }, + quickIs = function( elem, m ) { + var attrs = elem.attributes || {}; + return ( + (!m[1] || elem.nodeName.toLowerCase() === m[1]) && + (!m[2] || (attrs.id || {}).value === m[2]) && + (!m[3] || m[3].test( (attrs[ "class" ] || {}).value )) + ); + }, + hoverHack = function( events ) { + return jQuery.event.special.hover ? events : events.replace( rhoverHack, "mouseenter$1 mouseleave$1" ); + }; + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + add: function( elem, types, handler, data, selector ) { + + var elemData, eventHandle, events, + t, tns, type, namespaces, handleObj, + handleObjIn, quick, handlers, special; + + // Don't attach events to noData or text/comment nodes (allow plain objects tho) + if ( elem.nodeType === 3 || elem.nodeType === 8 || !types || !handler || !(elemData = jQuery._data( elem )) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + events = elemData.events; + if ( !events ) { + elemData.events = events = {}; + } + eventHandle = elemData.handle; + if ( !eventHandle ) { + elemData.handle = eventHandle = function( e ) { + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && (!e || jQuery.event.triggered !== e.type) ? + jQuery.event.dispatch.apply( eventHandle.elem, arguments ) : + undefined; + }; + // Add elem as a property of the handle fn to prevent a memory leak with IE non-native events + eventHandle.elem = elem; + } + + // Handle multiple events separated by a space + // jQuery(...).bind("mouseover mouseout", fn); + types = jQuery.trim( hoverHack(types) ).split( " " ); + for ( t = 0; t < types.length; t++ ) { + + tns = rtypenamespace.exec( types[t] ) || []; + type = tns[1]; + namespaces = ( tns[2] || "" ).split( "." ).sort(); + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend({ + type: type, + origType: tns[1], + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + quick: selector && quickParse( selector ), + namespace: namespaces.join(".") + }, handleObjIn ); + + // Init the event handler queue if we're the first + handlers = events[ type ]; + if ( !handlers ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener/attachEvent if the special events handler returns false + if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + // Bind the global event handler to the element + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle, false ); + + } else if ( elem.attachEvent ) { + elem.attachEvent( "on" + type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + // Nullify elem to prevent memory leaks in IE + elem = null; + }, + + global: {}, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var elemData = jQuery.hasData( elem ) && jQuery._data( elem ), + t, tns, type, origType, namespaces, origCount, + j, events, special, handle, eventType, handleObj; + + if ( !elemData || !(events = elemData.events) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = jQuery.trim( hoverHack( types || "" ) ).split(" "); + for ( t = 0; t < types.length; t++ ) { + tns = rtypenamespace.exec( types[t] ) || []; + type = origType = tns[1]; + namespaces = tns[2]; + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector? special.delegateType : special.bindType ) || type; + eventType = events[ type ] || []; + origCount = eventType.length; + namespaces = namespaces ? new RegExp("(^|\\.)" + namespaces.split(".").sort().join("\\.(?:.*\\.)?") + "(\\.|$)") : null; + + // Remove matching events + for ( j = 0; j < eventType.length; j++ ) { + handleObj = eventType[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !namespaces || namespaces.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) { + eventType.splice( j--, 1 ); + + if ( handleObj.selector ) { + eventType.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( eventType.length === 0 && origCount !== eventType.length ) { + if ( !special.teardown || special.teardown.call( elem, namespaces ) === false ) { + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + handle = elemData.handle; + if ( handle ) { + handle.elem = null; + } + + // removeData also checks for emptiness and clears the expando if empty + // so use it instead of delete + jQuery.removeData( elem, [ "events", "handle" ], true ); + } + }, + + // Events that are safe to short-circuit if no handlers are attached. + // Native DOM events should not be added, they may have inline handlers. + customEvent: { + "getData": true, + "setData": true, + "changeData": true + }, + + trigger: function( event, data, elem, onlyHandlers ) { + // Don't do events on text and comment nodes + if ( elem && (elem.nodeType === 3 || elem.nodeType === 8) ) { + return; + } + + // Event object or event type + var type = event.type || event, + namespaces = [], + cache, exclusive, i, cur, old, ontype, special, handle, eventPath, bubbleType; + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "!" ) >= 0 ) { + // Exclusive events trigger only for the exact event (no namespaces) + type = type.slice(0, -1); + exclusive = true; + } + + if ( type.indexOf( "." ) >= 0 ) { + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split("."); + type = namespaces.shift(); + namespaces.sort(); + } + + if ( (!elem || jQuery.event.customEvent[ type ]) && !jQuery.event.global[ type ] ) { + // No jQuery handlers for this event type, and it can't have inline handlers + return; + } + + // Caller can pass in an Event, Object, or just an event type string + event = typeof event === "object" ? + // jQuery.Event object + event[ jQuery.expando ] ? event : + // Object literal + new jQuery.Event( type, event ) : + // Just the event type (string) + new jQuery.Event( type ); + + event.type = type; + event.isTrigger = true; + event.exclusive = exclusive; + event.namespace = namespaces.join( "." ); + event.namespace_re = event.namespace? new RegExp("(^|\\.)" + namespaces.join("\\.(?:.*\\.)?") + "(\\.|$)") : null; + ontype = type.indexOf( ":" ) < 0 ? "on" + type : ""; + + // Handle a global trigger + if ( !elem ) { + + // TODO: Stop taunting the data cache; remove global events and always attach to document + cache = jQuery.cache; + for ( i in cache ) { + if ( cache[ i ].events && cache[ i ].events[ type ] ) { + jQuery.event.trigger( event, data, cache[ i ].handle.elem, true ); + } + } + return; + } + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data != null ? jQuery.makeArray( data ) : []; + data.unshift( event ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + eventPath = [[ elem, special.bindType || type ]]; + if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + cur = rfocusMorph.test( bubbleType + type ) ? elem : elem.parentNode; + old = null; + for ( ; cur; cur = cur.parentNode ) { + eventPath.push([ cur, bubbleType ]); + old = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( old && old === elem.ownerDocument ) { + eventPath.push([ old.defaultView || old.parentWindow || window, bubbleType ]); + } + } + + // Fire handlers on the event path + for ( i = 0; i < eventPath.length && !event.isPropagationStopped(); i++ ) { + + cur = eventPath[i][0]; + event.type = eventPath[i][1]; + + handle = ( jQuery._data( cur, "events" ) || {} )[ event.type ] && jQuery._data( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + // Note that this is a bare JS function and not a jQuery handler + handle = ontype && cur[ ontype ]; + if ( handle && jQuery.acceptData( cur ) && handle.apply( cur, data ) === false ) { + event.preventDefault(); + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( (!special._default || special._default.apply( elem.ownerDocument, data ) === false) && + !(type === "click" && jQuery.nodeName( elem, "a" )) && jQuery.acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name name as the event. + // Can't use an .isFunction() check here because IE6/7 fails that test. + // Don't do default actions on window, that's where global variables be (#6170) + // IE<9 dies on focus/blur to hidden element (#1486) + if ( ontype && elem[ type ] && ((type !== "focus" && type !== "blur") || event.target.offsetWidth !== 0) && !jQuery.isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + old = elem[ ontype ]; + + if ( old ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + elem[ type ](); + jQuery.event.triggered = undefined; + + if ( old ) { + elem[ ontype ] = old; + } + } + } + } + + return event.result; + }, + + dispatch: function( event ) { + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( event || window.event ); + + var handlers = ( (jQuery._data( this, "events" ) || {} )[ event.type ] || []), + delegateCount = handlers.delegateCount, + args = [].slice.call( arguments, 0 ), + run_all = !event.exclusive && !event.namespace, + special = jQuery.event.special[ event.type ] || {}, + handlerQueue = [], + i, j, cur, jqcur, ret, selMatch, matched, matches, handleObj, sel, related; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[0] = event; + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers that should run if there are delegated events + // Avoid non-left-click bubbling in Firefox (#3861) + if ( delegateCount && !(event.button && event.type === "click") ) { + + // Pregenerate a single jQuery object for reuse with .is() + jqcur = jQuery(this); + jqcur.context = this.ownerDocument || this; + + for ( cur = event.target; cur != this; cur = cur.parentNode || this ) { + + // Don't process events on disabled elements (#6911, #8165) + if ( cur.disabled !== true ) { + selMatch = {}; + matches = []; + jqcur[0] = cur; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + sel = handleObj.selector; + + if ( selMatch[ sel ] === undefined ) { + selMatch[ sel ] = ( + handleObj.quick ? quickIs( cur, handleObj.quick ) : jqcur.is( sel ) + ); + } + if ( selMatch[ sel ] ) { + matches.push( handleObj ); + } + } + if ( matches.length ) { + handlerQueue.push({ elem: cur, matches: matches }); + } + } + } + } + + // Add the remaining (directly-bound) handlers + if ( handlers.length > delegateCount ) { + handlerQueue.push({ elem: this, matches: handlers.slice( delegateCount ) }); + } + + // Run delegates first; they may want to stop propagation beneath us + for ( i = 0; i < handlerQueue.length && !event.isPropagationStopped(); i++ ) { + matched = handlerQueue[ i ]; + event.currentTarget = matched.elem; + + for ( j = 0; j < matched.matches.length && !event.isImmediatePropagationStopped(); j++ ) { + handleObj = matched.matches[ j ]; + + // Triggered event must either 1) be non-exclusive and have no namespace, or + // 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace). + if ( run_all || (!event.namespace && !handleObj.namespace) || event.namespace_re && event.namespace_re.test( handleObj.namespace ) ) { + + event.data = handleObj.data; + event.handleObj = handleObj; + + ret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler ) + .apply( matched.elem, args ); + + if ( ret !== undefined ) { + event.result = ret; + if ( ret === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + // Includes some event props shared by KeyEvent and MouseEvent + // *** attrChange attrName relatedNode srcElement are not normalized, non-W3C, deprecated, will be removed in 1.8 *** + props: "attrChange attrName relatedNode srcElement altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "), + + fixHooks: {}, + + keyHooks: { + props: "char charCode key keyCode".split(" "), + filter: function( event, original ) { + + // Add which for key events + if ( event.which == null ) { + event.which = original.charCode != null ? original.charCode : original.keyCode; + } + + return event; + } + }, + + mouseHooks: { + props: "button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "), + filter: function( event, original ) { + var eventDoc, doc, body, + button = original.button, + fromElement = original.fromElement; + + // Calculate pageX/Y if missing and clientX/Y available + if ( event.pageX == null && original.clientX != null ) { + eventDoc = event.target.ownerDocument || document; + doc = eventDoc.documentElement; + body = eventDoc.body; + + event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 ); + event.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 ) - ( doc && doc.clientTop || body && body.clientTop || 0 ); + } + + // Add relatedTarget, if necessary + if ( !event.relatedTarget && fromElement ) { + event.relatedTarget = fromElement === event.target ? original.toElement : fromElement; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + // Note: button is not normalized, so don't use it + if ( !event.which && button !== undefined ) { + event.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) ); + } + + return event; + } + }, + + fix: function( event ) { + if ( event[ jQuery.expando ] ) { + return event; + } + + // Create a writable copy of the event object and normalize some properties + var i, prop, + originalEvent = event, + fixHook = jQuery.event.fixHooks[ event.type ] || {}, + copy = fixHook.props ? this.props.concat( fixHook.props ) : this.props; + + event = jQuery.Event( originalEvent ); + + for ( i = copy.length; i; ) { + prop = copy[ --i ]; + event[ prop ] = originalEvent[ prop ]; + } + + // Fix target property, if necessary (#1925, IE 6/7/8 & Safari2) + if ( !event.target ) { + event.target = originalEvent.srcElement || document; + } + + // Target should not be a text node (#504, Safari) + if ( event.target.nodeType === 3 ) { + event.target = event.target.parentNode; + } + + // For mouse/key events; add metaKey if it's not there (#3368, IE6/7/8) + if ( event.metaKey === undefined ) { + event.metaKey = event.ctrlKey; + } + + return fixHook.filter? fixHook.filter( event, originalEvent ) : event; + }, + + special: { + ready: { + // Make sure the ready event is setup + setup: jQuery.bindReady + }, + + load: { + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + + focus: { + delegateType: "focusin" + }, + blur: { + delegateType: "focusout" + }, + + beforeunload: { + setup: function( data, namespaces, eventHandle ) { + // We only want to do this special case on windows + if ( jQuery.isWindow( this ) ) { + this.onbeforeunload = eventHandle; + } + }, + + teardown: function( namespaces, eventHandle ) { + if ( this.onbeforeunload === eventHandle ) { + this.onbeforeunload = null; + } + } + } + }, + + simulate: function( type, elem, event, bubble ) { + // Piggyback on a donor event to simulate a different one. + // Fake originalEvent to avoid donor's stopPropagation, but if the + // simulated event prevents default then we do the same on the donor. + var e = jQuery.extend( + new jQuery.Event(), + event, + { type: type, + isSimulated: true, + originalEvent: {} + } + ); + if ( bubble ) { + jQuery.event.trigger( e, null, elem ); + } else { + jQuery.event.dispatch.call( elem, e ); + } + if ( e.isDefaultPrevented() ) { + event.preventDefault(); + } + } +}; + +// Some plugins are using, but it's undocumented/deprecated and will be removed. +// The 1.7 special event interface should provide all the hooks needed now. +jQuery.event.handle = jQuery.event.dispatch; + +jQuery.removeEvent = document.removeEventListener ? + function( elem, type, handle ) { + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle, false ); + } + } : + function( elem, type, handle ) { + if ( elem.detachEvent ) { + elem.detachEvent( "on" + type, handle ); + } + }; + +jQuery.Event = function( src, props ) { + // Allow instantiation without the 'new' keyword + if ( !(this instanceof jQuery.Event) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = ( src.defaultPrevented || src.returnValue === false || + src.getPreventDefault && src.getPreventDefault() ) ? returnTrue : returnFalse; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || jQuery.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +function returnFalse() { + return false; +} +function returnTrue() { + return true; +} + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + preventDefault: function() { + this.isDefaultPrevented = returnTrue; + + var e = this.originalEvent; + if ( !e ) { + return; + } + + // if preventDefault exists run it on the original event + if ( e.preventDefault ) { + e.preventDefault(); + + // otherwise set the returnValue property of the original event to false (IE) + } else { + e.returnValue = false; + } + }, + stopPropagation: function() { + this.isPropagationStopped = returnTrue; + + var e = this.originalEvent; + if ( !e ) { + return; + } + // if stopPropagation exists run it on the original event + if ( e.stopPropagation ) { + e.stopPropagation(); + } + // otherwise set the cancelBubble property of the original event to true (IE) + e.cancelBubble = true; + }, + stopImmediatePropagation: function() { + this.isImmediatePropagationStopped = returnTrue; + this.stopPropagation(); + }, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse +}; + +// Create mouseenter/leave events using mouseover/out and event-time checks +jQuery.each({ + mouseenter: "mouseover", + mouseleave: "mouseout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var target = this, + related = event.relatedTarget, + handleObj = event.handleObj, + selector = handleObj.selector, + ret; + + // For mousenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || (related !== target && !jQuery.contains( target, related )) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +}); + +// IE submit delegation +if ( !jQuery.support.submitBubbles ) { + + jQuery.event.special.submit = { + setup: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Lazy-add a submit handler when a descendant form may potentially be submitted + jQuery.event.add( this, "click._submit keypress._submit", function( e ) { + // Node name check avoids a VML-related crash in IE (#9807) + var elem = e.target, + form = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.form : undefined; + if ( form && !form._submit_attached ) { + jQuery.event.add( form, "submit._submit", function( event ) { + event._submit_bubble = true; + }); + form._submit_attached = true; + } + }); + // return undefined since we don't need an event listener + }, + + postDispatch: function( event ) { + // If form was submitted by the user, bubble the event up the tree + if ( event._submit_bubble ) { + delete event._submit_bubble; + if ( this.parentNode && !event.isTrigger ) { + jQuery.event.simulate( "submit", this.parentNode, event, true ); + } + } + }, + + teardown: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Remove delegated handlers; cleanData eventually reaps submit handlers attached above + jQuery.event.remove( this, "._submit" ); + } + }; +} + +// IE change delegation and checkbox/radio fix +if ( !jQuery.support.changeBubbles ) { + + jQuery.event.special.change = { + + setup: function() { + + if ( rformElems.test( this.nodeName ) ) { + // IE doesn't fire change on a check/radio until blur; trigger it on click + // after a propertychange. Eat the blur-change in special.change.handle. + // This still fires onchange a second time for check/radio after blur. + if ( this.type === "checkbox" || this.type === "radio" ) { + jQuery.event.add( this, "propertychange._change", function( event ) { + if ( event.originalEvent.propertyName === "checked" ) { + this._just_changed = true; + } + }); + jQuery.event.add( this, "click._change", function( event ) { + if ( this._just_changed && !event.isTrigger ) { + this._just_changed = false; + jQuery.event.simulate( "change", this, event, true ); + } + }); + } + return false; + } + // Delegated event; lazy-add a change handler on descendant inputs + jQuery.event.add( this, "beforeactivate._change", function( e ) { + var elem = e.target; + + if ( rformElems.test( elem.nodeName ) && !elem._change_attached ) { + jQuery.event.add( elem, "change._change", function( event ) { + if ( this.parentNode && !event.isSimulated && !event.isTrigger ) { + jQuery.event.simulate( "change", this.parentNode, event, true ); + } + }); + elem._change_attached = true; + } + }); + }, + + handle: function( event ) { + var elem = event.target; + + // Swallow native change events from checkbox/radio, we already triggered them above + if ( this !== elem || event.isSimulated || event.isTrigger || (elem.type !== "radio" && elem.type !== "checkbox") ) { + return event.handleObj.handler.apply( this, arguments ); + } + }, + + teardown: function() { + jQuery.event.remove( this, "._change" ); + + return rformElems.test( this.nodeName ); + } + }; +} + +// Create "bubbling" focus and blur events +if ( !jQuery.support.focusinBubbles ) { + jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler while someone wants focusin/focusout + var attaches = 0, + handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + if ( attaches++ === 0 ) { + document.addEventListener( orig, handler, true ); + } + }, + teardown: function() { + if ( --attaches === 0 ) { + document.removeEventListener( orig, handler, true ); + } + } + }; + }); +} + +jQuery.fn.extend({ + + on: function( types, selector, data, fn, /*INTERNAL*/ one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { // && selector != null + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + this.on( type, selector, data, types[ type ], one ); + } + return this; + } + + if ( data == null && fn == null ) { + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return this; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return this.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + }); + }, + one: function( types, selector, data, fn ) { + return this.on( types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + if ( types && types.preventDefault && types.handleObj ) { + // ( event ) dispatched jQuery.Event + var handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + // ( types-object [, selector] ) + for ( var type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each(function() { + jQuery.event.remove( this, types, fn, selector ); + }); + }, + + bind: function( types, data, fn ) { + return this.on( types, null, data, fn ); + }, + unbind: function( types, fn ) { + return this.off( types, null, fn ); + }, + + live: function( types, data, fn ) { + jQuery( this.context ).on( types, this.selector, data, fn ); + return this; + }, + die: function( types, fn ) { + jQuery( this.context ).off( types, this.selector || "**", fn ); + return this; + }, + + delegate: function( selector, types, data, fn ) { + return this.on( types, selector, data, fn ); + }, + undelegate: function( selector, types, fn ) { + // ( namespace ) or ( selector, types [, fn] ) + return arguments.length == 1? this.off( selector, "**" ) : this.off( types, selector, fn ); + }, + + trigger: function( type, data ) { + return this.each(function() { + jQuery.event.trigger( type, data, this ); + }); + }, + triggerHandler: function( type, data ) { + if ( this[0] ) { + return jQuery.event.trigger( type, data, this[0], true ); + } + }, + + toggle: function( fn ) { + // Save reference to arguments for access in closure + var args = arguments, + guid = fn.guid || jQuery.guid++, + i = 0, + toggler = function( event ) { + // Figure out which function to execute + var lastToggle = ( jQuery._data( this, "lastToggle" + fn.guid ) || 0 ) % i; + jQuery._data( this, "lastToggle" + fn.guid, lastToggle + 1 ); + + // Make sure that clicks stop + event.preventDefault(); + + // and execute the function + return args[ lastToggle ].apply( this, arguments ) || false; + }; + + // link all the functions, so any of them can unbind this click handler + toggler.guid = guid; + while ( i < args.length ) { + args[ i++ ].guid = guid; + } + + return this.click( toggler ); + }, + + hover: function( fnOver, fnOut ) { + return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); + } +}); + +jQuery.each( ("blur focus focusin focusout load resize scroll unload click dblclick " + + "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + + "change select submit keydown keypress keyup error contextmenu").split(" "), function( i, name ) { + + // Handle event binding + jQuery.fn[ name ] = function( data, fn ) { + if ( fn == null ) { + fn = data; + data = null; + } + + return arguments.length > 0 ? + this.on( name, null, data, fn ) : + this.trigger( name ); + }; + + if ( jQuery.attrFn ) { + jQuery.attrFn[ name ] = true; + } + + if ( rkeyEvent.test( name ) ) { + jQuery.event.fixHooks[ name ] = jQuery.event.keyHooks; + } + + if ( rmouseEvent.test( name ) ) { + jQuery.event.fixHooks[ name ] = jQuery.event.mouseHooks; + } +}); + + + +/*! + * Sizzle CSS Selector Engine + * Copyright 2011, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * More information: http://sizzlejs.com/ + */ +(function(){ + +var chunker = /((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^\[\]]*\]|['"][^'"]*['"]|[^\[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, + expando = "sizcache" + (Math.random() + '').replace('.', ''), + done = 0, + toString = Object.prototype.toString, + hasDuplicate = false, + baseHasDuplicate = true, + rBackslash = /\\/g, + rNonWord = /\W/; + +// Here we check if the JavaScript engine is using some sort of +// optimization where it does not always call our comparision +// function. If that is the case, discard the hasDuplicate value. +// Thus far that includes Google Chrome. +[0, 0].sort(function() { + baseHasDuplicate = false; + return 0; +}); + +var Sizzle = function( selector, context, results, seed ) { + results = results || []; + context = context || document; + + var origContext = context; + + if ( context.nodeType !== 1 && context.nodeType !== 9 ) { + return []; + } + + if ( !selector || typeof selector !== "string" ) { + return results; + } + + var m, set, checkSet, extra, ret, cur, pop, i, + prune = true, + contextXML = Sizzle.isXML( context ), + parts = [], + soFar = selector; + + // Reset the position of the chunker regexp (start from head) + do { + chunker.exec( "" ); + m = chunker.exec( soFar ); + + if ( m ) { + soFar = m[3]; + + parts.push( m[1] ); + + if ( m[2] ) { + extra = m[3]; + break; + } + } + } while ( m ); + + if ( parts.length > 1 && origPOS.exec( selector ) ) { + + if ( parts.length === 2 && Expr.relative[ parts[0] ] ) { + set = posProcess( parts[0] + parts[1], context, seed ); + + } else { + set = Expr.relative[ parts[0] ] ? + [ context ] : + Sizzle( parts.shift(), context ); + + while ( parts.length ) { + selector = parts.shift(); + + if ( Expr.relative[ selector ] ) { + selector += parts.shift(); + } + + set = posProcess( selector, set, seed ); + } + } + + } else { + // Take a shortcut and set the context if the root selector is an ID + // (but not if it'll be faster if the inner selector is an ID) + if ( !seed && parts.length > 1 && context.nodeType === 9 && !contextXML && + Expr.match.ID.test(parts[0]) && !Expr.match.ID.test(parts[parts.length - 1]) ) { + + ret = Sizzle.find( parts.shift(), context, contextXML ); + context = ret.expr ? + Sizzle.filter( ret.expr, ret.set )[0] : + ret.set[0]; + } + + if ( context ) { + ret = seed ? + { expr: parts.pop(), set: makeArray(seed) } : + Sizzle.find( parts.pop(), parts.length === 1 && (parts[0] === "~" || parts[0] === "+") && context.parentNode ? context.parentNode : context, contextXML ); + + set = ret.expr ? + Sizzle.filter( ret.expr, ret.set ) : + ret.set; + + if ( parts.length > 0 ) { + checkSet = makeArray( set ); + + } else { + prune = false; + } + + while ( parts.length ) { + cur = parts.pop(); + pop = cur; + + if ( !Expr.relative[ cur ] ) { + cur = ""; + } else { + pop = parts.pop(); + } + + if ( pop == null ) { + pop = context; + } + + Expr.relative[ cur ]( checkSet, pop, contextXML ); + } + + } else { + checkSet = parts = []; + } + } + + if ( !checkSet ) { + checkSet = set; + } + + if ( !checkSet ) { + Sizzle.error( cur || selector ); + } + + if ( toString.call(checkSet) === "[object Array]" ) { + if ( !prune ) { + results.push.apply( results, checkSet ); + + } else if ( context && context.nodeType === 1 ) { + for ( i = 0; checkSet[i] != null; i++ ) { + if ( checkSet[i] && (checkSet[i] === true || checkSet[i].nodeType === 1 && Sizzle.contains(context, checkSet[i])) ) { + results.push( set[i] ); + } + } + + } else { + for ( i = 0; checkSet[i] != null; i++ ) { + if ( checkSet[i] && checkSet[i].nodeType === 1 ) { + results.push( set[i] ); + } + } + } + + } else { + makeArray( checkSet, results ); + } + + if ( extra ) { + Sizzle( extra, origContext, results, seed ); + Sizzle.uniqueSort( results ); + } + + return results; +}; + +Sizzle.uniqueSort = function( results ) { + if ( sortOrder ) { + hasDuplicate = baseHasDuplicate; + results.sort( sortOrder ); + + if ( hasDuplicate ) { + for ( var i = 1; i < results.length; i++ ) { + if ( results[i] === results[ i - 1 ] ) { + results.splice( i--, 1 ); + } + } + } + } + + return results; +}; + +Sizzle.matches = function( expr, set ) { + return Sizzle( expr, null, null, set ); +}; + +Sizzle.matchesSelector = function( node, expr ) { + return Sizzle( expr, null, null, [node] ).length > 0; +}; + +Sizzle.find = function( expr, context, isXML ) { + var set, i, len, match, type, left; + + if ( !expr ) { + return []; + } + + for ( i = 0, len = Expr.order.length; i < len; i++ ) { + type = Expr.order[i]; + + if ( (match = Expr.leftMatch[ type ].exec( expr )) ) { + left = match[1]; + match.splice( 1, 1 ); + + if ( left.substr( left.length - 1 ) !== "\\" ) { + match[1] = (match[1] || "").replace( rBackslash, "" ); + set = Expr.find[ type ]( match, context, isXML ); + + if ( set != null ) { + expr = expr.replace( Expr.match[ type ], "" ); + break; + } + } + } + } + + if ( !set ) { + set = typeof context.getElementsByTagName !== "undefined" ? + context.getElementsByTagName( "*" ) : + []; + } + + return { set: set, expr: expr }; +}; + +Sizzle.filter = function( expr, set, inplace, not ) { + var match, anyFound, + type, found, item, filter, left, + i, pass, + old = expr, + result = [], + curLoop = set, + isXMLFilter = set && set[0] && Sizzle.isXML( set[0] ); + + while ( expr && set.length ) { + for ( type in Expr.filter ) { + if ( (match = Expr.leftMatch[ type ].exec( expr )) != null && match[2] ) { + filter = Expr.filter[ type ]; + left = match[1]; + + anyFound = false; + + match.splice(1,1); + + if ( left.substr( left.length - 1 ) === "\\" ) { + continue; + } + + if ( curLoop === result ) { + result = []; + } + + if ( Expr.preFilter[ type ] ) { + match = Expr.preFilter[ type ]( match, curLoop, inplace, result, not, isXMLFilter ); + + if ( !match ) { + anyFound = found = true; + + } else if ( match === true ) { + continue; + } + } + + if ( match ) { + for ( i = 0; (item = curLoop[i]) != null; i++ ) { + if ( item ) { + found = filter( item, match, i, curLoop ); + pass = not ^ found; + + if ( inplace && found != null ) { + if ( pass ) { + anyFound = true; + + } else { + curLoop[i] = false; + } + + } else if ( pass ) { + result.push( item ); + anyFound = true; + } + } + } + } + + if ( found !== undefined ) { + if ( !inplace ) { + curLoop = result; + } + + expr = expr.replace( Expr.match[ type ], "" ); + + if ( !anyFound ) { + return []; + } + + break; + } + } + } + + // Improper expression + if ( expr === old ) { + if ( anyFound == null ) { + Sizzle.error( expr ); + + } else { + break; + } + } + + old = expr; + } + + return curLoop; +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Utility function for retreiving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +var getText = Sizzle.getText = function( elem ) { + var i, node, + nodeType = elem.nodeType, + ret = ""; + + if ( nodeType ) { + if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + // Use textContent for elements + // innerText usage removed for consistency of new lines (see #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + // Traverse it's children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + } else { + + // If no nodeType, this is expected to be an array + for ( i = 0; (node = elem[i]); i++ ) { + // Do not traverse comment nodes + if ( node.nodeType !== 8 ) { + ret += getText( node ); + } + } + } + return ret; +}; + +var Expr = Sizzle.selectors = { + order: [ "ID", "NAME", "TAG" ], + + match: { + ID: /#((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, + CLASS: /\.((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, + NAME: /\[name=['"]*((?:[\w\u00c0-\uFFFF\-]|\\.)+)['"]*\]/, + ATTR: /\[\s*((?:[\w\u00c0-\uFFFF\-]|\\.)+)\s*(?:(\S?=)\s*(?:(['"])(.*?)\3|(#?(?:[\w\u00c0-\uFFFF\-]|\\.)*)|)|)\s*\]/, + TAG: /^((?:[\w\u00c0-\uFFFF\*\-]|\\.)+)/, + CHILD: /:(only|nth|last|first)-child(?:\(\s*(even|odd|(?:[+\-]?\d+|(?:[+\-]?\d*)?n\s*(?:[+\-]\s*\d+)?))\s*\))?/, + POS: /:(nth|eq|gt|lt|first|last|even|odd)(?:\((\d*)\))?(?=[^\-]|$)/, + PSEUDO: /:((?:[\w\u00c0-\uFFFF\-]|\\.)+)(?:\((['"]?)((?:\([^\)]+\)|[^\(\)]*)+)\2\))?/ + }, + + leftMatch: {}, + + attrMap: { + "class": "className", + "for": "htmlFor" + }, + + attrHandle: { + href: function( elem ) { + return elem.getAttribute( "href" ); + }, + type: function( elem ) { + return elem.getAttribute( "type" ); + } + }, + + relative: { + "+": function(checkSet, part){ + var isPartStr = typeof part === "string", + isTag = isPartStr && !rNonWord.test( part ), + isPartStrNotTag = isPartStr && !isTag; + + if ( isTag ) { + part = part.toLowerCase(); + } + + for ( var i = 0, l = checkSet.length, elem; i < l; i++ ) { + if ( (elem = checkSet[i]) ) { + while ( (elem = elem.previousSibling) && elem.nodeType !== 1 ) {} + + checkSet[i] = isPartStrNotTag || elem && elem.nodeName.toLowerCase() === part ? + elem || false : + elem === part; + } + } + + if ( isPartStrNotTag ) { + Sizzle.filter( part, checkSet, true ); + } + }, + + ">": function( checkSet, part ) { + var elem, + isPartStr = typeof part === "string", + i = 0, + l = checkSet.length; + + if ( isPartStr && !rNonWord.test( part ) ) { + part = part.toLowerCase(); + + for ( ; i < l; i++ ) { + elem = checkSet[i]; + + if ( elem ) { + var parent = elem.parentNode; + checkSet[i] = parent.nodeName.toLowerCase() === part ? parent : false; + } + } + + } else { + for ( ; i < l; i++ ) { + elem = checkSet[i]; + + if ( elem ) { + checkSet[i] = isPartStr ? + elem.parentNode : + elem.parentNode === part; + } + } + + if ( isPartStr ) { + Sizzle.filter( part, checkSet, true ); + } + } + }, + + "": function(checkSet, part, isXML){ + var nodeCheck, + doneName = done++, + checkFn = dirCheck; + + if ( typeof part === "string" && !rNonWord.test( part ) ) { + part = part.toLowerCase(); + nodeCheck = part; + checkFn = dirNodeCheck; + } + + checkFn( "parentNode", part, doneName, checkSet, nodeCheck, isXML ); + }, + + "~": function( checkSet, part, isXML ) { + var nodeCheck, + doneName = done++, + checkFn = dirCheck; + + if ( typeof part === "string" && !rNonWord.test( part ) ) { + part = part.toLowerCase(); + nodeCheck = part; + checkFn = dirNodeCheck; + } + + checkFn( "previousSibling", part, doneName, checkSet, nodeCheck, isXML ); + } + }, + + find: { + ID: function( match, context, isXML ) { + if ( typeof context.getElementById !== "undefined" && !isXML ) { + var m = context.getElementById(match[1]); + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + return m && m.parentNode ? [m] : []; + } + }, + + NAME: function( match, context ) { + if ( typeof context.getElementsByName !== "undefined" ) { + var ret = [], + results = context.getElementsByName( match[1] ); + + for ( var i = 0, l = results.length; i < l; i++ ) { + if ( results[i].getAttribute("name") === match[1] ) { + ret.push( results[i] ); + } + } + + return ret.length === 0 ? null : ret; + } + }, + + TAG: function( match, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( match[1] ); + } + } + }, + preFilter: { + CLASS: function( match, curLoop, inplace, result, not, isXML ) { + match = " " + match[1].replace( rBackslash, "" ) + " "; + + if ( isXML ) { + return match; + } + + for ( var i = 0, elem; (elem = curLoop[i]) != null; i++ ) { + if ( elem ) { + if ( not ^ (elem.className && (" " + elem.className + " ").replace(/[\t\n\r]/g, " ").indexOf(match) >= 0) ) { + if ( !inplace ) { + result.push( elem ); + } + + } else if ( inplace ) { + curLoop[i] = false; + } + } + } + + return false; + }, + + ID: function( match ) { + return match[1].replace( rBackslash, "" ); + }, + + TAG: function( match, curLoop ) { + return match[1].replace( rBackslash, "" ).toLowerCase(); + }, + + CHILD: function( match ) { + if ( match[1] === "nth" ) { + if ( !match[2] ) { + Sizzle.error( match[0] ); + } + + match[2] = match[2].replace(/^\+|\s*/g, ''); + + // parse equations like 'even', 'odd', '5', '2n', '3n+2', '4n-1', '-n+6' + var test = /(-?)(\d*)(?:n([+\-]?\d*))?/.exec( + match[2] === "even" && "2n" || match[2] === "odd" && "2n+1" || + !/\D/.test( match[2] ) && "0n+" + match[2] || match[2]); + + // calculate the numbers (first)n+(last) including if they are negative + match[2] = (test[1] + (test[2] || 1)) - 0; + match[3] = test[3] - 0; + } + else if ( match[2] ) { + Sizzle.error( match[0] ); + } + + // TODO: Move to normal caching system + match[0] = done++; + + return match; + }, + + ATTR: function( match, curLoop, inplace, result, not, isXML ) { + var name = match[1] = match[1].replace( rBackslash, "" ); + + if ( !isXML && Expr.attrMap[name] ) { + match[1] = Expr.attrMap[name]; + } + + // Handle if an un-quoted value was used + match[4] = ( match[4] || match[5] || "" ).replace( rBackslash, "" ); + + if ( match[2] === "~=" ) { + match[4] = " " + match[4] + " "; + } + + return match; + }, + + PSEUDO: function( match, curLoop, inplace, result, not ) { + if ( match[1] === "not" ) { + // If we're dealing with a complex expression, or a simple one + if ( ( chunker.exec(match[3]) || "" ).length > 1 || /^\w/.test(match[3]) ) { + match[3] = Sizzle(match[3], null, null, curLoop); + + } else { + var ret = Sizzle.filter(match[3], curLoop, inplace, true ^ not); + + if ( !inplace ) { + result.push.apply( result, ret ); + } + + return false; + } + + } else if ( Expr.match.POS.test( match[0] ) || Expr.match.CHILD.test( match[0] ) ) { + return true; + } + + return match; + }, + + POS: function( match ) { + match.unshift( true ); + + return match; + } + }, + + filters: { + enabled: function( elem ) { + return elem.disabled === false && elem.type !== "hidden"; + }, + + disabled: function( elem ) { + return elem.disabled === true; + }, + + checked: function( elem ) { + return elem.checked === true; + }, + + selected: function( elem ) { + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + parent: function( elem ) { + return !!elem.firstChild; + }, + + empty: function( elem ) { + return !elem.firstChild; + }, + + has: function( elem, i, match ) { + return !!Sizzle( match[3], elem ).length; + }, + + header: function( elem ) { + return (/h\d/i).test( elem.nodeName ); + }, + + text: function( elem ) { + var attr = elem.getAttribute( "type" ), type = elem.type; + // IE6 and 7 will map elem.type to 'text' for new HTML5 types (search, etc) + // use getAttribute instead to test this case + return elem.nodeName.toLowerCase() === "input" && "text" === type && ( attr === type || attr === null ); + }, + + radio: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "radio" === elem.type; + }, + + checkbox: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "checkbox" === elem.type; + }, + + file: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "file" === elem.type; + }, + + password: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "password" === elem.type; + }, + + submit: function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && "submit" === elem.type; + }, + + image: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "image" === elem.type; + }, + + reset: function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && "reset" === elem.type; + }, + + button: function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && "button" === elem.type || name === "button"; + }, + + input: function( elem ) { + return (/input|select|textarea|button/i).test( elem.nodeName ); + }, + + focus: function( elem ) { + return elem === elem.ownerDocument.activeElement; + } + }, + setFilters: { + first: function( elem, i ) { + return i === 0; + }, + + last: function( elem, i, match, array ) { + return i === array.length - 1; + }, + + even: function( elem, i ) { + return i % 2 === 0; + }, + + odd: function( elem, i ) { + return i % 2 === 1; + }, + + lt: function( elem, i, match ) { + return i < match[3] - 0; + }, + + gt: function( elem, i, match ) { + return i > match[3] - 0; + }, + + nth: function( elem, i, match ) { + return match[3] - 0 === i; + }, + + eq: function( elem, i, match ) { + return match[3] - 0 === i; + } + }, + filter: { + PSEUDO: function( elem, match, i, array ) { + var name = match[1], + filter = Expr.filters[ name ]; + + if ( filter ) { + return filter( elem, i, match, array ); + + } else if ( name === "contains" ) { + return (elem.textContent || elem.innerText || getText([ elem ]) || "").indexOf(match[3]) >= 0; + + } else if ( name === "not" ) { + var not = match[3]; + + for ( var j = 0, l = not.length; j < l; j++ ) { + if ( not[j] === elem ) { + return false; + } + } + + return true; + + } else { + Sizzle.error( name ); + } + }, + + CHILD: function( elem, match ) { + var first, last, + doneName, parent, cache, + count, diff, + type = match[1], + node = elem; + + switch ( type ) { + case "only": + case "first": + while ( (node = node.previousSibling) ) { + if ( node.nodeType === 1 ) { + return false; + } + } + + if ( type === "first" ) { + return true; + } + + node = elem; + + /* falls through */ + case "last": + while ( (node = node.nextSibling) ) { + if ( node.nodeType === 1 ) { + return false; + } + } + + return true; + + case "nth": + first = match[2]; + last = match[3]; + + if ( first === 1 && last === 0 ) { + return true; + } + + doneName = match[0]; + parent = elem.parentNode; + + if ( parent && (parent[ expando ] !== doneName || !elem.nodeIndex) ) { + count = 0; + + for ( node = parent.firstChild; node; node = node.nextSibling ) { + if ( node.nodeType === 1 ) { + node.nodeIndex = ++count; + } + } + + parent[ expando ] = doneName; + } + + diff = elem.nodeIndex - last; + + if ( first === 0 ) { + return diff === 0; + + } else { + return ( diff % first === 0 && diff / first >= 0 ); + } + } + }, + + ID: function( elem, match ) { + return elem.nodeType === 1 && elem.getAttribute("id") === match; + }, + + TAG: function( elem, match ) { + return (match === "*" && elem.nodeType === 1) || !!elem.nodeName && elem.nodeName.toLowerCase() === match; + }, + + CLASS: function( elem, match ) { + return (" " + (elem.className || elem.getAttribute("class")) + " ") + .indexOf( match ) > -1; + }, + + ATTR: function( elem, match ) { + var name = match[1], + result = Sizzle.attr ? + Sizzle.attr( elem, name ) : + Expr.attrHandle[ name ] ? + Expr.attrHandle[ name ]( elem ) : + elem[ name ] != null ? + elem[ name ] : + elem.getAttribute( name ), + value = result + "", + type = match[2], + check = match[4]; + + return result == null ? + type === "!=" : + !type && Sizzle.attr ? + result != null : + type === "=" ? + value === check : + type === "*=" ? + value.indexOf(check) >= 0 : + type === "~=" ? + (" " + value + " ").indexOf(check) >= 0 : + !check ? + value && result !== false : + type === "!=" ? + value !== check : + type === "^=" ? + value.indexOf(check) === 0 : + type === "$=" ? + value.substr(value.length - check.length) === check : + type === "|=" ? + value === check || value.substr(0, check.length + 1) === check + "-" : + false; + }, + + POS: function( elem, match, i, array ) { + var name = match[2], + filter = Expr.setFilters[ name ]; + + if ( filter ) { + return filter( elem, i, match, array ); + } + } + } +}; + +var origPOS = Expr.match.POS, + fescape = function(all, num){ + return "\\" + (num - 0 + 1); + }; + +for ( var type in Expr.match ) { + Expr.match[ type ] = new RegExp( Expr.match[ type ].source + (/(?![^\[]*\])(?![^\(]*\))/.source) ); + Expr.leftMatch[ type ] = new RegExp( /(^(?:.|\r|\n)*?)/.source + Expr.match[ type ].source.replace(/\\(\d+)/g, fescape) ); +} +// Expose origPOS +// "global" as in regardless of relation to brackets/parens +Expr.match.globalPOS = origPOS; + +var makeArray = function( array, results ) { + array = Array.prototype.slice.call( array, 0 ); + + if ( results ) { + results.push.apply( results, array ); + return results; + } + + return array; +}; + +// Perform a simple check to determine if the browser is capable of +// converting a NodeList to an array using builtin methods. +// Also verifies that the returned array holds DOM nodes +// (which is not the case in the Blackberry browser) +try { + Array.prototype.slice.call( document.documentElement.childNodes, 0 )[0].nodeType; + +// Provide a fallback method if it does not work +} catch( e ) { + makeArray = function( array, results ) { + var i = 0, + ret = results || []; + + if ( toString.call(array) === "[object Array]" ) { + Array.prototype.push.apply( ret, array ); + + } else { + if ( typeof array.length === "number" ) { + for ( var l = array.length; i < l; i++ ) { + ret.push( array[i] ); + } + + } else { + for ( ; array[i]; i++ ) { + ret.push( array[i] ); + } + } + } + + return ret; + }; +} + +var sortOrder, siblingCheck; + +if ( document.documentElement.compareDocumentPosition ) { + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + if ( !a.compareDocumentPosition || !b.compareDocumentPosition ) { + return a.compareDocumentPosition ? -1 : 1; + } + + return a.compareDocumentPosition(b) & 4 ? -1 : 1; + }; + +} else { + sortOrder = function( a, b ) { + // The nodes are identical, we can exit early + if ( a === b ) { + hasDuplicate = true; + return 0; + + // Fallback to using sourceIndex (in IE) if it's available on both nodes + } else if ( a.sourceIndex && b.sourceIndex ) { + return a.sourceIndex - b.sourceIndex; + } + + var al, bl, + ap = [], + bp = [], + aup = a.parentNode, + bup = b.parentNode, + cur = aup; + + // If the nodes are siblings (or identical) we can do a quick check + if ( aup === bup ) { + return siblingCheck( a, b ); + + // If no parents were found then the nodes are disconnected + } else if ( !aup ) { + return -1; + + } else if ( !bup ) { + return 1; + } + + // Otherwise they're somewhere else in the tree so we need + // to build up a full list of the parentNodes for comparison + while ( cur ) { + ap.unshift( cur ); + cur = cur.parentNode; + } + + cur = bup; + + while ( cur ) { + bp.unshift( cur ); + cur = cur.parentNode; + } + + al = ap.length; + bl = bp.length; + + // Start walking down the tree looking for a discrepancy + for ( var i = 0; i < al && i < bl; i++ ) { + if ( ap[i] !== bp[i] ) { + return siblingCheck( ap[i], bp[i] ); + } + } + + // We ended someplace up the tree so do a sibling check + return i === al ? + siblingCheck( a, bp[i], -1 ) : + siblingCheck( ap[i], b, 1 ); + }; + + siblingCheck = function( a, b, ret ) { + if ( a === b ) { + return ret; + } + + var cur = a.nextSibling; + + while ( cur ) { + if ( cur === b ) { + return -1; + } + + cur = cur.nextSibling; + } + + return 1; + }; +} + +// Check to see if the browser returns elements by name when +// querying by getElementById (and provide a workaround) +(function(){ + // We're going to inject a fake input element with a specified name + var form = document.createElement("div"), + id = "script" + (new Date()).getTime(), + root = document.documentElement; + + form.innerHTML = ""; + + // Inject it into the root element, check its status, and remove it quickly + root.insertBefore( form, root.firstChild ); + + // The workaround has to do additional checks after a getElementById + // Which slows things down for other browsers (hence the branching) + if ( document.getElementById( id ) ) { + Expr.find.ID = function( match, context, isXML ) { + if ( typeof context.getElementById !== "undefined" && !isXML ) { + var m = context.getElementById(match[1]); + + return m ? + m.id === match[1] || typeof m.getAttributeNode !== "undefined" && m.getAttributeNode("id").nodeValue === match[1] ? + [m] : + undefined : + []; + } + }; + + Expr.filter.ID = function( elem, match ) { + var node = typeof elem.getAttributeNode !== "undefined" && elem.getAttributeNode("id"); + + return elem.nodeType === 1 && node && node.nodeValue === match; + }; + } + + root.removeChild( form ); + + // release memory in IE + root = form = null; +})(); + +(function(){ + // Check to see if the browser returns only elements + // when doing getElementsByTagName("*") + + // Create a fake element + var div = document.createElement("div"); + div.appendChild( document.createComment("") ); + + // Make sure no comments are found + if ( div.getElementsByTagName("*").length > 0 ) { + Expr.find.TAG = function( match, context ) { + var results = context.getElementsByTagName( match[1] ); + + // Filter out possible comments + if ( match[1] === "*" ) { + var tmp = []; + + for ( var i = 0; results[i]; i++ ) { + if ( results[i].nodeType === 1 ) { + tmp.push( results[i] ); + } + } + + results = tmp; + } + + return results; + }; + } + + // Check to see if an attribute returns normalized href attributes + div.innerHTML = ""; + + if ( div.firstChild && typeof div.firstChild.getAttribute !== "undefined" && + div.firstChild.getAttribute("href") !== "#" ) { + + Expr.attrHandle.href = function( elem ) { + return elem.getAttribute( "href", 2 ); + }; + } + + // release memory in IE + div = null; +})(); + +if ( document.querySelectorAll ) { + (function(){ + var oldSizzle = Sizzle, + div = document.createElement("div"), + id = "__sizzle__"; + + div.innerHTML = "

"; + + // Safari can't handle uppercase or unicode characters when + // in quirks mode. + if ( div.querySelectorAll && div.querySelectorAll(".TEST").length === 0 ) { + return; + } + + Sizzle = function( query, context, extra, seed ) { + context = context || document; + + // Only use querySelectorAll on non-XML documents + // (ID selectors don't work in non-HTML documents) + if ( !seed && !Sizzle.isXML(context) ) { + // See if we find a selector to speed up + var match = /^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec( query ); + + if ( match && (context.nodeType === 1 || context.nodeType === 9) ) { + // Speed-up: Sizzle("TAG") + if ( match[1] ) { + return makeArray( context.getElementsByTagName( query ), extra ); + + // Speed-up: Sizzle(".CLASS") + } else if ( match[2] && Expr.find.CLASS && context.getElementsByClassName ) { + return makeArray( context.getElementsByClassName( match[2] ), extra ); + } + } + + if ( context.nodeType === 9 ) { + // Speed-up: Sizzle("body") + // The body element only exists once, optimize finding it + if ( query === "body" && context.body ) { + return makeArray( [ context.body ], extra ); + + // Speed-up: Sizzle("#ID") + } else if ( match && match[3] ) { + var elem = context.getElementById( match[3] ); + + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE and Opera return items + // by name instead of ID + if ( elem.id === match[3] ) { + return makeArray( [ elem ], extra ); + } + + } else { + return makeArray( [], extra ); + } + } + + try { + return makeArray( context.querySelectorAll(query), extra ); + } catch(qsaError) {} + + // qSA works strangely on Element-rooted queries + // We can work around this by specifying an extra ID on the root + // and working up from there (Thanks to Andrew Dupont for the technique) + // IE 8 doesn't work on object elements + } else if ( context.nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { + var oldContext = context, + old = context.getAttribute( "id" ), + nid = old || id, + hasParent = context.parentNode, + relativeHierarchySelector = /^\s*[+~]/.test( query ); + + if ( !old ) { + context.setAttribute( "id", nid ); + } else { + nid = nid.replace( /'/g, "\\$&" ); + } + if ( relativeHierarchySelector && hasParent ) { + context = context.parentNode; + } + + try { + if ( !relativeHierarchySelector || hasParent ) { + return makeArray( context.querySelectorAll( "[id='" + nid + "'] " + query ), extra ); + } + + } catch(pseudoError) { + } finally { + if ( !old ) { + oldContext.removeAttribute( "id" ); + } + } + } + } + + return oldSizzle(query, context, extra, seed); + }; + + for ( var prop in oldSizzle ) { + Sizzle[ prop ] = oldSizzle[ prop ]; + } + + // release memory in IE + div = null; + })(); +} + +(function(){ + var html = document.documentElement, + matches = html.matchesSelector || html.mozMatchesSelector || html.webkitMatchesSelector || html.msMatchesSelector; + + if ( matches ) { + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9 fails this) + var disconnectedMatch = !matches.call( document.createElement( "div" ), "div" ), + pseudoWorks = false; + + try { + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( document.documentElement, "[test!='']:sizzle" ); + + } catch( pseudoError ) { + pseudoWorks = true; + } + + Sizzle.matchesSelector = function( node, expr ) { + // Make sure that attribute selectors are quoted + expr = expr.replace(/\=\s*([^'"\]]*)\s*\]/g, "='$1']"); + + if ( !Sizzle.isXML( node ) ) { + try { + if ( pseudoWorks || !Expr.match.PSEUDO.test( expr ) && !/!=/.test( expr ) ) { + var ret = matches.call( node, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || !disconnectedMatch || + // As well, disconnected nodes are said to be in a document + // fragment in IE 9, so check for that + node.document && node.document.nodeType !== 11 ) { + return ret; + } + } + } catch(e) {} + } + + return Sizzle(expr, null, null, [node]).length > 0; + }; + } +})(); + +(function(){ + var div = document.createElement("div"); + + div.innerHTML = "
"; + + // Opera can't find a second classname (in 9.6) + // Also, make sure that getElementsByClassName actually exists + if ( !div.getElementsByClassName || div.getElementsByClassName("e").length === 0 ) { + return; + } + + // Safari caches class attributes, doesn't catch changes (in 3.2) + div.lastChild.className = "e"; + + if ( div.getElementsByClassName("e").length === 1 ) { + return; + } + + Expr.order.splice(1, 0, "CLASS"); + Expr.find.CLASS = function( match, context, isXML ) { + if ( typeof context.getElementsByClassName !== "undefined" && !isXML ) { + return context.getElementsByClassName(match[1]); + } + }; + + // release memory in IE + div = null; +})(); + +function dirNodeCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { + for ( var i = 0, l = checkSet.length; i < l; i++ ) { + var elem = checkSet[i]; + + if ( elem ) { + var match = false; + + elem = elem[dir]; + + while ( elem ) { + if ( elem[ expando ] === doneName ) { + match = checkSet[elem.sizset]; + break; + } + + if ( elem.nodeType === 1 && !isXML ){ + elem[ expando ] = doneName; + elem.sizset = i; + } + + if ( elem.nodeName.toLowerCase() === cur ) { + match = elem; + break; + } + + elem = elem[dir]; + } + + checkSet[i] = match; + } + } +} + +function dirCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { + for ( var i = 0, l = checkSet.length; i < l; i++ ) { + var elem = checkSet[i]; + + if ( elem ) { + var match = false; + + elem = elem[dir]; + + while ( elem ) { + if ( elem[ expando ] === doneName ) { + match = checkSet[elem.sizset]; + break; + } + + if ( elem.nodeType === 1 ) { + if ( !isXML ) { + elem[ expando ] = doneName; + elem.sizset = i; + } + + if ( typeof cur !== "string" ) { + if ( elem === cur ) { + match = true; + break; + } + + } else if ( Sizzle.filter( cur, [elem] ).length > 0 ) { + match = elem; + break; + } + } + + elem = elem[dir]; + } + + checkSet[i] = match; + } + } +} + +if ( document.documentElement.contains ) { + Sizzle.contains = function( a, b ) { + return a !== b && (a.contains ? a.contains(b) : true); + }; + +} else if ( document.documentElement.compareDocumentPosition ) { + Sizzle.contains = function( a, b ) { + return !!(a.compareDocumentPosition(b) & 16); + }; + +} else { + Sizzle.contains = function() { + return false; + }; +} + +Sizzle.isXML = function( elem ) { + // documentElement is verified for cases where it doesn't yet exist + // (such as loading iframes in IE - #4833) + var documentElement = (elem ? elem.ownerDocument || elem : 0).documentElement; + + return documentElement ? documentElement.nodeName !== "HTML" : false; +}; + +var posProcess = function( selector, context, seed ) { + var match, + tmpSet = [], + later = "", + root = context.nodeType ? [context] : context; + + // Position selectors must be done after the filter + // And so must :not(positional) so we move all PSEUDOs to the end + while ( (match = Expr.match.PSEUDO.exec( selector )) ) { + later += match[0]; + selector = selector.replace( Expr.match.PSEUDO, "" ); + } + + selector = Expr.relative[selector] ? selector + "*" : selector; + + for ( var i = 0, l = root.length; i < l; i++ ) { + Sizzle( selector, root[i], tmpSet, seed ); + } + + return Sizzle.filter( later, tmpSet ); +}; + +// EXPOSE +// Override sizzle attribute retrieval +Sizzle.attr = jQuery.attr; +Sizzle.selectors.attrMap = {}; +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; +jQuery.expr[":"] = jQuery.expr.filters; +jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; + + +})(); + + +var runtil = /Until$/, + rparentsprev = /^(?:parents|prevUntil|prevAll)/, + // Note: This RegExp should be improved, or likely pulled from Sizzle + rmultiselector = /,/, + isSimple = /^.[^:#\[\.,]*$/, + slice = Array.prototype.slice, + POS = jQuery.expr.match.globalPOS, + // methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend({ + find: function( selector ) { + var self = this, + i, l; + + if ( typeof selector !== "string" ) { + return jQuery( selector ).filter(function() { + for ( i = 0, l = self.length; i < l; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + }); + } + + var ret = this.pushStack( "", "find", selector ), + length, n, r; + + for ( i = 0, l = this.length; i < l; i++ ) { + length = ret.length; + jQuery.find( selector, this[i], ret ); + + if ( i > 0 ) { + // Make sure that the results are unique + for ( n = length; n < ret.length; n++ ) { + for ( r = 0; r < length; r++ ) { + if ( ret[r] === ret[n] ) { + ret.splice(n--, 1); + break; + } + } + } + } + } + + return ret; + }, + + has: function( target ) { + var targets = jQuery( target ); + return this.filter(function() { + for ( var i = 0, l = targets.length; i < l; i++ ) { + if ( jQuery.contains( this, targets[i] ) ) { + return true; + } + } + }); + }, + + not: function( selector ) { + return this.pushStack( winnow(this, selector, false), "not", selector); + }, + + filter: function( selector ) { + return this.pushStack( winnow(this, selector, true), "filter", selector ); + }, + + is: function( selector ) { + return !!selector && ( + typeof selector === "string" ? + // If this is a positional selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + POS.test( selector ) ? + jQuery( selector, this.context ).index( this[0] ) >= 0 : + jQuery.filter( selector, this ).length > 0 : + this.filter( selector ).length > 0 ); + }, + + closest: function( selectors, context ) { + var ret = [], i, l, cur = this[0]; + + // Array (deprecated as of jQuery 1.7) + if ( jQuery.isArray( selectors ) ) { + var level = 1; + + while ( cur && cur.ownerDocument && cur !== context ) { + for ( i = 0; i < selectors.length; i++ ) { + + if ( jQuery( cur ).is( selectors[ i ] ) ) { + ret.push({ selector: selectors[ i ], elem: cur, level: level }); + } + } + + cur = cur.parentNode; + level++; + } + + return ret; + } + + // String + var pos = POS.test( selectors ) || typeof selectors !== "string" ? + jQuery( selectors, context || this.context ) : + 0; + + for ( i = 0, l = this.length; i < l; i++ ) { + cur = this[i]; + + while ( cur ) { + if ( pos ? pos.index(cur) > -1 : jQuery.find.matchesSelector(cur, selectors) ) { + ret.push( cur ); + break; + + } else { + cur = cur.parentNode; + if ( !cur || !cur.ownerDocument || cur === context || cur.nodeType === 11 ) { + break; + } + } + } + } + + ret = ret.length > 1 ? jQuery.unique( ret ) : ret; + + return this.pushStack( ret, "closest", selectors ); + }, + + // Determine the position of an element within + // the matched set of elements + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[0] && this[0].parentNode ) ? this.prevAll().length : -1; + } + + // index in selector + if ( typeof elem === "string" ) { + return jQuery.inArray( this[0], jQuery( elem ) ); + } + + // Locate the position of the desired element + return jQuery.inArray( + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[0] : elem, this ); + }, + + add: function( selector, context ) { + var set = typeof selector === "string" ? + jQuery( selector, context ) : + jQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ), + all = jQuery.merge( this.get(), set ); + + return this.pushStack( isDisconnected( set[0] ) || isDisconnected( all[0] ) ? + all : + jQuery.unique( all ) ); + }, + + andSelf: function() { + return this.add( this.prevObject ); + } +}); + +// A painfully simple check to see if an element is disconnected +// from a document (should be improved, where feasible). +function isDisconnected( node ) { + return !node || !node.parentNode || node.parentNode.nodeType === 11; +} + +jQuery.each({ + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return jQuery.dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, i, until ) { + return jQuery.dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return jQuery.nth( elem, 2, "nextSibling" ); + }, + prev: function( elem ) { + return jQuery.nth( elem, 2, "previousSibling" ); + }, + nextAll: function( elem ) { + return jQuery.dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return jQuery.dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, i, until ) { + return jQuery.dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, i, until ) { + return jQuery.dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return jQuery.sibling( elem.firstChild ); + }, + contents: function( elem ) { + return jQuery.nodeName( elem, "iframe" ) ? + elem.contentDocument || elem.contentWindow.document : + jQuery.makeArray( elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var ret = jQuery.map( this, fn, until ); + + if ( !runtil.test( name ) ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + ret = jQuery.filter( selector, ret ); + } + + ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; + + if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { + ret = ret.reverse(); + } + + return this.pushStack( ret, name, slice.call( arguments ).join(",") ); + }; +}); + +jQuery.extend({ + filter: function( expr, elems, not ) { + if ( not ) { + expr = ":not(" + expr + ")"; + } + + return elems.length === 1 ? + jQuery.find.matchesSelector(elems[0], expr) ? [ elems[0] ] : [] : + jQuery.find.matches(expr, elems); + }, + + dir: function( elem, dir, until ) { + var matched = [], + cur = elem[ dir ]; + + while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { + if ( cur.nodeType === 1 ) { + matched.push( cur ); + } + cur = cur[dir]; + } + return matched; + }, + + nth: function( cur, result, dir, elem ) { + result = result || 1; + var num = 0; + + for ( ; cur; cur = cur[dir] ) { + if ( cur.nodeType === 1 && ++num === result ) { + break; + } + } + + return cur; + }, + + sibling: function( n, elem ) { + var r = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + r.push( n ); + } + } + + return r; + } +}); + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, keep ) { + + // Can't pass null or undefined to indexOf in Firefox 4 + // Set to 0 to skip string check + qualifier = qualifier || 0; + + if ( jQuery.isFunction( qualifier ) ) { + return jQuery.grep(elements, function( elem, i ) { + var retVal = !!qualifier.call( elem, i, elem ); + return retVal === keep; + }); + + } else if ( qualifier.nodeType ) { + return jQuery.grep(elements, function( elem, i ) { + return ( elem === qualifier ) === keep; + }); + + } else if ( typeof qualifier === "string" ) { + var filtered = jQuery.grep(elements, function( elem ) { + return elem.nodeType === 1; + }); + + if ( isSimple.test( qualifier ) ) { + return jQuery.filter(qualifier, filtered, !keep); + } else { + qualifier = jQuery.filter( qualifier, filtered ); + } + } + + return jQuery.grep(elements, function( elem, i ) { + return ( jQuery.inArray( elem, qualifier ) >= 0 ) === keep; + }); +} + + + + +function createSafeFragment( document ) { + var list = nodeNames.split( "|" ), + safeFrag = document.createDocumentFragment(); + + if ( safeFrag.createElement ) { + while ( list.length ) { + safeFrag.createElement( + list.pop() + ); + } + } + return safeFrag; +} + +var nodeNames = "abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|" + + "header|hgroup|mark|meter|nav|output|progress|section|summary|time|video", + rinlinejQuery = / jQuery\d+="(?:\d+|null)"/g, + rleadingWhitespace = /^\s+/, + rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig, + rtagName = /<([\w:]+)/, + rtbody = /]", "i"), + // checked="checked" or checked + rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i, + rscriptType = /\/(java|ecma)script/i, + rcleanScript = /^\s*", "" ], + legend: [ 1, "
", "
" ], + thead: [ 1, "", "
" ], + tr: [ 2, "", "
" ], + td: [ 3, "", "
" ], + col: [ 2, "", "
" ], + area: [ 1, "", "" ], + _default: [ 0, "", "" ] + }, + safeFragment = createSafeFragment( document ); + +wrapMap.optgroup = wrapMap.option; +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// IE can't serialize and