Wiki

Version 230 (Etienne Pallier, 03/22/2016 10:59 am)

1 1 Etienne Pallier
h1. Technical Documentation for the PYROS project (FGFT-CC)
2 1 Etienne Pallier
3 1 Etienne Pallier
4 1 Etienne Pallier
HOWTO Format Redmine Wiki : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting
5 1 Etienne Pallier
6 1 Etienne Pallier
{{>toc}}
7 1 Etienne Pallier
8 1 Etienne Pallier
9 121 Etienne Pallier
---
10 1 Etienne Pallier
11 121 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}I - TODO%
12 121 Etienne Pallier
13 126 Etienne Pallier
 * installation sur windows
14 125 Etienne Pallier
15 126 Etienne Pallier
 * gitlab
16 1 Etienne Pallier
17 126 Etienne Pallier
 * séparation des BD Django et Pyros
18 125 Etienne Pallier
19 126 Etienne Pallier
 * intégration dans Eclipse
20 126 Etienne Pallier
21 174 Etienne Pallier
 * Intégration des modules Django déjà développés
22 125 Etienne Pallier
23 121 Etienne Pallier
24 3 Etienne Pallier
---
25 1 Etienne Pallier
26 140 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}I - DATABASE SCHEMA (v0.2.1)%
27 116 Etienne Pallier
28 116 Etienne Pallier
29 117 Etienne Pallier
{{thumbnail(PYROS_PDM_v021.png, size=300, title=Pyros data model)}}
30 121 Etienne Pallier
31 121 Etienne Pallier
32 121 Etienne Pallier
---
33 116 Etienne Pallier
34 141 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}II - Get the project (from gitlab)%
35 141 Etienne Pallier
36 169 Etienne Pallier
h3. Get the project from the terminal
37 1 Etienne Pallier
38 1 Etienne Pallier
<pre>
39 1 Etienne Pallier
git clone https://gitlab.irap.omp.eu/epallier/pyros.git PYROS
40 169 Etienne Pallier
41 174 Etienne Pallier
(or also : git clone git@gitlab.irap.omp.eu:epallier/pyros.git)
42 1 Etienne Pallier
</pre>
43 1 Etienne Pallier
44 197 Etienne Pallier
This creates a PYROS/ folder containing the project (with a .git/ subfolder for synchronization with the git repository)
45 1 Etienne Pallier
46 225 Etienne Pallier
_If you just wanted a static copy of the project (without synchronization) just remove the .git/ folder:_
47 1 Etienne Pallier
<pre>
48 1 Etienne Pallier
$ rm -r .git/
49 1 Etienne Pallier
</pre>
50 226 Etienne Pallier
51 226 Etienne Pallier
You should obtain this structure:
52 226 Etienne Pallier
53 226 Etienne Pallier
<pre>
54 226 Etienne Pallier
55 226 Etienne Pallier
PYROS/
56 226 Etienne Pallier
├── REQUIREMENTS.txt
57 226 Etienne Pallier
├── private/
58 226 Etienne Pallier
│   └── venv_py35_pyros/
59 226 Etienne Pallier
├── public/
60 226 Etienne Pallier
│   └── static/
61 226 Etienne Pallier
├── src/
62 226 Etienne Pallier
│   ├── manage.py
63 226 Etienne Pallier
│   ├── pyros/
64 226 Etienne Pallier
│   │   ├── __init__.py
65 226 Etienne Pallier
│   │   ├── __pycache__
66 226 Etienne Pallier
│   │   ├── settings.py
67 226 Etienne Pallier
│   │   ├── urls.py
68 226 Etienne Pallier
│   │   └── wsgi.py
69 226 Etienne Pallier
│   └── pyrosapp/
70 226 Etienne Pallier
│       ├── __init__.py
71 226 Etienne Pallier
│       ├── admin.py
72 226 Etienne Pallier
│       ├── apps.py
73 226 Etienne Pallier
│       ├── migrations
74 226 Etienne Pallier
│       ├── models.py
75 226 Etienne Pallier
│       ├── tests.py
76 226 Etienne Pallier
│       └── views.py
77 226 Etienne Pallier
78 226 Etienne Pallier
79 226 Etienne Pallier
</pre>
80 226 Etienne Pallier
81 174 Etienne Pallier
82 174 Etienne Pallier
h3. Get the project from Eclipse
83 169 Etienne Pallier
84 197 Etienne Pallier
<pre>
85 169 Etienne Pallier
TODO:
86 197 Etienne Pallier
</pre>
87 169 Etienne Pallier
88 141 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}III - INSTALLATION%
89 2 Etienne Pallier
90 120 Etienne Pallier
91 120 Etienne Pallier
---
92 120 Etienne Pallier
93 184 Etienne Pallier
h3. Install MySql (only if necessary)
94 2 Etienne Pallier
95 49 Etienne Pallier
 * Linux Ubuntu
96 49 Etienne Pallier
<pre>
97 107 Paul Carensac
98 107 Paul Carensac
$ sudo apt-get install mysql-server
99 107 Paul Carensac
$ sudo apt-get install mysql-client
100 107 Paul Carensac
101 49 Etienne Pallier
</pre>
102 49 Etienne Pallier
103 49 Etienne Pallier
 * Linux CentOS
104 49 Etienne Pallier
<pre>
105 49 Etienne Pallier
TODO:
106 49 Etienne Pallier
$ sudo yum install mysql
107 49 Etienne Pallier
...
108 49 Etienne Pallier
</pre>
109 49 Etienne Pallier
110 49 Etienne Pallier
 * Mac OS X
111 1 Etienne Pallier
Install XAMPP
112 1 Etienne Pallier
(but you could also use the pre-installed Mac OS MySql)
113 177 Etienne Pallier
<pre>
114 177 Etienne Pallier
TODO:
115 49 Etienne Pallier
</pre>
116 1 Etienne Pallier
117 49 Etienne Pallier
 * Windows
118 177 Etienne Pallier
Install XAMPP
119 49 Etienne Pallier
<pre>
120 49 Etienne Pallier
TODO:
121 49 Etienne Pallier
</pre>
122 49 Etienne Pallier
123 49 Etienne Pallier
124 49 Etienne Pallier
---
125 1 Etienne Pallier
126 185 Etienne Pallier
h3. Install Python3.5 (only if necessary)
127 1 Etienne Pallier
128 11 Etienne Pallier
129 11 Etienne Pallier
 * Mac OS X :
130 1 Etienne Pallier
<pre>
131 183 Etienne Pallier
132 24 Etienne Pallier
1) Installer MacPort
133 24 Etienne Pallier
(TODO: doc)
134 24 Etienne Pallier
135 24 Etienne Pallier
2) Installer le "port" python35
136 1 Etienne Pallier
$ sudo port install python35
137 183 Etienne Pallier
138 1 Etienne Pallier
</pre>
139 1 Etienne Pallier
140 1 Etienne Pallier
 * Linux (Ubuntu) :
