Senko’s corner of the Web

Domaća mobile developer scena zahuktala se u posljednjih par mjeseci. Uz pokretanje Mobile Mondaya, tu su i VIPNet Android Izazov te Budi kreaTivan 2010 natječaji koji su izazvali razmjerno velik interes potencijalnih developera.

Kao rezultat toga, na Android Marketu pojavljuje se sve više domaćih aplikacija, većinom lokalnog karaktera. Kako zapravo ne postoji način za saznati otkud su autori pojedine aplikacije i koliko je aplikacija iz Hrvatske, tijekom posljednjih nekoliko dana bilježio sam domaće aplikacije na koje sam naišao, skupio ih u listu, te vam sada ponosno predstavljam svjetsku premijeru najveće i jedine liste domaćih Android aplikacija:

• Advanced Call History – praćenje poziva i generiranje izvješća na osnovu prikupljenih podataka.
• aMazing Submarine – vodite podmornicu kroz labirint, sakupljajte blago i izbjegavajte ribe
• ATFLOCK – zaključajte telefon za slučaj krađe
• Aukcije.hr Mobile – pregled najnovijih aukcija na stranicama Aukcije.hr te pregled aktualnih kupnji i prodaje predmeta u aukcijama u kojima korisnik sudjeluje
• BankoMap – prikaz lokacije bankomata (zasad samo PBZ) u Zagrebu koristeći Google Maps
• Bela Brojalica – aplikacija za zbrajanje osvojenih bodova u Belotu za četiri igrača
• Belo zbrajalo – zbrajanje bodova i pregled stanja u Beli
• Brick Annoyed – klon klasične arkadne igre
• Burza.ZG – trenutne cijene dionica na Zagrebačkoj Burzi
• Buzdo, swinging mace – simulacija klatna, koristi akcelerometar za kontrolu
• Croatian keyboard – hrvatska tipkovnica za Android
• Croatian News Widget – najnovije vijesti iz Hrvatske na home screenu (widget i aplikacija)
• CRO City Info – u par klikova iz vašeg mobitela pronađite sve važne lokacije, druge informacije, prijevoz te mapu pokrivenosti besplatnim Wi-Fi-jem
• CRO Prognoza / Weather – sedmodnevna vremenska prognoza za više od 40 hrvatskih gradova
• Cro Tourist Guide – pretraživanje turističkih odredišta i smještaja u Hrvatskoj (vuče podatke sa www.crotouristguide.com)
• Crypto – aplikacija za kriptiranje slika
• DSSAndroidAutomation – info o kontaktima, nepročitanim porukama, propuštenim pozivima
• DSS Numerologija – izračunajte svoj sretan broj ili provjerite “kompatibilnost” sa simpatijom
• Elevation and Sea Depth – saznajte nadmorsku visinu i dubinu mora u smjeru u kojem usmjerite svoj mobitel
• Gdjesi.com – mobilni klijent za gdjesi.com servis
• GPS Explorer – aplikacija za mjerenje područja i praćenje ruta
• GPS Tracker – praćenje lokacije i slanje podataka na server tracking.virtualniured.hr
• HGSpot Mobile – čitajte vijesti i pretražujte proizvode iz HGSpota
• HNB Exchange Rate – tečaj Hrvatske Narodne Banke
• Hoću u kino! – popis hrvatskih kina i njihov raspored
• Horvat Andro – aplikacija za Android uređaje koja prikazuje najnovije informacije iz hrvatskog internetskog prostora.
• HotFuzz – saznajte što se zbiva u vašem gradu
• HRT Teletext – čitajte najnovije informacije objavljene na HRT teletekstu
• HrStock – pregled burzovnih indeksa regije
• Lociraj! – traženje obližnjih točaka (POI) – mobilni klijent za Lociraj.net
• Lokacijski Alarm – podsjetnik o vama važnim lokacijama, pali se kad ste u blizini neke od njih
• Ljetni Recepti – 20-ak recepata za osvježavajuće napitke koje možete sami napraviti u svega nekoliko minuta
• Meet Croatia – sakupljajte bodove posjećivanjem lokacija u Hrvatskoj
• Meet Friends@Vip – jednostavno organiziranje sastanaka s prijateljima putem poruka, slika, zvučnih zapisa i lokacija te pregleda javnih događaja u blizini
• Mjere (Measures) – ucrtavanje mjera u postojeće slike
• Mobilisis ATM – pronađite najbliži bankomat u Hrvatskoj
• Mobilisis Fleet – pratite lokaciju svojih vozila, zaposlenika ili djece (moraju imati instaliranu Mobilisis Tracker aplikaciju)
• Mobilisis Parking – aplikacija za plaćanje parkinga
• Mobilisis Tracker – aplikacija za praćenje lokacije mobitela (za praćenje treba koristiti Mobilisis Fleet aplikaciju)
• mPlaćanje – brzo i jednostavno plaćanje parkinga, garaže ili javnog gradskog prijevoza putem SMS-a u raznim gradovima Hrvatske
• Novinator – Novinator vam omogućuje pregledavanje vaših omiljenih news portala čak i kada nemate pristup Internetu
• Novine – pratite najnovije vijesti iz nekoliko domaćih portala
• Parking – jednostavno plaćanje parkinga
• Poštanski broj – pregled poštanskih brojeva i ureda unutar Republike Hrvatske.
• Praznik – prikaz hrvatskih praznika i blagdana
• Prepaid status widget – provjeravanje stanja prepaid računa i drugih USSD funkcija
• PrvaPomoc (First Aid) – aplikacija za bilježenje kritičnih informacija kod hitnog slučaja
• Qibla Compass – aplikacija za vjernike muslimanske vjeroispovjesti – vremena molitava te udaljenost i smjer Meke
• Rođoš – omogućava vam da na jednom mjestu vidite sve nadolazede rođendane
• Slooshaj! – aplikacija za slušanje hrvatskih radio stanica putem Interneta
• Slušaj Radio! – slušanje hrvatskih radio stanica putem Interneta
• SMSparking – plaćanje parkinga u preko 50 hrvatskih gradova
• StormWatcher – korištenjem radarske snimke oblaka, aplikacija pokušava predvidjeti nevrijeme
• Teletext – aplikacija za čitanje HRT Teleteksta
• Tele2SMS – aplikacija za besplatno slanje SMSova za Tele2 korisnike (putem online Tele2 usluge besplatnog slanja SMSa)
• This phone is mine! – osvetite se prijateljima koji isprobavaju vaš mobitel
• Trambus – lakše snalaženje u autobusnom i tramvajskom prijevozu Zagreba automatski računajući rute, locirajući najbliže stanice.
• Tramzilla – aplikacija za praćenje tramvajskog prometa
• TransDict – riječnik i prevoditelj
• Transmeet.TV MusicMap – detaljni pregled zanimljivih glazbenih događanja
• Troskovnik – planiranje odlaska u kupovinu i računanje troškova prilikom kupovine
• TVDroid – TV vodič, podržava ~260 TV postaja u Hrvatskoj i široj regiji + satelitski programi
• Tv Guide – prikaz programa hrvatskih TV postaja s mogućnošću odabira kanala, filtriranja i detaljnog pregleda
• TV Raspored – brzi pregled tjednog TV programa
• VIP RoamingViewer – informacije o roaming cijenama, operaterima za korisnike VIPNeta
• VMC application – mobilni klijent za Croatian Vip Music Club portal
• Weather Forecast USA – vremenska prognoza za SAD
• Weekend in Croatia – višejezična aplikacija za pronalaženje vikend/turističkih lokacija (mobilni klijent za vikendi.com)
• Svjetozor / Worldscope – pregledavanje slika s web kamera diljem svijeta
• Young Duke Domagoj – preživite što duže dok vas napada horda zombija
• Zagreb Tram – prikaz tramvajskih linija, stanica, najbliže stanice, voznog reda, kupnja karte za ZET
• ZETPanic – brzo aktiviranje usluge ZET mPrijevoz
• Žabolomac – žabac iz bajke kroz 30 nivoa i 3 područja treba savladati niz izazova kako bi došao do svoje princeze

