Wiki
Version 257 (Etienne Pallier, 03/22/2016 11:49 pm)
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 | 251 | Etienne Pallier | * Intégration dans Eclipse |
14 | 125 | Etienne Pallier | |
15 | 251 | Etienne Pallier | * Séparation des BD Django et Pyros |
16 | 126 | Etienne Pallier | |
17 | 174 | Etienne Pallier | * Intégration des modules Django déjà développés |
18 | 125 | Etienne Pallier | |
19 | 121 | Etienne Pallier | |
20 | 3 | Etienne Pallier | --- |
21 | 1 | Etienne Pallier | |
22 | 140 | Etienne Pallier | h2. %{margin-left:0px; font-weight:bold; font-size:25px; display:block; color:red;}I - DATABASE SCHEMA (v0.2.1)% |
23 | 116 | Etienne Pallier | |
24 | 116 | Etienne Pallier | |
25 | 117 | Etienne Pallier | {{thumbnail(PYROS_PDM_v021.png, size=300, title=Pyros data model)}} |
26 | 121 | Etienne Pallier | |
27 | 121 | Etienne Pallier | |
28 | 121 | Etienne Pallier | --- |
29 | 116 | Etienne Pallier | |
30 | 141 | Etienne Pallier | h2. %{margin-left:0px; font-weight:bold; font-size:25px; display:block; color:red;}II - Get the project (from gitlab)% |
31 | 141 | Etienne Pallier | |
32 | 253 | Etienne Pallier | h3. Project structure |
33 | 1 | Etienne Pallier | |
34 | 253 | Etienne Pallier | Once you have fetched the project, you should obtain this structure: |
35 | 1 | Etienne Pallier | |
36 | 226 | Etienne Pallier | <pre> |
37 | 1 | Etienne Pallier | |
38 | 1 | Etienne Pallier | PYROS/ |
39 | 254 | Etienne Pallier | ├── install/ |
40 | 254 | Etienne Pallier | │ └── REQUIREMENTS.txt |
41 | 254 | Etienne Pallier | │ └── INSTALLATION.txt |
42 | 226 | Etienne Pallier | ├── public/ |
43 | 226 | Etienne Pallier | │ └── static/ |
44 | 226 | Etienne Pallier | ├── src/ |
45 | 226 | Etienne Pallier | │ ├── manage.py |
46 | 226 | Etienne Pallier | │ ├── pyros/ |
47 | 226 | Etienne Pallier | │ │ ├── __init__.py |
48 | 226 | Etienne Pallier | │ │ ├── __pycache__ |
49 | 226 | Etienne Pallier | │ │ ├── settings.py |
50 | 1 | Etienne Pallier | │ │ ├── urls.py |
51 | 1 | Etienne Pallier | │ │ └── wsgi.py |
52 | 1 | Etienne Pallier | │ └── pyrosapp/ |
53 | 1 | Etienne Pallier | │ ├── __init__.py |
54 | 1 | Etienne Pallier | │ ├── admin.py |
55 | 1 | Etienne Pallier | │ ├── apps.py |
56 | 1 | Etienne Pallier | │ ├── migrations |
57 | 1 | Etienne Pallier | │ ├── models.py |
58 | 1 | Etienne Pallier | │ ├── tests.py |
59 | 1 | Etienne Pallier | │ └── views.py |
60 | 1 | Etienne Pallier | |
61 | 1 | Etienne Pallier | |
62 | 253 | Etienne Pallier | </pre> |
63 | 253 | Etienne Pallier | |
64 | 253 | Etienne Pallier | h3. Get the project from the terminal |
65 | 253 | Etienne Pallier | |
66 | 253 | Etienne Pallier | <pre> |
67 | 253 | Etienne Pallier | git clone https://gitlab.irap.omp.eu/epallier/pyros.git PYROS |
68 | 256 | Etienne Pallier | (or also : git clone git@gitlab.irap.omp.eu:epallier/pyros.git PYROS) |
69 | 253 | Etienne Pallier | </pre> |
70 | 255 | Etienne Pallier | |
71 | 253 | Etienne Pallier | This creates a PYROS/ folder containing the project (with a .git/ subfolder for synchronization with the git repository) |
72 | 253 | Etienne Pallier | |
73 | 257 | Etienne Pallier | _If you just wanted a static copy of the project (without synchronization), just remove the .git/ folder:_ |
74 | 253 | Etienne Pallier | <pre> |
75 | 253 | Etienne Pallier | $ rm -r .git/ |
76 | 253 | Etienne Pallier | </pre> |
77 | 226 | Etienne Pallier | |
78 | 1 | Etienne Pallier | h3. Get the project from Eclipse |
79 | 252 | Etienne Pallier | ECLIPSE |
80 | 1 | Etienne Pallier | |
81 | 252 | Etienne Pallier | File/Import project from git |
82 | 252 | Etienne Pallier | |
83 | 252 | Etienne Pallier | Select repository source: |
84 | 252 | Etienne Pallier | Clone URI |
85 | 252 | Etienne Pallier | |
86 | 252 | Etienne Pallier | URI: https://gitlab.irap.omp.eu/epallier/pyros.git |
87 | 252 | Etienne Pallier | |
88 | 252 | Etienne Pallier | Directory: |
89 | 252 | Etienne Pallier | par défaut, il propose : /Users/epallier/git/pyros |
90 | 252 | Etienne Pallier | mais je préfère le mettre ailleurs |
91 | 252 | Etienne Pallier | |
92 | 252 | Etienne Pallier | initial branch: master |
93 | 252 | Etienne Pallier | remote name: origin |
94 | 252 | Etienne Pallier | |
95 | 252 | Etienne Pallier | Import as general project |
96 | 252 | Etienne Pallier | |
97 | 252 | Etienne Pallier | Project name: PYROS |
98 | 252 | Etienne Pallier | |
99 | 252 | Etienne Pallier | The project is created. Now, you have to set it as a «PyDev » and a « Django » project. |
100 | 252 | Etienne Pallier | |
101 | 252 | Etienne Pallier | clic droit sur le projet / PyDev / set as a PyDev project |
102 | 252 | Etienne Pallier | |
103 | 252 | Etienne Pallier | clic droit sur le projet / PyDev / set as a Django project |
104 | 252 | Etienne Pallier | |
105 | 252 | Etienne Pallier | clic droit sur le projet : on doit maintenant avoir un sous-menu Django |
106 | 252 | Etienne Pallier | |
107 | 252 | Etienne Pallier | clic droit sur le dossier src / PyDev / set as source folder (add to PYTHONPATH) |
108 | 252 | Etienne Pallier | |
109 | 252 | Etienne Pallier | clic droit sur projet / Properties / Pydev-Django : |
110 | 252 | Etienne Pallier | - Django manage.py : src/manage.py |
111 | 252 | Etienne Pallier | - Django settings module : pyros.settings |
112 | 252 | Etienne Pallier | |
113 | 252 | Etienne Pallier | RUN SERVER : |
114 | 252 | Etienne Pallier | clic droit sur projet, Django/Custom command/runserver |
115 | 252 | Etienne Pallier | |
116 | 252 | Etienne Pallier | check http://localhost:8000/ |
117 | 252 | Etienne Pallier | |
118 | 252 | Etienne Pallier | |
119 | 252 | Etienne Pallier | |
120 | 252 | Etienne Pallier | mkdir private |
121 | 252 | Etienne Pallier | |
122 | 252 | Etienne Pallier | sudo port install py35-virtualenv |
123 | 252 | Etienne Pallier | |
124 | 252 | Etienne Pallier | virtualenv-3.5 venv_py35_pyros -p /opt/local/bin/python3.5 |
125 | 252 | Etienne Pallier | |
126 | 252 | Etienne Pallier | pip install -r ../PYROS/private/REQUIREMENTS.txt |
127 | 252 | Etienne Pallier | |
128 | 252 | Etienne Pallier | … |
129 | 252 | Etienne Pallier | |
130 | 252 | Etienne Pallier | |
131 | 252 | Etienne Pallier | clic droit sur projet / Properties / PyDev - Interpreter/Grammar : |
132 | 252 | Etienne Pallier | Grammar version : 3 |
133 | 252 | Etienne Pallier | Interpreter : click on « click here to configure an interpreter not listed » |
134 | 252 | Etienne Pallier | click on « New » : |
135 | 252 | Etienne Pallier | - Interpreter name : venv_py35_pyros |
136 | 252 | Etienne Pallier | - Interpreter executable : click on « Browse » |
137 | 252 | Etienne Pallier | Select your private/venv_py35_pyros/bin/python3.5 executable |
138 | 252 | Etienne Pallier | click OK |
139 | 252 | Etienne Pallier | click OK again |
140 | 252 | Etienne Pallier | |
141 | 252 | Etienne Pallier | Interpreter: select now venv_py35_pyros from the list |
142 | 252 | Etienne Pallier | |
143 | 252 | Etienne Pallier | |
144 | 252 | Etienne Pallier | Code style checking: |
145 | 252 | Etienne Pallier | |
146 | 252 | Etienne Pallier | Window/Preferences : Pydev / Editor |
147 | 252 | Etienne Pallier | - Auto Imports : uncheck « Do auto import » |
148 | 252 | Etienne Pallier | - Code style: |
149 | 252 | Etienne Pallier | - Locals … : camelCase |
150 | 252 | Etienne Pallier | - Methods : camelCase() with first lower |
151 | 252 | Etienne Pallier | - Code style / Code Formatter: activer « use autopep8.py for code formatting » |
152 | 252 | Etienne Pallier | - Tabs : Tab length : 4 |
153 | 252 | Etienne Pallier | |
154 | 252 | Etienne Pallier | |
155 | 252 | Etienne Pallier | |
156 | 252 | Etienne Pallier | |
157 | 169 | Etienne Pallier | |
158 | 141 | Etienne Pallier | h2. %{margin-left:0px; font-weight:bold; font-size:25px; display:block; color:red;}III - INSTALLATION% |
159 | 2 | Etienne Pallier | |
160 | 120 | Etienne Pallier | |
161 | 120 | Etienne Pallier | --- |
162 | 120 | Etienne Pallier | |
163 | 184 | Etienne Pallier | h3. Install MySql (only if necessary) |
164 | 2 | Etienne Pallier | |
165 | 49 | Etienne Pallier | * Linux Ubuntu |
166 | 49 | Etienne Pallier | <pre> |
167 | 107 | Paul Carensac | |
168 | 107 | Paul Carensac | $ sudo apt-get install mysql-server |
169 | 107 | Paul Carensac | $ sudo apt-get install mysql-client |
170 | 107 | Paul Carensac | |
171 | 49 | Etienne Pallier | </pre> |
172 | 49 | Etienne Pallier | |
173 | 49 | Etienne Pallier | * Linux CentOS |
174 | 49 | Etienne Pallier | <pre> |
175 | 49 | Etienne Pallier | TODO: |
176 | 49 | Etienne Pallier | $ sudo yum install mysql |
177 | 49 | Etienne Pallier | ... |
178 | 49 | Etienne Pallier | </pre> |
179 | 49 | Etienne Pallier | |
180 | 49 | Etienne Pallier | * Mac OS X |
181 | 1 | Etienne Pallier | Install XAMPP |
182 | 1 | Etienne Pallier | (but you could also use the pre-installed Mac OS MySql) |
183 | 177 | Etienne Pallier | <pre> |
184 | 177 | Etienne Pallier | TODO: |
185 | 49 | Etienne Pallier | </pre> |
186 | 1 | Etienne Pallier | |
187 | 49 | Etienne Pallier | * Windows |
188 | 243 | Paul Carensac | |
189 | 1 | Etienne Pallier | <pre> |
190 | 243 | Paul Carensac | Download and install the newest version on https://dev.mysql.com/downloads/installer/ |
191 | 243 | Paul Carensac | |
192 | 243 | Paul Carensac | Once installed, launch MySQL Installer. Clic on 'Add...' on the right. |
193 | 243 | Paul Carensac | In MySQLServers section, choose the newest, then clic on next. |
194 | 243 | Paul Carensac | Install and configure the server (just follow the installation guide). |
195 | 243 | Paul Carensac | |
196 | 243 | Paul Carensac | Then launch mysql (via the Windows menu). |
197 | 49 | Etienne Pallier | </pre> |
198 | 49 | Etienne Pallier | |
199 | 49 | Etienne Pallier | |
200 | 49 | Etienne Pallier | --- |
201 | 1 | Etienne Pallier | |
202 | 185 | Etienne Pallier | h3. Install Python3.5 (only if necessary) |
203 | 1 | Etienne Pallier | |
204 | 11 | Etienne Pallier | |
205 | 11 | Etienne Pallier | * Mac OS X : |
206 | 1 | Etienne Pallier | <pre> |
207 | 183 | Etienne Pallier | |
208 | 24 | Etienne Pallier | 1) Installer MacPort |
209 | 24 | Etienne Pallier | (TODO: doc) |
210 | 24 | Etienne Pallier | |
211 | 24 | Etienne Pallier | 2) Installer le "port" python35 |
212 | 1 | Etienne Pallier | $ sudo port install python35 |
213 | 183 | Etienne Pallier | |
214 | 1 | Etienne Pallier | </pre> |
215 | 1 | Etienne Pallier | |
216 | 1 | Etienne Pallier | * Linux (Ubuntu) : |
217 | 1 | Etienne Pallier | <pre> |
218 | 244 | Paul Carensac | $ sudo add-apt-repository ppa:fkrull/deadsnakes |
219 | 244 | Paul Carensac | $ sudo apt-get update |
220 | 244 | Paul Carensac | $ sudo apt-get install python3.5 |
221 | 1 | Etienne Pallier | |
222 | 244 | Paul Carensac | $ sudo pip install virtualenv |
223 | 1 | Etienne Pallier | </pre> |
224 | 1 | Etienne Pallier | |
225 | 244 | Paul Carensac | |
226 | 244 | Paul Carensac | * Windows 7 : |
227 | 244 | Paul Carensac | <pre> |
228 | 244 | Paul Carensac | Go to https://www.python.org/downloads/windows/ , choose the wanted version |
229 | 244 | Paul Carensac | On the wanted version’s page, download Windows x86 executable installer |
230 | 244 | Paul Carensac | |
231 | 244 | Paul Carensac | Run the executable |
232 | 244 | Paul Carensac | * On the first page, check "Add python3.5 to PATH" |
233 | 244 | Paul Carensac | * Choose "Install now" option |
234 | 245 | Paul Carensac | |
235 | 245 | Paul Carensac | Open cmd (windows + R, cmd) : |
236 | 245 | Paul Carensac | $ python -m pip install --upgrade pip |
237 | 245 | Paul Carensac | $ pip install virtualenv |
238 | 244 | Paul Carensac | </pre> |
239 | 1 | Etienne Pallier | |
240 | 183 | Etienne Pallier | * Windows 10 : |
241 | 183 | Etienne Pallier | <pre> |
242 | 187 | Etienne Pallier | TODO: |
243 | 183 | Etienne Pallier | </pre> |
244 | 3 | Etienne Pallier | |
245 | 4 | Etienne Pallier | --- |
246 | 5 | Etienne Pallier | |
247 | 192 | Etienne Pallier | h3. Create a Python3 virtual environment dedicated to the project (inside the project folder) |
248 | 127 | Etienne Pallier | |
249 | 131 | Etienne Pallier | <pre> |
250 | 1 | Etienne Pallier | |
251 | 193 | Etienne Pallier | $ mkdir private/ |
252 | 193 | Etienne Pallier | |
253 | 133 | Etienne Pallier | $ cd private/ |
254 | 3 | Etienne Pallier | |
255 | 246 | Paul Carensac | $ which python3.5 ("where python" for windows) |
256 | 3 | Etienne Pallier | /opt/local/bin/python3.5 |
257 | 15 | Etienne Pallier | |
258 | 127 | Etienne Pallier | $ virtualenv-3.5 venv_py35_pyros -p /opt/local/bin/python3.5 |
259 | 3 | Etienne Pallier | => creates a venv_py35_pyros/ folder inside PYROS/private/ |
260 | 1 | Etienne Pallier | |
261 | 131 | Etienne Pallier | </pre> |
262 | 1 | Etienne Pallier | |
263 | 7 | Etienne Pallier | --- |
264 | 3 | Etienne Pallier | |
265 | 65 | Etienne Pallier | h3. Activate the python virtual environment (from inside the project) |
266 | 7 | Etienne Pallier | |
267 | 55 | Etienne Pallier | <pre> |
268 | 1 | Etienne Pallier | |
269 | 65 | Etienne Pallier | $ pwd |
270 | 134 | Etienne Pallier | .../PYROS/private |
271 | 1 | Etienne Pallier | |
272 | 247 | Paul Carensac | $ source ./venv_py35_pyros/bin/activate (venv_py35_pyros/Scripts/activate on Windows) |
273 | 247 | Paul Carensac | |
274 | 65 | Etienne Pallier | |
275 | 3 | Etienne Pallier | $ python -V |
276 | 1 | Etienne Pallier | Python 3.5.1 |
277 | 3 | Etienne Pallier | |
278 | 3 | Etienne Pallier | $ which pip |
279 | 77 | Etienne Pallier | .../PYROS/venv_py35_pyros/bin/pip |
280 | 16 | Etienne Pallier | |
281 | 194 | Etienne Pallier | Upgrade pip to last version available: |
282 | 3 | Etienne Pallier | $ pip install --upgrade pip |
283 | 3 | Etienne Pallier | Collecting pip |
284 | 3 | Etienne Pallier | Downloading pip-8.1.1-py2.py3-none-any.whl (1.2MB) |
285 | 3 | Etienne Pallier | Installing collected packages: pip |
286 | 3 | Etienne Pallier | Found existing installation: pip 7.1.2 |
287 | 3 | Etienne Pallier | Uninstalling pip-7.1.2: |
288 | 3 | Etienne Pallier | Successfully uninstalled pip-7.1.2 |
289 | 1 | Etienne Pallier | Successfully installed pip-8.1.1 |
290 | 194 | Etienne Pallier | |
291 | 194 | Etienne Pallier | Upgrade wheel to last version available: |
292 | 194 | Etienne Pallier | $ pip install --upgrade wheel |
293 | 194 | Etienne Pallier | Collecting wheel |
294 | 194 | Etienne Pallier | Downloading wheel-0.29.0-py2.py3-none-any.whl (66kB) |
295 | 194 | Etienne Pallier | Installing collected packages: wheel |
296 | 194 | Etienne Pallier | Found existing installation: wheel 0.24.0 |
297 | 194 | Etienne Pallier | Uninstalling wheel-0.24.0: |
298 | 194 | Etienne Pallier | Successfully uninstalled wheel-0.24.0 |
299 | 194 | Etienne Pallier | Successfully installed wheel-0.29.0 |
300 | 194 | Etienne Pallier | |
301 | 55 | Etienne Pallier | |
302 | 55 | Etienne Pallier | </pre> |
303 | 18 | Etienne Pallier | |
304 | 212 | Etienne Pallier | h3. Install the needed Python packages (from within the virtual environment) |
305 | 18 | Etienne Pallier | |
306 | 66 | Etienne Pallier | First, be sure that the virtual environment is activated: |
307 | 66 | Etienne Pallier | <pre> |
308 | 66 | Etienne Pallier | $ python -V |
309 | 66 | Etienne Pallier | Python 3.5.1 |
310 | 66 | Etienne Pallier | </pre> |
311 | 66 | Etienne Pallier | |
312 | 62 | Etienne Pallier | * *Automatic Installation of all packages* |
313 | 62 | Etienne Pallier | <pre> |
314 | 90 | Etienne Pallier | $ pip install -r REQUIREMENTS.txt |
315 | 62 | Etienne Pallier | </pre> |
316 | 62 | Etienne Pallier | |
317 | 93 | Etienne Pallier | * *Or, manual installation of each package* |
318 | 62 | Etienne Pallier | |
319 | 62 | Etienne Pallier | * *Install Django* : |
320 | 32 | Etienne Pallier | <pre> |
321 | 3 | Etienne Pallier | $ pip install django |
322 | 3 | Etienne Pallier | Collecting django |
323 | 3 | Etienne Pallier | Downloading Django-1.9.4-py2.py3-none-any.whl (6.6MB) |
324 | 3 | Etienne Pallier | Installing collected packages: django |
325 | 3 | Etienne Pallier | Successfully installed django-1.9.4 |
326 | 3 | Etienne Pallier | |
327 | 3 | Etienne Pallier | $ pip install django-admin-tools |
328 | 3 | Etienne Pallier | Collecting django-admin-tools |
329 | 3 | Etienne Pallier | Downloading django_admin_tools-0.7.2-py2.py3-none-any.whl (289kB) |
330 | 3 | Etienne Pallier | Installing collected packages: django-admin-tools |
331 | 3 | Etienne Pallier | Successfully installed django-admin-tools-0.7.2 |
332 | 3 | Etienne Pallier | |
333 | 21 | Etienne Pallier | $ pip install django-debug-toolbar |
334 | 21 | Etienne Pallier | Collecting django-debug-toolbar |
335 | 21 | Etienne Pallier | Downloading django_debug_toolbar-1.4-py2.py3-none-any.whl (212kB) |
336 | 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) |
337 | 21 | Etienne Pallier | Collecting sqlparse (from django-debug-toolbar) |
338 | 21 | Etienne Pallier | Downloading sqlparse-0.1.19.tar.gz (58kB) |
339 | 21 | Etienne Pallier | Building wheels for collected packages: sqlparse |
340 | 21 | Etienne Pallier | Running setup.py bdist_wheel for sqlparse ... done |
341 | 21 | Etienne Pallier | Stored in directory: /Users/epallier/Library/Caches/pip/wheels/7b/d4/72/6011bb100dd5fc213164e4bbee13d4e03261dd54ce6a5de6b8 |
342 | 21 | Etienne Pallier | Successfully built sqlparse |
343 | 21 | Etienne Pallier | Installing collected packages: sqlparse, django-debug-toolbar |
344 | 21 | Etienne Pallier | Successfully installed django-debug-toolbar-1.4 sqlparse-0.1.19 |
345 | 21 | Etienne Pallier | |
346 | 21 | Etienne Pallier | $ pip install django-extensions |
347 | 21 | Etienne Pallier | Collecting django-extensions |
348 | 21 | Etienne Pallier | Downloading django_extensions-1.6.1-py2.py3-none-any.whl (202kB) |
349 | 21 | Etienne Pallier | Collecting six>=1.2 (from django-extensions) |
350 | 21 | Etienne Pallier | Downloading six-1.10.0-py2.py3-none-any.whl |
351 | 21 | Etienne Pallier | Installing collected packages: six, django-extensions |
352 | 21 | Etienne Pallier | Successfully installed django-extensions-1.6.1 six-1.10.0 |
353 | 21 | Etienne Pallier | |
354 | 21 | Etienne Pallier | $ pip install django-suit |
355 | 21 | Etienne Pallier | Collecting django-suit |
356 | 21 | Etienne Pallier | Downloading django-suit-0.2.18.tar.gz (587kB) |
357 | 21 | Etienne Pallier | Building wheels for collected packages: django-suit |
358 | 1 | Etienne Pallier | Running setup.py bdist_wheel for django-suit ... done |
359 | 1 | Etienne Pallier | Stored in directory: /Users/epallier/Library/Caches/pip/wheels/12/8b/9a/e02ab0ad9229881638aa040d47d77c8f562999533811927d41 |
360 | 1 | Etienne Pallier | Successfully built django-suit |
361 | 1 | Etienne Pallier | Installing collected packages: django-suit |
362 | 1 | Etienne Pallier | Successfully installed django-suit-0.2.18 |
363 | 21 | Etienne Pallier | |
364 | 32 | Etienne Pallier | </pre> |
365 | 32 | Etienne Pallier | |
366 | 63 | Etienne Pallier | * *Install the web application server gunicorn (will be used in production instead of the dev django web server)* : |
367 | 32 | Etienne Pallier | <pre> |
368 | 25 | Etienne Pallier | $ pip install gunicorn |
369 | 25 | Etienne Pallier | Collecting gunicorn |
370 | 25 | Etienne Pallier | Downloading gunicorn-19.4.5-py2.py3-none-any.whl (112kB) |
371 | 21 | Etienne Pallier | Installing collected packages: gunicorn |
372 | 26 | Etienne Pallier | Successfully installed gunicorn-19.4.5 |
373 | 1 | Etienne Pallier | </pre> |
374 | 1 | Etienne Pallier | |
375 | 63 | Etienne Pallier | * *Install the python mysql client*: |
376 | 32 | Etienne Pallier | <pre> |
377 | 32 | Etienne Pallier | $ pip install mysqlclient |
378 | 72 | Etienne Pallier | ... |
379 | 72 | Etienne Pallier | </pre> |
380 | 33 | Etienne Pallier | |
381 | 73 | Etienne Pallier | * => Issue under Mac OS X: |
382 | 72 | Etienne Pallier | <pre> |
383 | 3 | Etienne Pallier | $ pip install mysqlclient |
384 | 3 | Etienne Pallier | Collecting mysqlclient |
385 | 1 | Etienne Pallier | Downloading mysqlclient-1.3.7.tar.gz (79kB) |
386 | 22 | Etienne Pallier | Building wheels for collected packages: mysqlclient |
387 | 3 | Etienne Pallier | Running setup.py bdist_wheel for mysqlclient ... error |
388 | 3 | Etienne Pallier | … |
389 | 1 | Etienne Pallier | ---------------------------------------- |
390 | 1 | Etienne Pallier | Failed building wheel for mysqlclient |
391 | 1 | Etienne Pallier | Running setup.py clean for mysqlclient |
392 | 1 | Etienne Pallier | Failed to build mysqlclient |
393 | 1 | Etienne Pallier | Installing collected packages: mysqlclient |
394 | 1 | Etienne Pallier | Running setup.py install for mysqlclient ... done |
395 | 1 | Etienne Pallier | Successfully installed mysqlclient-1.3.7 |
396 | 1 | Etienne Pallier | |
397 | 1 | Etienne Pallier | BOUH !!! |
398 | 1 | Etienne Pallier | |
399 | 1 | Etienne Pallier | $ pip install --upgrade wheel |
400 | 1 | Etienne Pallier | Collecting wheel |
401 | 1 | Etienne Pallier | Downloading wheel-0.29.0-py2.py3-none-any.whl (66kB) |
402 | 1 | Etienne Pallier | Installing collected packages: wheel |
403 | 1 | Etienne Pallier | Found existing installation: wheel 0.24.0 |
404 | 1 | Etienne Pallier | Uninstalling wheel-0.24.0: |
405 | 1 | Etienne Pallier | Successfully uninstalled wheel-0.24.0 |
406 | 1 | Etienne Pallier | Successfully installed wheel-0.29.0 |
407 | 1 | Etienne Pallier | |
408 | 1 | Etienne Pallier | $ pip uninstall mysqlclient |
409 | 1 | Etienne Pallier | |
410 | 1 | Etienne Pallier | $ pip install mysqlclient |
411 | 1 | Etienne Pallier | Collecting mysqlclient |
412 | 1 | Etienne Pallier | Using cached mysqlclient-1.3.7.tar.gz |
413 | 1 | Etienne Pallier | Building wheels for collected packages: mysqlclient |
414 | 1 | Etienne Pallier | Running setup.py bdist_wheel for mysqlclient ... done |
415 | 1 | Etienne Pallier | Stored in directory: /Users/epallier/Library/Caches/pip/wheels/9b/06/50/d11418c26cf8f2156b13d4363b5afde8e7e75ebb8540d0228d |
416 | 1 | Etienne Pallier | Successfully built mysqlclient |
417 | 1 | Etienne Pallier | Installing collected packages: mysqlclient |
418 | 1 | Etienne Pallier | Successfully installed mysqlclient-1.3.7 |
419 | 1 | Etienne Pallier | |
420 | 1 | Etienne Pallier | YES !!! |
421 | 1 | Etienne Pallier | |
422 | 1 | Etienne Pallier | </pre> |
423 | 1 | Etienne Pallier | |
424 | 107 | Paul Carensac | * => Issues under Ubuntu: |
425 | 107 | Paul Carensac | <pre> |
426 | 107 | Paul Carensac | $ pip install mysqlclient |
427 | 107 | Paul Carensac | Collecting mysqlclient |
428 | 107 | Paul Carensac | Downloading mysqlclient-1.3.7.tar.gz (79kB) |
429 | 107 | Paul Carensac | 100% |████████████████████████████████| 81kB 1.5MB/s |
430 | 107 | Paul Carensac | Complete output from command python setup.py egg_info: |
431 | 107 | Paul Carensac | /bin/sh: 1: mysql_config: not found |
432 | 107 | Paul Carensac | Traceback (most recent call last): |
433 | 107 | Paul Carensac | File "<string>", line 1, in <module> |
434 | 107 | Paul Carensac | [...] |
435 | 107 | Paul Carensac | ---------------------------------------- |
436 | 107 | Paul Carensac | Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-build-q6j4inuz/mysqlclient/ |
437 | 1 | Etienne Pallier | |
438 | 108 | Paul Carensac | BOUH !!! |
439 | 108 | Paul Carensac | |
440 | 107 | Paul Carensac | $ sudo apt-get install libmysqlclient-dev |
441 | 108 | Paul Carensac | |
442 | 107 | Paul Carensac | $ pip install mysqlclient |
443 | 107 | Paul Carensac | Collecting mysqlclient |
444 | 107 | Paul Carensac | Using cached mysqlclient-1.3.7.tar.gz |
445 | 107 | Paul Carensac | Building wheels for collected packages: mysqlclient |
446 | 107 | Paul Carensac | Running setup.py bdist_wheel for mysqlclient ... error |
447 | 107 | Paul Carensac | … |
448 | 107 | Paul Carensac | _mysql.c:40:20: fatal error: Python.h: No such file or directory |
449 | 107 | Paul Carensac | #include "Python.h" |
450 | 107 | Paul Carensac | ^ |
451 | 107 | Paul Carensac | compilation terminated. |
452 | 107 | Paul Carensac | error: command 'x86_64-linux-gnu-gcc' failed with exit status 1 |
453 | 107 | Paul Carensac | |
454 | 107 | Paul Carensac | ---------------------------------------- |
455 | 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/ |
456 | 107 | Paul Carensac | |
457 | 108 | Paul Carensac | BOUH !!! |
458 | 108 | Paul Carensac | |
459 | 107 | Paul Carensac | $ sudo apt-get install python3.5-dev |
460 | 108 | Paul Carensac | |
461 | 107 | Paul Carensac | $ pip install mysqlclient |
462 | 107 | Paul Carensac | |
463 | 107 | Paul Carensac | YES !!! |
464 | 107 | Paul Carensac | |
465 | 107 | Paul Carensac | </pre> |
466 | 12 | Etienne Pallier | |
467 | 250 | Paul Carensac | * => Issue under Windows |
468 | 250 | Paul Carensac | <pre> |
469 | 250 | Paul Carensac | Same message as the issue for Mac. |
470 | 250 | Paul Carensac | |
471 | 250 | Paul Carensac | Go to http://www.lfd.uci.edu/~gohlke/pythonlibs/#mysqlclient to download the newest mysqlclient wheel |
472 | 250 | Paul Carensac | |
473 | 250 | Paul Carensac | $ pip install path\to\mysqlclient\wheel |
474 | 250 | Paul Carensac | |
475 | 250 | Paul Carensac | No need to redo "pip install mysqlclient" |
476 | 250 | Paul Carensac | </pre> |
477 | 250 | Paul Carensac | |
478 | 12 | Etienne Pallier | --- |
479 | 28 | Etienne Pallier | |
480 | 142 | Etienne Pallier | h3. Test the project |
481 | 142 | Etienne Pallier | |
482 | 142 | Etienne Pallier | <pre> |
483 | 142 | Etienne Pallier | |
484 | 150 | Etienne Pallier | $ cd src/ |
485 | 150 | Etienne Pallier | |
486 | 1 | Etienne Pallier | $ ./manage.py runserver |
487 | 38 | Etienne Pallier | (or gunicorn pyros.wsgi) |
488 | 3 | Etienne Pallier | ==> http://localhost:8000 |
489 | 87 | Etienne Pallier | ... |
490 | 87 | Etienne Pallier | ... |
491 | 87 | Etienne Pallier | Ctrl-c |
492 | 87 | Etienne Pallier | |
493 | 1 | Etienne Pallier | </pre> |
494 | 142 | Etienne Pallier | |
495 | 142 | Etienne Pallier | |
496 | 142 | Etienne Pallier | |
497 | 142 | Etienne Pallier | --- |
498 | 142 | Etienne Pallier | |
499 | 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)% |
500 | 155 | Paul Carensac | |
501 | 155 | Paul Carensac | --- |
502 | 155 | Paul Carensac | |
503 | 155 | Paul Carensac | h3. Back Office setup |
504 | 155 | Paul Carensac | |
505 | 155 | Paul Carensac | * Prerequisites in src/pyros/settings.py : |
506 | 155 | Paul Carensac | |
507 | 155 | Paul Carensac | * INSTALLED_APPS must (at least) contain : |
508 | 155 | Paul Carensac | |
509 | 155 | Paul Carensac | * django.contrib.admin |
510 | 155 | Paul Carensac | * django.contrib.auth |
511 | 155 | Paul Carensac | * django.contrib.contenttypes |
512 | 155 | Paul Carensac | * django.contrib.sessions |
513 | 155 | Paul Carensac | |
514 | 155 | Paul Carensac | * MIDDLEWARES must (at least) contain : |
515 | 155 | Paul Carensac | |
516 | 155 | Paul Carensac | * django.contrib.sessions.middleware.SessionMiddleware |
517 | 155 | Paul Carensac | * django.middleware.common.CommonMiddleware |
518 | 155 | Paul Carensac | * django.contrib.auth.middleware.AuthenticationMiddleware |
519 | 155 | Paul Carensac | |
520 | 155 | Paul Carensac | * At least one 'python manage.py migrate' must have been executed |
521 | 155 | Paul Carensac | |
522 | 155 | Paul Carensac | * Create a superuser for the administration : |
523 | 155 | Paul Carensac | |
524 | 155 | Paul Carensac | <pre> |
525 | 155 | Paul Carensac | $ python manage.py createsuperuser |
526 | 155 | Paul Carensac | </pre> |
527 | 155 | Paul Carensac | |
528 | 156 | Paul Carensac | * For each app of the project, fill the admin.py file : |
529 | 155 | Paul Carensac | |
530 | 155 | Paul Carensac | <pre> |
531 | 155 | Paul Carensac | from django.contrib import admin |
532 | 155 | Paul Carensac | from app.models import Model1, Model2 |
533 | 155 | Paul Carensac | |
534 | 155 | Paul Carensac | admin.site.register(Model1) |
535 | 155 | Paul Carensac | admin.site.register(Model2) |
536 | 155 | Paul Carensac | </pre> |
537 | 155 | Paul Carensac | |
538 | 155 | Paul Carensac | *Reminder* : each application must be registered in the settings.py INSTALLED_APPS variable. |
539 | 157 | Paul Carensac | |
540 | 168 | Paul Carensac | * For each model in models.py, add a '__str__()' method in order to identify the object on the back office. Example : |
541 | 157 | Paul Carensac | |
542 | 157 | Paul Carensac | <pre> |
543 | 157 | Paul Carensac | class UserLevel(models.Model): |
544 | 157 | Paul Carensac | name = models.CharField(max_length=45, blank=True, null=True) |
545 | 157 | Paul Carensac | desc = models.TextField(blank=True, null=True) |
546 | 157 | Paul Carensac | priority = models.IntegerField(blank=True, null=True) |
547 | 157 | Paul Carensac | quota = models.FloatField(blank=True, null=True) |
548 | 157 | Paul Carensac | |
549 | 157 | Paul Carensac | class Meta: |
550 | 157 | Paul Carensac | managed = True |
551 | 157 | Paul Carensac | db_table = 'userlevel' |
552 | 157 | Paul Carensac | |
553 | 157 | Paul Carensac | def __str__(self): |
554 | 163 | Paul Carensac | return (str(self.name)) |
555 | 157 | Paul Carensac | </pre> |
556 | 157 | Paul Carensac | |
557 | 159 | Paul Carensac | *Naming convention* : Use self.name when possible, the creation time/date otherwise. Example : |
558 | 159 | Paul Carensac | |
559 | 159 | Paul Carensac | <pre> |
560 | 159 | Paul Carensac | class SiteWatch(models.Model): |
561 | 159 | Paul Carensac | updated = models.DateTimeField(blank=True, null=True) |
562 | 159 | Paul Carensac | lights = models.CharField(max_length=45, blank=True, null=True) |
563 | 159 | Paul Carensac | dome = models.CharField(max_length=45, blank=True, null=True) |
564 | 159 | Paul Carensac | doors = models.CharField(max_length=45, blank=True, null=True) |
565 | 159 | Paul Carensac | temperature = models.FloatField(blank=True, null=True) |
566 | 159 | Paul Carensac | |
567 | 159 | Paul Carensac | class Meta: |
568 | 159 | Paul Carensac | managed = True |
569 | 159 | Paul Carensac | db_table = 'sitewatch' |
570 | 159 | Paul Carensac | |
571 | 159 | Paul Carensac | def __str__(self): |
572 | 160 | Paul Carensac | return (str(self.updated)) |
573 | 159 | Paul Carensac | </pre> |
574 | 173 | Etienne Pallier | |
575 | 211 | Paul Carensac | --- |
576 | 211 | Paul Carensac | |
577 | 211 | Paul Carensac | h3. Adaptation of the one-to-many and many-to-many display |
578 | 211 | Paul Carensac | |
579 | 211 | Paul Carensac | * The one-to-many relationships are the following (One.many format) : |
580 | 211 | Paul Carensac | |
581 | 211 | Paul Carensac | * Schedule.sequences |
582 | 211 | Paul Carensac | * Request.sequences |
583 | 211 | Paul Carensac | * Sequence.albums |
584 | 211 | Paul Carensac | * Album.plans |
585 | 211 | Paul Carensac | * Plan.images |
586 | 211 | Paul Carensac | * Telescope.detectors |
587 | 211 | Paul Carensac | * Detector.filters |
588 | 211 | Paul Carensac | * NrtAnalysis.images |
589 | 211 | Paul Carensac | * Filter.plans |
590 | 211 | Paul Carensac | * Detector.albums |
591 | 211 | Paul Carensac | * UserLevel.users |
592 | 211 | Paul Carensac | * Country.users |
593 | 211 | Paul Carensac | * ScientificProgram.requests |
594 | 211 | Paul Carensac | * User.requests |
595 | 211 | Paul Carensac | * StrategyObs.alerts |
596 | 211 | Paul Carensac | * SequenceType.sequences |
597 | 211 | Paul Carensac | |
598 | 211 | Paul Carensac | * For each "many", create a new class in admin.py just after the imports, following these examples : |
599 | 211 | Paul Carensac | |
600 | 211 | Paul Carensac | <pre> |
601 | 211 | Paul Carensac | |
602 | 211 | Paul Carensac | For Schedule.sequences, Request.sequences and Sequentype.sequences, we will need : |
603 | 211 | Paul Carensac | |
604 | 211 | Paul Carensac | class SequenceInline(admin.TabularInline): |
605 | 211 | Paul Carensac | model = Sequence |
606 | 211 | Paul Carensac | fields = ("name",) |
607 | 211 | Paul Carensac | show_change_link = True |
608 | 211 | Paul Carensac | |
609 | 211 | Paul Carensac | |
610 | 211 | Paul Carensac | For Sequence.albums and Detector.albums, we will need : |
611 | 211 | Paul Carensac | |
612 | 211 | Paul Carensac | class AlbumInline(admin.TabularInline): |
613 | 211 | Paul Carensac | model = Album |
614 | 211 | Paul Carensac | fields = ("name",) |
615 | 211 | Paul Carensac | show_change_link = True |
616 | 211 | Paul Carensac | |
617 | 211 | Paul Carensac | |
618 | 211 | Paul Carensac | For StrategyObs.alerts, we will need : |
619 | 211 | Paul Carensac | |
620 | 211 | Paul Carensac | class AlertInline(admin.TabularInline): |
621 | 211 | Paul Carensac | model = Alert |
622 | 211 | Paul Carensac | fields = ("request.name",) # there is no 'name' attribute in the Alert model |
623 | 211 | Paul Carensac | show_change_link = True |
624 | 211 | Paul Carensac | |
625 | 211 | Paul Carensac | </pre> |
626 | 211 | Paul Carensac | |
627 | 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 : |
628 | 211 | Paul Carensac | |
629 | 222 | Paul Carensac | <pre> |
630 | 222 | Paul Carensac | For Request.sequences : |
631 | 222 | Paul Carensac | |
632 | 222 | Paul Carensac | class RequestAdmin(admin.ModelAdmin): |
633 | 222 | Paul Carensac | inlines = [ |
634 | 222 | Paul Carensac | SequenceInline, |
635 | 222 | Paul Carensac | ] |
636 | 222 | Paul Carensac | |
637 | 222 | Paul Carensac | For Detector.filters and Detector.albums : |
638 | 222 | Paul Carensac | |
639 | 222 | Paul Carensac | class DetectorAdmin(admin.ModelAdmin): |
640 | 222 | Paul Carensac | inlines = [ |
641 | 222 | Paul Carensac | FilterInline, |
642 | 222 | Paul Carensac | AlbumInline, |
643 | 222 | Paul Carensac | ] |
644 | 222 | Paul Carensac | |
645 | 222 | Paul Carensac | </pre> |
646 | 222 | Paul Carensac | |
647 | 232 | Paul Carensac | |
648 | 222 | Paul Carensac | * The many-to-many relationships are the following : |
649 | 232 | Paul Carensac | |
650 | 222 | Paul Carensac | * ScientificProgram - User |
651 | 222 | Paul Carensac | * ScheduleHistory - Sequence |
652 | 222 | Paul Carensac | |
653 | 222 | Paul Carensac | * For each many-to-many relationship, declare a new "Inline" class in admin.py just after the imports, like this : |
654 | 222 | Paul Carensac | |
655 | 222 | Paul Carensac | <pre> |
656 | 222 | Paul Carensac | For ScientificProgram - User : |
657 | 222 | Paul Carensac | |
658 | 222 | Paul Carensac | class UserAndSPInline(admin.TabularInline): |
659 | 222 | Paul Carensac | model = ScientificProgram.users.through |
660 | 222 | Paul Carensac | |
661 | 222 | Paul Carensac | |
662 | 222 | Paul Carensac | For ScheduleHistory - Sequence |
663 | 222 | Paul Carensac | |
664 | 222 | Paul Carensac | class SequenceAndSHInline(admin.TabularInline): |
665 | 222 | Paul Carensac | model = ScheduleHistory.sequences.through |
666 | 222 | Paul Carensac | |
667 | 222 | Paul Carensac | </pre> |
668 | 222 | Paul Carensac | |
669 | 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. |
670 | 232 | Paul Carensac | |
671 | 232 | Paul Carensac | * For each many-to-many relationship, declare two new classes in admin.py, just after the inlines, like in the following examples : |
672 | 232 | Paul Carensac | |
673 | 232 | Paul Carensac | <pre> |
674 | 232 | Paul Carensac | For the ScheduleHistory - Sequence relationship : |
675 | 232 | Paul Carensac | |
676 | 232 | Paul Carensac | class ScheduleHistoryAdmin(admin.ModelAdmin): |
677 | 232 | Paul Carensac | inlines = [ |
678 | 232 | Paul Carensac | SequenceAndSHInline, |
679 | 232 | Paul Carensac | ] |
680 | 232 | Paul Carensac | exclude = ('sequences',) # ScheduleHistory declares the ManyToManyField, and we want to replace its display in the back office, so we won't display the default field |
681 | 232 | Paul Carensac | |
682 | 232 | Paul Carensac | class SequenceAdmin(admin.ModelAdmin): |
683 | 232 | Paul Carensac | inlines = [ |
684 | 232 | Paul Carensac | AlbumInline, # This is the Inline for the one-to-many relationship Sequence.albums |
685 | 232 | Paul Carensac | SequenceAndSHInline, |
686 | 232 | Paul Carensac | ] |
687 | 232 | Paul Carensac | |
688 | 232 | Paul Carensac | For the ScientificProgram - User relationship : |
689 | 232 | Paul Carensac | |
690 | 232 | Paul Carensac | class ScientificProgramAdmin(admin.ModelAdmin): |
691 | 232 | Paul Carensac | inlines = [ |
692 | 232 | Paul Carensac | RequestInline, |
693 | 232 | Paul Carensac | UserAndSPInline, |
694 | 232 | Paul Carensac | ] |
695 | 232 | Paul Carensac | exclude = ('users',) # Same as ScheduleHistory |
696 | 232 | Paul Carensac | |
697 | 232 | Paul Carensac | class UserAdmin(admin.ModelAdmin): |
698 | 232 | Paul Carensac | inlines = [ |
699 | 232 | Paul Carensac | RequestInline, # This is the Inline for the one-to-many relationship User.requests |
700 | 232 | Paul Carensac | UserAndSPInline, |
701 | 232 | Paul Carensac | ] |
702 | 232 | Paul Carensac | |
703 | 232 | Paul Carensac | </pre> |
704 | 232 | Paul Carensac | |
705 | 235 | Paul Carensac | * For each ModelAdmin class in the admin.py, change the registering line |
706 | 235 | Paul Carensac | |
707 | 235 | Paul Carensac | <pre> |
708 | 235 | Paul Carensac | admin.site.register(Album) |
709 | 235 | Paul Carensac | </pre> |
710 | 235 | Paul Carensac | |
711 | 235 | Paul Carensac | to |
712 | 235 | Paul Carensac | |
713 | 235 | Paul Carensac | <pre> |
714 | 235 | Paul Carensac | admin.site.register(Album, AlbumAdmin) |
715 | 235 | Paul Carensac | </pre> |
716 | 211 | Paul Carensac | |
717 | 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)% |
718 | 1 | Etienne Pallier | |
719 | 236 | Etienne Pallier | |
720 | 242 | Etienne Pallier | [[pyros_install_from_start|Pyros installation from the beginning]] |