141 1 Etienne Pallier
<pre>
142 107 Paul Carensac
sudo add-apt-repository ppa:fkrull/deadsnakes
143 107 Paul Carensac
sudo apt-get update
144 107 Paul Carensac
sudo apt-get install python3.5
145 107 Paul Carensac
146 107 Paul Carensac
sudo pip install virtualenv
147 23 Etienne Pallier
</pre>
148 1 Etienne Pallier
149 1 Etienne Pallier
150 183 Etienne Pallier
 * Windows 10 :
151 183 Etienne Pallier
<pre>
152 187 Etienne Pallier
TODO:
153 183 Etienne Pallier
</pre>
154 3 Etienne Pallier
155 4 Etienne Pallier
---
156 5 Etienne Pallier
157 192 Etienne Pallier
h3. Create a Python3 virtual environment dedicated to the project (inside the project folder)
158 127 Etienne Pallier
159 131 Etienne Pallier
<pre>
160 1 Etienne Pallier
161 193 Etienne Pallier
$ mkdir private/
162 193 Etienne Pallier
163 133 Etienne Pallier
$ cd private/
164 3 Etienne Pallier
165 3 Etienne Pallier
$ which python3.5
166 3 Etienne Pallier
/opt/local/bin/python3.5
167 15 Etienne Pallier
168 127 Etienne Pallier
$ virtualenv-3.5 venv_py35_pyros -p /opt/local/bin/python3.5
169 3 Etienne Pallier
=> creates a venv_py35_pyros/ folder inside PYROS/private/
170 1 Etienne Pallier
171 131 Etienne Pallier
</pre>
172 1 Etienne Pallier
173 7 Etienne Pallier
---
174 3 Etienne Pallier
175 65 Etienne Pallier
h3. Activate the python virtual environment (from inside the project)
176 7 Etienne Pallier
177 55 Etienne Pallier
<pre>
178 1 Etienne Pallier
179 65 Etienne Pallier
$ pwd
180 134 Etienne Pallier
.../PYROS/private
181 1 Etienne Pallier
182 65 Etienne Pallier
$ source ./venv_py35_pyros/bin/activate
183 65 Etienne Pallier
184 3 Etienne Pallier
$ python -V
185 1 Etienne Pallier
Python 3.5.1
186 3 Etienne Pallier
187 3 Etienne Pallier
$ which pip
188 77 Etienne Pallier
.../PYROS/venv_py35_pyros/bin/pip
189 16 Etienne Pallier
190 194 Etienne Pallier
Upgrade pip to last version available:
191 3 Etienne Pallier
$ pip install --upgrade pip
192 3 Etienne Pallier
Collecting pip
193 3 Etienne Pallier
  Downloading pip-8.1.1-py2.py3-none-any.whl (1.2MB)
194 3 Etienne Pallier
Installing collected packages: pip
195 3 Etienne Pallier
  Found existing installation: pip 7.1.2
196 3 Etienne Pallier
    Uninstalling pip-7.1.2:
197 3 Etienne Pallier
      Successfully uninstalled pip-7.1.2
198 1 Etienne Pallier
Successfully installed pip-8.1.1
199 194 Etienne Pallier
200 194 Etienne Pallier
Upgrade wheel to last version available:
201 194 Etienne Pallier
$ pip install --upgrade wheel
202 194 Etienne Pallier
Collecting wheel
203 194 Etienne Pallier
  Downloading wheel-0.29.0-py2.py3-none-any.whl (66kB)
204 194 Etienne Pallier
Installing collected packages: wheel
205 194 Etienne Pallier
  Found existing installation: wheel 0.24.0
206 194 Etienne Pallier
    Uninstalling wheel-0.24.0:
207 194 Etienne Pallier
      Successfully uninstalled wheel-0.24.0
208 194 Etienne Pallier
Successfully installed wheel-0.29.0
209 194 Etienne Pallier
210 55 Etienne Pallier
211 55 Etienne Pallier
</pre>
212 18 Etienne Pallier
213 212 Etienne Pallier
h3. Install the needed Python packages (from within the virtual environment)
214 18 Etienne Pallier
215 66 Etienne Pallier
First, be sure that the virtual environment is activated:
216 66 Etienne Pallier
<pre>
217 66 Etienne Pallier
$ python -V
218 66 Etienne Pallier
Python 3.5.1
219 66 Etienne Pallier
</pre>
220 66 Etienne Pallier
221 62 Etienne Pallier
 * *Automatic Installation of all packages*
222 62 Etienne Pallier
<pre>
223 90 Etienne Pallier
$ pip install -r REQUIREMENTS.txt
224 62 Etienne Pallier
</pre>
225 62 Etienne Pallier
226 93 Etienne Pallier
 * *Or, manual installation of each package*
227 62 Etienne Pallier
228 62 Etienne Pallier
  * *Install Django* :
229 32 Etienne Pallier
<pre>
230 3 Etienne Pallier
$ pip install django
231 3 Etienne Pallier
Collecting django
232 3 Etienne Pallier
  Downloading Django-1.9.4-py2.py3-none-any.whl (6.6MB)
233 3 Etienne Pallier
Installing collected packages: django
234 3 Etienne Pallier
Successfully installed django-1.9.4
235 3 Etienne Pallier
236 3 Etienne Pallier
$ pip install django-admin-tools
237 3 Etienne Pallier
Collecting django-admin-tools
238 3 Etienne Pallier
  Downloading django_admin_tools-0.7.2-py2.py3-none-any.whl (289kB)
239 3 Etienne Pallier
Installing collected packages: django-admin-tools
240 3 Etienne Pallier
Successfully installed django-admin-tools-0.7.2
241 3 Etienne Pallier
242 21 Etienne Pallier
$ pip install django-debug-toolbar
243 21 Etienne Pallier
Collecting django-debug-toolbar
244 21 Etienne Pallier
  Downloading django_debug_toolbar-1.4-py2.py3-none-any.whl (212kB)
245 21 Etienne Pallier
Requirement already satisfied (use --upgrade to upgrade): Django>=1.7 in ./venv_py35_pyros/lib/python3.5/site-packages (from django-debug-toolbar)
246 21 Etienne Pallier
Collecting sqlparse (from django-debug-toolbar)
247 21 Etienne Pallier
  Downloading sqlparse-0.1.19.tar.gz (58kB)
248 21 Etienne Pallier
Building wheels for collected packages: sqlparse
249 21 Etienne Pallier
  Running setup.py bdist_wheel for sqlparse ... done
250 21 Etienne Pallier
  Stored in directory: /Users/epallier/Library/Caches/pip/wheels/7b/d4/72/6011bb100dd5fc213164e4bbee13d4e03261dd54ce6a5de6b8
