Merge branch 'master' into doku_predstava
This commit is contained in:
		
						commit
						4679dca9bb
					
				
					 537 changed files with 55915 additions and 99546 deletions
				
			
		|  | @ -1,17 +1,20 @@ | |||
| # Univerzální popis našich konvencí pro nastavení editorů. | ||||
| # Vizte https://editorconfig.org pro detaily | ||||
| 
 | ||||
| root = true | ||||
| 
 | ||||
| [*] | ||||
| charset = utf-8 | ||||
| # Unix-y lines | ||||
| # Unixové řádky | ||||
| end_of_line = lf | ||||
| insert_final_newline = true | ||||
| 
 | ||||
| [*.{py,css}] | ||||
| indent_style = tab | ||||
| # I do not think we prescribe, how big a tab is. | ||||
| # Nenařizujeme konkrétní šířku tabulátoru | ||||
| indent_size = unset | ||||
| 
 | ||||
| # Migrations are auto-generated and thus follow PEP-8, let's not fight with that | ||||
| # Automaticky generované migrace dodržují PEP-8, nemá smysl s tím moc bojovat. | ||||
| [*/migrations/*.py] | ||||
| indent_style = space | ||||
| indent_size = 4 | ||||
|  |  | |||
							
								
								
									
										12
									
								
								.gitignore
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										12
									
								
								.gitignore
									
									
									
									
										vendored
									
									
								
							|  | @ -31,9 +31,15 @@ TODO | |||
| # reversion kvůli historii objektů v reversion | ||||
| **/reversion | ||||
| 
 | ||||
| # dokumentace | ||||
| docs/_build | ||||
| docs/modules | ||||
| 
 | ||||
| # logy týracího skriptu (./checklinks.sh) | ||||
| /wget.log.* | ||||
| 
 | ||||
| # pro lidi, co programují v nástrojích od JetBrains | ||||
| .idea | ||||
| 
 | ||||
| # dokumentace | ||||
| docs/_build | ||||
| docs/modules | ||||
| # Mac users | ||||
| .DS_Store | ||||
|  |  | |||
							
								
								
									
										159
									
								
								Makefile
									
									
									
									
									
								
							
							
						
						
									
										159
									
								
								Makefile
									
									
									
									
									
								
							|  | @ -1,154 +1,9 @@ | |||
| PYTHON ?= python3 | ||||
| VENV ?= ${PYTHON} -m venv | ||||
| # Všechny flagy, které se s venvem/virtualenvem/... mají volat patří sem. Volá se "${VENV} cesta"
 | ||||
| VENV_PATH ?= env | ||||
| # Musí být definovaná, i kdyby to měla být "."
 | ||||
| # Existence tohohle Makefile je tu jen proto, aby fungovala svalová paměť. Pokud můžete, použijte rovnou `make/…`
 | ||||
| %: | ||||
| 	# Používání make jako příkazu je zastaralé, prosím používej radši skripty ze složky make. Spouštím následující příkaz: | ||||
| 	make/$* | ||||
| 
 | ||||
| .PHONY: all venv_check clean install install_web install_venv clean_venv clean_schema run test deploy_test deploy_prod sync_test_media sync_test_db sync_test sync_local_media sync_local_db sync_local | ||||
| default: | ||||
| 	@cat make/README.md | ||||
| 
 | ||||
| # activate by mělo být předpokladem ke všemu, co volá webový python (i.e. python nasazený do ${VENV}u kvůli webu, např. manage.py)
 | ||||
| all: | ||||
| 	@# Just echo: | ||||
| 	# Install je trochu magický: | ||||
| 	# Spusť následující posloupnost příkazů: | ||||
| 	#	make install_venv | ||||
| 	#	. ${VENV_PATH}/bin/activate | ||||
| 	#	make install_web | ||||
| 	# | ||||
| 	# Pokud install_web říká Error: pg_config executable not found. nainstaluj si libpq-dev | ||||
| 	# Pokud chybová hláška obsahuje #include <Python.h>, nainstaluj si python3-dev | ||||
| 	# | ||||
| 	# Až skončíš s vývojem webu, spusť "deactivate". Tím zmizí '(${VENV_PATH})' ze začátku promptu. | ||||
| 
 | ||||
| venv_check: | ||||
| 	@# Pokud org nemá zapnutý venv, poradíme mu, aby si ho zapnul a spadneme. Jinak nic. | ||||
| 	@expr $$PATH : ".*:*$(shell pwd)/${VENV_PATH}/bin" > /dev/null && exit 0 || echo 'Není zapnutý venv, spusť ". ${VENV_PATH}/bin/activate".\nPokud není venv nainstalovaný, spusť "make install_venv"' && false | ||||
| 
 | ||||
| clean: clean_venv clean_schema | ||||
| 
 | ||||
| install: install_web | ||||
| 
 | ||||
| install_web: venv_check | ||||
| 	@# venv může být příšerně starý, takže nejdříve upgradujeme venvové věci | ||||
| 	pip install --upgrade pip | ||||
| 	pip install --upgrade setuptools | ||||
| 	# Instalace závislostí webu | ||||
| 	pip install -r requirements.txt --upgrade | ||||
| 	# Pro vygenerování tesdat spusť ./manage.py testdata | ||||
| 	# Po vygenerování testdat spusť  ./manage.py loaddata data/*, ať máš menu a další modely | ||||
| 	# Pro synchronizaci flatpages spusť make sync_prod_flatpages | ||||
| 
 | ||||
| install_venv: | ||||
| 	${VENV} ${VENV_PATH} | ||||
| 
 | ||||
| clean_venv: | ||||
| 	# Možná není 100% foolproof... | ||||
| 	@test ! ${VENV_PATH} = . || ! echo "Smaž si prosím venv sám, nebudu mazat celý web" | ||||
| 	rm -rfv ${VENV_PATH} | ||||
| 	rm -f pip-selfcheck.json | ||||
| clean_schema: | ||||
| 	rm -f schema_seminar.pdf schema_all.pdf | ||||
| 
 | ||||
| run: venv_check | ||||
| 	./manage.py runserver | ||||
| 
 | ||||
| test: venv_check | ||||
| 	./manage.py test -v2 seminar mamweb | ||||
| 
 | ||||
| # DB schemata
 | ||||
| 
 | ||||
| schema: schema_seminar.pdf schema_all.pdf | ||||
| 
 | ||||
| schema_seminar.pdf: venv_check | ||||
| 	./manage.py graph_models seminar | dot -Tpdf > schema_seminar.pdf | ||||
| 
 | ||||
| schema_all.pdf: venv_check | ||||
| 	./manage.py graph_models -a -g | dot -Tpdf > schema_all.pdf | ||||
| 
 | ||||
| # Deploy to current *mamweb-test* directory
 | ||||
| deploy_test: venv_check | ||||
| 	@if [ ${USER} != "mam-web" ]; then echo "Only possible by user mam-web"; exit 1; fi | ||||
| 	@if [ `readlink -f .` != "/aux/akce/mam/www/mamweb-test" ]; then echo "Only possible in directory mamweb-test"; exit 1; fi | ||||
| 	@echo "Installing version from origin/test ..." | ||||
| 	git pull origin test | ||||
| 	git clean -f | ||||
| 	make install | ||||
| 	./manage.py migrate  | ||||
| 	./manage.py collectstatic --noinput | ||||
| 	(chown -R :mam . || true ) | ||||
| 	(chmod -R g+rX,go-w . || true ) | ||||
| 	@echo Restarting systemd unit | ||||
| 	systemctl --user restart mamweb-test.service | ||||
| 	@echo Done. | ||||
| 
 | ||||
| # Deploy to current *mamweb-prod* directory
 | ||||
| deploy_prod: venv_check | ||||
| 	@if [ ${USER} != "mam-web" ]; then echo "Only possible by user mam-web"; exit 1; fi | ||||
| 	@if [ `readlink -f .` != "/aux/akce/mam/www/mamweb-prod" ]; then echo "Only possible in directory mamweb-prod"; exit 1; fi | ||||
| 	@echo "Backing up production DB ..." | ||||
| 	( cd -P .. && ./backup_prod_db.sh ) | ||||
| 	@echo "Installing version from origin/master ..." | ||||
| 	git pull origin master | ||||
| 	git clean -f | ||||
| 	make install | ||||
| 	./manage.py migrate  | ||||
| 	./manage.py collectstatic --noinput | ||||
| 	(chown -R :mam . || true ) | ||||
| 	(chmod -R g+rX,go-w . || true ) | ||||
| 	@echo Restarting systemd user unit for MaM web | ||||
| 	systemctl --user restart mamweb-prod.service | ||||
| 	@echo Done. | ||||
| 
 | ||||
| 
 | ||||
| sync_prod_flatpages: venv_check  | ||||
| 	@echo Downloading current version of flatpages from mamweb-prod. | ||||
| 	ssh mam-web@gimli.ms.mff.cuni.cz \
 | ||||
| 	"cd /akce/mam/www/mamweb-prod; . env/bin/activate; ./manage.py dumpdata flatpages --indent=2 > flat.json; ./fix_json.py flat.json flat_fixed.json" | ||||
| 	rsync -ave ssh mam-web@gimli.ms.mff.cuni.cz:/akce/mam/www/mamweb-prod/flat_fixed.json data/flat.json | ||||
| 	@echo "Applying downloaded flatpages." | ||||
| 	./manage.py loaddata data/flat.json | ||||
| 	@echo "Done." | ||||
| 
 | ||||
| # Sync test media directory with production
 | ||||
| sync_test_media: | ||||
| 	@if [ ${USER} != "mam-web" ]; then echo "Only possible by user mam-web"; exit 1; fi | ||||
| 	@if [ `readlink -f .` != "/aux/akce/mam/www/mamweb-test" ]; then echo "Only possible in /akce/mam/www/mamweb-test"; exit 1; fi | ||||
| 	rsync -av --delete /akce/mam/www/mamweb-prod/media/ ./media | ||||
| 
 | ||||
| # Sync (with drop) test database with production database
 | ||||
| sync_test_db_aggressive: | ||||
| 	@if [ ${USER} != "mam-web" ]; then echo "Only possible by user mam-web"; exit 1; fi | ||||
| 	pg_dump mam_test > dump-test-`date +"%Y%m%d_%H%M"`.sql | ||||
| 	pg_dump -Fc mam_prod > dump-prod.sql | ||||
| 	@# I am not sure which shell is used, so I am calling bash to make sure | ||||
| 	psql mam_test -c 'DROP OWNED BY "mam-web";' | ||||
| 	pg_restore -c --if-exists -d mam_test dump-prod.sql | ||||
| 	rm dump-prod.sql | ||||
| 	psql mam_test -c "UPDATE django_site SET name='MaMweb (test)', domain='mam-test.ks.matfyz.cz' WHERE id=1" | ||||
| 	@echo Done. | ||||
| 
 | ||||
| # Sync test with production
 | ||||
| # HACK ALERT: using aggressive variant, due to the schemas being too different.
 | ||||
| sync_test: sync_test_media sync_test_db_aggressive | ||||
| 
 | ||||
| 
 | ||||
| # Sync media directory with atrey. Useful for local development with production database
 | ||||
| # Does not sync Galerie and CACHE (too huge). 
 | ||||
| sync_local_media: | ||||
| 	rsync -ave ssh --exclude Galerie --exclude CACHE\
 | ||||
| 		mam-web@gimli.ms.mff.cuni.cz:/akce/mam/www/mamweb-prod/media/ ./media/ | ||||
| # Downloads and restores production database to local database. PostgreSQL only. 
 | ||||
| sync_local_db: | ||||
| 	scp mam-web@gimli.ms.mff.cuni.cz:`ssh mam-web@gimli.ms.mff.cuni.cz 'ls -v /akce/mam/www/backups/mam_prod-*\.pgdump.xz | tail -n 1'` \
 | ||||
| 		./last.pgdump.xz | ||||
| 	xz -fd last.pgdump.xz | ||||
| 	pg_restore -c -d mam-prod  last.pgdump | ||||
| 
 | ||||
| # Sync database and media. See above lines
 | ||||
| sync_local: sync_local_media sync_local_db | ||||
| 
 | ||||
| # Push local compiled Vue to gimli test site
 | ||||
| push_compiled_vue_to_test: | ||||
| 	scp vue_frontend/webpack-stats.json mam-web@gimli:/akce/mam/www/mamweb-test/vue_frontend/ | ||||
| 	rsync -ave ssh seminar/static/seminar/vue mam-web@gimli:/akce/mam/www/mamweb-test/seminar/static/seminar/ | ||||
| 	ssh mam-web@gimli.ms.mff.cuni.cz 'cd /akce/mam/www/mamweb-test/ && . env/bin/activate && ./manage.py collectstatic --noinput' | ||||
| .PHONY: default | ||||
|  |  | |||
							
								
								
									
										115
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										115
									
								
								README.md
									
									
									
									
									
								
							|  | @ -1,77 +1,58 @@ | |||
| Basic commands for web development | ||||
| ================================== | ||||
| Web M&M | ||||
| ====== | ||||
| 
 | ||||
| After you clone this repository, run `make`. It will download, locally install | ||||
| and setup virtualenv and pip, and then locally install all required packages | ||||
| from `requirements.txt`. | ||||
| Tohle je repozitář s kódem M&Mího webu. Pokud zde hledáte web samotný nebo | ||||
| informace o semináři, najdete je na <https://mam.matfyz.cz> (a upřímně nechápu, | ||||
| jak jste se dostali k tomuhle textu :-D) | ||||
| 
 | ||||
| When working with the code, always use the binaries in `./bin/`, such as | ||||
| `bin/pip`, `bin/python`, ... never the global python, pip, ... | ||||
| Use `make` and `./manage.py` for most things. | ||||
| Pokud jste tu zůstali, tak vás beztak zajímá vývoj webu (a jestli ne, tak | ||||
| budeme rádi, když začne :-)). | ||||
| 
 | ||||
