Just compute the definite integral, and evaluate at the limits manually. That is, use
integrate(1/(1-z), z).
However you're going to have problems because as Chris notes, log(1 - z) = log(-1) + log(z - 1) is not always valid (I think it may be true if z < 1, if I remember the rule correctly). The issue is that for real values, the integral of 1/x should be log(abs(x)) (this isn't true in the complex case, which is why SymPy doesn't return that value).
I believe the result you get with the I*pi is mathematically correct. That is, if you plug in any real value for z, you'll get the same result as from -log(abs(z - 1)).
Aaron Meurer