251 21 Etienne Pallier
Successfully built sqlparse
252 21 Etienne Pallier
Installing collected packages: sqlparse, django-debug-toolbar
253 21 Etienne Pallier
Successfully installed django-debug-toolbar-1.4 sqlparse-0.1.19
254 21 Etienne Pallier
255 21 Etienne Pallier
$ pip install django-extensions
256 21 Etienne Pallier
Collecting django-extensions
257 21 Etienne Pallier
  Downloading django_extensions-1.6.1-py2.py3-none-any.whl (202kB)
258 21 Etienne Pallier
Collecting six>=1.2 (from django-extensions)
259 21 Etienne Pallier
  Downloading six-1.10.0-py2.py3-none-any.whl
260 21 Etienne Pallier
Installing collected packages: six, django-extensions
261 21 Etienne Pallier
Successfully installed django-extensions-1.6.1 six-1.10.0
262 21 Etienne Pallier
263 21 Etienne Pallier
$ pip install django-suit
264 21 Etienne Pallier
Collecting django-suit
265 21 Etienne Pallier
  Downloading django-suit-0.2.18.tar.gz (587kB)
266 21 Etienne Pallier
Building wheels for collected packages: django-suit
267 1 Etienne Pallier
  Running setup.py bdist_wheel for django-suit ... done
268 1 Etienne Pallier
  Stored in directory: /Users/epallier/Library/Caches/pip/wheels/12/8b/9a/e02ab0ad9229881638aa040d47d77c8f562999533811927d41
269 1 Etienne Pallier
Successfully built django-suit
270 1 Etienne Pallier
Installing collected packages: django-suit
271 1 Etienne Pallier
Successfully installed django-suit-0.2.18
272 21 Etienne Pallier
273 32 Etienne Pallier
</pre>
274 32 Etienne Pallier
275 63 Etienne Pallier
  * *Install the web application server gunicorn (will be used in production instead of the dev django web server)* :
276 32 Etienne Pallier
<pre>
277 25 Etienne Pallier
$ pip install gunicorn
278 25 Etienne Pallier
Collecting gunicorn
279 25 Etienne Pallier
  Downloading gunicorn-19.4.5-py2.py3-none-any.whl (112kB)
280 21 Etienne Pallier
Installing collected packages: gunicorn
281 26 Etienne Pallier
Successfully installed gunicorn-19.4.5
282 1 Etienne Pallier
</pre>
283 1 Etienne Pallier
284 63 Etienne Pallier
  * *Install the python mysql client*:
285 32 Etienne Pallier
<pre>
286 32 Etienne Pallier
$ pip install mysqlclient
287 72 Etienne Pallier
...
288 72 Etienne Pallier
</pre>
289 33 Etienne Pallier
290 73 Etienne Pallier
   * => Issue under Mac OS X:
291 72 Etienne Pallier
<pre>
292 3 Etienne Pallier
$ pip install mysqlclient
293 3 Etienne Pallier
Collecting mysqlclient
294 1 Etienne Pallier
  Downloading mysqlclient-1.3.7.tar.gz (79kB)
295 22 Etienne Pallier
Building wheels for collected packages: mysqlclient
296 3 Etienne Pallier
  Running setup.py bdist_wheel for mysqlclient ... error
297 3 Etienne Pallier
298 1 Etienne Pallier
  ----------------------------------------
299 1 Etienne Pallier
  Failed building wheel for mysqlclient
300 1 Etienne Pallier
  Running setup.py clean for mysqlclient
301 1 Etienne Pallier
Failed to build mysqlclient
302 1 Etienne Pallier
Installing collected packages: mysqlclient
303 1 Etienne Pallier
  Running setup.py install for mysqlclient ... done
304 1 Etienne Pallier
Successfully installed mysqlclient-1.3.7
305 1 Etienne Pallier
306 1 Etienne Pallier
BOUH !!!
307 1 Etienne Pallier
308 1 Etienne Pallier
$ pip install --upgrade wheel
309 1 Etienne Pallier
Collecting wheel
310 1 Etienne Pallier
  Downloading wheel-0.29.0-py2.py3-none-any.whl (66kB)
311 1 Etienne Pallier
Installing collected packages: wheel
312 1 Etienne Pallier
  Found existing installation: wheel 0.24.0
313 1 Etienne Pallier
    Uninstalling wheel-0.24.0:
314 1 Etienne Pallier
      Successfully uninstalled wheel-0.24.0
315 1 Etienne Pallier
Successfully installed wheel-0.29.0
316 1 Etienne Pallier
317 1 Etienne Pallier
$ pip uninstall mysqlclient
318 1 Etienne Pallier
319 1 Etienne Pallier
$ pip install mysqlclient
320 1 Etienne Pallier
Collecting mysqlclient
321 1 Etienne Pallier
  Using cached mysqlclient-1.3.7.tar.gz
322 1 Etienne Pallier
Building wheels for collected packages: mysqlclient
323 1 Etienne Pallier
  Running setup.py bdist_wheel for mysqlclient ... done
324 1 Etienne Pallier
  Stored in directory: /Users/epallier/Library/Caches/pip/wheels/9b/06/50/d11418c26cf8f2156b13d4363b5afde8e7e75ebb8540d0228d
325 1 Etienne Pallier
Successfully built mysqlclient
326 1 Etienne Pallier
Installing collected packages: mysqlclient
327 1 Etienne Pallier
Successfully installed mysqlclient-1.3.7
328 1 Etienne Pallier
329 1 Etienne Pallier
YES !!!
330 1 Etienne Pallier
331 1 Etienne Pallier
</pre>
332 1 Etienne Pallier
333 107 Paul Carensac
   * => Issues under Ubuntu:
334 107 Paul Carensac
<pre>
335 107 Paul Carensac
$ pip install mysqlclient
336 107 Paul Carensac
Collecting mysqlclient
337 107 Paul Carensac
  Downloading mysqlclient-1.3.7.tar.gz (79kB)
338 107 Paul Carensac
    100% |████████████████████████████████| 81kB 1.5MB/s
339 107 Paul Carensac
    Complete output from command python setup.py egg_info:
340 107 Paul Carensac
    /bin/sh: 1: mysql_config: not found
341 107 Paul Carensac
    Traceback (most recent call last):
342 107 Paul Carensac
      File "<string>", line 1, in <module>
343 107 Paul Carensac
    [...]
344 107 Paul Carensac
    ----------------------------------------
345 107 Paul Carensac
Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-build-q6j4inuz/mysqlclient/
346 1 Etienne Pallier
347 108 Paul Carensac
BOUH !!!
348 108 Paul Carensac
349 107 Paul Carensac
$ sudo apt-get install libmysqlclient-dev
350 108 Paul Carensac
351 107 Paul Carensac
$ pip install mysqlclient
352 107 Paul Carensac
Collecting mysqlclient
353 107 Paul Carensac
  Using cached mysqlclient-1.3.7.tar.gz
