.. _installation_guide/appendix/sandbox: Il progetto Sandbox =================== Nelle risorse in documentazione spesso verrà fatto riferimento al progetto **sandbox**, creato appositamente a scopo didattico. Pertanto suggeriamo di scaricarlo e provare ad avviarlo seguendo le seguenti istruzioni. E' inoltre possibile utilizzare un'istanza online dell'applicativo sandbox all'indirizzo https://sandbox.genropy.org autenticandosi con le credenziali - username: sandbox - password: sandbox git clone ~~~~~~~~~ Spostatevi dunque nella directory dei vostri progetti custom (definita nel vostro :ref:`environment.xml` ),e scaricate il progetto sandbox:: cd ~/.../genropy_projects/ git clone https://bitbucket.org/genropy/sandbox.git Oppure:: git clone https://github.com/genropy/sandbox Avviare Sandbox in locale ~~~~~~~~~~~~~~~~~~~~~~~~~ Innanzitutto è necessario dare il comando ``dbsetup`` seguito dal nome dell'istanza **sandbox** per far generare il database con tutte le tables necessarie. Nella configurazione di base viene creato un database *sqlite*. :: gnr app dbsetup sandbox Ricordiamo che prima di avviare l'applicativo *Sandbox*, e qualsiasi altro webserver Genropy, si deve prima lanciare l'istruzione ``daemon`` da un terminale:: gnr web daemon E poi da un'altra finestra di terminale si esegue l'istruzione ``wsgiserve sandbox`` come spiegato nella pagina del :ref:`collaudo dell'installazione` :: gnr web wsgiserve sandbox Se ogni cosa è andata a buon fine dal terminale avremo conferma che la nostra applicazione è servita in locale alla porta 8080:: serving on 0.0.0.0:8080 view at http://127.0.0.1:8080 Remote edit ~~~~~~~~~~~ Genropy offre una modalità di editing del codice dalle pagine direttamente da browser. Se volete sperimentare, e usare questa modalità, occorre avviare l'applicativo con l'opzione ``remote_edit``:: gnr web wsgiserve sandbox --remote_edit L'output del comando precedente indica l'indirizzo da inserire nel browser per accedere alle pagine del sito del progetto. Generalmente è http://127.0.0.1:8080/ (nel caso della sandbox l'utente per l'accesso è admin e la password quella che avete deciso durante l'installazione di genropy). Nel caso in cui si voglia imporre una porta diversa, si può usare il seguente comando (per esempio, volendo imporre la porta 8085, invece di 8080):: gnr web wsgiserve -p 8085 sandbox Per ripristinare il file eventualmente modificato:: git checkout Per ottenere il nome del file da ripristinare:: git status I file modificati sono indicati con la dicitura *modified* in testa ad esempio:: modified: packages/tutor/webpages/lessons/2_la_pagina/02_hello_world.py git checkout packages/tutor/webpages/lessons/2_la_pagina/02_hello_world.py