| Use git :-) | ||||
| Co je M&Mweb uvnitř | ||||
| ------ | ||||
| Celý náš web je napsaný v [Pythonu](https://www.python.org) ve frameworku | ||||
| [Django](https://www.djangoproject.com/). Web běží na serveru zvaném Gimli, | ||||
| jako databázi používá PostgreSQL (pro lokální vývoj naopak SQLite) a všechen | ||||
| náš kód je uložený v [Gitu](https://git-scm.com/) na [téhle | ||||
| gitee](https://gitea.ks.matfyz.cz/). Pro dokumentaci používáme | ||||
| [Sphinx](https://www.sphinx-doc.org). | ||||
| 
 | ||||
| Quickstart | ||||
| ---------- | ||||
| Run the following commands: | ||||
| 	make install_venv | ||||
| 	. env/bin/activate | ||||
| 	make install_web | ||||
| <!--TODO: Z odstavce výše by ideálně měla být zachována jen první věta a zbytek | ||||
| by měl být někde v docs s podrobnějším popisem…--> | ||||
| 
 | ||||
| Pokud install_web říká Error: pg_config executable not found. nainstaluj si libpq-dev | ||||
| Pokud chybová hláška obsahuje #include <Python.h>, nainstaluj si python3-dev | ||||
| Jak si web pořídit | ||||
| ------ | ||||
| Prosím přečti si podrobnější návod v <docs/vyvoj.rst> (tady by bylo zbytečné | ||||
| ho duplikovat). | ||||
| 
 | ||||
| After finishing development, run "deactivate". | ||||
| Jak web vyvíjet | ||||
| ---- | ||||
| <!--TODO: Napsat obšírněji, asi zase do docs/--> | ||||
| 
 | ||||
| Make commands | ||||
| ------------- | ||||
| Na webu je mnoho věcí k dělání, některé ani nevyžadují kódění (třeba uhánění | ||||
| orgů, aby si psali medailonky, aktualizace fotek, …), některé se naopak týkají | ||||
| infrastruktury pod kódem (Gitea, Gimli, …). Je proto těžké mít na to úplně | ||||
| obecný návod, tak tady je zhruba návod na úpravy kódu a pokud se něco z toho | ||||
| nedá aplikovat, tak to prostě zkus nějak udělat jinak, po svém. (Omlouvám se | ||||
| neinformatikům, ale líp to teď nesepíšu :-)) | ||||
| 
 | ||||
| * `make install` (or `make`) - locally install and setup virtualpy, install | ||||
|   required packages. Ran again installs missing packages. Run after changing | ||||
|   `requirements.txt`. | ||||
| 
 | ||||
| * `make clean` - remove local python packages. | ||||
| 
 | ||||
| * `make veryclean` - remove local packages and virtualpy enviroment and | ||||
|   binaries. | ||||
| 
 | ||||
| * `make run` - runs "./manage.py runserver_plus" | ||||
| 
 | ||||
| * `make push_test` - pushes the last commited version to test location. | ||||
|   Only git-commited changes are pushed! Rest is re-generated from scratch. | ||||
|   At test server, the media data and database are kept the same. | ||||
|   Everything else not in .gitignore is deleted/overwritten on the test server. | ||||
| 
 | ||||
| * `make schema` - generates graph of seminar and all schemas as PDF. Supercool! | ||||
| 
 | ||||
| * `make sync_prod_flatpages` - downloads and applies static/flat pages from mamweb-prod | ||||
| 
 | ||||
| ./manage.py commands | ||||
| -------------------- | ||||
| 
 | ||||
| * `./manage.py migrate` - update the database schema, initialise the database. | ||||
|   You need to run this in the beginning. | ||||
| 
 | ||||
| * `./manage.py runserver_plus` - run a debugging server for the web. Slightly | ||||
|   enhanced compared to `./manage.py runserver`. | ||||
|   Open [127.0.0.1:8000](127.0.0.1:8000). | ||||
| 
 | ||||
| * `./manage.py testdata` - create pseudo-random seminar data and admin/admin | ||||
|   user. | ||||
| 
 | ||||
| * `./manage.py test` - run the tests. | ||||
| 
 | ||||
| * `./manage.py shell` - run commands, list elemements of database, check syntax | ||||
|   by importing files, etc. | ||||
| 
 | ||||
| Configurations | ||||
| -------------- | ||||
| 
 | ||||
| * `mamweb/settings_common.py` contains most configuration options. | ||||
| * `mamweb/settings.py` is used only for local development. | ||||
| * `mamweb/settings_test.py` is used for testing on atrey. | ||||
| * `mamweb/settings_prod.py` is used in production deployment. | ||||
| 
 | ||||
| These are automatically switched by `make`. | ||||
| 1. Nejprve si stáhni repozitář a rozběhni si lokální web u sebe (viz <docs/vyvoj.rst>). | ||||
| 1. Najdi si problém v Kanboardu (klikni na „Issues“ na Gitee) a/nebo se domluv | ||||
|    s webaři, na čem bys tak mohl/a pracovat. | ||||
| 1. Najdi místo, kde se to dá opravit a zkus to tam opravit. Uznávám, že tenhle | ||||
|    bod je otravně obecný, pokud tápeš, zkus se zeptat zkušenějších webařů nebo | ||||
|    podívat do dokumentace. | ||||
| 1. Vyzkoušej, že ti to lokálně funguje tak, jak má. | ||||
| 1. Zvládneš-li a máš-li čas, zkus to i zdokumentovat a/nebo napsat testy (TODO: chybí návod) | ||||
| 1. Po dohodě s webaři to vyzkoušej na testwebu | ||||
| 1. Pošli pull-request a případně zkus reagovat na komentáře | ||||
| 1. Až se změna začlení do hlavní větve (`master`) a nasadí se web na produkci, | ||||
|    můžeš mít radost, že se web bude používat lépe Tobě i ostatním orgům :-) | ||||
| 
 | ||||
| ### Proč pull-requesty? | ||||
| <!--FIXME: Tohle ale už úplně patří do docs a ne sem, jen je zatím nemám prozkoumané…--> | ||||
| 
 | ||||
| Účelů pull-requestů je několik. Jednak doufáme, že pomůže webařům se orientovat | ||||
| v kódu, jednak tím umožňujeme dělat experimenty a dávat si zpětnou vazbu. V | ||||
| neposlední řadě pomáhají držet aspoň trochu konzistentní kód, což má pomoci | ||||
| pohodě při programování… (A asi jsem na něco zapomněl :-)) | ||||
|  |  | |||
|  | @ -1,16 +0,0 @@ | |||
| git hooks | ||||
| ========= | ||||
| 
 | ||||
| Kontrola stylu pythoních zdrojáků pomocí flake8. Kontrolujeme jen změny, | ||||
| abychom nenutili lidi dělat nesouvisející úpravy, které by rozbíjely historii | ||||
| (git blame). | ||||
| 
 | ||||
| pre-commit | ||||
| ---------- | ||||
| * kontrola změn před commitnutím | ||||
| * instalace: lokálně zkopírovat do .git/hooks (musí být spustitelný) | ||||
| 
 | ||||
| update | ||||
| ------ | ||||
| * kontrola změn přicházejících s pushem | ||||
| * instalace: na atreyi zkopírovat do /akce/MaM/MaMweb/mamweb.git/hooks | ||||
|  | @ -1,30 +0,0 @@ | |||
| #!/bin/sh | ||||
| # | ||||
| # Git hook script to verify what is about to be committed. | ||||
| # Checks that the changes don't introduce new flake8 errors. | ||||
| 
 | ||||
| TMPDIFF=`tempfile` | ||||
| FLAKE8="`git rev-parse --show-toplevel`/bin/flake8" | ||||
| 
 | ||||
| status=0 | ||||
| 
 | ||||
| # select only changed python files which are not migrations | ||||
| changed=`git diff --cached --name-only | grep 'py$' | grep -v 'migrations/[0-9]'` | ||||
| if [ -z $changed ] ; then | ||||
|     # Nothing to check. Note the exit is necessary -- we would not pass any | ||||
|     # paths to git diff below and it would output the diff unfiltered. | ||||
|     exit 0 | ||||
| fi | ||||
| 
 | ||||
| git diff --unified=1 --cached HEAD -- $changed > $TMPDIFF | ||||
| 
 | ||||
| # only do the check when there are some changes to be commited | ||||
| # otherwise flake8 would hang waiting for input | ||||
| if [ -s $TMPDIFF ] ; then | ||||
|     cat $TMPDIFF | $FLAKE8 --diff | ||||
|     status=$? | ||||
| fi | ||||
| 
 | ||||
| rm -f $TMPDIFF | ||||
| 
 | ||||
| exit $status | ||||
|  | @ -1,61 +0,0 @@ | |||
| #!/bin/sh | ||||
| 
 | ||||
| # git update hook to check that pushed changes don't introduce new flake8 | ||||
| # errors | ||||
| 
 | ||||
| # --- Command line | ||||
| refname="$1" | ||||
| oldrev="$2" | ||||
| newrev="$3" | ||||
| 
 | ||||
| # --- Safety check | ||||
| if [ -z "$GIT_DIR" ]; then | ||||
| 	echo "Don't run this script from the command line." >&2 | ||||
| 	echo " (if you want, you could supply GIT_DIR then run" >&2 | ||||
| 	echo "  $0 <ref> <oldrev> <newrev>)" >&2 | ||||
| 	exit 1 | ||||
| fi | ||||
| 
 | ||||
| if [ -z "$refname" -o -z "$oldrev" -o -z "$newrev" ]; then | ||||
| 	echo "usage: $0 <ref> <oldrev> <newrev>" >&2 | ||||
| 	exit 1 | ||||
| fi | ||||
| 
 | ||||
| 
 | ||||
| TMPDIR=`mktemp -d` | ||||
| TMPDIFF=`tempfile` | ||||
| 
 | ||||
| [ $refname != "refs/heads/master" -a $refname != "refs/heads/stable" ] && exit 0 | ||||
| 
 | ||||
| # select only changed python files which are not migrations | ||||
| changed=`git diff --name-only $oldrev $newrev | grep 'py$' | grep -v 'migrations/[0-9]'` | ||||
| if [ -z $changed ] ; then | ||||
|     # Nothing to check. Note the exit is necessary -- we would not pass any | ||||
|     # paths to git diff below and it would output the diff unfiltered. | ||||
|     exit 0 | ||||
| fi | ||||
| 
 | ||||
| git diff --unified=1 $oldrev $newrev -- $changed >${TMPDIFF} | ||||
| 
 | ||||
| # there is no working tree in bare git repository, so we recreate it for flake8 | ||||
| git archive $newrev | tar -x -C ${TMPDIR} | ||||
| 
 | ||||
| cd ${TMPDIR} | ||||
| # report only errors on lines in diff | ||||
| # (if threre was flake8 installed on atrey, we could just call flake8) | ||||
| /akce/MaM/WWW/mamweb-test/bin/flake8 --diff <${TMPDIFF} | ||||
| status=$? | ||||
| if [ $status != 0 ] ; then | ||||
|     echo | ||||
|     echo -n "Změny, které se snažíte pushnout, obsahují kód v pythonu " | ||||
|     echo -n "nevyhovující flake8 (viz výše). Opravte je a zkuste to znovu. " | ||||
|     echo -n "Nezapomeňte, že můžete editovat historii (git commit --amend, " | ||||
|     echo -n "git rebase -i). Pokud byste chybu příště raději odhalili už při " | ||||
|     echo "commitu, zkopírujte si pre-commit hook z _git_hooks do .git/hooks." | ||||
|     echo | ||||
| fi | ||||
| 
 | ||||
| rm -rf ${TMPDIR} | ||||
| rm -f ${TMPDIFF} | ||||
| 
 | ||||
| exit $status | ||||
|  | @ -1,8 +1,5 @@ | |||
| """ | ||||
| Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace. | ||||
| """ | ||||
| from django.apps import AppConfig | ||||
| 
 | ||||
| 
 | ||||
| class AesopConfig(AppConfig): | ||||
|     name = 'aesop' | ||||
|     verbose_name = 'Export do AESOPa' | ||||
|  |  | |||
|  | @ -1,5 +1,5 @@ | |||
| from django.http import HttpResponse | ||||
| from django.utils.encoding import force_text | ||||
| from django.utils.encoding import force_str | ||||
| 
 | ||||
| 
 | ||||
| class OvvpFile: | ||||
|  | @ -20,7 +20,7 @@ class OvvpFile: | |||
| 		yield '\t'.join(self.columns) + '\n' | ||||
| 		# rows | ||||
| 		for r in self.rows: | ||||
| 			yield '\t'.join([force_text(r[c]) for c in self.columns]) + '\n' | ||||
| 			yield '\t'.join([force_str(r[c]) for c in self.columns]) + '\n' | ||||
| 
 | ||||
| 	def to_string(self): | ||||
| 		return ''.join(self.to_lines()) | ||||
|  |  | |||
|  | @ -1,10 +1,3 @@ | |||
| """ | ||||
| Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují: | ||||
| 
 | ||||
| - ``aesop-export/mam-rocnik-<int:prvni_rok>.csv`` (seminar_export_rocnik) :class:`~aesop.views.ExportRocnikView` | ||||
| - ``aesop-export/mam-sous-<str:datum_zacatku>.csv`` (seminar_export_sous) :class:`~aesop.views.ExportSousView` | ||||
| - ``aesop-export/index.csv`` (seminar_export_index) :class:`~aesop.views.ExportIndexView` | ||||
| """ | ||||
| from django.urls import path | ||||
| from aesop import views | ||||
| 
 | ||||
|  |  | |||
|  | @ -1,6 +1,6 @@ | |||
| import datetime | ||||
| 
 | ||||
| from django.utils.encoding import force_text | ||||
| from django.utils.encoding import force_str | ||||
| 
 | ||||
| from aesop.ovvpfile import OvvpFile | ||||
| 
 | ||||
|  | @ -9,7 +9,7 @@ def default_ovvpfile(event, rocnik): | |||
|     of = OvvpFile() | ||||
|     of.headers['version'] = '1' | ||||
|     of.headers['event'] = event | ||||
|     of.headers['year'] = force_text(rocnik.prvni_rok) | ||||
|     of.headers['year'] = force_str(rocnik.prvni_rok) | ||||
|     of.headers['date'] = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S") | ||||
|     of.headers['id-scope'] = 'mam' | ||||
|     of.headers['id-generation'] = '1' | ||||
|  |  | |||
|  | @ -1,19 +1,14 @@ | |||
| """ | ||||
| Soubor sloužící k deklaraci jednotlivých „views“ (nejčastěji funkce beroucí request | ||||
| a vracející :func:`django.shortcuts.render` respektive nějakou response, nebo | ||||
| třídy většinou rozšiřující nějakou třídu z :mod:`django.views.generic`) | ||||
| """ | ||||
| import django | ||||
| from django.shortcuts import get_object_or_404 | ||||
| from django.http import HttpResponse | ||||
| from django.urls import reverse | ||||
| from django.views import generic | ||||
| from django.utils.encoding import force_text | ||||
| from django.utils.encoding import force_str | ||||
| 
 | ||||
| from .utils import default_ovvpfile | ||||
| from seminar.models import Rocnik, Soustredeni | ||||
| from vysledkovky import utils | ||||
| from seminar.utils import aktivniResitele | ||||
| from tvorba.utils import aktivniResitele | ||||
| 
 | ||||
| class ExportIndexView(generic.View): | ||||
| 	def get(self, request): | ||||
|  |  | |||
|  | @ -1,8 +1,6 @@ | |||
| """ | ||||
| Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace. | ||||
| """ | ||||
| from django.apps import AppConfig | ||||
| 
 | ||||
| 
 | ||||
| class ApiConfig(AppConfig): | ||||
|     name = 'api' | ||||
|     verbose_name = 'Různá webová API' | ||||
|  |  | |||
|  | @ -1,9 +1,9 @@ | |||
| from django.test import TestCase | ||||
| from django.test import TestCase, tag | ||||
| from django.urls import reverse | ||||
| import seminar.models as m | ||||
| import seminar.views as v | ||||
| from seminar.utils import sync_skoly | ||||
| from personalni.utils import sync_skoly | ||||
| 
 | ||||
| @tag('stejny-model-na-produkci') | ||||
| class OrgSkolyAutocompleteTestCase(TestCase): | ||||
| 	@classmethod | ||||
| 	def setUpClass(cls): | ||||
|  | @ -11,19 +11,20 @@ class OrgSkolyAutocompleteTestCase(TestCase): | |||
| 		sync_skoly('https://mam.mff.cuni.cz/') | ||||
| 		# Správné školy podle toho, co orgové poslali: (prefix, ID školy) | ||||
| 		# NOTE: Pozor, jedná se o databázové indexy. Pokud se to někdy rozbije, bude potřeba je přepsat nebo předělat na IZO | ||||
| 		# TODO: Opravit zakomentované školy. | ||||
| 		cls.spravna_data = [ | ||||
| 				('gymnázium kolín', 53), | ||||
| 				('kolín', 53), | ||||
| 				('gasoš', 96), | ||||
| 				#('gasoš', 96), | ||||
| 				('Rokycany', 96), | ||||
| 				('gasoš Rokycany', 96), | ||||
| 				('SPŠE Pardubice', 815), | ||||
| 				#('gasoš Rokycany', 96), | ||||
| 				#('SPŠE Pardubice', 815), | ||||
| 				('Jaroše', 164), | ||||
| 				("Gymnázium, Brno, tř. Kpt. Jaroše", 164), | ||||
| 				#("Gymnázium, Brno, tř. Kpt. Jaroše", 164), | ||||
| 				("Jírovcova", 157), | ||||
| 				('České Budějovice', 157), | ||||
| 				("Gymnázium, České Budějovice, Jírovcova 8", 157), | ||||
| 				("první soukromé", 2), | ||||
| 				#("první soukromé", 2), | ||||
| 				("Gymnázium Elgartova", 147), | ||||
| 				("Jihlava", 45), | ||||
| 				('Milevsko', 223), | ||||
|  |  | |||
							
								
								
									
										16
									
								
								api/urls.py
									
									
									
									
									
								
							
							
						
						
									
										16
									
								
								api/urls.py
									
									
									
									
									
								
							|  | @ -1,18 +1,6 @@ | |||
| """ | ||||
| Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují: | ||||
| 
 | ||||
| - ``api/expor/skoly/`` (export_skoly) :func:`~api.views.exports.exportSkolView` | ||||
| - ``api/autocomplete/skola/`` (autocomplete_skola) :class:`~api.views.autocomplete.SkolaAutocomplete` | ||||
| - ``api/autocomplete/resitel/`` (autocomplete_resitel) :class:`~api.views.autocomplete.ResitelAutocomplete` | ||||
| - ``api/autocomplete/problem/odevzdatelny`` (autocomplete_problem_odevzdatelny) :class:`~api.views.autocomplete.OdevzdatelnyProblemAutocomplete` | ||||
| 
 | ||||
| Na autocomplete v3 čeká: | ||||
| 
 | ||||
| - ``autocomplete/organizatori/`` (seminar_autocomplete_organizator) :class:`~api.views.autocomplete.OrganizatorAutocomplete` | ||||
| """ | ||||
| from django.urls import path | ||||
| from . import views | ||||
| from seminar.utils import org_required | ||||
| from personalni.utils import org_required | ||||
| 
 | ||||
| urlpatterns = [ | ||||
| 	# Export škol | ||||
|  | @ -22,7 +10,9 @@ urlpatterns = [ | |||
| 	# Autocomplete | ||||
| 	path('api/autocomplete/skola/', views.SkolaAutocomplete.as_view(), name='autocomplete_skola'), | ||||
| 	path('api/autocomplete/resitel/', org_required(views.ResitelAutocomplete.as_view()), name='autocomplete_resitel'), | ||||
| 	path('api/autocomplete/resitel_public/', views.PublicResitelAutocomplete.as_view(), name='autocomplete_resitel_public'), | ||||
| 	path('api/autocomplete/problem/odevzdatelny', views.OdevzdatelnyProblemAutocomplete.as_view(), name='autocomplete_problem_odevzdatelny'), | ||||
| 	path('api/autocomplete/problem/vsechny', views.ProblemAutocomplete.as_view(), name='autocomplete_problem'), | ||||
| 
 | ||||
| 	# Ceka na autocomplete v3 | ||||
| 	# path('autocomplete/organizatori/', | ||||
|  |  | |||
|  | @ -1,7 +1,2 @@ | |||
| """ | ||||
| Soubory sloužící k deklaraci jednotlivých „views“ (nejčastěji funkce beroucí request | ||||
| a vracející :func:`django.shortcuts.render` respektive nějakou response, nebo | ||||
| třídy většinou rozšiřující nějakou třídu z :mod:`django.views.generic`) | ||||
| """ | ||||
| from .autocomplete import * | ||||
| from .exports import * | ||||
|  |  | |||
|  | @ -12,7 +12,7 @@ from .helpers import LoginRequiredAjaxMixin | |||
| class SkolaAutocomplete(autocomplete.Select2QuerySetView): | ||||
| 	""" View k :mod:`dal.autocomplete` pro vyhledávání škol hlavně při registraci. """ | ||||
| 	def get_queryset(self): | ||||
|         	# Don't forget to filter out results depending on the visitor ! | ||||
| 		# Don't forget to filter out results depending on the visitor ! | ||||
| 		qs = m.Skola.objects.all() | ||||
| 		if self.q: | ||||
| 			words = self.q.split(' ') #TODO re split podle bileho znaku | ||||
|  | @ -37,30 +37,62 @@ class ResitelAutocomplete(LoginRequiredAjaxMixin,autocomplete.Select2QuerySetVie | |||
| 			query = Q() | ||||
| 			for part in parts: | ||||
| 				query &= ( | ||||
| 					Q(osoba__jmeno__istartswith=self.q)| | ||||
| 					Q(osoba__prijmeni__istartswith=self.q)| | ||||
| 					Q(osoba__prezdivka__istartswith=self.q) | ||||
| 					Q(osoba__jmeno__istartswith=part)| | ||||
| 					Q(osoba__prijmeni__istartswith=part)| | ||||
| 					Q(osoba__prezdivka__istartswith=part) | ||||
| 				) | ||||
| 			qs = qs.filter(query) | ||||
| 		return qs | ||||
| 
 | ||||
| 
 | ||||
| class PublicResitelAutocomplete(LoginRequiredAjaxMixin, autocomplete.Select2QuerySetView): | ||||
| 	""" | ||||
| 		View k :mod:`dal.autocomplete` pro vyhledávání řešitelů podle přezdívky | ||||
| 		především v odevzdávátku. | ||||
| 	""" | ||||
| 	def get_queryset(self): | ||||
| 		letos = m.Nastaveni.get_solo().aktualni_rocnik | ||||
| 		qs = m.Resitel.objects.filter( | ||||
| 			rok_maturity__gte=letos.druhy_rok() | ||||
| 		).filter( | ||||
| 			prezdivka_resitele__isnull=False | ||||
| 		).exclude( | ||||
| 			prezdivka_resitele="" | ||||
| 		).filter( | ||||
| 			prezdivka_resitele__icontains=self.q | ||||
| 		).all() | ||||
| 		return qs | ||||
| 
 | ||||
| 	def get_result_label(self, result): | ||||
| 		return result.prezdivka_resitele | ||||
| 
 | ||||
| 
 | ||||
| class OdevzdatelnyProblemAutocomplete(autocomplete.Select2QuerySetView): | ||||
| 	""" View k :mod:`dal.autocomplete` pro vyhledávání problémů především v odevzdávátku. """ | ||||
| 	def get_queryset(self): | ||||
| 		qs = m.Problem.objects.filter(stav=m.Problem.STAV_ZADANY) | ||||
| 		if self.q: | ||||
| 			qs = qs.filter( | ||||
| 					Q(nazev__icontains=self.q)) | ||||
| 
 | ||||
| 		nadproblem_id = int(self.forwarded.get("nadproblem_id", -1)) | ||||
| 		if nadproblem_id != -1: | ||||
| 			# Seřadíme tak, aby ty s nadproblem==None byly dole (větší motivace tam naklikat konkrétní úlohy) a pak nějak rozumně. | ||||
| 			# Tohle je řazení pro odevzdávátko, kde je definován nadproblém, proto je to v tomto ifu. (Jinde si to netroufám řadit) | ||||
| 			qs = qs.order_by("nadproblem", "kod", "nazev") | ||||
| 			qs = list(filter(lambda problem: problem.hlavni_problem.id == nadproblem_id, qs)) | ||||
| 		return qs | ||||
| 
 | ||||
| class ProblemAutocomplete(autocomplete.Select2QuerySetView): | ||||
| 	""" View k :mod:`dal.autocomplete` pro vyhledávání problémů především v odevzdávátku. """ | ||||
| 	def get_queryset(self): | ||||
| 		# FIXME i starší úlohy | ||||
| 		nastaveni = get_object_or_404(m.Nastaveni) | ||||
| 		rocnik = nastaveni.aktualni_rocnik | ||||
| 		# Od tohoto místa dál jsem zkoušel spoustu variací podle https://django-polymorphic.readthedocs.io/en/stable/advanced.html | ||||
| 		temaQ = Q(Tema___rocnik = rocnik, stav=m.Problem.STAV_ZADANY) | ||||
| 		ulohaQ = Q(Uloha___cislo_zadani__rocnik = rocnik, stav=m.Problem.STAV_ZADANY) | ||||
| 		clanekQ = Q(Clanek___cislo__rocnik = rocnik, stav=m.Problem.STAV_ZADANY) | ||||
| 		qs = m.Problem.objects.filter(temaQ | ulohaQ | clanekQ) | ||||
| 		#print(temata, ulohy, clanky) | ||||
| 		#ulohy.union(temata, all=True) | ||||
| 		#print(ulohy) | ||||
| 		#ulohy.union(clanky, all=True) | ||||
| 		#print(ulohy) | ||||
| 		#qs = ulohy | ||||
| 		print(qs) | ||||
| 		temaQ = Q(Tema___rocnik = rocnik) | ||||
| 		ulohaQ = Q(Uloha___cislo_zadani__rocnik=rocnik) | ||||
| 		clanekQ = Q(Clanek___cislo__rocnik=rocnik) | ||||
| 		qs = m.Problem.objects.filter(temaQ | ulohaQ | clanekQ).order_by("-stav", "nazev") | ||||
| 		if self.q: | ||||
| 			qs = qs.filter( | ||||
| 					Q(nazev__icontains=self.q)) | ||||
|  |  | |||
										
											
												File diff suppressed because one or more lines are too long
											
										
									
								
							|  | @ -437,7 +437,7 @@ | |||
| 			"insitetree": true, | ||||
| 			"parent": 21, | ||||
| 			"sort_order": 36, | ||||
| 			"title": "Poslat řešení", | ||||
| 			"title": "Nahrát řešení", | ||||
| 			"tree": 1, | ||||
| 			"url": "seminar_nahraj_reseni", | ||||
| 			"urlaspattern": true | ||||
|  | @ -476,9 +476,9 @@ | |||
| 			"access_perm_type": 1, | ||||
| 			"access_permissions": [ | ||||
| 				[ | ||||
| 					"change_hodnoceni", | ||||
| 					"seminar", | ||||
| 					"hodnoceni" | ||||
| 					"org", | ||||
| 					"auth", | ||||
| 					"user" | ||||
| 				] | ||||
| 			], | ||||
| 			"access_restricted": true, | ||||
|  | @ -719,7 +719,7 @@ | |||
| 			"insitetree": true, | ||||
| 			"parent": 21, | ||||
| 			"sort_order": 36, | ||||
| 			"title": "Nahrát řešení", | ||||
| 			"title": "Vložit řešení", | ||||
| 			"tree": 1, | ||||
| 			"url": "seminar_vloz_reseni", | ||||
| 			"urlaspattern": true | ||||
|  | @ -1025,5 +1025,83 @@ | |||
| 		}, | ||||
| 		"model": "sitetree.treeitem", | ||||
| 		"pk": 51 | ||||
| 	}, | ||||
| 	{ | ||||
| 		"fields": { | ||||
| 			"access_guest": false, | ||||
| 			"access_loggedin": false, | ||||
| 			"access_perm_type": 1, | ||||
| 			"access_permissions": [ | ||||
| 				[ | ||||
| 					"resitel", | ||||
| 					"auth", | ||||
| 					"user" | ||||
| 				] | ||||
| 			], | ||||
| 			"access_restricted": true, | ||||
| 			"alias": null, | ||||
| 			"description": "", | ||||
| 			"hidden": false, | ||||
| 			"hint": "", | ||||
| 			"inbreadcrumbs": true, | ||||
| 			"inmenu": true, | ||||
| 			"insitetree": true, | ||||
| 			"parent": 23, | ||||
| 			"sort_order": 52, | ||||
| 			"title": "Nahrát řešení k nadproblému {{nadproblem_id}}", | ||||
| 			"tree": 1, | ||||
| 			"url": "seminar_nahraj_reseni nadproblem_id", | ||||
| 			"urlaspattern": true | ||||
| 		}, | ||||
| 		"model": "sitetree.treeitem", | ||||
| 		"pk": 52 | ||||
| 	}, | ||||
| 	{ | ||||
| 		"fields": { | ||||
| 			"access_guest": false, | ||||
| 			"access_loggedin": false, | ||||
| 			"access_perm_type": 1, | ||||
| 			"access_permissions": [], | ||||
| 			"access_restricted": false, | ||||
| 			"alias": null, | ||||
| 			"description": "", | ||||
| 			"hidden": false, | ||||
| 			"hint": "", | ||||
| 			"inbreadcrumbs": true, | ||||
| 			"inmenu": true, | ||||
| 			"insitetree": true, | ||||
| 			"parent": 28, | ||||
| 			"sort_order": 53, | ||||
| 			"title": "Přidat PDF", | ||||
| 			"tree": 1, | ||||
| 			"url": "/admin/korektury/korekturovanepdf/add/", | ||||
| 			"urlaspattern": false | ||||
| 		}, | ||||
| 		"model": "sitetree.treeitem", | ||||
| 		"pk": 53 | ||||
| 	}, | ||||
| 	{ | ||||
| 		"fields": { | ||||
| 			"access_guest": false, | ||||
| 			"access_loggedin": false, | ||||
| 			"access_perm_type": 1, | ||||
| 			"access_permissions": [], | ||||
| 			"access_restricted": true, | ||||
| 			"alias": null, | ||||
| 			"description": "", | ||||
| 			"hidden": false, | ||||
| 			"hint": "", | ||||
| 			"inbreadcrumbs": true, | ||||
| 			"inmenu": true, | ||||
| 			"insitetree": true, | ||||
| 			"parent": 20, | ||||
| 			"sort_order": 54, | ||||
| 			"title": "Export do abstraktů sousu {{ soustredeni.id }}", | ||||
| 			"tree": 1, | ||||
| 			"url": "seminar_soustredeni_abstrakty soustredeni.id", | ||||
| 			"urlaspattern": true | ||||
| 		}, | ||||
| 		"model": "sitetree.treeitem", | ||||
| 		"pk": 54 | ||||
| 	} | ||||
| ] | ||||
| ] | ||||
|  |  | |||
|  | @ -64,6 +64,36 @@ | |||
| 		"ct_app_label": "galerie", | ||||
| 		"ct_model": "obrazek" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_fotkaheader", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaheader" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_fotkaheader", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaheader" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_fotkaheader", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaheader" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_fotkaurlvazba", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaurlvazba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_fotkaurlvazba", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaurlvazba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_fotkaurlvazba", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaurlvazba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_komentar", | ||||
| 		"ct_app_label": "korektury", | ||||
|  | @ -225,123 +255,118 @@ | |||
| 		"ct_model": "clanek" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_konfera", | ||||
| 		"codename": "add_deadline", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "deadline" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_deadline", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "deadline" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_deadline", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "deadline" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_konfera", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfera" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_konfera", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfera" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_konfera", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfera" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_konfera", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfera" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_konfery_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfery_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_konfery_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfery_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_konfery_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfery_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_konfery_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "konfery_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_nastaveni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "various", | ||||
| 		"ct_model": "nastaveni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_nastaveni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "various", | ||||
| 		"ct_model": "nastaveni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_nastaveni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "various", | ||||
| 		"ct_model": "nastaveni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_nastaveni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "various", | ||||
| 		"ct_model": "nastaveni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_novinky", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "novinky", | ||||
| 		"ct_model": "novinky" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_novinky", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "novinky", | ||||
| 		"ct_model": "novinky" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_novinky", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "novinky", | ||||
| 		"ct_model": "novinky" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_novinky", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "novinky", | ||||
| 		"ct_model": "novinky" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_organizator", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "organizator" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_organizator", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "organizator" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_organizator", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "organizator" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_organizator", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "organizator" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_osoba", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "osoba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_osoba", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "osoba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_osoba", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "osoba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_osoba", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "osoba" | ||||
| 	}, | ||||
| 	{ | ||||
|  | @ -366,22 +391,22 @@ | |||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_prijemce", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "prijemce" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_prijemce", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "prijemce" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_prijemce", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "prijemce" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_prijemce", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "prijemce" | ||||
| 	}, | ||||
| 	{ | ||||
|  | @ -404,24 +429,14 @@ | |||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "problem" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_resitel", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "resitel" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_resitel", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "resitel" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_resitel", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "resitel" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_resitel", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "resitel" | ||||
| 	}, | ||||
| 	{ | ||||
|  | @ -446,82 +461,82 @@ | |||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_skola", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "skola" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_skola", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "skola" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_skola", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "skola" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_skola", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "personalni", | ||||
| 		"ct_model": "skola" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_soustredeni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_soustredeni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_soustredeni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_soustredeni", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_soustredeni_organizatori", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_organizatori" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_soustredeni_organizatori", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_organizatori" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_soustredeni_organizatori", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_organizatori" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_soustredeni_organizatori", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_organizatori" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_soustredeni_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_soustredeni_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "delete_soustredeni_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_soustredeni_ucastnici", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_app_label": "soustredeni", | ||||
| 		"ct_model": "soustredeni_ucastnici" | ||||
| 	}, | ||||
| 	{ | ||||
|  | @ -603,50 +618,5 @@ | |||
| 		"codename": "view_taggeditem", | ||||
| 		"ct_app_label": "taggit", | ||||
| 		"ct_model": "taggeditem" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_fotkaheader", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaheader" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_fotkaheader", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaheader" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_fotkaheader", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaheader" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_fotkaurlvazba", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaurlvazba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_fotkaurlvazba", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaurlvazba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_fotkaurlvazba", | ||||
| 		"ct_app_label": "header_fotky", | ||||
| 		"ct_model": "fotkaurlvazba" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "add_deadline", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "deadline" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "change_deadline", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "deadline" | ||||
| 	}, | ||||
| 	{ | ||||
| 		"codename": "view_deadline", | ||||
| 		"ct_app_label": "seminar", | ||||
| 		"ct_model": "deadline" | ||||
| 	} | ||||
| ] | ||||
|  |  | |||
|  | @ -2,3 +2,4 @@ Aprílové nápad | |||
| ============== | ||||
| 
 | ||||
