Create a New Repository

Warning

It is here assumed the:code:statiskit-dev environment has been installed and activated as written in Section Configure your Computer. This section heavily relies on the devops-tools program. For more information on the github, travis_ci and appveyor_ci commands, refer to their documentation <http://devops-tools.rtfd.io>.

Official repositories of StatisKit are currently hosted on GitHub. In order to create an official repository of StatisKit we recommend to proceed as follows.

Note

In the following <REPOSITORY> denote the official repository name.

  1. Initialize the repository on the organization account. To do so, type the following command in your console

    github init <REPOSITORY> --owner=StatisKit --license=apache-2.0
    
  2. Clone the repository from the organization account to your computer. If this repository is already cloned on your computer, you can skip this step. Otherwise, type the following command in your console

    github clone <REPOSITORY> --owner=StatisKit
    

    Warning

    After this step, it is assumed that your console working directory is the one of the local repository.

  3. Activate Continuous Integration and Deployment services for your repository. Contrarily to user repositories, this step is mandatory for organization account’s repositories. To do so, type the following commands in your console

    travis_ci init --anaconda-label=develop
    appveyor_ci init --anaconda-label=develop
    
  1. Populate the repository with relevant files.

    Warning

    Until now, the repository structure has not been clearly set. More information can be gathered in the Frequently Asked Questions section. A package is yet under consideration to propose command lines to simplify the process (e.g., layout init).

  2. Retrieve the latest code from the repository located on the organization account and push your modifications to the repository located on the organization account.

    To do so, type the following commands in your console

    git pull
    git push
    

    Warning

    Before using these commands, it is better to make sure that there are no uncommitted changes nor untracked files on your local repository. To do so, type the following command in your console

    git status
    

    If you want to suppress (permanently) all uncommitted changes, type the following command in your console

    git reset --hard
    

    Moreover; if you want to suppress (permanently) all untracked files, type the following command in your console

    git clean -fd
    

Note

For more information concerning naming conventions and places for files specific to further repository developments, refer to the Frequently Asked Questions section.