Napomene: Oneliner opisi pojedine aplikacije preuzeti su iz njenog opisa u Marketu, uz ponegdje slobodan prijevod sa engleskog i skraćivanje/parafraziranje opisa – ako uočite bilo koju grešku ili smatrate da sam krivo prepričao opis, ili ste našli aplikaciju koju ja nisam pa je nema u popisu, molim vas da mi javite. Također, većinu ovih aplikacija nisam isprobao, a i za one koje jesam, ovdje ne donosim svoj sud, mišljenje ili preporuku. Prilikom isprobavanja pojedine aplikacije, preporučam pročitati komentare na Marketu (te dati i vlastiti komentar/ocjenu, čime ćete autoru aplikacije dati dragocijeni feedback za daljnji razvoj iste).

Update: dodane aplikacije: Žabolomac, aMazing Submarine, HrStock, Meet Croatia, Tv Guide, Mobilisis (ATM, Fleet, Parking, Tracker), Praznik, Rođoš, VMC application, Hoću u kino!, Gdjesi.com, Tele2SMS. Maknut Columbus (slovačka aplikacija).

Update2: dodani HRT Teletext, HotFuzz, Transmeet.TV MusicMap, Worldscope

Update3: dodani Elevation and Sea Depth, Qibla Compass, Weather Forecast USA.

Prošli tjedan je Google na svojoj IO konferenciji objavio kako će svoj VP8 video kodek učiniti dostupnim svima pod slobodnim licencama. Samu objavu podržao je veliki broj organizacija i firmi, među ostalima Mozilla, Opera, Adobe, donekle Microsoft, kao i neki proizvođači hardvera – nVidia, ARM, AMD, Texas Instruments.

Posebnost objave je to da je VP8 ne samo kvalitetan (kvalitetniji od H.263, Theore ili Flash videa) i besplatan (odnosno enkoder/dekoder i specifikacija su potpuno otvoreni i slobodni za korištenje) nego je i neopterećen patentima. Točnije, Google kaže da je u posjedu svih patenata koje VP8 koristi, kao i da te patente daje u slobodno korištenje svim korisnicima VP8 kodeka. U praksi ovo znači da bilo tko može koristiti kodek (bilo za kreiranje sadržaja, distribuciju, ili samo gledanje) bez da ima obavezu bilo kome bilo što plaćati.

Worse is better?

To ga čini puno privlačnijim (sa pravno/ekonomske strane) od H.264, trenutno najzastupljenijeg (ako ne računamo ne-hd Flash videe, koji koriste stariji i lošiji kodek) kodeka za web video. H.264 je tehnološki bolji od VP8, ali je opterećen patentima. MPEG-LA, organizacija koja zastupa vlasnike patenata koje koristi H.264 trenutno dozvoljava njegovo korištenje uz prilično liberalne uvjete, ali vrlo je vjerojatno da će ih pooštriti (tj. početi naplaćivati) kad zaključi da joj se to isplati – odnosno čeka da većina sadržaja bude u H.264 i da ga svi koriste, pa će onda samo ubirati svoj dio.

Iscrpnu usporedbu tehničkih karakteristika oba kodeka napravio je Jason Garrett-Glaser, glavni developer na x.264 (open source H.264 enkoder, vjerojatno najbolji na svijetu). Njegov zaključak je kako je VP8 tu negdje po kvaliteti kao osnovna verzija H.264 (tzv. Baseline Profile, inačica koja se većinom koristi u mobilnim uređajima), dok su naprednije verzije H.264 puno bolje od VP8 (dakle, nećemo uskoro gledati 1080p filmove u VP8 kodeku). Također kaže da su sami enkoder i dekoder trenutačno prilično ne-optimalni, za što je realnio zaključiti da će se popraviti s vremenom.

Jason također tvrdi da su VP8 i H.264 zapravo vrlo slični – toliko slični da je moguće da VP8 ipak krši patente iz H.264. Njegovo mišljenje također dijeli i Steve Jobs, iako je za vjerovati da je to Jobsov primarno politički stav (Apple svugdje koristi H.264, jedan je od vlasnika patenata nad njim, i nikako im ne odgovara da svi ostali pređu na VP8).

Rat patenata

S druge strane, prilično je teško vjerovati da brojni odvjetnici Googlea i ostalih firmi koje ga podržavaju u ovome projektu nisu vrlo pažljivo pregledali svaki komadić kodeka i uvjerili se da nema opasnosti. Softverski patenti su vrlo specifični – da bi se dokazalo da netko koristi tuđi patent, potrebno je dokazati da precizno radi točno ono što piše u patentu. Kod H.264 stvar je čista, jer sam standard specificira točno one stvari koje su i u patentima. Ali kod VP8, ako je on samo “sličan”, ne mora značiti da krši bilo što. Dapače, lako je moguće da su očiti nedostaci VP8 u odnosu na H.264 izostavljeni baš zato kako bi se zaobišli patenti.

Naravno, MPEG-LA je već najavila pripremanje “patent poola” i analizu VP8 kako bi ustanovila koji su patenti prekršeni. Ali njihovu izjavu treba shvatiti u kontekstu toga da se oni samo tim i bave, i već godinama najavljuju da će krenuti u pohod na Vorbis (slobodni i otvoreni audio kodek) zbog povrede neimenovanih patenata, pa još nisu. S druge strane, Google se drži prilično samouvjereno, i već je najavio da će svi sadržaji na YouTube-u biti rekodirani u VP8.

Ono čemu se mnogi nadaju i što bi svakako zacementiralo sigurnost u VP8 je Googleova izjava da će na sebe preuzeti sav rizik od eventualne tužbe za povredu patenata – no teško je vjerovati da bi se Google želio toliko izložiti, bez obzira na to koliko su samouvjereni. U nedostatku toga, vrijeme će pokazati koliko su strahovi oko VP8 utemeljeni. U svakom slučaju, zanimljiva su vremena za web <video/> pred nama.

PS. VP8 podrška dostupna je već za brojne free software multimedia projekte, među kojima su GStreamer, FFMpeg, MPlayer, VLC, itd. Više informacija kako gledati VP8 sadržaje može se naći na stranicama WebM projekta. I hrvatski web može se pohvaliti eksperimentalnom podrškom za VP8 na CARNet Media on Demand portalu.

U prošlom postu u Git serijalu spomenuli smo mogućnost konflikata prilikom rebaziranja ili spajanja grana te dali par sugestija kako ih izbjeći. No kod kompliciranijih projekata i workflowova konflikti su ponekad neizbježni, stoga je korisno znati kako riješiti konflikt kad do njega dođe.

Rješavanje konflikata

Ukoliko sami radite na projektu, konflikti vam se vjerojatno neće događati (osim ukoliko ne pazite). No, ukoliko radite na projektu sa više ljudi, može vam se zadesiti da se nađete u situaciji gdje ćete morati riješiti konflikt.

Recimo da je naš helloworld projekt dobio na važnosti i sada na njemu rade dva developera, Mirko i Slavko. Mirko i Slavko u stvarnom životu radit će na svojim granama u svojim klonovima repozitorija, ali da si ovdje pojednostavnimo priču, svaki će imati po jednu granu u našem zajedničkom repozitoriju.

Kreirajmo obje grane, bez prebacivanja u njih:

> git checkout master
Switched to branch 'master'

> git branch mirko
> git branch slavko
> git branch -l
  helloworld-0
* master
  mirko
  slavko

Dolazi Mirko, vidi problem u načinu kako je definirana funkcija main i popravlja ga u svojoj grani:

> git checkout mirko
Switched to branch 'mirko'

[...promjene hello.c...]

> git diff
diff --git a/hello.c b/hello.c
index 0bb4941..8b08068 100644
--- a/hello.c
+++ b/hello.c
@@ -1,6 +1,7 @@
 #include <stdio.h>