| * aprílový easter-egg pro řešitele - vytvořit nějakou vtipnou testovací databázi a nasadit ji místo produkce | ||||
| * změnit veškerý text na oranžovo | ||||
|  |  | |||
							
								
								
									
										14
									
								
								docs/conf.py
									
									
									
									
									
								
							
							
						
						
									
										14
									
								
								docs/conf.py
									
									
									
									
									
								
							|  | @ -85,3 +85,17 @@ source_suffix = { | |||
|     '.rst': 'restructuredtext', | ||||
|     '.md': 'markdown', | ||||
| } | ||||
| 
 | ||||
| # Autodoc má ignorovat některé moduly | ||||
| # Ref: https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#event-autodoc-skip-member | ||||
| # Kudos: https://stackoverflow.com/a/21449475/ | ||||
| def ignorovat(app, what, name, obj, skip, options): | ||||
| 	blacklist = ( | ||||
| 		# typ (what), name | ||||
| 		('module', 'settings.mamweb_prod'), | ||||
| 		) | ||||
| 	ignore = (what, name) in blacklist | ||||
| 	return True if ignore else None | ||||
| 
 | ||||
| def setup(app): | ||||
| 	app.connect('autodoc-skip-member', ignorovat) | ||||
|  |  | |||
							
								
								
									
										27
									
								
								docs/css.rst
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										27
									
								
								docs/css.rst
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,27 @@ | |||
| CSS (a další styly na webu) | ||||
| =========================== | ||||
| 
 | ||||
| Inspirován `css-trick článkem <https://css-tricks.com/methods-organize-css/>`_ jsem se rozhodl rozdělit | ||||
| CSSka do | ||||
| 
 | ||||
| - Konstant (``constants.css``), které jsou využívány na mnoha místech CSSek | ||||
| - Nastylování html tagů (``base.css``) | ||||
| - Layoutu (``layout.css``), což je to, co určuje celkové rozložení stránky | ||||
| - Jednotlivých prvků (``modules.css``) | ||||
| 
 | ||||
| Dále jsem separoval CSSka pro **galerii** (potřebuje hodně specifických stylů). Stejně tak **korekturovátko** má styly separátně. | ||||
| 
 | ||||
| Dále web (asi) používá externí frameworky (v separátních složkách – mají k sobě i JS a podobné věci): | ||||
| 
 | ||||
| - bootstrap: dělá nějaké basic stylování, *web je na něm hodně závislý* (například jsem zjistil, že bootstrap kdysi přidával ``font-size:14px``, bez čehož se web úplně rozpadnul) (také na něm běží mobilní meníčko, které navíc vyžaduje Popper, tedy bootstrap.bundle.js místo bootstrap.js) | ||||
| 
 | ||||
| Pak jsou tu ``mamweb-dev.css`` a ``printtable.css``, co jsem si ještě nerozmyslel, co s tím. | ||||
| 
 | ||||
| Pár myšlenek | ||||
| ------------ | ||||
| 
 | ||||
| - Až na pár výjimek (galerii a korekturovátko) bych styly držel v jedné složce a málo souborech, | ||||
| protože CSS šíleně dědí všechno možné | ||||
| - Chce to dobře pojmenovávat třídy (speciálně aby bylo vidět, co ta třída dělá nebo kde se používá) | ||||
| - Chce to hodně komentovat kód (speciálně tam, kde není splněn předchozí bod) | ||||
| 
 | ||||
|  | @ -9,12 +9,6 @@ static | |||
| ------ | ||||
| Složka, kam django nakopíruje všechno ze složek static a pak na to z templatů / kódu jde ukazovat pomocí ``static``. | ||||
| 
 | ||||
| _git_hooks | ||||
| ---------- | ||||
| Hooky do gitu pro kontrolu Pythoního stylu. Především ``flake8``. | ||||
| 
 | ||||
| Zbylo tu z minulosti mamwebu. | ||||
| 
 | ||||
| data | ||||
| ---- | ||||
| Obsahuje data, která patří do databáze, ale jsou přímo součástí webu jako | ||||
|  | @ -28,7 +22,7 @@ Generuje se za pomocí:: | |||
| 
 | ||||
| nebo (v případě meníčka):: | ||||
| 
 | ||||
