X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=.github%2FCONTRIBUTING.md;h=47129ea74eca2914f791d6740a666b84d5483ce8;hb=db9df9a72c67a6ba150620f0f1c0838a3c155786;hp=1256a02bdfecbfb1ede41705252c8137c40abf6d;hpb=b4bc269e5517849b5b89052f0c1a2c01b6f65089;p=github%2FChocobozzz%2FPeerTube.git diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 1256a02bd..47129ea74 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -18,8 +18,10 @@ Interested in contributing? Awesome! - [Server side](#server-side) - [Client side](#client-side) - [Client and server side](#client-and-server-side) - - [Testing the federation of PeerTube servers](#testing-the-federation-of-peertube-servers) - - [Unit tests](#unit-tests) + - [RTL layout](#rtl-layout) + - [Testing](#testing) + - [Unit tests](#unit-tests) + - [Testing the federation of PeerTube servers](#testing-the-federation-of-peertube-servers) - [Emails](#emails) - [Plugins & Themes](#plugins--themes) @@ -74,13 +76,12 @@ link your PR to the issues it solves by using the GitHub syntax: "fixes #issue_n First, you should use a server or PC with at least 4GB of RAM. Less RAM may lead to crashes. -Make sure that you have followed +1) Make sure that you have followed [the steps](/support/doc/dependencies.md) to install the dependencies. - -Fork the github repository, -and then clone the sources and install node modules: - +1) Install [parallel](https://www.gnu.org/software/parallel/) to be able to run tests. +1) Fork the Github repository. +1) Run the following commands. ``` $ git clone https://github.com/Chocobozzz/PeerTube $ cd PeerTube @@ -164,6 +165,14 @@ and the web server is automatically restarted. $ npm run dev ``` +### RTL layout + +To test RTL layout using `ar` locale: + +``` +$ npm run dev -- --ar-locale +``` + ### Testing Your code contributions must pass the tests before they can be merged. Tests ensure most of the application behaves @@ -195,6 +204,12 @@ If you just want to run 1 test (which is what you want to debug a specific test $ TS_NODE_FILES=true npm run mocha -- --exit -r ts-node/register -r tsconfig-paths/register --bail server/tests/api/videos/single-server.ts ``` +While testing, you might want to display a server's logs: + +``` +NODE_APP_INSTANCE=1 NODE_ENV=test npm run parse-log -- --level debug | less +GF +``` + Instance configurations are in `config/test-{1,2,3,4,5,6}.yaml`. Note that only instance 2 has transcoding enabled. @@ -211,14 +226,16 @@ $ createdb -O peertube peertube_test{1,2,3} Build the application and flush the old tests data: ``` -$ npm run build -- --light +$ npm run build $ npm run clean:server:test ``` -This will run 3 nodes: +To run 3 nodes: ``` -$ npm run play +$ NODE_APP_INSTANCE=1 NODE_ENV=test npm start +$ NODE_APP_INSTANCE=2 NODE_ENV=test npm start +$ NODE_APP_INSTANCE=3 NODE_ENV=test npm start ``` Then you will get access to the three nodes at `http://localhost:900{1,2,3}`