354 107 Paul Carensac
Building wheels for collected packages: mysqlclient
355 107 Paul Carensac
  Running setup.py bdist_wheel for mysqlclient ... error
356 107 Paul Carensac
357 107 Paul Carensac
    _mysql.c:40:20: fatal error: Python.h: No such file or directory
358 107 Paul Carensac
     #include "Python.h"
359 107 Paul Carensac
                        ^
360 107 Paul Carensac
    compilation terminated.
361 107 Paul Carensac
    error: command 'x86_64-linux-gnu-gcc' failed with exit status 1
362 107 Paul Carensac
    
363 107 Paul Carensac
    ----------------------------------------
364 107 Paul Carensac
Command "/home/carens_p/pyros/venv_py35_pyros/bin/python3.5 -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-k3klv92j/mysqlclient/setup.py';exec(compile(getattr(tokenize, 'open', open)(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-gz242xxs-record/install-record.txt --single-version-externally-managed --compile --install-headers /home/carens_p/pyros/venv_py35_pyros/include/site/python3.5/mysqlclient" failed with error code 1 in /tmp/pip-build-k3klv92j/mysqlclient/
365 107 Paul Carensac
366 108 Paul Carensac
BOUH !!!
367 108 Paul Carensac
368 107 Paul Carensac
$ sudo apt-get install python3.5-dev
369 108 Paul Carensac
370 107 Paul Carensac
$ pip install mysqlclient
371 107 Paul Carensac
372 107 Paul Carensac
YES !!!
373 107 Paul Carensac
374 107 Paul Carensac
</pre>
375 12 Etienne Pallier
376 12 Etienne Pallier
---
377 28 Etienne Pallier
378 142 Etienne Pallier
h3. Test the project
379 142 Etienne Pallier
380 142 Etienne Pallier
<pre>
381 142 Etienne Pallier
382 150 Etienne Pallier
$ cd src/
383 150 Etienne Pallier
384 1 Etienne Pallier
$ ./manage.py runserver
385 38 Etienne Pallier
(or gunicorn pyros.wsgi)
386 3 Etienne Pallier
==> http://localhost:8000
387 87 Etienne Pallier
...
388 87 Etienne Pallier
...
389 87 Etienne Pallier
Ctrl-c
390 87 Etienne Pallier
391 1 Etienne Pallier
</pre>
392 142 Etienne Pallier
393 142 Etienne Pallier
394 142 Etienne Pallier
395 142 Etienne Pallier
---
396 142 Etienne Pallier
397 156 Paul Carensac
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}IV - CONFIGURATION of the Django Back Office (administration interface)%
398 155 Paul Carensac
399 155 Paul Carensac
---
400 155 Paul Carensac
401 155 Paul Carensac
h3. Back Office setup
402 155 Paul Carensac
403 155 Paul Carensac
 * Prerequisites in src/pyros/settings.py :
404 155 Paul Carensac
405 155 Paul Carensac
    * INSTALLED_APPS must (at least) contain :
406 155 Paul Carensac
407 155 Paul Carensac
        * django.contrib.admin
408 155 Paul Carensac
        * django.contrib.auth
409 155 Paul Carensac
        * django.contrib.contenttypes
410 155 Paul Carensac
        * django.contrib.sessions
411 155 Paul Carensac
412 155 Paul Carensac
    * MIDDLEWARES must (at least) contain :
413 155 Paul Carensac
414 155 Paul Carensac
        * django.contrib.sessions.middleware.SessionMiddleware
415 155 Paul Carensac
        * django.middleware.common.CommonMiddleware
416 155 Paul Carensac
        * django.contrib.auth.middleware.AuthenticationMiddleware
417 155 Paul Carensac
418 155 Paul Carensac
 * At least one 'python manage.py migrate' must have been executed
419 155 Paul Carensac
420 155 Paul Carensac
 * Create a superuser for the administration :
421 155 Paul Carensac
422 155 Paul Carensac
<pre>
423 155 Paul Carensac
$ python manage.py createsuperuser
424 155 Paul Carensac
</pre>
425 155 Paul Carensac
426 156 Paul Carensac
* For each app of the project, fill the admin.py file :
427 155 Paul Carensac
428 155 Paul Carensac
<pre>
429 155 Paul Carensac
from django.contrib import admin
430 155 Paul Carensac
from app.models import Model1, Model2
431 155 Paul Carensac
432 155 Paul Carensac
admin.site.register(Model1)
433 155 Paul Carensac
admin.site.register(Model2)
434 155 Paul Carensac
</pre>
435 155 Paul Carensac
436 155 Paul Carensac
*Reminder* : each application must be registered in the settings.py INSTALLED_APPS variable.
437 157 Paul Carensac
438 168 Paul Carensac
* For each model in models.py, add a '__str__()' method in order to identify the object on the back office. Example :
439 157 Paul Carensac
440 157 Paul Carensac
<pre>
441 157 Paul Carensac
class UserLevel(models.Model):
442 157 Paul Carensac
    name = models.CharField(max_length=45, blank=True, null=True)
443 157 Paul Carensac
    desc = models.TextField(blank=True, null=True)
444 157 Paul Carensac
    priority = models.IntegerField(blank=True, null=True)
445 157 Paul Carensac
    quota = models.FloatField(blank=True, null=True)
446 157 Paul Carensac
447 157 Paul Carensac
    class Meta:
448 157 Paul Carensac
        managed = True
449 157 Paul Carensac
        db_table = 'userlevel'
450 157 Paul Carensac
451 157 Paul Carensac
    def __str__(self):
452 163 Paul Carensac
        return (str(self.name))
453 157 Paul Carensac
</pre>
454 157 Paul Carensac
455 159 Paul Carensac
*Naming convention* : Use self.name when possible, the creation time/date otherwise. Example :
456 159 Paul Carensac
457 159 Paul Carensac
<pre>
458 159 Paul Carensac
class SiteWatch(models.Model):
459 159 Paul Carensac
    updated = models.DateTimeField(blank=True, null=True)
460 159 Paul Carensac
    lights = models.CharField(max_length=45, blank=True, null=True)
461 159 Paul Carensac
    dome = models.CharField(max_length=45, blank=True, null=True)
462 159 Paul Carensac
    doors = models.CharField(max_length=45, blank=True, null=True)
463 159 Paul Carensac
    temperature = models.FloatField(blank=True, null=True)
464 159 Paul Carensac
465 159 Paul Carensac
    class Meta:
466 159 Paul Carensac
        managed = True
467 159 Paul Carensac
        db_table = 'sitewatch'