|     ./manage.py dumpdata sitetree --natrual-foreign > data/sitetree_new.json | ||||
|     ./manage.py dumpdata sitetree --natural-foreign > data/sitetree_new.json | ||||
|     ./fix_json.py data/sitetree_new.json data/sitetree.json | ||||
| 
 | ||||
| deploy_v2 | ||||
|  |  | |||
|  | @ -6,14 +6,32 @@ | |||
| Vítejte v dokumentaci M&Mího webu! | ||||
| =================================== | ||||
| 
 | ||||
| Tzv. produkce (tedy to, co vidí uživatelé) běží na `<mam.mff.cuni.cz>`_ (resp. | ||||
| `<mam.matfyz.cz>`_), menu, obrázky v pozadí menu a spousta stránek (ty pouze se | ||||
| statickým textem/obrázky) se mění přímo na produkci. Testovací verze běží na | ||||
| `<https://mam-test.ks.matfyz.cz/>`_. | ||||
| 
 | ||||
| Abychom uměli web vyvíjet, musíme ho většinou nejdřív umět | ||||
| :doc:`naklonovat a spustit lokálně <vyvoj>`. | ||||
| 
 | ||||
| :doc:`struktura mamwebu <struktura>` se řídí hlavně djangem, ale snažíme se | ||||
| také o oddělení jednotlivých částí do :doc:`samostatných aplikací | ||||
| <modules/modules>`. | ||||
| 
 | ||||
| Dokumentace (jak v ``docs/``, tak přímo v kódu) je psaná ve | ||||
| :doc:`sphinxu <sphinx>`. | ||||
| 
 | ||||
| .. toctree:: | ||||
|    :caption: M&M web | ||||
|    :maxdepth: 2 | ||||
|    :titlesonly: | ||||
| 
 | ||||
|    vyvoj | ||||
|    zavislosti | ||||
|    sphinx | ||||
|    dalsi_soubory | ||||
|    skripty | ||||
|    modules/modules | ||||
|    dalsi_soubory | ||||
|    zapisy/zapisy | ||||
| 
 | ||||
| 
 | ||||
|  |  | |||
|  | @ -1,3 +1,4 @@ | |||
| FIXME přepsat do rst, přidat i další věci a případně přesunout na wiki | ||||
| Přidání obrázků do odměn: | ||||
| admin -> flatpage odměn -> ikona přidat obrázek | ||||
| záložka odeslat, vybrat obrázek, odeslat | ||||
							
								
								
									
										108
									
								
								docs/skripty.rst
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										108
									
								
								docs/skripty.rst
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,108 @@ | |||
| Skripty pro práci s repozitářem | ||||
| =================== | ||||
| 
 | ||||
| Máme dvě hlavní sady skriptů/příkazů na ovládání webu a repozitáře. Skripty pro | ||||
| práci s webem psané v Pythonu jsou uložené ve složkách | ||||
| ``<aplikace>/management/commands/``, případně vestavěné, a volají se pomocí | ||||
| ``./manage.py <příkaz>``. Oproti tomu skripty pro práci s repozitářem a pro | ||||
| úpravy databáze a souborů „zvenčí“ se nejčastěji nacházejí ve složce ``make/`` | ||||
| a volají se pomocí cesty: ``make/<příkaz>``. | ||||
| 
 | ||||
| Občas existují i nějaké další skripty na různých jiných místech. Všechny by | ||||
| měly být ideálně popsány asi tady. | ||||
| 
 | ||||
| Make skripty | ||||
| ---- | ||||
| 
 | ||||
| Skripty v ``make/`` se označují jako „Make skripty“. Slouží často k velkým | ||||
| úkonům s repozitářem, jako je nasazení celého webu, zprovoznění lokálního webu | ||||
| a podobně. | ||||
| 
 | ||||
| .. note:: Označení pro tyto skripty je dáno tím, že byly původně volány pomocí | ||||
|    make (tj. z Makefile). Ve skutečnosti je lze stále volat i jako ``make | ||||
|    <skript>``, ale pak není možné předávat parametry a obecně je tato cesta | ||||
|    zastaralá a existuje jen pro zpětnou kompatibilitu se svalovou pamětí. | ||||
| 
 | ||||
| Tyto skripty jsou samonosné, dají se spustit rovnou a v případě problémů si | ||||
| budou hlasitě stěžovat. Pro účely debugování různých věcí jsou ale (bohužel?) | ||||
| hlasité i při normálním spuštění, konkrétně vypisují všechny příkazy, které se | ||||
| spouštějí (\ ``set -x``). Tyto příkazy jsou vidět za jedním či více plusky (\ ``+``). | ||||
| 
 | ||||
| .. tip:: Pokud některý make skript selže, tak by na konci měl vypsat, že se něco nepovedlo. | ||||
| 
 | ||||
| 
 | ||||
| Knihovna ``make/lib.sh`` | ||||
| ^^^^^^ | ||||
| 
 | ||||
| Pro pohodlí při psaní velká část z nich využívá knihovnu uloženou | ||||
| v ``make/lib.sh``. Jsou zde definované užitečné proměnné, kontroly a společný | ||||
| kód. Kromě toho při inicializaci otestuje, že je skript spuštěn z kořene | ||||
| repozitáře (takže to pak není potřeba zkoumat v ostatních skriptech). | ||||
| 
 | ||||