-int main(void)
+int
+main(int argc, char *argv[])
 {
   printf("Hello world\n");
   return 0;

> git commit -a -m "popravio main prototip"
[mirko 4e5f904] popravio main prototip
 1 files changed, 2 insertions(+), 1 deletions(-)

U međuvremenu, dolazi Slavko, vidi isti problem, ne zna da je Mirko radio na istoj stvari pa ga rješava kod sebe:

> git checkout slavko
Switched to branch 'slavko'

[...promjene hello.c...]

> git diff
diff --git a/hello.c b/hello.c
index 0bb4941..38586b0 100644
--- a/hello.c
+++ b/hello.c
@@ -1,6 +1,6 @@
 #include <stdio.h>

-int main(void)
+int main(int argc, char **argv)
 {
   printf("Hello world\n");
   return 0;

> git commit -a -m "prepravio definiciju funkcije main"
[slavko 4bb59be] prepravio definiciju funkcije main
 1 files changed, 1 insertions(+), 1 deletions(-)

Sve je dobro dok su promjene u zasebnim granama. No u jednom trenu ćemo željeti sve Mirkove i Slavkove promjene spojiti u master. Prva promjena će proći dobro, no na drugoj će nam se dogoditi konflikt.

> git checkout master
Switched to branch 'master'

> git merge mirko
git merge mirko
Updating 302ef80..4e5f904
Fast-forward
 hello.c |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

> git merge slavko
git merge slavko
Auto-merging hello.c
CONFLICT (content): Merge conflict in hello.c
Automatic merge failed; fix conflicts and then commit the result.

Uh, huh… obojica su mijenjala isto mjesto u istoj datoteci, i git ne zna kako riješiti problem. Zbog toga je merge pauziran i dana nam je prilika da riješimo konflikt. Pogledajmo što se dogodilo:

git diff
diff --cc hello.c
index 8b08068,38586b0..0000000
--- a/hello.c
+++ b/hello.c
@@@ -1,7 -1,6 +1,11 @@@
  #include <stdio.h>

++<<<<<<< HEAD
 +int
 +main(int argc, char *argv[])
++=======
+ int main(int argc, char **argv)
++>>>>>>> slavko
  {
    printf("Hello world\n");
    return 0;

> cat hello.c
#include <stdio.h>

<<<<<<< HEAD
int
main(int argc, char *argv[])
=======
int main(int argc, char **argv)
>>>>>>> slavko
{
  printf("Hello world\n");
  return 0;
}

Diff prikazuje obje nekompatibilne promjene. Prva je iz trenutne grane (odnosno to je ona Mirkova promjena koju smo uspješno preuzeli spajanjem Mirkove grane), dok je druga iz grane slavko. Rješimo konflikt modificiranjem tog dijela datoteke da izgleda onako kako mi želimo:

[...promjene hello.c...]
cat hello.c
#include <stdio.h>

int
main(int argc, char **argv)
{
  printf("Hello world\n");
  return 0;
}

> git diff
diff --cc hello.c
index 8b08068,38586b0..0000000
--- a/hello.c
+++ b/hello.c
@@@ -1,7 -1,6 +1,7 @@@
  #include <<tdio.h>

 -int main(int argc, char **argv)
 +int
- main(int argc, char *argv[])
++main(int argc, char **argv)
  {
    printf("Hello world\n");
    return 0;

> git add hello.c
> git commit
[master fd96bab] Merge branch 'slavko'

Diff prikaz u slučaju konflikata je pomalo zbunjujuć, no snalaženje u samoj datoteci koju treba popraviti je relativno jednostavno - konflikt je između <<<<<<< i >>>>>>>, a ======= razdvaja konfliktne promjene.

Konflikt prilikom rebaziranja

Kao što smo već prije vidjeli, obično želimo grane održavati tako da u svakom trenu njihove promjene budu primjenjive na master (odnosno na baznu granu gdje ih na kraju želimo spojiti), a jedan od razloga je upravo izbjegavanje konflikata kod spajanja.

Jedan od razloga zbog kojih je konflikt kod spajanja nezgodan je i činjenica da problem praktički "prebacujemo" onom tko radi merge, a kod većih projekata to je obično osoba koja održava projekt (tj. glavni developer). Ukoliko od nje tražite da granu sa vašim promjenama spaja sa masterom, a to izaziva konflikte kod mergea, zapravo ste prilično nepristojni.

Zato je bolje prije nego zatražite (ili krenete raditi) spajanje rebazirati svoju granu tako da samo spajanje bude čisto. To znači da ćete eventualne konflikte morati sami rješiti prilikom rebaziranja.

Vratimo se malo u prošlost i zaboravimo da smo radili merge Mirkove i Slavkove grane:

> git reset --hard 302ef80039bd55fbbc680d84e37e5ebcf7f63a5c
HEAD is now at 302ef80 dodan README

Mirko odluči spojiti svoju granu s masterom. Njegovu granu nije potrebno rebazirati jer se nastavlja na master (tj master nema nikakvih novih promjena):

> git merge mirko
Updating 302ef80..4e5f904
Fast-forward
 hello.c |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

Slavko odluči spojiti svoju granu. Njegovu granu je potrebno rebazirati jer
master ima novih comittova:

> git checkout slavko
Switched to branch 'slavko'

> git rebase master
First, rewinding head to replay your work on top of it...
Applying: prepravio definiciju funkcije main
Using index info to reconstruct a base tree...
Falling back to patching base and 3-way merge...
Auto-merging hello.c
CONFLICT (content): Merge conflict in hello.c
Failed to merge in the changes.
Patch failed at 0001 prepravio definiciju funkcije main

When you have resolved this problem run "git rebase --continue".
If you would prefer to skip this patch, instead run "git rebase --skip".
To restore the original branch and stop rebasing run "git rebase --abort".

Ovo izgleda mnogo strašnije nego poruka kod mergea! Ali problem je isti, u što se možemo uvjeriti pomoću git diff (s tim da će umjesto imena naše grane biti naziv commita u našoj grani s kojim ima problema). Nakon što napravimo ispravke u datoteci, trebamo nastaviti proces rebaziranja:

[...promjene hello.c...]
> git add hello.c
> git rebase --continue
Applying: prepravio definiciju funkcije main

Ovdje nismo ručno radili git commit, nego smo nakon popravka nastavili proces rebaziranja. Kako rebaziranje ide commit po commit, ukoliko ima još konflikata u narednim commitovima, rebase bi se opet zaustavio i zatražio da popravimo stvari.

Ukoliko zaključimo da je commit nepotreban (npr. zato što je u drugoj grani taj problem već riješen), možemo ga odbaciti. Ako se radi o ozbiljnom problemu za kojeg ne znamo kako ga riješiti, možemo prekinuti rebase, a grana će nam se vratiti u prvobitno stanje. U tom slučaju ćemo vjerojatno morati rješavati merge konflikte prilikom spajanja i napraviti merge a ne rebase.

Imagine you’ve seen a blog post titled Free linux-like kernel sources for x86-64 PC’s with the following contents:

Do you pine for the nice days of linux 2.4, when men were men and wrote
their own device drivers? Are you without a nice project and just dying
to cut your teeth on a OS you can try to modify for your needs? Are you
finding it frustrating when everything works on linux? No more all-
nighters to get a nifty program working? Then this post might be just
for you :-)

As I tweeted a month(?) ago, I’m working on a free version of a
linux-lookalike for x86-64 computers. It has finally reached the stage
where it’s even usable (though may not be depending on what you want),
and I am willing to put out the sources for wider distribution. It is
just version 0.02 (+1 (very small) patch already), but I’ve successfully
run bash/gcc/gnu-make/gnu-sed/compress etc under it.

Sources for this pet project of mine can be found on github. The repo also
contains some README-file and a couple of binaries to work under it
(bash, update and gcc, what more can you ask for :-). Full kernel
source is provided, as no linux code has been used. Library sources are
only partially free, so that cannot be distributed currently. The
system is able to compile “as-is” and has been known to work. Heh.
Sources to the binaries (bash and gcc) can be found at the same place.

ALERT! WARNING! NOTE! These sources still need linux to be compiled
(and gcc, possibly gcc4, haven’t tested), and you need linux to
set it up if you want to run it, so it is not yet a standalone system
for those of you without linux. I’m working on it. You also need to be
something of a hacker to set it up (?), so for those hoping for an
alternative to linux, please ignore me. It is currently meant for
hackers interested in operating systems and x86-64′s with access to linux.

The system needs an IDE harddisk (sorry) and any VGA card. If
you are still interested, please read my blog post about it, and/or ask me
on Twitter for additinal info.

I can (well, almost) hear you asking yourselves “why?”. Next year (or the
one after it who knows) will be The Year Of Linux Desktop, and I’ve already got
Ubuntu. This is a program for hackers by a hacker. I’ve enjouyed doing
it, and somebody might enjoy looking at it and even modifying it for
their own needs. It is still small enough to understand, use and
modify, and I’m looking forward to any comments you might have.

Does this sound familiar to you? If you know your Linux history, is should – it’s a ripoff of the original Linux announcement post that Linus posted to the comp.os.minix newsgroup.

A few points to consider:

• look what a crazy (in a positive way) guy’s hobby did to the computer industry
• is kernel programming still fun? should it be? is it serious work now?
• is there still fun to be had in non-web related stuff?

Nakon što smo u prošlom postu proučili kako raditi grananje, spajanje i rebaziranje grana, git nam već može biti poprilično koristan alat. Kako projekt raste, git nam može pomoći da ne izgubimo glavu u različitim granama i verzijama koje održavamo unutar jednog projekta.

Interaktivno dodavanje promjena

Prilikom rada na projektu, često ćemo da bi stvar uopće natjerali da radi morati napraviti nekoliko nezavisnih promjena, a tek onda biti sigurni da smo dobili dobar rezultat. Obično tek tada želimo napraviti commit, ali bismo htjeli da nezavisne promjene idu u nezavisne commitove. Ako se te promjene nalaze u istoj datoteci, običan git add nam ne pomaže jer bi on označio cijelu datoteku za commit.

U tom slučaju možemo koristiti interaktivno dodavanje. Ono nam pruža veću kontrolu nad time što dodajemo u commit, a i preglednije je (i pruža nam priliku za review napravljenoga prije commitanja), pa preporučam da ga uvijek koristite, čak i kad želite dodati sve promjene.

Recimo da smo napravili dvije nezavisne izmjene u hello.c. datoteci i želimo ih committati odvojeno (primjer radim u novoj test grani koju ću kasnije obrisati):

> git checkout -b test
Switched to a new branch 'test'

> git diff
diff --git a/hello.c b/hello.c
index 0bb4941..d560074 100644
--- a/hello.c
+++ b/hello.c
@@ -1,3 +1,4 @@
+#include <stdlib.h>
 #include <stdio.h>

 int main(void)
@@ -5,3 +6,9 @@ int main(void)
   printf("Hello world\n");
   return 0;
 }
+
+void unused(void)
+{
+  puts("I'm never used");
+}
+

> git add -p
diff --git a/hello.c b/hello.c
index 0bb4941..d560074 100644
--- a/hello.c
+++ b/hello.c
@@ -1,3 +1,4 @@
+#include 
 #include 

 int main(void)
Stage this hunk [y,n,q,a,d,/,j,J,g,e,?]? y
@@ -5,3 +6,9 @@ int main(void)
   printf("Hello world\n");
   return 0;
 }
+
+void unused(void)
+{
+  puts("I'm never used");
+}
+
Stage this hunk [y,n,q,a,d,/,K,g,e,?]? n

Ovo će označiti (tj. spremiti u index) samo prvu promjenu u datoteci za committanje. To možemo provjeriti sa git diff --cached:

git diff --cached
diff --git a/hello.c b/hello.c
index 0bb4941..c6efc61 100644
--- a/hello.c
+++ b/hello.c
@@ -1,3 +1,4 @@
+#include <stdlib.h>
 #include <stdio.h>

 int main(void)

Pregled promjena u datotekama

Nakon što neko vrijeme radite na projektu, većina datoteka unutar projekta
vjerojatno će biti mijenjana mnogo puta. Kako bi vidjeli koje promjene smo radili
nad jednom datotekom (ili direktorijem), možemo koristiti još jedan oblik
već poznate git log naredbe:

> git log hello.c
commit 5e547517e1a29a08b3594f6b8c8c0a289070376d
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 06:31:05 2010 +0100
popravljen kod

commit 04f3667425705d29f2c3a10bb45e79f5cc6b7d7d
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 05:49:59 2010 +0100
malo uljepsano

commit 6e70237aaa84a0c8ff74bd0fad6cccb4d118b695
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 05:49:03 2010 +0100
prva verzija

Ovaj ispis dobar je ako želimo kronološki pregled promjena. No često je slučaj
da nas zanima zašto je baš neki dio (trenutne) datoteke napisan tako je, tj. koji
je razlog za dodavanje (ili promjenu) pojedine linije unutar koda.

Pregled promjena po pojedinim linijama datoteke omogućuje nam git blame,
tako nazvan jer nam govori tko je odgovoran za pojedinu liniju datoteke i zašto:

> git blame hello.c
5e547517 (Senko Rasic 2010-01-23 06:31:05 +0100 1) #include <stdio.h>
5e547517 (Senko Rasic 2010-01-23 06:31:05 +0100 2)
5e547517 (Senko Rasic 2010-01-23 06:31:05 +0100 3) int main(void)
04f36674 (Senko Rasic 2010-01-23 05:49:59 +0100 4) {
04f36674 (Senko Rasic 2010-01-23 05:49:59 +0100 5)   printf("Hello world\n");
5e547517 (Senko Rasic 2010-01-23 06:31:05 +0100 6)   return 0;
04f36674 (Senko Rasic 2010-01-23 05:49:59 +0100 7) }

Popis za svaku liniju sadrži skraćeni ID commita, autora te datum promjene.
Nakon što identificiramo promjenu koja nas zanima, pomoću već poznate
git show naredbe možemo vidjeti i ostale detalje te promjene.

Označavanje (tagiranje) commitova

Naš “Hello World” projekt već ima praktički svu funkcionalnost koju želimo,
stoga je pravo vrijeme da napravimo naš prvi release. Osim što možemo napraviti
arhivu izvornog koda (kao tar.gz ili u nekom drugom formatu) i poslati je korisnicima
svog programa, korisno je i u samom repozitoriju označiti da smo napravili
release.

Kako bismo “zapamtili” da smo napravili release, možemo dodati oznaku (tag) na
trenutni commit. Kako svaki commit zna za sve koji su se dogodili prije njega,
ta oznaka poslužit će nam da bi na jednostavan način dolazili do stanja projekta
u raznim fazama razvoja, bez da pamtimo IDeve comittova.

Oznaka (tj. tag) je (pojednostavljeno) najobičniji “alias” na ID commita.
Postavljenu oznaku možemo koristiti praktički svugdje gdje moramo navoditi ID
commita. Možemo ga koristiti kako god želimo – najčešća praksa je obilježavanje
kad se dogodilo nešto značajno u projektu, kao što je release.

Tagirajmo release 0.1 našeg projekta. Kako release radimo iz master
grane, pripazit ćemo ne tagiramo commit u krivoj grani:

> git checkout master
> git tag -m "postavljamo tag" "helloworld-0.1"

tagove možemo pregledavati pomoću git tag -l, a brisati pomoću
git tag -d <ime_taga>.

Prilikom postavljanja oznake, možemo je i kriptografski potpisati (gpg-om,
uz korištenje gpg privatnog ključa za mail adresu koju koristimo kod rada
s repozitorijem), korištenjem opcije -s.

Sretni sa napravljenim releasom, krećemo dalje sa razvojem projekta. Verzija
0.1 je potpun program, ali mu nedostaje build sustav, zbog čega svaki put moramo
ručno pozivati kompilator. Namjera nam je to riješiti korištenjem make
alata.

Kreirajmo konfiguracijsku datoteku za make zvanu Makefile
(napomena: make je izbirljiv glede sintakse, stoga je bitno na određenim mjestima
koristiti tab umjesto razmaka, što je posebno naznačeno u ovom listingu):

CC = gcc
OBJS = hello.o
CFLAGS = -Wall -Werror -O3 -g

.PHONY: all clean

all: hello

hello: $(OBJS)
<tab>$(CC) $(OBJS) -o $@

%.o: %.c
<tab>$(CC) $(CFLAGS) -c $< -o $@

clean:
<tab>rm -f hello $(OBJS)

Dodajmo novostvorenu datoteku u projekt, repozicionirajmo doc granu
(pošto imamo novosti u masteru) i spojimo je natrag u master granu.
Pošto smo završili sa doc granom, na kraju je možemo i obrisati.

> git add Makefile
> git commit -m "dodan Makefile"
master b23a04b] dodan Makefile
 1 files changed, 17 insertions(+), 0 deletions(-)
 create mode 100644 Makefile