468 159 Paul Carensac
469 159 Paul Carensac
    def __str__(self):
470 160 Paul Carensac
        return (str(self.updated))
471 159 Paul Carensac
</pre>
472 173 Etienne Pallier
473 211 Paul Carensac
---
474 211 Paul Carensac
475 211 Paul Carensac
h3. Adaptation of the one-to-many and many-to-many display
476 211 Paul Carensac
477 211 Paul Carensac
* The one-to-many relationships are the following (One.many format) :
478 211 Paul Carensac
479 211 Paul Carensac
    * Schedule.sequences
480 211 Paul Carensac
    * Request.sequences
481 211 Paul Carensac
    * Sequence.albums
482 211 Paul Carensac
    * Album.plans
483 211 Paul Carensac
    * Plan.images
484 211 Paul Carensac
    * Telescope.detectors
485 211 Paul Carensac
    * Detector.filters
486 211 Paul Carensac
    * NrtAnalysis.images
487 211 Paul Carensac
    * Filter.plans
488 211 Paul Carensac
    * Detector.albums
489 211 Paul Carensac
    * UserLevel.users
490 211 Paul Carensac
    * Country.users
491 211 Paul Carensac
    * ScientificProgram.requests
492 211 Paul Carensac
    * User.requests
493 211 Paul Carensac
    * StrategyObs.alerts
494 211 Paul Carensac
    * SequenceType.sequences
495 211 Paul Carensac
496 211 Paul Carensac
* For each "many", create a new class in admin.py just after the imports, following these examples :
497 211 Paul Carensac
498 211 Paul Carensac
<pre>
499 211 Paul Carensac
500 211 Paul Carensac
For Schedule.sequences, Request.sequences and Sequentype.sequences, we will need :
501 211 Paul Carensac
502 211 Paul Carensac
class SequenceInline(admin.TabularInline):
503 211 Paul Carensac
    model = Sequence
504 211 Paul Carensac
    fields = ("name",)
505 211 Paul Carensac
    show_change_link = True
506 211 Paul Carensac
507 211 Paul Carensac
508 211 Paul Carensac
For Sequence.albums and Detector.albums, we will need :
509 211 Paul Carensac
510 211 Paul Carensac
class AlbumInline(admin.TabularInline):
511 211 Paul Carensac
    model = Album
512 211 Paul Carensac
    fields = ("name",)
513 211 Paul Carensac
    show_change_link = True
514 211 Paul Carensac
515 211 Paul Carensac
516 211 Paul Carensac
For StrategyObs.alerts, we will need :
517 211 Paul Carensac
518 211 Paul Carensac
class AlertInline(admin.TabularInline):
519 211 Paul Carensac
    model = Alert
520 211 Paul Carensac
    fields = ("request.name",) # there is no 'name' attribute in the Alert model
521 211 Paul Carensac
    show_change_link = True
522 211 Paul Carensac
523 211 Paul Carensac
</pre>
524 211 Paul Carensac
525 222 Paul Carensac
* For each "One", declare a new class in admin.py, just after the "Inlines" class declaration, as done in the following examples :
526 211 Paul Carensac
527 222 Paul Carensac
<pre>
528 222 Paul Carensac
For Request.sequences :
529 222 Paul Carensac
530 222 Paul Carensac
class RequestAdmin(admin.ModelAdmin):
531 222 Paul Carensac
    inlines = [
532 222 Paul Carensac
	SequenceInline,
533 222 Paul Carensac
    ]
534 222 Paul Carensac
535 222 Paul Carensac
For Detector.filters and Detector.albums :
536 222 Paul Carensac
537 222 Paul Carensac
class DetectorAdmin(admin.ModelAdmin):
538 222 Paul Carensac
    inlines = [
539 222 Paul Carensac
	FilterInline,
540 222 Paul Carensac
        AlbumInline,
541 222 Paul Carensac
    ]
542 222 Paul Carensac
543 222 Paul Carensac
</pre>
544 222 Paul Carensac
545 222 Paul Carensac
* The many-to-many relationships are the following :
546 222 Paul Carensac
    * ScientificProgram - User
547 222 Paul Carensac
    * ScheduleHistory - Sequence
548 222 Paul Carensac
549 222 Paul Carensac
* For each many-to-many relationship, declare a new "Inline" class in admin.py just after the imports, like this :
550 222 Paul Carensac
551 222 Paul Carensac
<pre>
552 222 Paul Carensac
For ScientificProgram - User :
553 222 Paul Carensac
554 222 Paul Carensac
class UserAndSPInline(admin.TabularInline):
555 222 Paul Carensac
    model = ScientificProgram.users.through
556 222 Paul Carensac
557 222 Paul Carensac
558 222 Paul Carensac
For ScheduleHistory - Sequence
559 222 Paul Carensac
560 222 Paul Carensac
class SequenceAndSHInline(admin.TabularInline):
561 222 Paul Carensac
    model = ScheduleHistory.sequences.through
562 222 Paul Carensac
563 222 Paul Carensac
</pre>
564 222 Paul Carensac
565 222 Paul Carensac
+Note :+ The order in the line "model = ScientificProgram.users.through" is very important : the first model (ScientificProgram) is the one in which is declared the ManyToManyField relationship.
566 211 Paul Carensac
567 229 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}V - INSTALLATION FROM THE BEGINNING (for dev only, history of the initial project creation)%
568 204 Etienne Pallier
569 205 Etienne Pallier
h3. Install MySql (only if necessary)
570 205 Etienne Pallier
571 205 Etienne Pallier
See above in III-Installation
572 1 Etienne Pallier
https://projects.irap.omp.eu/projects/pyros/wiki/Wiki#III-INSTALLATION
573 207 Etienne Pallier
574 207 Etienne Pallier
575 207 Etienne Pallier
---
576 207 Etienne Pallier
577 208 Etienne Pallier
h3. Create the database (from sql script generated with Mysql Workbench)
578 207 Etienne Pallier
579 207 Etienne Pallier
 * Linux and Mac OS X:
580 207 Etienne Pallier
<pre>
581 207 Etienne Pallier
One liner:
582 207 Etienne Pallier
$ mysql -u root < pyros_create.sql
583 207 Etienne Pallier
584 207 Etienne Pallier
Or :
585 207 Etienne Pallier
$ mysql -u root
586 207 Etienne Pallier
mysql> create database pyros;
587 207 Etienne Pallier
mysql> use pyros;
588 207 Etienne Pallier
mysql> source pyros_create.sql;
589 207 Etienne Pallier
590 207 Etienne Pallier
(
591 207 Etienne Pallier
TODO:
592 207 Etienne Pallier
mysql> grant all on pyros.* to pyros@localhost identified by ‘pyros’;)
593 207 Etienne Pallier
mysql> flush privileges;
594 207 Etienne Pallier
)
595 207 Etienne Pallier
</pre>
596 207 Etienne Pallier
597 207 Etienne Pallier
598 207 Etienne Pallier
 * Windows:
599 207 Etienne Pallier
<pre>
600 207 Etienne Pallier
TODO: Use phpmyadmin ?
601 207 Etienne Pallier
</pre>
602 205 Etienne Pallier
603 205 Etienne Pallier
h3. Install Python3.5 (only if necessary)
604 205 Etienne Pallier
605 205 Etienne Pallier
See above in III-Installation
606 205 Etienne Pallier
https://projects.irap.omp.eu/projects/pyros/wiki/Wiki#III-INSTALLATION
607 205 Etienne Pallier
608 210 Etienne Pallier
609 210 Etienne Pallier
h3. Create the project structure
610 210 Etienne Pallier
611 210 Etienne Pallier
<pre>
612 210 Etienne Pallier
$ mkdir PYROS
613 210 Etienne Pallier
</pre>
614 210 Etienne Pallier
615 210 Etienne Pallier
Example of a good organization :
616 210 Etienne Pallier
617 210 Etienne Pallier
1 project = N applis
618 210 Etienne Pallier
1 appli = N models
619 210 Etienne Pallier
A! L’appli est à côté du projet, PAS DEDANS,
620 210 Etienne Pallier
cela facilite la REUTILISATION
621 210 Etienne Pallier
(an appli can be part of many projects => reuse)
622 210 Etienne Pallier
1 appli = 1 Python module, organized for Django, by default = appli web (but not mandatory)
623 210 Etienne Pallier
624 210 Etienne Pallier
<pre>
625 210 Etienne Pallier
626 210 Etienne Pallier
MYPROJECT/
627 210 Etienne Pallier
	REQUIREMENTS.txt
628 210 Etienne Pallier
	src/
629 210 Etienne Pallier
		myproject/
630 210 Etienne Pallier
		appli1/
631 210 Etienne Pallier
		appli2/
632 210 Etienne Pallier
633 210 Etienne Pallier
		appliN/
634 210 Etienne Pallier
635 210 Etienne Pallier
	public/
636 210 Etienne Pallier
		static/
637 210 Etienne Pallier
638 210 Etienne Pallier
	private/
639 210 Etienne Pallier
		venv_py35_pyros/
640 210 Etienne Pallier
641 210 Etienne Pallier
</pre>
642 210 Etienne Pallier
643 210 Etienne Pallier
644 210 Etienne Pallier
Set needed folders:
645 210 Etienne Pallier
<pre>
646 210 Etienne Pallier
$ cd PYROS/
647 210 Etienne Pallier
$ mkdir private public
648 210 Etienne Pallier
$ mkdir public/static
649 210 Etienne Pallier
</pre>
650 210 Etienne Pallier
651 210 Etienne Pallier
652 210 Etienne Pallier
653 210 Etienne Pallier
---
654 210 Etienne Pallier
655 205 Etienne Pallier
h3. Create a Python3 virtual environment dedicated to the project (inside the project folder)
656 205 Etienne Pallier
657 205 Etienne Pallier
See above in III-Installation
658 205 Etienne Pallier
https://projects.irap.omp.eu/projects/pyros/wiki/Wiki#III-INSTALLATION
659 205 Etienne Pallier
660 205 Etienne Pallier
h3. Activate the Python virtual environment (from inside the project)
661 205 Etienne Pallier
662 205 Etienne Pallier
See above in III-Installation
663 205 Etienne Pallier
https://projects.irap.omp.eu/projects/pyros/wiki/Wiki#III-INSTALLATION
664 205 Etienne Pallier
665 213 Etienne Pallier
h3. Install the needed Python packages (from within the virtual environment)
666 205 Etienne Pallier
667 1 Etienne Pallier
See above in III-Installation
668 213 Etienne Pallier
https://projects.irap.omp.eu/projects/pyros/wiki/Wiki#Install-the-needed-Python-packages-from-within-the-virtual-environment
669 213 Etienne Pallier
(cf manual installation)
670 213 Etienne Pallier
671 215 Etienne Pallier
h3. Create a Django project named PYROS
672 1 Etienne Pallier
673 215 Etienne Pallier
<pre>
674 215 Etienne Pallier
675 215 Etienne Pallier
From inside the project:
676 215 Etienne Pallier
$ pwd
677 215 Etienne Pallier
.../PYROS/
678 215 Etienne Pallier
679 215 Etienne Pallier
$ django-admin startproject pyros
680 215 Etienne Pallier
681 215 Etienne Pallier
Rename the project folder "pyros/" as "src/"
682 215 Etienne Pallier
683 215 Etienne Pallier
$ mv pyros src
684 215 Etienne Pallier
685 215 Etienne Pallier
We have then this architecture:
686 215 Etienne Pallier
687 215 Etienne Pallier
PYROS
688 215 Etienne Pallier
├── REQUIREMENTS.txt
689 215 Etienne Pallier
├── private
690 215 Etienne Pallier
│   └── venv_py35_pyros
691 215 Etienne Pallier
├── public
692 215 Etienne Pallier
│   └── static
693 215 Etienne Pallier
├── src
694 215 Etienne Pallier
│   ├── manage.py
695 215 Etienne Pallier
│   ├── pyros
696 215 Etienne Pallier
│   │   ├── __init__.py
697 215 Etienne Pallier
│   │   ├── settings.py
698 215 Etienne Pallier
│   │   ├── urls.py
699 215 Etienne Pallier
│   │   └── wsgi.py
700 215 Etienne Pallier
701 215 Etienne Pallier
</pre>
702 215 Etienne Pallier
703 215 Etienne Pallier
704 215 Etienne Pallier
705 215 Etienne Pallier
706 215 Etienne Pallier
---
707 205 Etienne Pallier
708 205 Etienne Pallier
h3. Test the project
709 205 Etienne Pallier
710 205 Etienne Pallier
See above in III-Installation
711 205 Etienne Pallier
https://projects.irap.omp.eu/projects/pyros/wiki/Wiki#III-INSTALLATION
712 205 Etienne Pallier
713 205 Etienne Pallier
h3. The Web server
714 205 Etienne Pallier
715 217 Etienne Pallier
716 217 Etienne Pallier
Apache : gère tous les fichiers statiques (images, html…), et délègue les fichiers python au serveur django (par défaut)
717 217 Etienne Pallier
718 217 Etienne Pallier
Le fichier pyros/urls.py prend le relai pour tout ce qui est django
719 217 Etienne Pallier
720 217 Etienne Pallier
Le moteur web django sera soit du wsgi soit du unicorn
721 217 Etienne Pallier
722 217 Etienne Pallier
Par défaut, 1 seul worker, mais on peut en configurer plusieurs, l’idéal étant de faire "nb coeurs + 1" 
723 217 Etienne Pallier
(le worker maître qui fait le dispatching aux autres)
724 217 Etienne Pallier
725 217 Etienne Pallier
Frontend : Apache ou Ngininx
726 217 Etienne Pallier
727 217 Etienne Pallier
Backend : gunicorn (gère facilement des workers) ou uwsgi
728 217 Etienne Pallier
729 217 Etienne Pallier
<pre>
730 217 Etienne Pallier
$ gunicorn pyros.wsgi
731 217 Etienne Pallier
(à la place de manage runserver => A EVITER EN PROD)
732 217 Etienne Pallier
733 217 Etienne Pallier
Ou encore:
734 217 Etienne Pallier
735 217 Etienne Pallier
$ gunicorn --workers 5 library.wsgi
736 217 Etienne Pallier
</pre>
737 217 Etienne Pallier
738 217 Etienne Pallier
---
739 217 Etienne Pallier
740 219 Etienne Pallier
h3. Set the database engine as MySql
741 219 Etienne Pallier
742 219 Etienne Pallier
Edit src/pyros/settings.py
743 219 Etienne Pallier
744 219 Etienne Pallier
<pre>
745 219 Etienne Pallier
DATABASES = {
746 219 Etienne Pallier
    'default': {
747 219 Etienne Pallier
        'ENGINE': 'django.db.backends.mysql',
748 219 Etienne Pallier
        'NAME': 'pyros',
749 219 Etienne Pallier
        'USER': 'root',
750 219 Etienne Pallier
        'PASSWORD': ''
751 219 Etienne Pallier
    }
752 219 Etienne Pallier
}
753 219 Etienne Pallier
</pre>
754 219 Etienne Pallier
755 219 Etienne Pallier
---
756 205 Etienne Pallier
757 221 Etienne Pallier
h3. Import the database into Django (with inspectdb)
758 221 Etienne Pallier
759 221 Etienne Pallier
From src/ :
760 221 Etienne Pallier
761 221 Etienne Pallier
<pre>
762 221 Etienne Pallier
$ ./manage.py inspectdb > models.py
763 221 Etienne Pallier
</pre>
764 221 Etienne Pallier
765 221 Etienne Pallier
Issue on Mac OS X:
766 221 Etienne Pallier
<pre>
767 221 Etienne Pallier
Traceback (most recent call last):
768 221 Etienne Pallier
  File "/Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/django/db/backends/mysql/base.py", line 25, in <module>