| Proměnné | ||||
| """"" | ||||
| 
 | ||||
| Popsány jsou jen užitečné proměnné, ve skutečnosti jich je definovaných víc, | ||||
| ale jsou triviální a samopopisné. | ||||
| 
 | ||||
| ``VENV_PATH`` | ||||
|   Cesta virtuálního prostředí. Též lze přepsat. | ||||
| ``REPO`` | ||||
|   Cesta ke gitovému repozitáři na serveru, rovnou použitelná v ``git clone`` | ||||
| ``GIMLI_LOGIN`` | ||||
|   Přihlašovací údaje ke Gimlimu | ||||
| ``PRODWEB`` a ``TESTWEB`` | ||||
|   Cesty ke složkám s produkčním a testovacím webem | ||||
| 
 | ||||
| Funkce a další zkratky | ||||
| """""" | ||||
| 
 | ||||
| ``ensure_venv`` | ||||
|   Zajistí, že se zbytek skriptu spustí ve virtuálním prostředí, a pokud neexistuje, tak jej založí. | ||||
| ``ensure_web_installed`` | ||||
|   Vyzkouší, že je web (django) aspoň elementárně zprovozněno a pokud ne, tak vyzve uživatele, aby to spravil. | ||||
| ``gimli_only`` | ||||
|   Otestuje, že je příkaz spuštěn na Gimlim, pokud tomu tak není, zeptá se, jestli si uživatel skutečně přeje zbytek skriptu vykonat | ||||
| ``only_in_directory <složka>`` | ||||
|   Otestuje, že skript běží z konkrétní složky. Zejména použitelné s ``gimli_only`` a ``$TESTWEB`` | ||||
| ``safe_checkout_branch <větev>`` | ||||
|   Bezpečně přepne repozitář na jinou větev. Pokud by mělo dojít k přepsání | ||||
|   knihovny nebo volajícího make skriptu, vyzve uživatele, aby přepnul ručně. | ||||
| ``install_everything`` | ||||
|   Společná část kódu pro nasazování produkce a testwebu. | ||||
| 
 | ||||
| Skripty pro lokální vývoj | ||||
| ^^^^^^^ | ||||
| 
 | ||||
| ``make/install_web`` (nebo ekvivalentně ``make/install``) | ||||
|   Vytvoří virtualenv a nainstaluje do něj závislosti webu podle ``requirements.txt``. Následně popíše, jak vyrobit zbytek lokálního webu. | ||||
| ``make/run`` | ||||
|   Spustí lokální web (ekvivalentní s ``./manage.py runserver``) | ||||
| ``make/schema`` | ||||
|   Vykreslí závislosti a atributy modelů | ||||
| ``make/sync_prod_flatpages`` | ||||
|   Stáhne z produkce aktuální statické stránky a uloží je do složky ``data/`` | ||||
| ``make/test`` | ||||
|   Spustí testy (ekvivalentní s ``./manage.py test -v2``) | ||||
| ``make/init_local`` | ||||
|   Zkratka za posloupnost ``make/install_web``, ``./manage.py testdata``, ``./manage.py loaddata data/*``, ``make/sync_prod_flatpages`` | ||||
| 
 | ||||
| Práce s testwebem | ||||
| ^^^^^^^ | ||||
| 
 | ||||
| ``make/deploy`` | ||||
|   Nasadí testweb. Volitelně bere jako parametr jméno větve, kterou má nasadit. | ||||
|   Rovnou nastaví přihlašování a vygeneruje příslušnou verzi dokumentace `sem <https://mam-test.ks.matfyz.cz/docs>`_. | ||||
| ``make/push_compiled_vue_to_test`` | ||||
|   **Neotestováno** Nahraje Vue z lokálního počítače na testweb. (Gimli často má moc starou verzi Node.js, takže nejde zkompilovat tam) | ||||
| ``make/sync_test_db_aggressive`` | ||||
|   Zkopíruje databázi z produkčního webu. | ||||
| ``make/sync_test_media`` | ||||
|   Zkopíruje média (obrázky, nahrané soubory) z produkčního webu. | ||||
| ``make/sync_test`` | ||||
|   Zkratka za ``make/sync_test_db_aggressive`` + ``make/sync_test_media``. | ||||
| 
 | ||||
| Nasazení produkce | ||||
| ^^^^ | ||||
| 
 | ||||
| ``make/deploy_prod``. Před samotným nasazením zálohuje databázi a zkontroluje, že se nasazuje větev ``master``. | ||||
|  | @ -44,12 +44,14 @@ Jinak všechny rst, co jsou ve složce ``doc`` a jejích podsložkách nezačín | |||
| 
 | ||||
| Sphinx se píše v rst: `Návod na syntaxi rst`_ `Cheat sheet`_ | ||||
| 
 | ||||
| To je snad vše, co je potřeba vědět k dokumentaci mamwebu. Následující sekce jsou o tom, co jsem provedl Sphinxu, aby to fungovalo: | ||||
| 
 | ||||
| .. _Návod na syntaxi rst: https://sphinx-tutorial.readthedocs.io/step-1/#sections | ||||
| .. _Cheat sheet: https://sphinx-tutorial.readthedocs.io/cheatsheet/ | ||||
| 
 | ||||
| make html | ||||
| --------- | ||||
| Make html dělá následující: Vygenerují se rst soubory do modules z pythoní dokumentace pomocí:: | ||||
| ``make html`` dělá následující: Vygenerují se rst soubory do modules z pythoní dokumentace pomocí:: | ||||
| 
 | ||||
|     sphinx-apidoc --module-first -o modules .. ../*/migrations --templatedir _templates -f | ||||
| 
 | ||||
|  |  | |||
							
								
								
									
										31
									
								
								docs/struktura.rst
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										31
									
								
								docs/struktura.rst
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,31 @@ | |||
| Co kde najít (mamweb + django) | ||||
| ============================== | ||||
| 
 | ||||
| Nejdůležitější aplikace z pohledu djanga je ``mamweb``. Tu totiž django pouští | ||||
| a obsahuje tedy nastavení (tam se přidávají ostatní aplikace, včetně těch | ||||
| importovaných z djanga, a nastavují se tam různé věci jak v djangu, tak i naše, | ||||
| například složky, kam se budou věci přidané uživateli ukládat). Dále obsahuje | ||||
| základní urls, udávající, „na jaké adrese co je“. A nakonec obsahuje obecné | ||||
| věci jako chybové hlášky a vzhled M&M stránek (menu, patička, atd.). Aktuálně | ||||
| i veškeré csv. | ||||
| 
 | ||||
| Další jsou pak jednotlivé aplikace (pokud něco hledáte, tak zřejmě chcete najít | ||||
| tu aplikaci, která tomu odpovídá, respektive se k ní dostat přes url), za | ||||
| zmínku stojí seminar, kde jsou takové ty věci, co zbyly. Plus jsou tam aktuálně | ||||
| téměř všechny modely, protože je těžké je přesunout jinam. | ||||
| 
 | ||||
| **TLDR: Nevšímejte si složky data/ a souborů přímo v kořenové složce.** | ||||
| Kromě věcí potřebných ke gitu, :doc:`ke spuštění <vyvoj>` a fukci djanga, | ||||
| dalších drobností, lokální databáze a již zmíněných aplikací jsou tu ``data``, | ||||
| kde je takový ten obsah webu, co by se měl dát snadno měnit (tudíž musí být v | ||||
| databázi), tj. statické stránky, menu a obrázky v pozadí menu. Ten je třeba | ||||
| měnit hlavně na produkci a sekundárně tady (může to dělat i newebař a nechcete | ||||
| přepsat jeho práci). Vše, co nejsou aplikace je popsáno :doc:`tady <dalsi_soubory>`. | ||||
| 
 | ||||
| Základy djanga | ||||
| -------------- | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| mamweb je psaný téměř čistě v djangu. Což znamená, že to „co je vidět na stránkách“ | ||||
| jsou views. | ||||
							
								
								
									
										194
									
								
								docs/vyvoj.rst
									
									
									
									
									
								
							
							
						
						
									
										194
									
								
								docs/vyvoj.rst
									
									
									
									
									
								
							|  | @ -1,20 +1,184 @@ | |||
| Lokální vývoj mamwebu | ||||
| ===================== | ||||
| Stačí spustit:: | ||||
| 
 | ||||
|     ## Nahradte svym gimli username | ||||
|     git clone USER@gimli.ms.mff.cuni.cz:/akce/mam/git/mamweb.git mamweb | ||||
|     cd mamweb | ||||
|     ## Instalace je trochu magická, spusť následující posloupnost příkazů: | ||||
|     make install_venv | ||||
|     . env/bin/activate | ||||
|     make install_web | ||||
| Asi hlavní část vývoje většiny webu probíhá lokálně. Každý tak může pracovat na | ||||
| vlastních úpravách nezávisle na ostatních. | ||||
| 
 | ||||
|     ## Vygeneruje nejaka testovaci data (spis chuda) | ||||
|     ./manage.py testdata | ||||
|     ## Nahraje statické stránky, menu a obrázky v pozadí menu | ||||
|     ./manage.py loaddata data/* | ||||
|     ## Spusti testovaci server na http://127.0.0.1:8000/ | ||||
|     ./manage.py runserver | ||||
| Potřebné vybavení | ||||
| ------- | ||||
| 
 | ||||
| Tento soupis cílí na Linuxáky. Jistě je | ||||
| spousta dalších možností, které zde nejsou postihnuty – poraď se s webaři, | ||||
| pokud si nejsi jistý. (Speciálně lze nějak vyvíjet na Windows, leč lze často | ||||
| narazit na odlišné chování od Linuxu.) | ||||
| 
 | ||||
| Motivace cílení na Linux je to, že Gimli je Linuxový stroj, takže je vývojové | ||||
| prostředí pak podobné produkci a zmenšuje to množství odlišného chování. | ||||
| 
 | ||||
| .. TODO: Na dokumentaci odlišného chování (Postgres vs. SQLite, Win vs. Linux, …) | ||||
|    by to asi chtělo výhledově separátní stránku, ale teď píšu tuhle :-) | ||||
| 
 | ||||
| Nutné | ||||
| ^^^^ | ||||
| 
 | ||||
| - `Git <https://git-scm.com>`_ | ||||
| - `Python <https://python.org>`_ | ||||
| 
 | ||||
|   - Ideálně ve verzi 3.9 (to je to, co je aktuálně (2022) na Gimlim) | ||||
|   - Včetně pip-u (na Ubuntu balíček ``python3-pip``), venvu (``python3-venv``) a knihoven pro kompilaci | ||||
|     Cčkových rozšíření (``python3-dev``) | ||||
| - Knihovna pro práci s PostgreSQL (``libpq-dev``, protože jsou potřeba všechny db backendy) | ||||
| - Webový prohlížeč | ||||
| - \*NIXový shell (typicky ``bash``) | ||||
| 
 | ||||
| .. TODO: Pokud tu něco chybí, tak to dopiš :-) | ||||
| 
 | ||||
| Kromě toho je potřeba mít účet na `Gitee <https://gitea.ks.matfyz.cz>`_, kde | ||||
| bydlí gitový repozitář s kódem. | ||||
| 
 | ||||
| .. tip:: Potřebné balíčky v různých distribucích jsou sepsané v :ref:`tabulce | ||||
|    prerekvizit <Alternativní jména balíčků>`. | ||||
| 
 | ||||
| Doporučené | ||||
| ^^^^^^^^^^ | ||||
| 
 | ||||
| - Python wheel (možná řeší problémy s potřebou ``-dev`` balíčků…) | ||||
| - Editor / IDE podporující `Editorconfig <https://editorconfig.org/>`_ | ||||
| - Uživatelská zkušenost s `produkční verzí webu <https://mam.matfyz.cz>`_ | ||||
| - Účet v `Kanci <https://kanboard.ledoian.cz>`_ | ||||
| 
 | ||||
| .. TODO: A nejspíš další věci, na které jsem si teď nevzpomněl. | ||||
| 
 | ||||
| 
 | ||||
| Zprovoznění | ||||
| ------- | ||||
| 
 | ||||
| Nejprve je potřeba stáhnout si repozitář. To se provede příkazem ``git clone | ||||
| https://gitea.ks.matfyz.cz/mam/mamweb.git``, případně ``git clone | ||||
| git@gitea.ks.matfyz.cz:mam/mamweb.git``, pokud už máš nahraný SSH klíč na | ||||
| Giteu. (Obě adresy se dají zkopírovat ze `stránky repozitáře | ||||
| <https://gitea.ks.matfyz.cz/mam/mamweb>`_.) To vyrobí složku ``mamweb``, přepni | ||||
| se do ní (``cd mamweb``) | ||||
| 
 | ||||
| O zprovoznění webu se stará skript ``make/install_web``, stačí ho spustit. Ten | ||||
| vytvoří virtualenv (neexistuje-li) a nainstaluje do něj závislosti webu (podle | ||||
| souboru ``requirements.txt``). | ||||
| 
 | ||||
| .. FIXME: Novowebaři zmínka o requirements.txt tady moc nepomůže, to má být na | ||||
|    stránce o celkové stavbě repozitáře a stacku… | ||||
| 
 | ||||
| Následně je potřeba nahrát další data do databáze, což uděláš pomocí příkazů | ||||
| ``./manage.py testdata`` a ``./manage.py loaddata data/*``. Skript | ||||
| ``make/install_web`` to kdyžtak na konci připomene. | ||||
| 
 | ||||
| .. caution:: Zatímco skripty v ``make/`` to nepotřebují, pro použití skriptu | ||||
|   ``./manage.py`` (a dalších) se potřebuješ přepnout do virtuálního prostředí. | ||||
|   To uděláš velmi pravděpodobně spuštěním ``source env/bin/activate``, před | ||||
|   začátkem *promptu* by se mělo objevit ``(env)``. Pro opuštění spusť | ||||
|   ``deactivate``. | ||||
| 
 | ||||
| Samotný web se spustí třeba pomocí ``make/run``, nebo ekvivalentně | ||||
| ``./manage.py runserver`` a pak je vidět na `<http://127.0.0.1:8000>`_. | ||||
| 
 | ||||
| Časté problémy | ||||
| ^^^^^^ | ||||
| 
 | ||||
| - ``make/install_web`` vypíše ``Error: pg_config executable not found.``: | ||||
|   Chybí ``libpq-dev`` | ||||
| - Chybová hláška obsahuje ``#include <Python.h>``: chybí ``python3-dev`` | ||||
| - Na webu není vidět meníčko: spusť ``./manage.py loaddata data/*`` | ||||
| - ``locale.Error: unsupported locale setting``: Chybí podpora pro příslušný | ||||
|   jazyk ve tvém systému. Odkomentuj příslušnou lokalizaci v ``/etc/locale.gen`` | ||||
|   a spusť ``locale-gen`` jako root, tím se to spraví. | ||||
| 
 | ||||
| S dalšími problémy se zkus obrátit na další webaře, třeba někdo bude vědět :-) | ||||
| 
 | ||||
| Příkazy pro ovládání webu | ||||
| ------- | ||||
| 
 | ||||
| Příkazy se dělí do několika skupin. Některé souvisí přímo s webem, Djangem, | ||||
| databází a podobně, ty typicky používají ``./manage.py``. Skripty pro | ||||
| obhospodařování repozitáře a webu „zvenku“ typicky bydlí ve složce ``make/``. | ||||
| Ostatní skripty jsou na náhodných místech :-) | ||||
| 
 | ||||
| Tady jsou rozebrány jen příkazy relevantní pro lokální web a univerzálně | ||||
| užitečné, ostatní najdeš v :ref:`Skripty pro práci s repozitářem`. | ||||
| 
 | ||||
| Make skripty | ||||
| ^^^^^^^ | ||||
| 
 | ||||
| - ``make/install_web`` nainstaluje závislosti webu | ||||
| - ``make/run`` spustí web (ekvivalentní s ``./manage.py runserver``) | ||||
| - ``make/schema`` nakreslí schéma vazeb modelů (může se hodit pro referenci a představu) | ||||
| - ``make/test`` spustí testy (ale moc jich zatím není; ekvivalentní s ``./manage.py test``) | ||||
| - ``make/sync_prod_flatpages`` stáhne statické stránky z produkčního webu a | ||||
|   uloží je do souboru v gitu, což umožňuje jejich verzování | ||||
| 
 | ||||
| Manage.py skripty | ||||
| ^^^^^ | ||||
| 
 | ||||
| .. note:: Je potřeba je spouštět ve virtuálním prostředí, viz výše. | ||||
| 
 | ||||
| Všechny skripty kdyžtak mají ``--help``, dá se tak zjistit, co všechno umějí. | ||||
| 
 | ||||
| - ``./manage.py testdata`` vygeneruje spíše chudá testovací data, aby bylo na | ||||
|   čem testovat web. | ||||
| - ``./manage.py loaddata <soubor/y>`` nahraje data ze souborů do databáze | ||||
| - ``./manage.py dumpdata <model>`` naopak z databáze vyrobí textovou reprezentaci | ||||
| - ``./manage.py shell`` spustí interaktivní pythoní shell, ze kterého lze | ||||
|   interagovat s webem / Djangem. | ||||
| - ``./manage.py dbshell`` spustí databázový shell (typicky používá SQL) | ||||
| 
 | ||||
| - ``./manage.py makemigrations`` vyrobí popis migrací, ``./manage.py migrate`` | ||||
|   je spustí, ``showmigrations`` ukáže, které migrace jsou aplikované a které | ||||
|   ne. | ||||
| - ``./manage.py runserver_plus`` spouští o něco lepší vývojový server (ale | ||||
|   nikdy jsem asi ty lepší featury nepoužil) | ||||
| 
 | ||||
| Může se hodit vědět, že spuštění ``./manage.py`` bez parametrů vypíše seznam | ||||
| všech příkazů, které lze spustit. | ||||
| 
 | ||||
| Dokumentace djangových příkazů je v `dokumentaci Djanga | ||||
| <https://docs.djangoproject.com/en/3.2/ref/django-admin/#available-commands>`_ | ||||
| 
 | ||||
| Ostatní užitečné příkazy | ||||
| ^^^^^ | ||||
| 
 | ||||
| - ``git status`` je univerzální nápověda na aktuální stav repozitáře a co s tím | ||||
|   lze dělat. | ||||
| - ``git clean -fxd`` smaže všechny soubory, které nejsou uložené v gitu (včetně | ||||
|   ignorovaných). **Nebezpečný příkaz**, zamysli se, než ho spustíš | ||||
| 
 | ||||
| Specifika lokálního webu | ||||
| ------- | ||||
| 
 | ||||
| Lokální uživatelé | ||||
| ^^^^^^^ | ||||
| 
 | ||||
| Přihlašovací údaje jsou psány jako ``login:heslo`` | ||||
| 
 | ||||
| - Superuživatel: ``admin:admin`` | ||||
| - Orgovské účty: ``o:o``, ``o1:o`` až ``o3:o`` | ||||
| - Řešitelské účty: ``r:r``, ``r1:r`` až ``r3:r`` | ||||
| 
 | ||||
| Všechny tyto účty jsou (?) svázané s nějakými fiktivními osobami, není ale zřejmé se | ||||
| kterými, budeš to muset vyzkoušet a pak tady zdokumentovat :-) | ||||
| 
 | ||||
| E-maily | ||||
| ^^^^^ | ||||
| 
 | ||||
| Posílání e-mailů se lokálně dá zkoušet, e-mail se vypíše do terminálu, kde je | ||||
| web spuštěn (e.g. pomocí ``make/run``). | ||||
| 
 | ||||
| Pruhy | ||||
| ^^^^ | ||||
| 
 | ||||
| To, že má lokální web po stranách zelené pruhy je normální a správně, slouží to | ||||
| k vizuálnímu odlišení lokálního webu. | ||||
| 
 | ||||
| .. TODO: Mít někde popis všech tří instancí a tady na něj pak odkázat. | ||||
| .. - Tahák k používání gitových větví: do workflow, ne sem… | ||||
| .. - Užitečné odkazy – kam se kouknout | ||||
|   (dohledávání views podle URL, settings_*, ) | ||||
| .. - Zpříjemnění práce (ssh-klíče, tea, --help, …) | ||||
| 
 | ||||
| Když si lokálně spustíte web, běží na http://127.0.0.1:8000/, admin najdete na http://127.0.0.1:8000/admin/ (admin/admin) Až skončíš s vývojem webu, spusť “deactivate”. Tím zmizí ‘(env)’ ze začátku promptu. | ||||
|  | @ -116,7 +116,7 @@ Aktuálně: Jakýsi coding style zhruba existuje, není popsaný, šíří se li | |||
| - Nesmí být striktně vynucovaný | ||||
| - Musel by být hodně nastavitelný | ||||
|     - Nechceme mít kód plný `#NOQA: WTF42` | ||||
| - Nejspíš vždycky bude mít false positives (`seminar.utils.roman_numerals`) i false negatives (`seminar.models.tvorba.Cislo.posli_cislo_mailem`) | ||||
| - Nejspíš vždycky bude mít false positives (`tvorba.utils.roman_numerals`) i false negatives (`seminar.models.tvorba.Cislo.posli_cislo_mailem`) | ||||
|     - Možná dobrý sluha, ale určitě špatný pán (also: špatná zkušenost ☺) | ||||
| - __Důsledek:__ Hrozí, že těch falešných varování bude moc, čímž to ztratí smysl úplně | ||||
|     - Potenciálně by šlo aplikovat jen lokálně na změny? | ||||
|  |  | |||
|  | @ -2,4 +2,7 @@ Zápisy | |||
| ====== | ||||
| 
 | ||||
| .. toctree:: | ||||
|     2021-12-06-testovani_dokumentace_codereview | ||||
|    :caption: Importy zápisů z Markdownu | ||||
|    :maxdepth: 1 | ||||
| 
 | ||||
|    2021-12-06-testovani_dokumentace_codereview | ||||
							
								
								
									
										97
									
								
								docs/zavislosti.rst
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										97
									
								
								docs/zavislosti.rst
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,97 @@ | |||
| Závislosti webu | ||||
| @@@@@@@@@@@@@@@ | ||||
| 
 | ||||
| Web ke svému běhu potřebuje různé další programy. Tahle stránka se snaží je pokrýt. | ||||
| 
 | ||||
| Stránka je koncipována jako odrážkový seznam balíčků pro Ubuntu s případnými | ||||
| komentáři, na konci stránky jsou uvedena :ref:`jména balíčků <Alternativní jména | ||||
| balíčků>` v různých dalších distribucích. (Seznam mj. cílí na lokální | ||||
| rozchození, proto popisuji Ubuntu a ne Debian. I tak se ale snažíme popsat web | ||||
| v úplnosti.) | ||||
| 
 | ||||
| .. I use Arch, btw. | ||||
| 
 | ||||
| 
 | ||||
| Základ webu | ||||
| =========== | ||||
| 
 | ||||
| - ``python3`` – Ideálně Python 3.9, jenž je na Gimlim | ||||
| - ``python3-pip`` pro instalaci dalších Pythoních balíčků podle ``requirements.txt`` | ||||
| - ``python3-venv`` | ||||
| - ``gcc`` – kompilace Pythoních knihoven ze zdrojových distribucí (sdist), možná (neotestováno) jde jako alternativu použít ``python3-wheel`` a stahovat bdists | ||||
| - ``python3-dev`` – taktéž | ||||
| - ``libpq-dev`` do třetice… | ||||
| - ``ghostscript`` TODO konverze PDF v korekturovátku | ||||
| - ``pdflatex`` FIXME! generování obálek a stvrzenek | ||||
| - ``git`` – používán :ref:`Make skripty` | ||||
| - ``locales`` pro české formáty | ||||
| 
 | ||||
| Nasazení na produkci / testweb | ||||
| ============================== | ||||
| 
 | ||||
| (nejsou nutně potřeba k provozu lokální instance) | ||||
| 
 | ||||
| - ``rsync`` | ||||
| - ``pg_utils`` FIXME | ||||
| - ``htpasswd`` FIXME – aby testweb nepoužívali náhodní kolemjdoucí | ||||
| - ``postgresql-server`` TODO | ||||
| - ``acl`` pro nastavování práv přes ``setfacl`` | ||||
| 
 | ||||
| Pro testweb je potřeba i všechno pro :ref:`dokumentaci <Dokumentace>`, vizte níž. | ||||
| 
 | ||||
| Předpokládá se nasazení v uWSGI pod Nginxem a služba běžící pod systemd, nicméně to už je spíš záležitost infrastruktury a ne specifikum mamwebu. | ||||
| 
 | ||||
| Dokumentace | ||||
| =========== | ||||
| 
 | ||||
| - ``make`` pro zbuildění | ||||
| - Pythoní balíčky podle příslušné části ``requirements.txt`` | ||||
| 
 | ||||
| Vývojové nástroje | ||||
| ================= | ||||
| 
 | ||||
| (Nejsou nezbytně nutné, ale předpokládáme jejich užitečnost. Mohou se hodit i na produkci.) | ||||
| 
 | ||||
| - ``psql`` TODO pro manuální dotazy do PostgreSQL | ||||
| - ``sqlite3`` TODO totéž pro SQLite3 | ||||
| - ``ssh`` | ||||
| - ``graphviz`` pro vygenerování schématu | ||||
| - ``rsync`` | ||||
| - ``ipython3`` – hezčí interaktivní shell (stačí z ``requirements.txt``) | ||||
| 
 | ||||
| Potenciální usnadnění života | ||||
| ============================ | ||||
| 
 | ||||
| (Úplně zbytečné, ale sdílíme pozitivní zkušenosti :-)) | ||||
| 
 | ||||
| - ``tea`` – CLI klient pro Giteu, aby člověk nepotřeboval otevírat web pro založení PR | ||||
| 
 | ||||
| 
 | ||||
| Alternativní jména balíčků | ||||
| ========================== | ||||
| 
 | ||||
| Různé distribuce balí SW různě, takže to, co je v jedné distribuci jeden | ||||
| balíček může být v jiné rozděleno do víc. Pro usnadnění nasazení je tady | ||||
| přehled známých alternativních jmen. | ||||
| 
 | ||||
| TODO: tabulka není úplná. Pokud na něco narazíte, tak ji prosím doplňte. | ||||
| 
 | ||||
| .. admonition:: Jak se pozná, že web funguje, pro účely tabulky? | ||||
| 
 | ||||
|    Na čistém repozitáři (``git clean -fxd``) a čistém systému spouštíme | ||||
|    ``make/init_local``. Když to spadne, tak do tabulky zapíšeme, co jsme | ||||
|    přiinstalovali. Protože nefunguje synchronizace flatpages (nemáme SSH klíč), | ||||
|    ``make/init_local`` sestřelíme při pokusu o synchronizaci a vyzkoušíme, že | ||||
|    ``make/test`` spustí testy. | ||||
| 
 | ||||
| .. Grafické tabulky (grid-tables, simple-tables) jsou strašný porod vyrábět, dlabu na to a cpu to do CSV… | ||||
| 
 | ||||
| .. csv-table:: Prerekvizity v jednotlivých distribucích | ||||
|    :header: Distribuce / OS, Repozitář s Py3.9, venv, py knihovny, PostgreSQL knihovna, poznámky | ||||
| 
 | ||||
|    Ubuntu 22.10, ??, ``python3-venv``, ``python3-dev``, ``libpq-dev``, "Je potřeba zapnout zdroj ``universe`` a nainstalovat kompilátor C (``gcc``)?" | ||||
|    Linux Mint 21, ??, ``python3-venv``, ``python3-dev``, ``libpq-dev``, "" | ||||
|    Archlinux 2022.11.01, AUR, vestavěný, vestavěné, ``postgresql-libs``, "Je potřeba céčkový kompilátor (``gcc``)" | ||||
|    openSUSE Leap 15.4, oficiální (``python39``), předinstalovaný?, ``python39-devel``, ??FIXME!!, "Výchozí verze pythonu je 3.6 a ta je moc stará, potřeba instalovat ``gcc``. Nevím jak sehnat pg_config." | ||||
|    Debian 11, "oficiální, výchozí", ??, ??, ??, "Určitě to tam rozběhat jde, protože Gimli. Nejspíš bude relativně podobné Ubuntu." | ||||
| 
 | ||||
							
								
								
									
										25
									
								
								galerie/TODO
									
									
									
									
									
								
							
							
						
						
									
										25
									
								
								galerie/TODO
									
									
									
									
									
								
							|  | @ -1,25 +0,0 @@ | |||
| ======== | ||||
| | TODO | | ||||
| |======| | ||||
| 
 | ||||
| Aktualni | ||||
| * co s titulni fotkou | ||||
| * do CSS | ||||
|   * nahledy | ||||
|     * nastylovat tabulku s nahledy | ||||
|     * komentare uz na nahledy? | ||||
|   * detail | ||||
|     * nahledy pred a po | ||||
|     * opravit prechodove sipky | ||||
|     * vyrobit prechodove sipky ve M&M-stylu | ||||
| 
 | ||||
| Dlouhodobe | ||||
| * sipky na prechazeni mezi fotkami | ||||
| * hromadne PRIDANI fotek do jiz existujici galerie | ||||
| 
 | ||||
| Fylozoficke | ||||
| * zvolit velikosti velke a male fotky | ||||
| * je potreba i jine razeni nez automaticky podle casu nebo staci podgalerie? | ||||
|   * napr. dve hry na dvou ruznych mistech ve stejny cas | ||||
|   * fotky od ucastniku ze hry (skupinky se pohybuji ve stejny cas, ale maji sled fotek) -- nestaci to pripadne vrazit do podgalerii? | ||||
| 
 | ||||
|  | @ -1,5 +1,3 @@ | |||
| #coding: utf-8 | ||||
| 
 | ||||
| from galerie.models import Obrazek, Galerie | ||||
| from django.contrib import admin | ||||
| from django.http import HttpResponseRedirect | ||||
|  |  | |||
|  | @ -1,47 +0,0 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| 
 | ||||
| from autocomplete_light import shortcuts as autocomplete_light | ||||
| 
 | ||||
| from .models import Obrazek, Galerie | ||||
| from .views import cesta_od_korene | ||||
| 
 | ||||
| 
 | ||||
| class ObrazekAutocomplete(autocomplete_light.AutocompleteModelBase): | ||||
| 
 | ||||
|     model = Obrazek | ||||
|     search_fields = ['nazev', 'popis'] | ||||
|     split_words = True | ||||
|     limit_choices = 15 | ||||
|     attrs = { | ||||
|         # This will set the input placeholder attribute: | ||||
|         'placeholder': u'Obrázek', | ||||
|         # This will set the yourlabs.Autocomplete.minimumCharacters | ||||
|         # options, the naming conversion is handled by jQuery | ||||
|         'data-autocomplete-minimum-characters': 1, | ||||
|     } | ||||
| 
 | ||||
|     choice_html_format = ''' | ||||
|         <span class="block" data-value="{}"> | ||||
|             <span class="block"> | ||||
|                 {} | ||||
|                 <span class="block">{}</span> | ||||
|             </span> | ||||
|         </span> | ||||
|     ''' | ||||
| 
 | ||||
|     def choice_label(self, obrazek): | ||||
|         cesta = "/".join(g.nazev for g in cesta_od_korene(obrazek.galerie)) | ||||
|         popis = "{}<br>".format(obrazek.popis) if obrazek.popis else "" | ||||
|         return '{}<br>{}{}'.format(obrazek.nazev, popis, cesta) | ||||
| 
 | ||||
|     def choice_html(self, obrazek): | ||||
|         """Vrátí kus html i s obrázkem, které se pak ukazuje v nabídce""" | ||||
|         return self.choice_html_format.format(self.choice_value(obrazek), | ||||
|             obrazek.obrazek_maly_tag(), self.choice_label(obrazek)) | ||||
| 
 | ||||
|     widget_attrs={ | ||||
|         'data-widget-maximum-values': 15, | ||||
|         'class': 'modern-style', | ||||
|     } | ||||
| 
 | ||||
| autocomplete_light.register(ObrazekAutocomplete) | ||||
|  | @ -1,7 +1,4 @@ | |||
| #coding: utf-8 | ||||
| 
 | ||||
| from django import forms | ||||
| from seminar.models import Soustredeni | ||||
| 
 | ||||
| class KomentarForm(forms.Form): | ||||
| 	komentar = forms.CharField(label = "Komentář:", max_length = 300, required=False) | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| # Generated by Django 1.11.20 on 2019-04-30 21:40 | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| # Generated by Django 1.11.21 on 2019-06-10 21:58 | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
|  |  | |||
							
								
								
									
										13
									
								
								galerie/migrations/0011_pre_split_soustredeni.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										13
									
								
								galerie/migrations/0011_pre_split_soustredeni.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,13 @@ | |||
| # Generated by Django 4.2.11 on 2024-04-30 21:53 | ||||
| 
 | ||||
| from django.db import migrations | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('galerie', '0010_auto_20200819_0947'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|     ] | ||||
							
								
								
									
										20
									
								
								galerie/migrations/0012_soustredeni_relink.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										20
									
								
								galerie/migrations/0012_soustredeni_relink.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,20 @@ | |||
| # Generated by Django 4.2.11 on 2024-05-01 13:07 | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
| import django.db.models.deletion | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('soustredeni', '0001_split_from_seminar'), | ||||
|         ('galerie', '0011_pre_split_soustredeni'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|         migrations.AlterField( | ||||
|             model_name='galerie', | ||||
|             name='soustredeni', | ||||
|             field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, to='soustredeni.soustredeni'), | ||||
|         ), | ||||
|     ] | ||||
							
								
								
									
										14
									
								
								galerie/migrations/0013_post_split_soustredeni.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										14
									
								
								galerie/migrations/0013_post_split_soustredeni.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,14 @@ | |||
| # Generated by Django 4.2.11 on 2024-05-01 13:35 | ||||
| 
 | ||||
| from django.db import migrations | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('galerie', '0012_soustredeni_relink'), | ||||
|         ('soustredeni', '0003_post_split_soustredeni'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|     ] | ||||
|  | @ -1,14 +1,11 @@ | |||
| # coding: utf-8 | ||||
| 
 | ||||
| from django.db import models | ||||
| #from django.db.models import Q | ||||
| from django.utils.encoding import force_text | ||||
| from imagekit.models import ImageSpecField | ||||
| from imagekit.processors import ResizeToFit, Transpose | ||||
| 
 | ||||
| import os | ||||
| 
 | ||||
| from seminar.models import Soustredeni | ||||
| from soustredeni.models import Soustredeni | ||||
| 
 | ||||
| VZDY=0 | ||||
| ORG=1 | ||||
|  |  | |||
							
								
								
									
										186
									
								
								galerie/static/css/galerie.css
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										186
									
								
								galerie/static/css/galerie.css
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,186 @@ | |||
| @charset "utf-8"; /* vynuť utf-8 */ | ||||
| 
 | ||||
| /* Galerie */ | ||||
| 
 | ||||
| 
 | ||||
| /* velká fotka */ | ||||
| /* zmenšování spolu s oknem prohlížeče */ | ||||
| .galerie .obrazek, .titulni_obrazek { | ||||
| 	max-width: 100%; | ||||
| 	height: auto; | ||||
| 	width: auto\9; /* ie8 */ | ||||
| } | ||||
| 
 | ||||
| .predchozi_obrazek{ | ||||
| 	position: absolute; | ||||
| 	z-index: 1; | ||||
| 	width: 33%; | ||||
| 	height: 100%; | ||||
| 	left: 0; | ||||
| 	top: 0; | ||||
| } | ||||
| .predchozi_obrazek:hover{ | ||||
| 	background-image: url("/static/galerie/prvky/predchozi.svg"); | ||||
| 	filter: drop-shadow(0px 5px 5px rgba(0, 0, 0, 0.4)); | ||||
| 	background-position: left center; | ||||
| 	background-repeat: no-repeat; | ||||
| } | ||||
| .dalsi_obrazek{ | ||||
| 	position: absolute; | ||||
| 	z-index: 1; | ||||
| 	width: 33%; | ||||
| 	height: 100%; | ||||
| 	left: 67%; | ||||
| 	top: 0; | ||||
| } | ||||
| .dalsi_obrazek:hover{ | ||||
| 	background-image: url("/static/galerie/prvky/dalsi.svg"); | ||||
| 	filter: drop-shadow(0px 5px 5px rgba(0, 0, 0, 0.4)); | ||||
| 	background-position: right center; | ||||
| 	background-repeat: no-repeat; | ||||
| } | ||||
| 
 | ||||
| .galerie { | ||||
| 	position: relative; | ||||
| 	text-align: center; | ||||
| 	margin: 20px auto 0 auto; | ||||
| } | ||||
| 
 | ||||
| .galerie h1 { | ||||
| 	text-align: center; | ||||
| } | ||||
| 
 | ||||
| .galerie_hlavicka { | ||||
| 	margin: 30px auto 30px auto; | ||||
| } | ||||
| 
 | ||||
| .popis { | ||||
| 	margin: 10px 10px 30px 0px; | ||||
| 	text-align: center; | ||||
| } | ||||
| 
 | ||||
| #nahoru { | ||||
| 	text-align: center; | ||||
| } | ||||
| 
 | ||||
| /* titulní obrázek hlavní galerie soustředění */ | ||||
| 
 | ||||
| .galerie_nahledy{ | ||||
| 	/*margin: 1em 0;*/ | ||||
| 	margin: auto; | ||||
| 	padding: 10px; | ||||
| 	text-align: center; | ||||
| 	overflow: auto; | ||||
| } | ||||
| 
 | ||||
| .galerie_nahledy img { | ||||
| 	margin: 10px; | ||||
| } | ||||
| 
 | ||||
| .galerie_nahledy div.navigace { | ||||
| 	display: inline-block; | ||||
| } | ||||
| 
 | ||||
| .galerie_nahled, .podgalerie_nahled { /* frame */ | ||||
| 	display: block; | ||||
| 	position: relative; | ||||
| 	float: left; | ||||
| 	width: 200px; | ||||
| 	height: 200px; | ||||
| 	text-align: center; | ||||
| 	border: solid; | ||||
| 	border-width: 1px; | ||||
| 	border-radius: 4px; | ||||
| 	border-color: var(--svetla-oranzova); | ||||
| 	background-color: var(--barva-pozadi); | ||||
| 	white-space: nowrap; | ||||
| 	margin: 10px; | ||||
| 	font-weight: bold; | ||||
| } | ||||
| 
 | ||||
| .galerie_nahled:hover, .podgalerie_nahled:hover { | ||||
| 	background-color: var(--svetla-oranzova); | ||||
| 	filter: drop-shadow(0px 5px 5px rgba(0, 0, 0, 0.4)); | ||||
| 	color: var(--tmava-oranzova); | ||||
| } | ||||
| 
 | ||||
| .vystredeno{ /* helper */ | ||||
| 	display: inline-block; | ||||
| 	height: 100%; | ||||
| 	vertical-align: middle; | ||||
| } | ||||
| 
 | ||||
| .galerie_nahled img { | ||||
| 	vertical-align: middle; | ||||
| 	max-height: 180px; | ||||
| 	max-width: 180px; | ||||
| } | ||||
| 
 | ||||
| .galerie_nahled div { | ||||
| 	position: absolute; | ||||
| 	bottom: 0px; | ||||
| 	width: 100%; | ||||
| 	text-align: center; | ||||
| } | ||||
| 
 | ||||
| .podgalerie_nahled img { | ||||
| 	margin-top: 20px; | ||||
| 	margin-bottom: 15px; | ||||
| 	max-height: 125px; | ||||
| 	max-width: 167px; | ||||
| } | ||||
| 
 | ||||
| .podgalerie_nahled .nazev_galerie { | ||||
| 	position: absolute; | ||||
| 	width: 100%; | ||||
| 	top: 160px; | ||||
| } | ||||
| 
 | ||||
| 
 | ||||
| /* Odkazy na předchozí a následující podgalerii */ | ||||
| .galerie_predchozi_nasledujici { | ||||
| 	overflow: auto; | ||||
| 	margin: 10px auto 10px auto; | ||||
| } | ||||
| 
 | ||||
| .galerie_predchozi_nasledujici .predchozi { | ||||
| 	float: left; | ||||
| } | ||||
| 
 | ||||
| .galerie_predchozi_nasledujici .nasledujici { | ||||
| 	float: right; | ||||
| } | ||||
| 
 | ||||
| /* posune kotvu obrázku v galerii o oranžový pruh dolu, aby se pod ním obrázek neschovával */ | ||||
| /* https://stackoverflow.com/questions/10732690/offsetting-an-html-anchor-to-adjust-for-fixed-header */ | ||||
| .kotva_obrazku { | ||||
| 	position: absolute; | ||||
| 	width: 0; | ||||
| 	height: 55px; /* viz #title */ | ||||
| 	margin-top: -55px; /* viz #title */ | ||||
| } | ||||
| @media(max-width: 860px) { | ||||
| 	.kotva_obrazku { | ||||
| 		height: 3em; /* #FIXME nemám páru, jak zjistit výšku toho elementu */ | ||||
| 		margin-top: -3em; /* #FIXME */ | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| 
 | ||||
| /* plus a minus tlacitka */ | ||||
| .mam-org-only-galerie { | ||||
| 	background: var(--orgovska-svetla-fialova); | ||||
| 	padding: 10px; | ||||
| 	margin: 10px 10px 10px -20px; | ||||
| 	border: #333 2px dashed; | ||||
| 	float: left; | ||||
| } | ||||
| 
 | ||||
| .mam-org-only-galerie a{ | ||||
| 	padding: 3px 5px; | ||||
| 	margin: 5px; | ||||
| 	border-radius: 20px; | ||||
| 	background-color: var(--tmava-oranzova);; | ||||
| 	color: var(--barva-pozadi); | ||||
| 	float: left; | ||||
| } | ||||
|  | @ -1,4 +1,4 @@ | |||
| {% extends "base.html" %} | ||||
| {% extends "galerie/base.html" %} | ||||
| 
 | ||||
| 
 | ||||
| {% block nadpis1a %} | ||||
|  |  | |||
|  | @ -1,4 +1,4 @@ | |||
| {% extends "base.html" %} | ||||
| {% extends "galerie/base.html" %} | ||||
| 
 | ||||
| {% block nadpis1a %} | ||||
| Galerie {{galerie.nazev}} | ||||
|  |  | |||
|  | @ -1,4 +1,4 @@ | |||
| {% extends "base.html" %} | ||||
| {% extends "galerie/base.html" %} | ||||
| 
 | ||||
| 
 | ||||
| {% block content %} | ||||
|  |  | |||
							
								
								
									
										6
									
								
								galerie/templates/galerie/base.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										6
									
								
								galerie/templates/galerie/base.html
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,6 @@ | |||
| {% extends "base.html" %} | ||||
| {% load static %} | ||||
| 
 | ||||
| {% block custom_css %} | ||||
|   <link href="{% static 'css/galerie.css' %}?version=1" rel="stylesheet"> | ||||
| {% endblock %} | ||||
|  | @ -1,14 +1,5 @@ | |||
| """ | ||||
| Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují: | ||||
| 
 | ||||