> git checkout doc
Switched to branch 'doc'

> git rebase master
First, rewinding head to replay your work on top of it...
Applying: dodan README

> git checkout master
Switched to branch 'master'

> git merge doc
Updating b23a04b..302ef80
Fast-forward
 README.txt |    1 +
 1 files changed, 1 insertions(+), 0 deletions(-)
 create mode 100644 README.txt

> git branch -d doc
Deleted branch doc (was 302ef80).

Pregršt novih promjena! Pogledajmo što smo sve izmjenili od zadnjeg releasea:

< git log helloworld-0.1..HEAD
commit 302ef80039bd55fbbc680d84e37e5ebcf7f63a5c
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 06:06:26 2010 +0100
dodan README

commit b23a04b47dbc1044d44d94ee0a5df967f8f1b26d
Author: Senko Rasic <senko@localhost>
Date:   Fri Feb 5 16:02:54 2010 +0100
dodan Makefile

Poput grana, tagove je moguće checkout-ati, čime se vraćamo u prošlost,
u stanje projekta kakvo je bilo u trenutku tagiranja. Vratimo se malo u prošlost
do naše verzije 0.1:

> git checkout helloworld-0.1
Note: moving to 'helloworld-0.1' which isn't a local branch
If you want to create a new branch from this checkout, you may do so
(now or later) by using -b with the checkout command again. Example:
  git checkout -b 