769 221 Etienne Pallier
    import MySQLdb as Database
770 221 Etienne Pallier
  File "/Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/MySQLdb/__init__.py", line 19, in <module>
771 221 Etienne Pallier
    import _mysql
772 221 Etienne Pallier
ImportError: dlopen(/Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so, 2): Library not loaded: libmysqlclient.18.dylib
773 221 Etienne Pallier
  Referenced from: /Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so
774 221 Etienne Pallier
  Reason: image not found
775 221 Etienne Pallier
776 221 Etienne Pallier
=> BOUH !!!
777 221 Etienne Pallier
778 221 Etienne Pallier
LA SOLUTION EST ICI : http://stackoverflow.com/questions/6383310/python-mysqldb-library-not-loaded-libmysqlclient-18-dylib
779 221 Etienne Pallier
780 221 Etienne Pallier
Il suffit de faire ceci:
781 221 Etienne Pallier
782 221 Etienne Pallier
$ sudo mkdir -p /usr/local/lib   
783 221 Etienne Pallier
$ sudo ln -s /Applications/XAMPP/xamppfiles/lib/libmysql* /usr/local/lib/
784 221 Etienne Pallier
785 221 Etienne Pallier
Mais on peut aussi faire ceci:
786 221 Etienne Pallier
787 221 Etienne Pallier
Okay, so the offending file is /Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so
788 221 Etienne Pallier
789 221 Etienne Pallier
Next, figure out where _mysql.so thinks it should find libmysqlclient.18.dylib:
790 221 Etienne Pallier
791 221 Etienne Pallier
$ otool -L /Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so
792 221 Etienne Pallier
/Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so:
793 221 Etienne Pallier
	libmysqlclient.18.dylib (compatibility version 18.0.0, current version 18.0.0)
794 221 Etienne Pallier
...
795 221 Etienne Pallier
796 221 Etienne Pallier
So, it's looking for libmysqlclient.18.dylib with no path information, let's fix that:
797 221 Etienne Pallier
798 221 Etienne Pallier
$ locate libmysqlclient.18.dylib
799 221 Etienne Pallier
/Applications/XAMPP/xamppfiles/lib/libmysqlclient.18.dylib
800 221 Etienne Pallier
/Library/SystemMigration/History/Migration-68137DFB-CB6A-4FBB-81E2-11BDB5D01E48/QuarantineRoot/usr/lib/libmysqlclient.18.dylib
801 221 Etienne Pallier
802 221 Etienne Pallier
$ sudo install_name_tool -change libmysqlclient.18.dylib /Applications/XAMPP/xamppfiles/lib/libmysqlclient.18.dylib /Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so
803 221 Etienne Pallier
804 221 Etienne Pallier
Now _mysql.so knows the full path to the library and everything works, regardless of environment variables.
805 221 Etienne Pallier
806 221 Etienne Pallier
$ otool -L /Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so
807 221 Etienne Pallier
/Users/epallier/Documents/_W_more/PROJECTS/GFT/SOFT/PYROS/pyros/venv_py35_pyros/lib/python3.5/site-packages/_mysql.cpython-35m-darwin.so:
808 221 Etienne Pallier
	/Applications/XAMPP/xamppfiles/lib/libmysqlclient.18.dylib (compatibility version 18.0.0, current version 18.0.0)
