overpass.API deprecation message is inaccurate #203

joachim-n commented 2026年05月31日 21:30:45 +02:00

I did this (from the README):

api = overpass.API(user_agent="...")

and got this message:

/Users/joachim/Sites/hist/test-overpass.py:2: DeprecationWarning: overpass.API is deprecated and will be removed in overpass 1.0; use overpass.OverpassClient in 1.0 instead.

So, as indicated, I tried this:

api = overpass.OverpassClient(user_agent="...")

and it crashes with:

AttributeError: module 'overpass' has no attribute 'OverpassClient'

I did this (from the README): ``` api = overpass.API(user_agent="...") ``` and got this message: > /Users/joachim/Sites/hist/test-overpass.py:2: DeprecationWarning: overpass.API is deprecated and will be removed in overpass 1.0; use overpass.OverpassClient in 1.0 instead. So, as indicated, I tried this: ``` api = overpass.OverpassClient(user_agent="...") ``` and it crashes with: > AttributeError: module 'overpass' has no attribute 'OverpassClient'

joachim-n commented 2026年05月31日 21:32:37 +02:00

I've tried the code from the 1.0 design doc instead:

from overpass import OverpassClient

and that crashes too:

ImportError: cannot import name 'OverpassClient' from 'overpass' (/Users/joachim/Sites/hist/venv/lib/python3.14/site-packages/overpass/init.py)

I've tried the code from the 1.0 design doc instead: ``` from overpass import OverpassClient ``` and that crashes too: > ImportError: cannot import name 'OverpassClient' from 'overpass' (/Users/joachim/Sites/hist/venv/lib/python3.14/site-packages/overpass/__init__.py)

mvexel commented 2026年05月31日 23:37:52 +02:00

Yes, that’s confusing. The deprecation warning is merely that: a warning. You should continue to use the current method.

Did the code you tried in your first message work despite the warning?

use overpass.OverpassClient in 1.0 instead. should not be there or should be worded differently at least.

Apologies for that confusion.

Yes, that’s confusing. The deprecation warning is merely that: a warning. You should continue to use the current method. Did the code you tried in your first message work despite the warning? `use overpass.OverpassClient in 1.0 instead.` should not be there or should be worded differently at least. Apologies for that confusion.

joachim-n commented 2026年06月01日 17:23:49 +02:00

The deprecation warning is merely that: a warning. You should continue to use the current method

I take a deprecation warning as meaning 'You should switch to the new method as soon as possible'. Since I'm writing a new project, it made sense to switch immediately.

The old version of the code works, yes.

> The deprecation warning is merely that: a warning. You should continue to use the current method I take a deprecation warning as meaning 'You should switch to the new method as soon as possible'. Since I'm writing a new project, it made sense to switch immediately. The old version of the code works, yes.

mvexel commented 2026年06月04日 20:25:44 +02:00

@joachim-n I fixed this up on the 0.8.x branch. If you don't want to wait for a release, you can grab the latest directly from there. Let me know if this works for you. Thanks for reporting!

@joachim-n I fixed this up on the 0.8.x branch. If you don't want to wait for a release, you can grab the latest directly from there. Let me know if this works for you. Thanks for reporting!