HEAD is now at 5e54751... popravljen kod

Git nas upozorava da smo došli na commit koji nije zadnji u nekoj grani. Ukoliko
želimo raditi bilo kakve modifikacije na projektu od ove točke, moramo kreirati novu
granu u koju će one biti spremljene.

Razvojne i stabilne grane

Ovo nam daje dobru ideju - možemo kreirati novu granu s početkom u helloworld-0.1,
koja služi samo za "održavanje" postojećeg koda i ispravljanje pogrešaka, dok ćemo sav
novi razvoj na projektu raditi kao i do sada na masteru. Ovime se želimo
osigurati da imamo "stabilnu verziju" projekta u koju nam neće slučajno upadati i
nove stvari koje razvijamo na "razvojnoj verziji" projekta na master grani.

> git checkout -b helloworld-0 helloworld-0.1
Switched to a new branch 'helloworld-0'

Grana helloworld-0 sadrži commit tagiran sa 'helloworld-0.1' i
sve njegove prethodnike i predstavlja stanje projekta kakvo je bilo u trenutku
kada smo tagirali taj commit. Granu potom možemo koristiti samo za promjene na
stabilnoj/releasanoj verziji, dok nam master ostaje za novi razvoj.

Cherry-picking

Ponekad prilikom rada na novoj verziji uočimo i ispravimo pogrešku koja postoji
i u već releasanoj verziji. Iako bismo ispravke mogli napraviti posebno na obje
grane, jednostavnije je ispravak napraviti na jednoj (obično razvojnoj, tj.
masteru) i nakon toga istu zakrpu primjeniti i na drugu. Ukoliko ispravku radimo
na masteru, primjenjivanje zakrpe i na starije release grane se zove
backporting.

Da bismo napravili backport commita koji ispravlja neku grešku, ne možemo
koristiti niti merge niti rebase, jer oni preuzimaju sve commitove iz mastera.
U slučaju kada želimo izabrati samo jedan commit (ili nekoliko njih, ali ne
cijelu granu) iz jedne grane i primjeniti ga na drugu, možemo koristiti
git cherry-pick.

Korisnici verzije 0.1 našeg softvera su ogorčeni jer ručno moraju pokretati
gcc. Smatraju da je to bug, a kako mi već imamo rješenje u obliku Makefilea
u master grani, rješenje je jednostavno - backportati commit koji je dodao
Makefile i napraviti novi release na 0.* grani.

> git cherry-pick b23a04b47dbc1044d44d94ee0a5df967f8f1b26d
Finished one cherry-pick.
[helloworld-0 f60bcbd] dodan Makefile
 1 files changed, 17 insertions(+), 0 deletions(-)
 create mode 100644 Makefile

Traženi commit je preuzet u trenutnu granu. Preciznije, promjene
koje je traženi commit napravio su napravljene i spremljene i za trenutnu granu.
Ovo je bitno zbog toga što se ID commita mijenja - kao i kod rebasea, originalni
i cherry-pickani commitovi nisu isti. Ovisno o daljnjim promjenama koje radimo
na grani, možemo se naći u situaciji da granu više nije moguće rebazirati ili
spojiti sa masterom, odnosno trebali bi rješavati konflikte. Stoga bi trebalo
izbjegavati cherry-picking iz grane koju u budućnosti želimo spojiti sa trenutnom
granom.

Više o konfliktima te što napraviti kad vam se oni dogode pročitajte u slijedećem postu u ovom serijalu, za par dana...

FOSDEM

Ovaj vikend se u Bruxellesu održava tradicionalna FOSDEM konferencija. Broj zanimljivih predavanja i prezentacija je ogroman (samo popis stvari koje bih želio poslušati zahtjeva da se kloniram par puta :), a osim toga bit će velik broj zanimljivih ljudi koji se bave različitim stvarima, štandova, … a ne smijemo zaboraviti niti belgijsku pivu :) Tako da mi je drago da ću i ove godine prisustvovati ovoj konferenciji.

Računajte na #fosdem tweetove (po uvjetom da gomile geekova ne preopterete wireless, što je obično slučaj :) te kasnije i blog post o stvarima koje su se meni osobno isticale na konfi.

IT Showoff

Slijedeći petak će se u prostoru FERa u Zagrebu održati prvi jubilarni IT Showoff, na kojem ću održati prezentaciju i demo o tome kako i zašto koristiti git. Sa sobom ću imati i N900 i laptop sa složenom razvojnom okolinom za Maemo, pa mi se slobodno javite ukoliko želite popričati o Maemu, N900 te razvoju softvera za ovaj sustav.

N900 na eHrvatska TV

Kad smo već kod N900, nedavno je ekipa iz eHrvatska TV napravila reportažu o ovom uređaju, Maemou i Linuxu u sklopu koje su i mene priupitali za par pitanja. Snimku reportaže možete pogledati na eHrvatska kanalu na YouTube-u.

U prethodnom postu u serijalu o korištenju distrbuiranih sustava za verzioniranje projekata pokazao sam osnove korištenja git-a, ali se nisam dotaknuo zanimljivih dijelova kod kojih distribuirani sustavi pokazuju svoju pravu stranu – grananje projekata u različite verzije, spajanje verzija nazad u jednu i repozicioniranje pojedinih grana u odnosu na druge grane (rebasing).

Ovi pojmovi koriste se u većini (svim?) distribuiranim SCM sustavima, ali se ovdje situacija već dovoljno komplicira da različiti sustavi na ne posve identične načine pristupaju istom problemu. Zbog toga je ovaj post posve specifičan i priča o git-u. Ukoliko koristite neki drugi SCM, imajte na umu da je stvar slična, ali se pojedinosti vjerojatno podosta razlikuju.

Grananje (branch)

U našem hello world projektu zasad imamo samo jednu granu, master, na kojoj smo radili sve promjene. To nam je odgovaralo jer smo točno znali što želimo napraviti slijedeće i nismo imali potrebe raditi više stvari paralelno (ili eksperimentirati u više različitih smjerova odjednom).

No, sada bismo željeli početi pisati i dokumentaciju za projekt. Kako nam se promjene vezane uz dokumentaciju ne bi mješale sa eventualnim nevezanim promjenama koda koje ćemo možda htjeti raditi, dokumentaciju ćemo dodavati u posebnoj grani projekta koju ćemo na kraju spojiti u glavnu. Kreirajmo novu granu doc iz postojeće master grane i odmah se prebacimo u nju:

> git checkout -b doc master
Switched to a new branch 'doc'

Za početak ćemo samo kreirati datoteku README.txt i u nju staviti osnovnu informaciju o programu:

Ovo je tipični "Hello World" program pisan u C-u.

Dodajmo datoteku u repozitorij, napravimo commit, i pogledajmo što smo dobili:

> git add README.txt
> git commit -m "dodan README"
[doc 7bb37b0] dodan README
 1 files changed, 1 insertions(+), 0 deletions(-)
 create mode 100644 README.txt
> git log
commit 7bb37b04d7eeb36dc91e60ef1d01e2648bb2e813
Author: Senko Rasic 
Date:   Sat Jan 23 06:06:26 2010 +0100
dodan README

commit 459b8bd04f3667425705d29f2c3a10bb45e79f5c
Author: Senko Rasic <senko@localhost>
Date:   Fri Dec 11 00:53:32 2009 +0100
malo uljepsano

commit ac3a48559de3b7f225ffa96c504a8586057fb4b9
Author: Senko Rasic <senko@localhost>
Date:   Fri Dec 11 00:38:16 2009 +0100
prva verzija

Kako smo granu doc stvorili iz grane master, ona je uključuje sve dosadašnje promjene. Ovaj prikaz nam nije previše koristan ukoliko želimo vidjeti samo razliku između trenutne grane i mastera. To možemo napraviti ovako:

> git log master..HEAD
commit 7bb37b04d7eeb36dc91e60ef1d01e2648bb2e813
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 06:06:26 2010 +0100
dodan README

Argumentom master..HEAD zatražili smo log svih promjena do zadnjeg commita u trenutnoj grani (HEAD) koje se ne nalaze u master grani. Osim od-do, parametar može biti i samo jedna oznaka, čime se traži log svih promjena od početka do te oznake. Tako će git log master prikazati log svih promjena na grani master bez obzira u kojoj smo grani trenutno. Oznaka HEAD uvijek pokazuje na posljednji commit u trenutnoj grani, pa je git log HEAD isto što i samo git log.

Dokumentiranje našeg programa dobro napreduje, ali paralelno s tim sjetili smo se da bi htjeli napraviti još neke kozmetičke promjene na programu. Na njima želimo raditi nezavisno o procesu dokumentiranja pa ćemo kreirati novu granu. Kako ne bi imali poluzavršenu dokumentaciju u novoj grani, novu granu beauty ćemo opet kreirati iz master grane:

> git checkout -b beauty master
Switched to a new branch 'beauty'

Trenutna inačica programa nije posve legalan C program, stoga ćemo je opet malo doraditi, tj. preraditi u nešto pristojnije:

#include <stdio.h>

int main(void)
{
  printf("Hello world\n");
  return 0;
}

Promjene spremimo u novi commit sa opisom “popravljen kod”. (Update: dodao nedostajući korak, commitanje upravo napravljenih promjena; hvala Mariju Splivalu na dojavi greške).

> git commit -a -m "popravljen kod"

Sada smo već napravili nekoliko grana i u svakoj po nekoliko commitova i sve je teže pratiti gdje se nalazi što. Podsjetimo se koje grane imamo i što one sadrže:

> git branch
* beauty
  doc
  master
> git log master..beauty
commit 5e547517e1a29a08b3594f6b8c8c0a289070376d
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 06:31:05 2010 +0100
popravljen kod

> git log master..doc
...
> git log master
...

Spajanje grana (merge)

Nakon što smo napravili sve što smo htjeli i sve committali te nakon što smo zaključili da smo zadovoljni promjenama na ovoj grani, željeli bismo je spojiti nazad u master.

Napomena: radi jednostavnosti primjera, ovdje nam se grana sastoji od samo jednog commita te ćemo je odmah spojiti nazad, što izgleda kao puno kompliciranja nizašto. No u stvarnom radu promjene obično nisu ovako trivijalne i grane se sastoje od nekoliko (možda desetke) committova, kod čega branch/merge ima smisla.

> git checkout master
Switched to branch 'master'
> git merge beauty
Updating 459b8bd..5e54751
Fast-forward
 hello.c |    5 ++++-
 1 files changed, 4 insertions(+), 1 deletions(-)

Prilikom ovog mergea, master nije imao nikakvih dodatnih commitova kojih nema u beauty grani pa se git nije morao mnogo mučiti sa spajanjem – samo je napravio fast-forward odnosno zalijepio sve nove commitove iz beauty grane u master granu. Pomoću git log možemo se uvjeriti da se uistinu radi o istim committovima (jedinstveni ID im je jednak).

Spajanjem grana beauty nije nestala. Ona još uvijek postoji, iako sad kad su svi njeni commitovi i u masteru, nema razlike između nje i mastera – jednako kao da smo je tek sad kreirali. U daljnjem radu opet možemo koristiti istu granu i dodavati nove committove koje periodički spajamo nazad u master. Stvar je izbora (i specifične organizacije projekta na kojem radite) želite li imati dugotrajnije grane koje periodički spajate s masterom ili za nove promjene radite nove grane.

Ukoliko odlučimo da nam grana više ne treba, možemo je obrisati:

> git branch -d beauty
Deleted branch beauty (was 5e54751).

Repozicioniranje grana (rebase)

Sretni sa dosadašnjim napretkom na master grani, vraćamo se nazad na doc. No sada master ima neke comitove koje doc nema. Zasad nema problema, git bi comittove pametno spojio, no ukoliko i ubuduće mijenjamo master (tj. dodajemo nove comitove), razlika će se sve više povećavati i sve će veća biti vjerojatnost da (slučajno ili namjerno) negdje modificiramo istu stvar i uzrokujemo konflikt.

Kako bi to minimizirali, dugovječne grane možemo repozicionirati, tj. rebazirati (rebase). Rebaziranjem pomičemo točku u kojoj se grana “odvojila” od grane iz koje smo je stvorili (ovdje, mastera), tako da izgleda kao da smo je tek sada stvorili.

> git checkout doc
Switched to branch 'doc'
> git rebase master
First, rewinding head to replay your work on top of it...
Applying: dodan README

> git log
commit 6c0516dbe782173b57997039576e3b38bc20997c
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 06:06:26 2010 +0100
dodan README

commit 5e547517e1a29a08b3594f6b8c8c0a289070376d
Author: Senko Rasic <senko@localhost>
Date:   Sat Jan 23 06:31:05 2010 +0100
popravljen kod

Primjetite da je nakon rebaziranja “dodan README” comit ispao zadnji, iako je zadnja promjena koju smo mi stvarno na cijelom projektu napravili bio “popravljen kod” u beauty grani. Također, primjetite da se ID zadnjeg comitta promjenio – to zapravo više nije isti commit. Radi se o tome da je git doslovno pospremio patcheve, obrisao comittove, a kasnije ih vraćao jedan po jedan i automatski radio nove comittove.

Kao rezultat toga, grana doc više uopće ne izgleda isto. Ako solo radite na projektu, to za vas ne igra nikakvu ulogu. Ali ukoliko nekoliko ljudi radi na istom projektu, potreban je oprez – ukoliko je netko kod sebe povukao vašu granu, a vi ju naknadno rebazirate, stanje comittova u toj grani u vašem repozitoriju više se neće slagati sa stanjem u njihovom repozitoriju. Kod takvih situacija osnovno pravilo je – nikad ne modificirajte povijest grane koju je netko drugi već povukao od vas.

Merge ili rebase?

Nije odmah očito zašto bi radili rebase ako već imamo spajanje grana, no postoji razlika. Kod spajanja promjene iz druge grane “naljepe” se na trenutnu granu. Ukoliko dođe do konflikta, nemamo informaciju koji od comitova iz trenutne grane je uzrokovao konflikt. Stoga ga nećemo moći niti prepraviti, nego ćemo rješenje konflikta samo zalijepiti kao još jedan novi commit.

Spajanje logički znači “sav dosadašnji rad na grani koja se spaja sa trenutnom granom od sada se nalazi i u ovoj grani”. Ukoliko bismo koristili merge za povlačenje novih promjena mastera u doc, efekt bi bio kao da smo rekli “ok, od sada će nam doc biti glavna grana u projektu”.

Za razliku od toga, repozicioniranje znači “promjeni trenutnu granu tako da izgleda da sam sve promjene radio nad sadašnjim sadržajem mastera (odnosno granom nad kojom radim rebase – baznu granu)”, odnosno svojevrsno “osvježavanje patcheva” koje imamo u odnosu na master. Konkretno, rebase radi slijedeće:

1. privremeno miče sve comittove iz trenutne grane koji nisu u baznoj grani i sprema ih na sigurno
2. povlači sve nove comittove iz bazne grane koji nisu u trenutnoj (fast-forward), nakon čega bazna grana i trenutna grana imaju isti sadržaj
3. jedan po jedan vraća nazad comittove koji su spremljeni na sigurno

Ukoliko u nekom trenu dođe do konflikta, rebase će se zaustaviti i imat ćemo priliku prepraviti commit koji uzrokuje konflikt. Na taj način praktički “osvježavamo” trenutnu granu, tako da promjene koja ona predstavlja budu primjenjive na trenutno stanje bazne grane. Ovo nam omogućuje da imamo dugovječne grane sa relativno velikim promjenama u odnosu na baznu granu, a da te promjene uvjek budu ažurne.

Kada koristiti rebase ili merge možete pročitati i u Linusovom mailu o toj temi na LKML – “Some git best practices” post na LWN sadrži malo šire objašnjenje za nas koji ne pratimo LKML.

Join us next time…

Rukovanje granama je vjerojatno najbitniji i najkompliciraniji dio git-a. Nakon što smo to apsolvirali, možemo se opet baciti na laganije, a opet korisne stvari koje korisnicima gita život čine ugodnijim i lakšim. Pridružite mi se slijedeći put dok istražujem interaktivno dodavanje promjena, pretraživanje povijesti, tagiranje, cherry-picking, …

N900 is a device with a lot of connectivity options and a very capable browser. With that, it’s a good Wikipedia reader out of the box. But not so if your connectivity is limited (you’re on top of a mountain, or roaming, or don’t have a data plan alltogether and there are no open wifi hotspots).

Since I got a great Christmas gift from Collabora I’ve been poking at a small toy application that could store and read Wikipedia articles offline. Since Wikipedia hosts a huge number of articles, and device capabilities are limited compared to a desktop PC, this posed an interesting (but not unsolvable) challenge for the weekend hack sessions.

The result is Mawire (Maemo Wikipedia Reader):

The application

Having worked on bits and pieces in Maemo 5, I knew my way around the Maemo 5 SDK and some of the APIs, but nevertheless the Developer’s Guide was of great help. I’ve also perused examples, code (such as browser launcher) and packaging from marnanel‘s raeddit application.

The application is a lightweight reader, so the aim is not to display complete article, but rather to show enough information for a quick check, and provide convenient way for the user to find more on the Wikipedia itself.

At the moment you can download the application from here, or browse or download the source code from github. I hope to upload it to maemo-extras soon. If you’re reading this from your N900, you can install mawire automatically by clicking on the install icon. Warning: It’s an early development (alpha) version, only tested on my device so far, so proceed with caution and only if you know what you’re doing.

Since writing this blog post (but before I hit the Publish button), I’ve played around with portrait mode functionality, and released version 0.2 which has portrait mode support. If your keyboard is closed, mawire will switch to portrait mode. When you slide it open at any time (e.g. for typing search queries, or when you want to copy/paste part of the article), mawire will switch to landscape mode.

Data handling

Since Wikipedia (especially the English edition) has a huge number of articles, amount of text for a complete and comprehensive copy is just too large to conveniently use on the device. Recent enwiki dump contains more than 3 million articles and is almost 6GB of bzip2′d XML.

To minimise database size, and since I wasn’t trying to replicate complete Wikipedia functionality, I decided to strip the articles as much as possible, not only of markup (so only bold and emphasis are preserved), but also to only include content of a few first paragraphs – up to the first heading. The idea is that topic overview is probably outlined first, and then each paragraph expands the coverage (often also having a complete article of its own).

So, the reader only includes the overview and provides “Read more…” button that connects to Wikipedia proper. So the app can be used not only as offline reader, but as quick Wikipedia launcher by itself.

The other problem is number of articles and search performance. If database contains up to a few million articles, sequential searching through the database is extremely slow. Unfortunately, the version of SQlite3 shipped on N900 (and indeed in many Linux distros ATM) doesn’t support fast fulltext search (FTS3), which is ideal for mawire.

So, the application currently ships with its own copy of SQLite library with enabled FTS3 module. It’s installed in a private lib directory so it doesn’t clash with the OS version (similar to what Firefox on Linux distros does), and is only ever used by mawire.

The data itself was prepared by a Python program that:

1. parses the XML dump (using expat),
2. extracts, parses and strips Wikipedia markup (using a bunch of hacked regexps, as I haven’t found a suitable wikimedia markup parser – this is the weakest part of the program and I hope to improve it in the future),
3. filters articles we want to exclude (special pages, lists of things, too short articles),
4. compresses the article text (using zlib) and finally stores them to a SQlite3 database (using SQLalchemy).

The final step is manual, building of FTS3 index, and consists of two SQL statements. This is so it could be done separately, on a machine having SQLite with FTS3.

The program is included in mawire source code, so you can use it to create custom Wikimedia databases (or, indeed, database for any MediaWiki powered wiki).

A database of selected articles (3000 most visited + featured + good + vital; about 14 thousand articles in total) from English Wikipedia (13.6MB). Database is installed in /opt so it doesn’t fill up your rootfs.

Complete English edition, as well as several other major language editions are also available, but I haven’t created Maemo packages for them. You can download them directly, put them on your device or MMC card and select from the application menu.

• English edition, complete (1.4GB)
• French edition, complete (313MB)
• German edition, complete (479MB)
• Russian edition, complete (289MB)
• Spanish edition, complete (288MB)
• Croatian edition, complete (31MB)

Ne znam koja će situacija biti jednom kad se N900 počne prodavati kod nas, ali ukoliko imate primjerak izvana, nemate hrvatsku tastaturu nego najvjerojatnije koristite englesku. Ako vam kojim slučajem zatrebaju naši dijakritici (recimo prilikom pisanja službenog maila :), dovest ćete se u neprilike.

Jedno jednostavno rješenje je nadodati naše dijakritike na kombinacije Fn + kursorske tipke, na kojima po defaultu nema nikakvih drugih simbola. Kako naših dijakritika ima 5, osim kursorskih tipki možemo se poslužiti i BackSpace tipkom.

Kako bi layout bio što sličniji onom na normalnim tipkovnicama, na svojoj Nokii postavio sam ga tako da mi Fn+Up bude Š, Fn+BackSpace Đ (malo poetske pravde je u tome da je davno prije BackSlash bio Đ :), Fn+Left Č, Fn+Down Ć, Fn+Right Ž.

Kako biste to napraivli i kod sebe, morate biti u shellu i imati root privilegije, za što vam pomoći programčić zvan gainroot. Napomena: ovim lako možete dovesti svoju N900 u stanje da se ne može bootati, stoga budite pažljivi, ne radite ovo ako niste sigurni šta radite; ne odgovaram za bilo kakve nastale probleme.

Remapiranje tipkovnice radite editiranjem datoteke /usr/share/X11/xkb/symbols/nokia_vndr/rx-51. Prije editiranja datoteke, svakako napravite backup kopiju. Napomena: Backup kopiju nemojte spremati u isti direktorij, jer će vam se N900 odbiti bootati slijedeći put!

U datoteci pronađite liniju koja spominje <BKSP> (BackSpace tipka), i promijenite je u:

key <BKSP>   { type[Group1] = "PC_FN_LEVEL2", symbols[Group1] =
        [ BackSpace, dstroke ] };

Nakon toga na samom dnu datoteke pronađite blok xkb_symbols "arrows_4btns" i promijenite ga u (odlazak u novi red nakon znaka “=” je tu samo zbog čitljivosti u blog postu – u datoteci možete svaku definiciju staviti u svoj red):

xkb_symbols "arrows_4btns" {
    key <UP>   { type[Group1] = "PC_FN_LEVEL2", symbols[Group1] =
        [ Up, scaron ] };
    key <LEFT> { type[Group1] = "PC_FN_LEVEL2", symbols[Group1] =
        [ Left, ccaron ] };
    key <DOWN> { type[Group1] = "PC_FN_LEVEL2", symbols[Group1] =
        [ Down, cacute ] };
    key <RIGHT> { type[Group1] = "PC_FN_LEVEL2", symbols[Group1] =
        [ Right, zcaron ] };
};

(Update: popravio nazive simbola, originalno sam krivo postavio uglate zagrade).