| - ``<int:pk>/`` :func:`~galerie.views.nahled` | ||||
| - ``<int:pk>/<int:fotka>/`` :func:`~galerie.views.detail` | ||||
| - ``<int:galerie>/new/`` :func:`~galerie.views.new_galerie` | ||||
| - ``<int:galerie>/plus/<int:subgalerie>/`` :func:`~galerie.views.plus_galerie` | ||||
| - ``<int:galerie>/minus/<int:subgalerie>/`` :func:`~galerie.views.minus_galerie` | ||||
| """ | ||||
| from django.urls import path | ||||
| from seminar.utils import org_required | ||||
| from personalni.utils import org_required | ||||
| from . import views | ||||
| 
 | ||||
| urlpatterns = [ | ||||
|  |  | |||
|  | @ -1,5 +1,3 @@ | |||
| # coding: utf-8 | ||||
| 
 | ||||
| import random | ||||
| 
 | ||||
| from django.http import HttpResponse, Http404 | ||||
|  |  | |||
|  | @ -1,14 +1,3 @@ | |||
| """ | ||||
| Soubor sloužící k definici toho, co bude v adminu. Většinou pouhým zavoláním | ||||
| funkce :func:`django.contrib.admin.site.register`, v případě, že chceme něco | ||||
| upravit, tak jako třída rozšiřující :class:`django.contrib.admin.ModelAdmin` | ||||
| s dekorátorem :func:`django.contrib.admin.register`. | ||||
| 
 | ||||
| Zde se definuje admin pro: | ||||
| 
 | ||||
| - :class:`~header_fotky.models.FotkaHeader` | ||||
| - :class:`~header_fotky.models.FotkaUrlVazba` | ||||
| """ | ||||
| from django.contrib import admin | ||||
| from django.contrib.admin import ModelAdmin | ||||
| import header_fotky.models as m | ||||
|  | @ -22,4 +11,4 @@ class FotkaPozadiAdmin(ModelAdmin): | |||
|     readonly_fields = ['cas'] | ||||
| 
 | ||||
| admin.site.register(m.FotkaHeader, FotkaPozadiAdmin) | ||||
| admin.site.register(m.FotkaUrlVazba) | ||||
| admin.site.register(m.FotkaUrlVazba) | ||||
|  |  | |||
|  | @ -1,8 +1,6 @@ | |||
| """ | ||||
| Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace. | ||||
| """ | ||||
| from django.apps import AppConfig | ||||
| 
 | ||||
| 
 | ||||
| class HeaderFotkyConfig(AppConfig): | ||||
|     name = 'header_fotky' | ||||
|     verbose_name = 'Fotky v záhlaví' | ||||
|  |  | |||
|  | @ -12,46 +12,46 @@ from header_fotky.models import FotkaUrlVazba | |||
| 
 | ||||
| 
 | ||||
| def vzhled(request): | ||||
|     """ | ||||
|         Podle času přidá do contextu, zdali je nebo není noc. Dále podle dení | ||||
|         doby a url přidá do contextu správnou fotku. | ||||
| 	""" | ||||
| 		Podle času přidá do contextu, zdali je nebo není noc. Dále podle dení | ||||
| 		doby a url přidá do contextu správnou fotku. | ||||
| 
 | ||||
|         url adresu nejprve vyzkouší celou, pak postupně odřezává věci za | ||||
|         lomítkem, dokud nenajde url, pro kterou existuje alespoň jedna fotka. | ||||
|         Z fotek pro toto url zkusí vybrat tu ve správné denní době a až poté | ||||
|         libovolnou. (Z více možných fotek pro 1 url a 1 dobu vybírá náhodně.) | ||||
|     """ | ||||
|     hodin = datetime.now().hour | ||||
|     if (hodin <= 6) or (hodin >= 20): | ||||
|         noc = True | ||||
|         nedoba = 'den' | ||||
|         doba = 'noc' | ||||
|     else: | ||||
|         noc = False | ||||
|         nedoba = 'noc' | ||||
|         doba = 'den' | ||||
|     url = request.path | ||||
| 		url adresu nejprve vyzkouší celou, pak postupně odřezává věci za | ||||
| 		lomítkem, dokud nenajde url, pro kterou existuje alespoň jedna fotka. | ||||
| 		Z fotek pro toto url zkusí vybrat tu ve správné denní době a až poté | ||||
| 		libovolnou. (Z více možných fotek pro 1 url a 1 dobu vybírá náhodně.) | ||||
| 	""" | ||||
| 	hodin = datetime.now().hour | ||||
| 	if (hodin <= 6) or (hodin >= 20): | ||||
| 		noc = True | ||||
| 		nedoba = 'den' | ||||
| 		doba = 'noc' | ||||
| 	else: | ||||
| 		noc = False | ||||
| 		nedoba = 'noc' | ||||
| 		doba = 'den' | ||||
| 	url = request.path | ||||
| 
 | ||||
|     fotky = FotkaUrlVazba.objects.exclude(denni_doba=nedoba) | ||||
|     fotka = None | ||||
| 	fotky = FotkaUrlVazba.objects.exclude(denni_doba=nedoba) | ||||
| 	fotka = None | ||||
| 
 | ||||
|     # TODO rychlejší patternmatch? | ||||
|     while (fotka is None) and (url != ''): | ||||
|         presne = fotky.filter(url__exact=url) | ||||
|         if presne.count() > 0: | ||||
|             presne_doba = presne.filter(denni_doba=doba) | ||||
|             if presne_doba.count() > 0: | ||||
|                 fotka = random.choice(presne_doba).url_fotky() | ||||
|             else: | ||||
|                 fotka = random.choice(presne).url_fotky() | ||||
| 	# TODO rychlejší patternmatch? | ||||
| 	while (fotka is None) and (url != ''): | ||||
| 		presne = fotky.filter(url__exact=url) | ||||
| 		if presne.count() > 0: | ||||
| 			presne_doba = presne.filter(denni_doba=doba) | ||||
| 			if presne_doba.count() > 0: | ||||
| 				fotka = random.choice(presne_doba).url_fotky() | ||||
| 			else: | ||||
| 				fotka = random.choice(presne).url_fotky() | ||||
| 
 | ||||
|         url = url[:-1] | ||||
|         index = url.rfind('/') | ||||
|         if index != -1: | ||||
|             url = url[:index+1] | ||||
| 		url = url[:-1] | ||||
| 		index = url.rfind('/') | ||||
| 		if index != -1: | ||||
| 			url = url[:index+1] | ||||
| 
 | ||||
|     if fotka is None: | ||||
|         fotka = settings.STATIC_URL + "images/header/vikendovka.jpg" | ||||
| 	if fotka is None: | ||||
| 		fotka = settings.STATIC_URL + "images/header/vikendovka.jpg" | ||||
| 
 | ||||
|     return {'noc': noc, 'fotka': fotka} | ||||
| 	return {'noc': noc, 'fotka': fotka} | ||||
| 
 | ||||
|  |  | |||
|  | @ -1,17 +1,3 @@ | |||
| """ | ||||
| Tento soubor slouží k definici databázového modelu. | ||||
| 
 | ||||