809 221 Etienne Pallier
...
810 221 Etienne Pallier
811 221 Etienne Pallier
$ ./manage.py inspectdb > models.py
812 221 Etienne Pallier
813 221 Etienne Pallier
=> YES !!!
814 221 Etienne Pallier
</pre>
815 221 Etienne Pallier
816 221 Etienne Pallier
817 221 Etienne Pallier
---
818 205 Etienne Pallier
819 224 Etienne Pallier
h3. Create a Django application named "pyrosapp"
820 224 Etienne Pallier
821 224 Etienne Pallier
From src/ :
822 224 Etienne Pallier
823 224 Etienne Pallier
<pre>
824 224 Etienne Pallier
$ ./manage.py startapp pyrosapp
825 224 Etienne Pallier
</pre>
826 224 Etienne Pallier
827 224 Etienne Pallier
We obtain this structure:
828 224 Etienne Pallier
829 224 Etienne Pallier
<pre>
830 224 Etienne Pallier
831 224 Etienne Pallier
PYROS/
832 224 Etienne Pallier
├── REQUIREMENTS.txt
833 224 Etienne Pallier
├── private/
834 224 Etienne Pallier
│   └── venv_py35_pyros/
835 224 Etienne Pallier
├── public/
836 224 Etienne Pallier
│   └── static/
837 224 Etienne Pallier
├── src/
838 224 Etienne Pallier
│   ├── manage.py
839 224 Etienne Pallier
│   ├── pyros/
840 224 Etienne Pallier
│   │   ├── __init__.py
841 224 Etienne Pallier
│   │   ├── __pycache__
842 224 Etienne Pallier
│   │   ├── settings.py
843 224 Etienne Pallier
│   │   ├── urls.py
844 224 Etienne Pallier
│   │   └── wsgi.py
845 224 Etienne Pallier
│   └── pyrosapp/
846 224 Etienne Pallier
│       ├── __init__.py
847 224 Etienne Pallier
│       ├── admin.py
848 224 Etienne Pallier
│       ├── apps.py
849 224 Etienne Pallier
│       ├── migrations
850 224 Etienne Pallier
│       ├── models.py
851 224 Etienne Pallier
│       ├── tests.py
852 224 Etienne Pallier
│       └── views.py
853 224 Etienne Pallier
854 224 Etienne Pallier
855 224 Etienne Pallier
</pre>
856 224 Etienne Pallier
857 224 Etienne Pallier
---
858 205 Etienne Pallier
859 205 Etienne Pallier
h3. Replace the default pyrosapp models.py with the inspectdb generated one
860 205 Etienne Pallier
861 228 Etienne Pallier
From src/ :
862 228 Etienne Pallier
863 228 Etienne Pallier
<pre>
864 228 Etienne Pallier
$ mv models.py pyrosapp/
865 228 Etienne Pallier
</pre>
866 228 Etienne Pallier
867 228 Etienne Pallier
Add pyrosapp to the project's applications :
868 228 Etienne Pallier
869 228 Etienne Pallier
Edit src/pyros/settings.py
870 228 Etienne Pallier
871 228 Etienne Pallier
<pre>
872 228 Etienne Pallier
INSTALLED_APPS = [
873 228 Etienne Pallier
    'django.contrib.admin',
874 228 Etienne Pallier
    'django.contrib.auth',
875 228 Etienne Pallier
    'django.contrib.contenttypes',
876 228 Etienne Pallier
    'django.contrib.sessions',
877 228 Etienne Pallier
    'django.contrib.messages',
878 228 Etienne Pallier
    'django.contrib.staticfiles',
879 228 Etienne Pallier
    'pyrosapp',
880 228 Etienne Pallier
]
881 228 Etienne Pallier
</pre>
882 228 Etienne Pallier
883 228 Etienne Pallier
---
884 228 Etienne Pallier
885 205 Etienne Pallier
h3. Fix and improve the pyrosapp models.py file (generated by inspectdb)
886 205 Etienne Pallier
887 201 Etienne Pallier
h3. Set Requirements
888 201 Etienne Pallier
889 201 Etienne Pallier
<pre>
890 201 Etienne Pallier
$ pip freeze > REQUIREMENTS.txt
891 201 Etienne Pallier
</pre>
892 182 Etienne Pallier
893 182 Etienne Pallier
894 1 Etienne Pallier
---
895 203 Etienne Pallier
896 203 Etienne Pallier
h3. Initialize the git repository
897 203 Etienne Pallier
898 203 Etienne Pallier
*Git global setup:*
899 203 Etienne Pallier
900 203 Etienne Pallier
<pre>
901 203 Etienne Pallier
$ git config --global user.name "Etienne Pallier"
902 203 Etienne Pallier
$ git config --global user.email "etienne.pallier@irap.omp.eu"
903 203 Etienne Pallier
904 203 Etienne Pallier
$ cat ~/.gitconfig 
905 203 Etienne Pallier
[user]
906 203 Etienne Pallier
	name = Etienne Pallier
907 203 Etienne Pallier
	email = epallier@irap.omp.eu
908 203 Etienne Pallier
[http]
909 203 Etienne Pallier
	sslVerify = false
910 203 Etienne Pallier
</pre>
911 203 Etienne Pallier
912 203 Etienne Pallier
913 203 Etienne Pallier
*Create a new repository:*
914 203 Etienne Pallier
915 203 Etienne Pallier
<pre>
916 203 Etienne Pallier
$ cd PYROS/
917 203 Etienne Pallier
918 203 Etienne Pallier
Define files and folders to be ignored:
919 203 Etienne Pallier
$ vi .gitignore
920 203 Etienne Pallier
.DS_Store
921 203 Etienne Pallier
private
922 203 Etienne Pallier
__pycache__
923 203 Etienne Pallier
924 203 Etienne Pallier
$ touch README.md
925 203 Etienne Pallier
926 203 Etienne Pallier
$ git add README.md
927 203 Etienne Pallier
928 203 Etienne Pallier
$ git commit -m "first commit"
929 203 Etienne Pallier
930 203 Etienne Pallier
$ git remote add origin https://gitlab.irap.omp.eu/epallier/pyros.git
931 203 Etienne Pallier
932 203 Etienne Pallier
$ git push -u origin master
933 203 Etienne Pallier
934 203 Etienne Pallier
$ git add .
935 203 Etienne Pallier
936 203 Etienne Pallier
( if you want to be sure to add ALL files: 
937 203 Etienne Pallier
$ git add -A
938 203 Etienne Pallier
)
939 203 Etienne Pallier
940 203 Etienne Pallier
( if you wanted to remove added files, just type:
941 203 Etienne Pallier
$ git reset HEAD
942 203 Etienne Pallier
)
943 203 Etienne Pallier
944 203 Etienne Pallier
$ git commit -m "first full project commit"
945 203 Etienne Pallier
946 203 Etienne Pallier
$ git push -u origin master
947 203 Etienne Pallier
Counting objects: 43, done.
948 203 Etienne Pallier
Delta compression using up to 4 threads.
949 203 Etienne Pallier
Compressing objects: 100% (41/41), done.
950 203 Etienne Pallier
Writing objects: 100% (43/43), 575.13 KiB ö 0 bytes/s, done.
951 203 Etienne Pallier
Total 43 (delta 2), reused 0 (delta 0)
952 203 Etienne Pallier
To https://gitlab.irap.omp.eu/epallier/pyros.git
953 203 Etienne Pallier
   9c7128c..64501c9  master -> master
954 203 Etienne Pallier
Branch master set up to track remote branch master from origin.
955 203 Etienne Pallier
956 203 Etienne Pallier
$ git status
957 203 Etienne Pallier
On branch master
958 203 Etienne Pallier
Your branch is up-to-date with 'origin/master'.
959 203 Etienne Pallier
nothing to commit, working directory clean
960 203 Etienne Pallier
961 203 Etienne Pallier
</pre>