Paczuj
Z UMP
d (→Przykładowa sesja) |
d (HUNK succeed - ostrzeżenie) |
||
Linia 244: | Linia 244: | ||
HUNK succeed ... | HUNK succeed ... | ||
Diff został dodany, jednak z pewnym przesunięciem wynikającym z wcześniejszych zmian innych edytorów. Czyli nie został dopisany w linii '''N''', ale '''N+Y'''. | Diff został dodany, jednak z pewnym przesunięciem wynikającym z wcześniejszych zmian innych edytorów. Czyli nie został dopisany w linii '''N''', ale '''N+Y'''. | ||
+ | |||
+ | W większości przypadków takie przesuniecie jest poprawne i pożądane, jednak może się zdarzyć że będzie błędne. W szczególności kiedy diffy zwierają zmianę typu dróg bez zmiany jej przebiegu. | ||
HUNK failed ... | HUNK failed ... | ||
Diff nie został dodany - CVS stwierdził, że zmiana ma już miejsce lub nie może być zaaplikowana - odrzucone zmiany są zapisywane w plikach '''rej''' w katalogu źródeł. | Diff nie został dodany - CVS stwierdził, że zmiana ma już miejsce lub nie może być zaaplikowana - odrzucone zmiany są zapisywane w plikach '''rej''' w katalogu źródeł. |
Wersja z dnia 17:59, 26 lis 2013
W ramach usprawnienia codziennej pracy z diffami z FlySpray powstał mały pomocnik: paczuj.bat
Uwaga!
Narzędzie jest dla tych, co mają prawa zapisu i mogą wysłać poprawki bezpośrednio na serwer.
Spis treści |
Czego potrzebuje
- Działające środowisko UMP (Windows)
- Prawa zapisu do CSV
- Pliki diff.txt umieszczone w katalogu UMP-OBSZAR (nie w UMP-OBSZAR\src)
- Połączenie z siecią (aktualizacja)
Jak wykorzystać
Wgraj pliki diff i _nowosci do katalogu UMP-Obszar (jeżeli używałeś mont-demont.bat już masz te pliki w odpowiednim miejscu). Uruchom paczuj.bat w tym katalogu.
Napisy w oknie podpowiedzą co dalej. Twoje działania to czytanie komunikatów i naciskanie np: spacji lub zamknięcie tego okna [x] w przypadku jakiegoś błędu.
ME zostanie uruchomiony z kolorowym podświetleniem (znaczenie niżej) i flagami błędów.
Znaczenie kolorów
- czerwony - rzeczy usunięte,
- zielony - dodane,
- niebieski - i takie, którym nie zmienił się przebieg, a tylko opis,
- żółty - dane z pliku mp, najczęściej _nowosci.txt.
Co robi (po kolei)
- Uaktualnia narzędzia i OBSZAR
- Tworzy jeden plik wszystko.patch
- Próbuje zaaplikować łaty bez modyfikacji i wypisuje co by robił: poprawnie to patching i fuzzy, jeżeli jest coś źle, zamknij okno lub wciśnij <CTRL+C>, opisz na FS, że diffy są za stare.
- Aplikuje pliki diff (na tym etapie zmiany są już w UMP-OBSZAR\src)
- Montuje mapę dla mapedita i sprawdza błędy
- Uruchamia mapedita z mapą, na której widać zmiany i dodane są flagi z błędami
- Po zamknięciu Mapedita sprawdza czy są jakieś zmiany i jeżeli nie ma uruchamia cvs commit
- Koniec
Stare diffy
Po wykryciu ze diffy są za stare (punkt 3), powinieneś przerwać pracę paczuja. Masz już wygenerowane podświetlenie. Możesz zobaczyć co autor diffa miał na myśli, montując źródła w standardowy sposób i dodając pliki old.plt, new.plt, chg.plt, nowosc.plt (niekoniecznie wszystkie one istnieją). Często przy małych zmianach można samemu ręcznie wprowadzić poprawki na podstawie podświetlenia.
paczuj-granice.bat
Na podobnej zasadzie co paczuj.bat, działa inny ułatwiacz do wprowadzania granic paczuj-granice.bat. Wymaga przeniesienia pliku granice-wspolne.diff.txt do katalogu narzedzia/ i uruchomienia, dalej czytanie komunikatów i naciskanie spacji (tym razem nie uruchamia się ME) i wpisanie opisu dla zmian w cvs
paczuj.bat w UMP-radary
wymaga przekopiowania odpowiednich diffów do katalogu UMP-radary/ następnie należy uruchomić paczuja.
Niestety cvs commit trzeba wywołać samemu.
Przykładowa sesja
Przkładowa sesja paczuj - gdy kilka diffów zostało podrzuconych przez osobę bez uprawnień. Wykonana aktualizacja źródeł, wyrzucone śmiecie, tylko diffy i źródła.
Pobieranie aktualizacji, prosze czekac... cvs update: Updating narzedzia cvs update: Updating narzedzia/android cvs update: Updating narzedzia/ikonki cvs update: Updating narzedzia/ikonki/punkty cvs update: Updating narzedzia/install cvs update: Updating narzedzia/lua cvs update: Updating narzedzia/misc cvs update: Updating narzedzia/netgen.src cvs update: Updating narzedzia/opisy cvs update: Updating narzedzia/ump-www cvs update: Updating narzedzia/ump-www/html cvs update: Updating narzedzia/ump-www/html/css cvs update: Updating narzedzia/ump-www/html/js cvs update: Updating narzedzia/ump-www/mapnik_style cvs update: Updating narzedzia/ump-www/mapnik_style/settings cvs update: Updating narzedzia/ump-www/mapnik_style/symbols cvs update: Updating narzedzia/ump-www/mapnik_style/symbols_me cvs update: Updating narzedzia/ump-www/mapnik_style/symbols_ump cvs update: Updating narzedzia/ump-www/mapnik_style/world_boundaries cvs update: Updating narzedzia/ump-www/ump2osm cvs update: Updating narzedzia/ump-www/ump2osm/polygon_cleaner cvs update: Updating narzedzia/ump-www/ump2osm/src cvs update: Updating narzedzia/ump-www/ump2osm/wojek cvs update: Updating narzedzia/widzimisie cvs update: dying gasps from cvs.ump.waw.pl unexpected cvs update: Updating UMP-radary cvs update: Updating UMP-radary/bmp cvs update: Updating UMP-radary/bmp/Kontrole Drogowe cvs update: Updating UMP-radary/bmp/Niebezpieczne Miejsca cvs update: Updating UMP-radary/bmp/Przejazdy Kolejowe cvs update: Updating UMP-radary/bmp/Slupki cvs update: Updating UMP-radary/mp3-Agatka cvs update: Updating UMP-radary/mp3-Agatka/Kontrole Drogowe cvs update: Updating UMP-radary/mp3-Agatka/Niebezpieczne Miejsca cvs update: Updating UMP-radary/mp3-Agatka/Przejazdy Kolejowe cvs update: Updating UMP-radary/mp3-Agatka/Slupki cvs update: Updating UMP-radary/mp3-Jacek cvs update: Updating UMP-radary/mp3-Jacek/Kontrole Drogowe cvs update: Updating UMP-radary/mp3-Jacek/Niebezpieczne Miejsca cvs update: Updating UMP-radary/mp3-Jacek/Przejazdy Kolejowe cvs update: Updating UMP-radary/mp3-Jacek/Slupki cvs update: Updating UMP-radary/src cvs update: Updating UMP-radary/wav-Agatka cvs update: Updating UMP-radary/wav-Agatka/Kontrole Drogowe cvs update: Updating UMP-radary/wav-Agatka/Niebezpieczne Miejsca cvs update: Updating UMP-radary/wav-Agatka/Przejazdy Kolejowe cvs update: Updating UMP-radary/wav-Jacek cvs update: Updating UMP-radary/wav-Jacek/Kontrole Drogowe cvs update: Updating UMP-radary/wav-Jacek/Niebezpieczne Miejsca cvs update: Updating UMP-radary/wav-Jacek/Przejazdy Kolejowe cvs update: Updating UMP-radary/wav-Jacek/Slupki cvs update: dying gasps from cvs.ump.waw.pl unexpected patching file `WARSZAWA.dzielnice.topo.txt' patching file `WARSZAWA.granice.txt' patching file `WARSZAWA.kolej.txt' patching file `WARSZAWA.obszary.txt' patching file `WARSZAWA.topo.txt' patching file `WARSZAWA.zielone.txt' patching file `WARSZAWA_REMBERTOW.budynki.txt' patching file `WARSZAWA_REMBERTOW.ulice.txt' patching file `WOLOMIN.drogi.txt' patching file `ZIELONKA.ulice.txt' patching file `POI-Warszawa.debug.pnt' patching file `POI-Warszawa.szkoly.pnt' To suchy przebieg (bez zmian) Jak cos sie nie powiodlo - wcisnij CTRL+C lub zamknij to okno Press any key to continue . . . patching file `WARSZAWA.dzielnice.topo.txt' patching file `WARSZAWA.granice.txt' patching file `WARSZAWA.kolej.txt' patching file `WARSZAWA.obszary.txt' patching file `WARSZAWA.topo.txt' patching file `WARSZAWA.zielone.txt' patching file `WARSZAWA_REMBERTOW.budynki.txt' patching file `WARSZAWA_REMBERTOW.ulice.txt' patching file `WOLOMIN.drogi.txt' patching file `ZIELONKA.ulice.txt' patching file `POI-Warszawa.debug.pnt' patching file `POI-Warszawa.szkoly.pnt' Zmiany zostaly wprowadzone Press any key to continue . . . Skladanie mapy. wersja przenosna - obowiazuje od 16.6.2013 Wybrano: MONTAZ Granice: tylko jednego obszaru (Warszawa). Montuje ulice i obszary... Montuje punkty z pnt... Dolaczam punkty radarow Gotowy do edycji! Uruchamianie "netgen2.bat" Warszawa Do zrobienia: - analiza podstawowa plik do analizy: Warszawa-wynik.mp === Analiza podstawowa --- analiza pliku .mp --- analiza siatki drog Statystyka dziury_w_routingu 163 slepe 3 za_bliskie 4 zle_postawione_bojki 9 bledy_routingu 1 przeciecia 1 Sprawdzam punkty adresowe Summary: Mix/Par/End: 0, Node: 0, eNode: 0, NoLabel: 0, Other: 0 Gotowe! wersja przenosna - obowiazuje od 16.6.2013 Wybrano: EDYCJA
Teraz następuje edycja - do czasu zamknięcia MapEdit okno się nie zmieni.
Po zamknięciu MapEdit następuje rozłożenie obszaru
Rozkladam wszystko... Zamieniam punkty... Sprawdzam zmiany w plikach... Przejrzyj WARSZAWA_REMBERTOW.budynki.txt.diff.txt Przejrzyj WARSZAWA_REMBERTOW.ulice.txt.diff.txt Przejrzyj WARSZAWA_WAWER.ulice.txt.diff.txt Plik GATSO_FP.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik GATSO_FS.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik GATSO_SU.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Przejrzyj POI-Warszawa.debug.pnt.diff.pnt Plik safety_NM.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik safety_PK.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik safety_slupki.pnt do obejrzenia (zmieniony albo nie ma zawartosci) ############################################################################# Wykryto nowe diffy po przebiegu!!! Uruchom paczuj jeszcze raz
Efekt rozłożenia:
- 4 diffy WARSZAWA_REMBERTOW.budynki.txt.diff.txt, WARSZAWA_REMBERTOW.ulice.txt.diff.txt, WARSZAWA_WAWER.ulice.txt.diff.txt, POI-Warszawa.debug.pnt.diff.pnt
- 4 pliki źródłowe - WARSZAWA_REMBERTOW.budynki.txt, WARSZAWA_REMBERTOW.ulice.txt, WARSZAWA_WAWER.ulice.txt, POI-Warszawa.debug.pnt
Komunikaty o plikach słupków/radarów są tylko informacją o czymś, co nie uległo zmianie. Na koniec wyraźna sugestia, by uruchomić ponownie paczuj, bo są diffy po zamknięciu MapEdit (poprawki błędów, uproszczenia budynków wykonane przez MapEdit). Ponowne uruchomienie - aplikacja powstałych diffów - przejrzenie w MapEdit, zamknięcie MapEdit już bez zmian (bo jest ok) i wynik działania paczuj, gdy nic się nie zmienia:
Rozkladam wszystko... Zamieniam punkty... Sprawdzam zmiany w plikach... Plik GATSO_FP.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik GATSO_FS.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik GATSO_SU.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik safety_NM.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik safety_PK.pnt do obejrzenia (zmieniony albo nie ma zawartosci) Plik safety_slupki.pnt do obejrzenia (zmieniony albo nie ma zawartosci) ############################################################################# Nie wykryto dodatkowych zmian po przebiegu Zostanie uruchominy cvs commit, zamknij to okno je┐eli tego NIE chcesz Press any key to continue . . . cvs commit: Examining src
W wersji tekstowej cvs następuje otwarcie okna edytora, wpisujemy komentarz do sesji, zamykamy okno zapisując komentarz i dane lecą na serwer o ile nie ma konfliktu.
Błędy i ostrzeżenia podczas używania paczuj.bat
Normalne komunikaty są poniżej:
patching file `TORUN.ulice.txt' patching file `TORUN.zielone.txt' patching file `POI-Torun.debug.pnt'
Błędy podczas paczuj.bat mogą pojawić się w następujących sytuacjach:
- ktoś w tym samym momencie rysuje w tym samym obszarze i edytuje te same obiekty
- wrzucając czyjeś diffy ktoś dokonał zmian w tym samym obszarze już po wygenerowaniu diffów
- diffy mają błędny format - ktoś ręcznie coś poprawiał dodając linię
Błędy/ostrzeżenia z którymi się spotkasz to:
HUNK succeed ...
Diff został dodany, jednak z pewnym przesunięciem wynikającym z wcześniejszych zmian innych edytorów. Czyli nie został dopisany w linii N, ale N+Y.
W większości przypadków takie przesuniecie jest poprawne i pożądane, jednak może się zdarzyć że będzie błędne. W szczególności kiedy diffy zwierają zmianę typu dróg bez zmiany jej przebiegu.
HUNK failed ...
Diff nie został dodany - CVS stwierdził, że zmiana ma już miejsce lub nie może być zaaplikowana - odrzucone zmiany są zapisywane w plikach rej w katalogu źródeł.