| Třídy rozšiřují většinou :class:`django.db.models.Model` a jejich atributy jsou | ||||
| většinou sloupce v databázi (tj. nastaví se na hodnotu něčeho z :mod:`django.db.models`). | ||||
| Na výběr jsou: | ||||
| 
 | ||||
| 	- :class:`django.db.models.TextField` | ||||
| 	- :class:`django.db.models.ForeignKey` | ||||
| 	- :class:`django.db.models.DateField` | ||||
| 	- :class:`django.db.models.DateTimeField` | ||||
| 	- :class:`django.db.models.ImageField` | ||||
| 	- :class:`django.db.models.CharField` | ||||
| """ | ||||
| from django.core.exceptions import ValidationError | ||||
| from django.db import models | ||||
| from django.utils import timezone | ||||
|  |  | |||
|  | @ -1,11 +0,0 @@ | |||
| - korektura potrebuje reakci | ||||
| + komentáře fixně na username | ||||
|   - používat skutečné jméno? | ||||
| - vyžádat pozornost autora obsahu | ||||
| - zvednout upload limit na 5MB | ||||
| - sbalit a rozbalit korekturu | ||||
| - nahrávání jiných věcí než PDF - kontrolovat? | ||||
| - stylování | ||||
| - seznam PDF - co zobrazovat? | ||||
| 
 | ||||
| 
 | ||||
|  | @ -1,21 +1,10 @@ | |||
| """ | ||||
| Soubor sloužící k definici toho, co bude v adminu. Většinou pouhým zavoláním | ||||
| funkce :func:`django.contrib.admin.site.register`, v případě, že chceme něco | ||||
| upravit, tak jako třída rozšiřující :class:`django.contrib.admin.ModelAdmin` | ||||
| s dekorátorem :func:`django.contrib.admin.register`. | ||||
| 
 | ||||
| Zde se definuje admin pro: | ||||
| 
 | ||||
| - :class:`korektury.models.KorekturovanePDF` | ||||
| """ | ||||
| from django.contrib import admin | ||||
| from reversion.admin import VersionAdmin | ||||
| from korektury.models import KorekturovanePDF | ||||
| 
 | ||||
| from django.core.mail import send_mail | ||||
| from django.core.mail import EmailMessage | ||||
| from django.urls import reverse | ||||
| 
 | ||||
| # Register your models here. | ||||
| class KorekturovanePDFAdmin(VersionAdmin): | ||||
| 	""" | ||||
| 	nastaví čas vložení (:attr:`~koretkury.models.KorekturovanePDF.cas`) a počet | ||||
|  | @ -36,12 +25,13 @@ class KorekturovanePDFAdmin(VersionAdmin): | |||
| 	fieldsets = [ | ||||
| 			(None, | ||||
| 				{'fields': | ||||
| 					['pdf', 'cas', 'org', 'stran', 'nazev', 'komentar', 'poslat_mail']}), | ||||
| 					['pdf', 'cas', 'stran', 'nazev', 'orgove', 'komentar', 'poslat_mail']}), | ||||
| 			# (u'PDF',       {'fields': ['pdf']}), | ||||
| 				] | ||||
| 	list_display = ['nazev', 'cas', 'stran', 'org'] | ||||
| 	list_display = ['nazev', 'cas', 'stran'] | ||||
| 	list_filter = [] | ||||
| 	search_fields = [] | ||||
| 	autocomplete_fields = ['orgove'] | ||||
| 
 | ||||
| 	def save_model(self, request, obj, form, change): | ||||
| 		""" | ||||
|  | @ -64,6 +54,11 @@ Popis souboru: | |||
| S pozdravem a korekturám zdar! | ||||
| Korekturovátko | ||||
| ''' | ||||
| 			send_mail(predmet,text,odesilatel,[prijemce]) | ||||
| 			EmailMessage( | ||||
| 				subject=predmet, | ||||
| 				body=text, | ||||
| 				from_email=odesilatel, | ||||
| 				to=[prijemce], | ||||
| 			).send() | ||||
| 
 | ||||
| admin.site.register(KorekturovanePDF, KorekturovanePDFAdmin) | ||||
|  |  | |||
|  | @ -1,13 +1,3 @@ | |||
| """ | ||||
| Formuláře (:class:`django.forms.Form`) umožňují jednoduchou tvorbu formulářů, | ||||
| které lze pak jednoduše dát do frontendu i zpracovat na backendu. | ||||
| 
 | ||||
| Pro přidání políčka do formuláře je potřeba | ||||
|  - mít v modelu tu položku, kterou chci upravovat | ||||
|  - přidat do views (prihlaskaView, resitelEditView) | ||||
|  - přidat do forms | ||||
|  - includovat do html | ||||
| """ | ||||
| from django import forms | ||||
| 
 | ||||
| class OpravaForm(forms.Form): | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import models, migrations | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| # Generated by Django 1.11.20 on 2019-04-30 21:40 | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
|  |  | |||
|  | @ -1,4 +1,3 @@ | |||
| # -*- coding: utf-8 -*- | ||||
| # Generated by Django 1.11.21 on 2019-06-10 21:58 | ||||
| from __future__ import unicode_literals | ||||
| 
 | ||||
|  |  | |||
							
								
								
									
										18
									
								
								korektury/migrations/0019_auto_20221205_2014.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										18
									
								
								korektury/migrations/0019_auto_20221205_2014.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,18 @@ | |||
| # Generated by Django 2.2.28 on 2022-12-05 19:14 | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('korektury', '0018_korekturovanepdf_poslat_mail'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|         migrations.AlterField( | ||||
|             model_name='korekturovanepdf', | ||||
|             name='nazev', | ||||
|             field=models.CharField(help_text='Název (např. 22.1 verze 4) korekturovaného PDF', max_length=50, verbose_name='název PDF'), | ||||
|         ), | ||||
|     ] | ||||
							
								
								
									
										18
									
								
								korektury/migrations/0020_lepsi_popis_nazvu_PDF_v_adminu.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										18
									
								
								korektury/migrations/0020_lepsi_popis_nazvu_PDF_v_adminu.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,18 @@ | |||
| # Generated by Django 2.2.28 on 2023-06-19 19:38 | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('korektury', '0019_auto_20221205_2014'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|         migrations.AlterField( | ||||
|             model_name='korekturovanepdf', | ||||
|             name='nazev', | ||||
|             field=models.CharField(help_text='Název (např. `22.1 | analyza v4` nebo `propagace | letacek v0`) korekturovaného PDF', max_length=50, verbose_name='název PDF'), | ||||
|         ), | ||||
|     ] | ||||
							
								
								
									
										13
									
								
								korektury/migrations/0021_auto_20240312_2124.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										13
									
								
								korektury/migrations/0021_auto_20240312_2124.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,13 @@ | |||
| # Generated by Django 4.2.8 on 2024-03-12 20:24 | ||||
| 
 | ||||
| from django.db import migrations | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('korektury', '0020_lepsi_popis_nazvu_PDF_v_adminu'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|     ] | ||||
|  | @ -0,0 +1,30 @@ | |||
| # Generated by Django 4.2.11 on 2024-03-19 21:35 | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
| import django.db.models.deletion | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('personalni', '0003_initial'), | ||||
|         ('korektury', '0021_auto_20240312_2124'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|         migrations.AlterField( | ||||
|             model_name='komentar', | ||||
|             name='autor', | ||||
|             field=models.ForeignKey(blank=True, help_text='Autor komentáře', null=True, on_delete=django.db.models.deletion.SET_NULL, to='personalni.organizator'), | ||||
|         ), | ||||
|         migrations.AlterField( | ||||
|             model_name='korekturovanepdf', | ||||
|             name='org', | ||||
|             field=models.ForeignKey(blank=True, default=None, help_text='Zodpovědný organizátor za obsah', null=True, on_delete=django.db.models.deletion.SET_NULL, to='personalni.organizator'), | ||||
|         ), | ||||
|         migrations.AlterField( | ||||
|             model_name='oprava', | ||||
|             name='autor', | ||||
|             field=models.ForeignKey(blank=True, help_text='Autor opravy', null=True, on_delete=django.db.models.deletion.SET_NULL, to='personalni.organizator'), | ||||
|         ), | ||||
|     ] | ||||
							
								
								
									
										14
									
								
								korektury/migrations/0023_personalni_post_migrate.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										14
									
								
								korektury/migrations/0023_personalni_post_migrate.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,14 @@ | |||
| # Generated by Django 4.2.11 on 2024-03-26 21:25 | ||||
| 
 | ||||
| from django.db import migrations | ||||
| 
 | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('korektury', '0022_alter_komentar_autor_alter_korekturovanepdf_org_and_more'), | ||||
|         ('personalni', '0005_personalni_post_migrate'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|     ] | ||||
							
								
								
									
										41
									
								
								korektury/migrations/0024_vic_orgu_k_pdf.py
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										41
									
								
								korektury/migrations/0024_vic_orgu_k_pdf.py
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,41 @@ | |||
| # Generated by Django 4.2.13 on 2024-06-11 23:53 | ||||
| 
 | ||||
| from django.db import migrations, models | ||||
| 
 | ||||
| def pridej_orgy(apps, schema_editor): | ||||
|     PDF = apps.get_model('korektury', 'KorekturovanePDF') | ||||
|     for pdf in PDF.objects.all(): # Tohle by asi mělo jít udělat pomocí update, ale moc práce a rychlé hledání taky nepomohlo. | ||||
|         if pdf.org is not None: pdf.orgove.add(pdf.org) | ||||
|         pdf.save() # ig? | ||||
| 
 | ||||
| def vyber_orga(apps, schema_editor): | ||||
|     PDF = apps.get_model('korektury', 'KorekturovanePDF') | ||||
|     for pdf in PDF.objects.all(): | ||||
|         orgove = pdf.orgove.all() | ||||
|         if len(orgove) > 1: | ||||
|             raise migrations.exceptions.IrreversibleError(f'PDF {pdf.id} má víc než jednoho zodpovědného orga, nejde odmigrovat na verzi, která umí jen jednoho.') | ||||
|         if len(orgove) == 0: | ||||
|             pdf.org = None | ||||
|         else: | ||||
|             pdf.org = orgove[0] | ||||
|         pdf.save() | ||||
| 
 | ||||
| class Migration(migrations.Migration): | ||||
| 
 | ||||
|     dependencies = [ | ||||
|         ('personalni', '0011_osloveni_vsechny_choices'), | ||||
|         ('korektury', '0023_personalni_post_migrate'), | ||||
|     ] | ||||
| 
 | ||||
|     operations = [ | ||||
|         migrations.AddField( | ||||
|             model_name='korekturovanepdf', | ||||
|             name='orgove', | ||||
|             field=models.ManyToManyField(blank=True, default=None, help_text='Zodpovědní organizátoři za obsah (chodí jim maily o nových korekturách)', to='personalni.organizator'), | ||||
|         ), | ||||
|         migrations.RunPython(pridej_orgy, vyber_orga), | ||||
|         migrations.RemoveField( | ||||
|             model_name='korekturovanepdf', | ||||
|             name='org', | ||||
|         ), | ||||
|     ] | ||||
|  | @ -1,27 +1,12 @@ | |||
| """ | ||||
| Tento soubor slouží k definici databázového modelu. | ||||
| 
 | ||||
| Třídy rozšiřují většinou :class:`django.db.models.Model` a jejich atributy jsou | ||||
| většinou sloupce v databázi (tj. nastaví se na hodnotu něčeho z :mod:`django.db.models`). | ||||
| Na výběr jsou: | ||||
| 
 | ||||
| 	- :class:`django.db.models.TextField` | ||||
| 	- :class:`django.db.models.ForeignKey` | ||||
| 	- :class:`django.db.models.DateField` | ||||
| 	- :class:`django.db.models.DateTimeField` | ||||
| 	- :class:`django.db.models.ImageField` | ||||
| 	- :class:`django.db.models.CharField` | ||||
| """ | ||||
| import os | ||||
| from django.db import models | ||||
| from django.utils import timezone | ||||
| from django.conf import settings | ||||
| from django.utils.encoding import force_text | ||||
| from django.core.exceptions import ObjectDoesNotExist | ||||
| from django.utils.functional import cached_property | ||||
| from django.utils.text import get_valid_filename | ||||
| 
 | ||||
| from seminar.models import Organizator | ||||
| from personalni.models import Organizator | ||||
| 
 | ||||
| import subprocess | ||||
| from reversion import revisions as reversion | ||||
|  | @ -41,7 +26,6 @@ def generate_filename(self, filename): | |||
| 		clean) | ||||
| 	return os.path.join(settings.KOREKTURY_PDF_DIR, fname) | ||||
| 
 | ||||
| 
 | ||||
| #@reversion.register(ignore_duplicates=True) | ||||
| class KorekturovanePDF(models.Model): | ||||
| 	class Meta: | ||||
|  | @ -55,15 +39,15 @@ class KorekturovanePDF(models.Model): | |||
| 
 | ||||
| 	cas = models.DateTimeField(u'čas vložení PDF',default=timezone.now,help_text = 'Čas vložení PDF') | ||||
| 
 | ||||
| 	nazev = models.CharField(u'název PDF',blank = True,max_length=50, help_text='Název (např. 22.1 verze 4) korekturovaného PDF') | ||||
| 	nazev = models.CharField(u'název PDF',blank = False,max_length=50, help_text='Název (např. `22.1 | analyza v4` nebo `propagace | letacek v0`) korekturovaného PDF') | ||||
| 
 | ||||
| 	komentar = models.TextField(u'komentář k PDF',blank = True, help_text='Komentář ke korekturovanému PDF (např. na co se zaměřit)') | ||||
| 
 | ||||
| 	pdf = models.FileField(u'PDF', upload_to = generate_filename) | ||||
| 
 | ||||
| 	org = models.ForeignKey(Organizator, blank=True, | ||||
| 		help_text='Zodpovědný organizátor za obsah', | ||||
| 		null=True, default=None, on_delete=models.SET_NULL) | ||||
| 	orgove = models.ManyToManyField(Organizator, blank=True, | ||||
| 		help_text='Zodpovědní organizátoři za obsah (chodí jim maily o nových korekturách)', | ||||
| 		default=None) | ||||
| 
 | ||||
| 	stran = models.IntegerField(u'počet stran', help_text='Počet stran PDF', | ||||
| 								default=0) | ||||
|  |  | |||
|  | @ -146,7 +146,7 @@ | |||
| 					</button> | ||||
| 					{% endif %} | ||||
| 					{% if o.status != 'neni_chyba' %}  | ||||
| 					<button type='submit' name='action' value='wontfix' title='Označ jako irelevantní '> | ||||
| 					<button type='submit' name='action' value='wontfix' title='Označ, že se nebude měnit'> | ||||
|             <img src="{% static "korektury/imgs/cross.png" %}"/> | ||||
| 					</button> | ||||
| 					{% endif %} | ||||
|  |  | |||
|  | @ -1,3 +0,0 @@ | |||
| from django.test import TestCase | ||||
| 
 | ||||
| # Create your tests here. | ||||
|  | @ -1,13 +1,5 @@ | |||
| """ | ||||
| Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují: | ||||
| 
 | ||||