Spremite datoteku i isprobajte odmah novi layout naredbom setxkbmap. Ukoliko vam naredba vrati grešku, popravite datoteku ili vratite backup – nemojte niti slučajno ostaviti nepravilnu datoteku, jer će vam se kod slijedećeg boota N900 odbiti podići.

Update: ispravio pogrešno napisan naziv komande, hvala Saši na dojavi.

Nakon uspješnog učitavanja novog layouta, naši dijakritici odmah su vam dostupni u svim aplikacijama, koristeći kombinaciju Fn+kursorske tipke ili backspace, za mala slova, odnosno Shift+Fn+tipke za velika slova.

Inspiraciju i sve potrebne informacije za post našao sam na Maemo wikiju, gdje možete pronaći još informacija o ovome i mnogim drugim hackovima za vašu N900.

Update: pripremljenu datoteku možete preuzeti ovdje. Datoteku skopirajte na gorenavedenu i svakako provjerite na goreopisan način (meni provjereno radi, ali ne garantiram da će i vama i ne snosim posljedice ako bude problema).

U sezoni (političkih) izbora vrijeme je za moj tradicionalni izbor free & open source softvera kojeg koristim u svakodnevnom radu i zabavi na računalu. Kako je to izgledalo pred dvije godine pogledajte u ovom postu. A ove godine, krenimo redom:

Editor – (G)VIM

Uza sve moje pokušaje i isprobavanja drugih editora, uvijek se vraćam VIM-u (odnosno njegovom grafičkom pandanu GVIM-u). Većina piskaranja koje radim je zapravo programiranje, za što je ovaj editor upravo idealan. Još uvijek sam na newb razini, ali svake godine upamtim par zgodnih shortcutova .. za jedno 20tak godina ću biti guru :) Mali demo što sve VIM može (otprilike polovicu ovoga još ne koristim .. kao što rekoh, newb sam) pogledajte u izvrsnoj Perl.Hacks.On.Vim prezentaciji.

Web browser – Google Chrome

Velika promjena u zadnje dvije godine – većina browser opcija sada je bazirana na WebKit engineu, a jedino se Firefox drži svojeg Gecka. Novi rat browsera koji se zahuktava u poslijednje vrijeme osigurao je da svi browseri budu mnogo kvalitetniji nego njihove starije inačice – Firefox više nikako nije neosporni vlasnik Linux desktop browser mindsharea.

Pri najavi Google Chrome browsera bio sam prilično nezadovoljan overhypeom koji je dotični doživio. Nakon izlaska bete za Linux, prebacio sam se par dana na nju i mogu zadovoljno reći da Googlovci nisu podbacili – browser je stvarno kvalitetan. Nakon tjedan-dva testiranja, sve svoje browsanje prebacio sam na Chrome. Zasad mi se subjektivno čini stvarno brži od Firefoxa (3.5). Koliko je stvar u činjenici da je Firefox opterećen raznoraznim ekstenzijama i alatima (jeste li znali da Firebug usporava JavaScript čak i na stranicama gdje nije upaljen?) a koliko u stvarnoj brzini enginea i rendera, vidjet ću s vremenom kad se i na Chromeu nakupi po par ekstenzija.

Jedna stvar koja mi se kod Chromea sviđa za razliku od Firefoxa je jednostavnost pisanja ekstenzija – jednostavne ekstenzije se mogu napisati u par desetaka linija JS-a, za razliku od mnoštva boilerplatea kojeg treba pripremiti za Firefox.

Kao lagano off-topic zanimljivost, napomenuo bih da iako koristim Google Chrome kao browser, ne koristim Google kao tražilicu (niti GMail, niti Google Docs, … koristim GMaps kad mi zatreba te GTalk iz Empathya); umjesto toga, koristim DuckDuckGo! zbog toga što mi daje preglednije, relevantne rezultate, a njihov 0-click info box je u većini slučajeva točno ono što me i zanima. U par mjeseci korištenja mislim da nisam više od 2-3 puta zatražio drugu “stranicu” rezultata. Mana DuckDuckGoa su slabiji rezultati za .hr prostor i slabiji rezultati ukoliko copy-pasteam neki dugački opis greške; za te stvari i dalje ručno odem na Google.

Grafičko sučelje – XMonad

Pomalo je depresivno da današnja računala subjektivno ne djeluju mnogo brža od računala koje smo koristili pred 5 ili 10 godina. Naravno da objektivno jesu mnogo brža – dovoljno je samo usporediti grafiku sadašnjih i tadašnjih igara, ili sadašnje multimedijske mogućnosti sa tadašnjim playbackom poštanskih maraka ili kockastih filmova niske rezolucije. Sama GUI sučelja su mnogo rafiniranija, sa više opcija, efekata i slično. Ali opet, pomalo je to depresivno.

Isprobavši par alternativa, otkrio sam da mi je od laganih rješenja najzgodniji XMonad, window manager pisan u Haskellu (isprobavanje XMonada pogodilo se vremenski sa čitanjem izvrsne Real World Haskell knjige o tom programskom jeziku). XMonad mi se učinio stvarno user-friendly, mnogo više od awesome WM-a pisanog napola u Lui, iz jednostavnog razloga što sam za awesome morao odmah editirati konfiguracijsku datoteku (i učiti Luu) dok za XMonad još uvijek nemam nikakvu konfig datoteku – stvar radi po defaultu točno ono što želim.

Kad sam već maknuo Metacity, rješio sam se i GNOME panela, a kako niti Nautilus ne koristim često, izbacio sam i njega. Da izbjegnem pokretanje gnome-sessions-daemona samo zbog gnome-screensavera, zamjenio sam i njega xscreensaverom, a kad već idem u tom smjeru, i gdm sam zamjenio xdm-om.

Networking – male shell skripte

Izbacivši GNOME Panel ostao sam i bez Network Managera (cnetworkmanager, komandolinijski alat, nije pretjerano korisna stvar). Srećom, Nikola mi je otkrio wicd, zamjenu za NetworkManager sa dobrim grafičkim i terminal klijentima. No zbog nekih problema drivera wireless kartice na svom laptopu, kod resumea treba reinicijalizirati driver pa sam cijelu stvar automatizirao sa par shell skripta i otkrio da mi je i sam wicd nepotreban.

Terminal – GNOME Terminal

Kako na kraju ispada da većinu stvari radim / pokrećem iz komadndne linije, bitno mi je da je terminal emulator lagan i brz. Kao pobjednik pokazao mi se GNOME Terminal, jer iako nije lagan po potrošnji memorije i prvom startupu, najbrži je u prikazu antialiasinih TrueType fontova (a od Inconsolate se ne odvajam).

E-mail – Thunderbird 3

Thunderbird 3 pokazao mi se kao odličan mail klijent – osim vidljivih unapređenja u odnosu na verziju 2 (bolji i brži search, tabovi, tagiranje), pokazao mi se kao mnogo bolji u hendlanju velikih IMAP foldera s kojima svakodnevno radim.

Media centar – XBMC

Da sam ovaj post pisao pred 3 tjedna, pod ovu stavku stavio bih Moovidu (nee. Elisa), vrlo dobar media centar baziran na GStreamer frameworku. No Moovida mi zna imati problema sa nekim formatima (ponajviše .mkv) i updateom librarya, a pogotovo sa hendlanjem velike količine fajlova u mojoj glazbenoj kolekciji (zbog čega trenutno koristim i remote kontrolirani Music Player Daemon). XBMC ne pati od tih boljki, također ima podršku za pluginove te mi se zasad ukupno čini kao bolji sustav.

Chat – Empathy

Kako sam jedan od developera na Telepathy projektu (kojeg je i Empathy client jedan dio), nije nikakvo čudo da mi je Empathy najdraži IM client. No otkad imam N900, više chatam sa njega (opet pogonjeno Telepathyem) nego sa laptopa…

Twitter – Chromed Bird

Rudimentaran, ali ima sve što meni treba (pregled svog timelinea, reply, retweet, skraćivanje linkova putem bit.ly-a). Neko vrijeme sam koristio Thwirl i poslije Gwibber, ali prvi mora učitati popriličan AIR runtime a drugi WebKit. Za razliku od njih, Chromed Bird nema praktički nikakvi dodatni load na sustav.