| - ``korektury/`` (korektury_list) :class:`~korektury.views.KorekturySeskupeneListView` | ||||
| - ``korektury/neseskupene/`` (korektury_neseskupene_list) :class:`~korektury.views.KorekturyAktualniListView` | ||||
| - ``korektury/zastarale/`` (korektury_stare_list) :class:`~korektury.views.KorekturyZastaraleListView` | ||||
| - ``korektury/<int:pdf>/`` (korektury) :class:`~korektury.views.KorekturyView` | ||||
| """ | ||||
| from django.urls import path | ||||
| from seminar.utils import org_required | ||||
| from personalni.utils import org_required | ||||
| from . import views | ||||
| 
 | ||||
| urlpatterns = [ | ||||
|  |  | |||
|  | @ -1,14 +1,8 @@ | |||
| """ | ||||
| Soubor sloužící k deklaraci jednotlivých „views“ (nejčastěji funkce beroucí request | ||||
| a vracející :func:`django.shortcuts.render` respektive nějakou response, nebo | ||||
| třídy většinou rozšiřující nějakou třídu z :mod:`django.views.generic`) | ||||
| """ | ||||
| from django.shortcuts import get_object_or_404, render | ||||
| from django.views import generic | ||||
| from django.utils.translation import ugettext as _ | ||||
| from django.conf import settings | ||||
| from django.http import HttpResponseForbidden | ||||
| from django.core.mail import send_mail | ||||
| from django.core.mail import EmailMessage | ||||
| from django.db.models import Count,Q | ||||
| 
 | ||||
| from .models import Oprava,Komentar,KorekturovanePDF, Organizator | ||||
|  | @ -30,28 +24,28 @@ class KorekturyListView(generic.ListView): | |||
| 	template_name = 'korektury/seznam.html' | ||||
| 
 | ||||
| class KorekturyAktualniListView(KorekturyListView): | ||||
|     def get_queryset(self, *args, **kwargs): | ||||
|         queryset=super().get_queryset() | ||||
|         queryset=queryset.exclude(status="zastarale") | ||||
|         return queryset | ||||
| 	def get_queryset(self, *args, **kwargs): | ||||
| 		queryset=super().get_queryset() | ||||
| 		queryset=queryset.exclude(status="zastarale") | ||||
| 		return queryset | ||||
| 
 | ||||
|     def get_context_data(self, **kwargs): | ||||
|         context = super().get_context_data(**kwargs) | ||||
|         context['selected'] = 'aktualni' | ||||
|         return context | ||||
| 	def get_context_data(self, **kwargs): | ||||
| 		context = super().get_context_data(**kwargs) | ||||
| 		context['selected'] = 'aktualni' | ||||
| 		return context | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| class KorekturyZastaraleListView(KorekturyListView): | ||||
|     def get_queryset(self, *args, **kwargs): | ||||
|         queryset=super().get_queryset() | ||||
|         queryset=queryset.filter(status="zastarale").order_by("-cas") | ||||
|         return queryset | ||||
| 	def get_queryset(self, *args, **kwargs): | ||||
| 		queryset=super().get_queryset() | ||||
| 		queryset=queryset.filter(status="zastarale").order_by("-cas") | ||||
| 		return queryset | ||||
| 
 | ||||
|     def get_context_data(self, **kwargs): | ||||
|         context = super().get_context_data(**kwargs) | ||||
|         context['selected'] = 'zastarale' | ||||
|         return context | ||||
| 	def get_context_data(self, **kwargs): | ||||
| 		context = super().get_context_data(**kwargs) | ||||
| 		context['selected'] = 'zastarale' | ||||
| 		return context | ||||
| 
 | ||||
| class KorekturySeskupeneListView(KorekturyAktualniListView): | ||||
| 	template_name = 'korektury/seskupeny_seznam.html' | ||||
|  | @ -189,9 +183,9 @@ class KorekturyView(generic.TemplateView): | |||
| 			if email_komentujiciho: | ||||
| 				emails.add(email_komentujiciho) | ||||
| 
 | ||||
| 		# zodpovedny org | ||||
| 		if oprava.pdf.org: | ||||
| 			email_zobpovedny = oprava.pdf.org.osoba.email | ||||
| 		# zodpovedni orgove | ||||
| 		for org in oprava.pdf.orgove.all(): | ||||
| 			email_zobpovedny = org.osoba.email | ||||
| 			if email_zobpovedny: | ||||
| 				emails.add(email_zobpovedny) | ||||
| 
 | ||||
|  | @ -200,14 +194,12 @@ class KorekturyView(generic.TemplateView): | |||
| 		if email: | ||||
| 			emails.discard(email) | ||||
| 
 | ||||
| 		if not settings.POSLI_MAILOVOU_NOTIFIKACI: | ||||
| 			print("Poslal bych upozornění na tyto adresy: ", " ".join(emails)) | ||||
| 			print("---- Upozornění:") | ||||
| 			print(text) | ||||
| 			print("---- Konec upozornění") | ||||
| 			return | ||||
| 
 | ||||
| 		send_mail(subject, text, from_email, list(emails)) | ||||
| 		EmailMessage( | ||||
| 			subject=subject, | ||||
| 			body=text, | ||||
| 			from_email=from_email, | ||||
| 			to=list(emails), | ||||
| 		).send() | ||||
| 
 | ||||
| 	def get_context_data(self, **kwargs): | ||||
| 		context = super().get_context_data(**kwargs) | ||||
|  |  | |||
							
								
								
									
										8
									
								
								make/README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										8
									
								
								make/README.md
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,8 @@ | |||
| Milý člověče, M&Mí web tě vítá. Prosím, neděs se, zkusím tě provést lokálním zprovozněním webu. | ||||
| Pro detaily a nápovědu si prosím přečti dokumentaci v docs/vyvoj.rst. | ||||
| 
 | ||||
| TL;DR: Web vyrobíš pomocí následující posloupnosti příkazů: | ||||
| 	make/init_local | ||||
| 	make/run | ||||
| a web potom najdeš na <http://127.0.0.1:8000> | ||||
| 
 | ||||
							
								
								
									
										31
									
								
								make/deploy
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										31
									
								
								make/deploy
									
									
									
									
									
										Executable file
									
								
							|  | @ -0,0 +1,31 @@ | |||
| #!/bin/bash | ||||
| 
 | ||||
| set -exuo pipefail | ||||
| . make/lib.sh | ||||
| 
 | ||||
| gimli_only | ||||
| only_in_directory "$TESTWEB" | ||||
| 
 | ||||
| CURRENT_BRANCH="$(git branch --show-current)" | ||||
| BRANCH="${1:-$CURRENT_BRANCH}" | ||||
| 
 | ||||
| safe_checkout_branch "$BRANCH" | ||||
| 
 | ||||
| # Teď máme správnou větev, jdeme vše nainstalovat | ||||
| install_everything | ||||
| systemctl --user restart mamweb-test.service | ||||
| 
 | ||||
| # Přihlášení | ||||
| htpasswd -bc .htpasswd test lisakjelisak | ||||
| setfacl -m u:www-data:r .htpasswd | ||||
| 
 | ||||
| # Build dokumentace | ||||
| ensure_venv | ||||
| ( | ||||
| 	cd docs | ||||
| 	make html | ||||
| ) | ||||
| # Oprava práv k dokumentaci | ||||
| setfacl -m u:www-data:x . docs docs/_build | ||||
| setfacl -R -m u:www-data:rX docs/_build/html | ||||
| setfacl -R -m default:u:www-data:rX docs/_build/html | ||||
							
								
								
									
										25
									
								
								make/deploy_prod
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										25
									
								
								make/deploy_prod
									
									
									
									
									
										Executable file
									
								
							|  | @ -0,0 +1,25 @@ | |||
| #!/bin/bash | ||||
| 
 | ||||
| set -exuo pipefail | ||||
| . make/lib.sh | ||||
| 
 | ||||
| gimli_only | ||||
| only_in_directory "$PRODWEB" | ||||
| 
 | ||||
| CURRENT_BRANCH="$(git branch --show-current)" | ||||
| BRANCH="${1:-$CURRENT_BRANCH}" | ||||
| 
 | ||||
| if test "$BRANCH" != master | ||||
| then | ||||
| 	echo "Pozor, nasazuješ na produkci větev, která není master ($BRANCH), chceš pokračovat? Pokud ne, sestřel tento skript." | ||||
| 	read | ||||
| fi | ||||
| 
 | ||||
| # Záloha DB | ||||
| ( cd -P .. && ./backup_prod_db.sh ) | ||||
| 
 | ||||
| safe_checkout_branch "$BRANCH" | ||||
| 
 | ||||
| # Teď máme správnou větev, jdeme vše nainstalovat | ||||
| install_everything | ||||
| systemctl --user restart mamweb-prod.service | ||||
							
								
								
									
										11
									
								
								make/init_local
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										11
									
								
								make/init_local
									
									
									
									
									
										Executable file
									
								
							|  | @ -0,0 +1,11 @@ | |||
| #!/bin/bash | ||||
| 
 | ||||
| set -exuo pipefail | ||||
| . make/lib.sh | ||||
| 
 | ||||
| make/install_web | ||||
| ensure_venv | ||||
| ./manage.py testdata | ||||
| ./manage.py loaddata data/* | ||||
| #make/sync_prod_flatpages | ||||
| ./manage.py load_org_permissions deploy_v2/admin_org_prava.json | ||||
							
								
								
									
										1
									
								
								make/install
									
									
									
									
									
										Symbolic link
									
								
							
							
						
						
									
										1
									
								
								make/install
									
									
									
									
									
										Symbolic link
									
								
							|  | @ -0,0 +1 @@ | |||
| install_web | ||||
							
								
								
									
										16
									
								
								make/install_web
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										16
									
								
								make/install_web
									
									
									
									
									
										Executable file
									
								
							|  | @ -0,0 +1,16 @@ | |||
| #!/bin/bash | ||||
| 
 | ||||
| set -exuo pipefail | ||||
| . make/lib.sh | ||||
| 
 | ||||
| ensure_venv | ||||
| 
 | ||||
| # Aktualizace toolchainu | ||||
| pip install --upgrade pip setuptools | ||||
| # Instalace závislostí webu | ||||
| pip install -r requirements.txt --upgrade | ||||
| 
 | ||||
| # XXX: Připomínka z původního Makefile: | ||||
| echo 'Pro vygenerování tesdat spusť ./manage.py testdata | ||||
| Po vygenerování testdat spusť  ./manage.py loaddata data/*, ať máš menu a další modely | ||||
| Pro synchronizaci flatpages spusť make/sync_prod_flatpages' | ||||
							
								
								
									
										115
									
								
								make/lib.sh
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										115
									
								
								make/lib.sh
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,115 @@ | |||
| #!/bin/false Tohle je knihovna, nemá se spouštět, ale načítat pomocí source(1) nebo '.' | ||||
| 
 | ||||
| PYTHON="${PYTHON:-python3}" | ||||
| VENV="${VENV:-${PYTHON} -m venv}" | ||||
| VENV_PATH="${VENV_PATH:-env}" | ||||
| BRANCH="${BRANCH:-master}" | ||||
| 
 | ||||
| REPO="${REPO:-git@gitea.ks.matfyz.cz:mam/mamweb.git}" | ||||
| UPSTREAM_REMOTE='origin' | ||||
| GIMLI='gimli.ms.mff.cuni.cz' | ||||
| GIMLI_LOGIN="mam-web@$GIMLI" | ||||
| # Skutečné cesty, jak je vrátí `realpath` | ||||
| PRODWEB="/aux/akce/mam/www/mamweb-prod" | ||||
| TESTWEB="/aux/akce/mam/www/mamweb-test" | ||||
| 
 | ||||
| function die { | ||||
| 	echo "$@" >&2 | ||||
| 	exit 1 | ||||
| } | ||||
| 
 | ||||
| trap 'echo Něco se nepovedlo :-/' ERR | ||||
| 
 | ||||
| # Vždycky chceme zajistit, že běžíme z rootu repozitáře | ||||
| # TODO: chceme? Nechceme naopak umět to spouštět odkudkoliv, aspoň u většiny targetů? | ||||
| test -e '.git' || die "Make skript spuštěn ve špatné složce, spusť ho z kořenového adresáře repozitáře." | ||||
| 
 | ||||
| function ensure_venv { | ||||
| 	test -f "$VENV_PATH/bin/activate" || $VENV "$VENV_PATH" | ||||
| 	. "$VENV_PATH/bin/activate" | ||||
| 	# To ale není všechno Horste – ten venv nemusí fungovat, chceme to ověřit a případně spadnout. | ||||
| 	local SPRAVNA_CESTA="$(readlink -f "$VENV_PATH/bin/python")" | ||||
| 	local SKUTECNA_CESTA="$(readlink -f "$(which python)")" | ||||
| 	test "$SPRAVNA_CESTA" == "$SKUTECNA_CESTA" || die "Venv asi nefunguje. Prosím smaž si ho a zkus to znovu." | ||||
| 	python -c 'print()' > /dev/null || die "Python ve venvu je rozbitý. Prosím smaž venv a zkus to znovu." | ||||
| } | ||||
| 
 | ||||
| function ensure_web_installed { | ||||
| 	ensure_venv | ||||
| 	python -c 'import django; print(django.__version__)' > /dev/null && return | ||||
| 	echo >&2 "POZOR: Web nevypadá nainstalovaně, instaluji." | ||||
| 	make/install_web | ||||
| } | ||||
| 
 | ||||
| function gimli_only { | ||||
| 	# Rovnou zkontrolujeme i uživatele | ||||
| 	if test "$HOSTNAME" != gimli -o "$USER" != mam-web | ||||
| 	then | ||||
| 		echo "Tento příkaz se má spouštět na gimlim, chceš pokračovat? Pokud ne, sestřel tento skript." | ||||
| 		read | ||||
| 	fi | ||||
| } | ||||
| 
 | ||||
| function only_in_directory { | ||||
| 	local DIR="$1" | ||||
| 	local CURRENT="$(readlink -f .)" | ||||
| 	if test "$CURRENT" != "$DIR" | ||||
| 	then | ||||
| 		echo "Tento příkaz se má spouštět ve složce $DIR, chceš pokračovat? Pokud ne, sestřel tento skript." | ||||
| 		read | ||||
| 	fi | ||||
| } | ||||
| 
 | ||||
| function safe_checkout_branch { | ||||
| 	if test "$#" -ne 1 | ||||
| 	then | ||||
| 		echo >&2 "Použití: $0 <branch>" | ||||
| 		return 1 | ||||
| 	fi | ||||
| 
 | ||||
| 	local BRANCH="$1" | ||||
| 	local SCRIPT="$0" | ||||
| 
 | ||||
| 	git fetch --all | ||||
| 	local UPSTREAM_BRANCH | ||||
| 	if git rev-parse "$BRANCH@{u}" >/dev/null 2>/dev/null | ||||
| 	then | ||||
| 		UPSTREAM_BRANCH="$BRANCH@{u}" # Stačí symbolicky. | ||||
| 	else | ||||
| 		# Tohle je jediná možná záchrana. | ||||
| 		UPSTREAM_BRANCH="$UPSTREAM_REMOTE/$BRANCH" | ||||
| 	fi | ||||
| 	git rev-parse "$UPSTREAM_BRANCH" || die "Vzdálená větev $UPSTREAM_BRANCH neexistuje?" | ||||
| 
 | ||||
| 	# Od teď si musíme dát pozor, abychom nezměnili kód, který právě běží. | ||||
| 	# Zkontrolujeme, že se nemění tahle knihovna a skript, který běží. | ||||
| 	# `git rev-parse` dává SHA-1 hashe objektů, vizte manuálovou stránku pro pochopení. | ||||
| 	# Pozor: tohle porovnává jen verze commitnuté do gitu. Lokální změny udělají něco náhodného… | ||||
| 	if test "$(git rev-parse @:make/lib.sh)" != "$(git rev-parse "$UPSTREAM_BRANCH":make/lib.sh)" | ||||
| 	then | ||||
| 		echo >&2 "Změna v make/lib.sh, prosím pullni manuálně" | ||||
| 		exit 1 | ||||
| 	fi | ||||
| 	if test "$(git rev-parse @:"$SCRIPT")" != "$(git rev-parse "$UPSTREAM_BRANCH":"$SCRIPT")" | ||||
| 	then | ||||
| 		echo >&2 "Změna v $SCRIPT, prosím pullni manuálně" | ||||
| 		exit 1 | ||||
| 	fi | ||||
| 	git checkout "$BRANCH" | ||||
| 	git pull | ||||
| 	git clean -f | ||||
| } | ||||
| 
 | ||||
| function install_everything { | ||||
| 	# Skoro celé nasazení webu je stejné pro testweb i pro produkci, tak je to tady dohromady | ||||
| 	gimli_only | ||||
| 	ensure_venv | ||||
| 	make/install | ||||
| 	./manage.py migrate | ||||
| 	./manage.py collectstatic --noinput | ||||
| 	setfacl -R -m default:u:www-data:rX media static | ||||
| 	setfacl -R -m u:www-data:rX media static | ||||
| 	chown -R :mam . || true | ||||
| 	chmod -R g+rX,go-w . || true | ||||
| } | ||||
| 
 | ||||
							
								
								
									
										14
									
								
								make/push_compiled_vue_to_test
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										14
									
								
								make/push_compiled_vue_to_test
									
									
									
									
									
										Executable file
									
								
							|  | @ -0,0 +1,14 @@ | |||
| #!/bin/bash | ||||
| 
 | ||||
| set -exuo pipefail | ||||
| . make/lib.sh | ||||
| 
 | ||||
| scp vue_frontend/webpack-stats.json "$GIMLI_LOGIN:$TESTWEB/vue_frontend/" | ||||
| rsync -ave ssh seminar/static/seminar/vue "$GIMLI_LOGIN:$TESTWEB/seminar/static/seminar/" | ||||
| ssh "$GIMLI_LOGIN" " | ||||
| 	set -euxo pipefail | ||||
| 	cd $TESTWEB | ||||
| 	. make/lib.sh | ||||
| 	ensure_venv | ||||
| 	./manage.py collectstatic --noinput | ||||
| 	" | ||||
Some files were not shown because too many files have changed in this diff Show more
		Loading…
	
		Reference in a new issue