dbf.py API question concerning Index.index_search()

Path	csiph.com!usenet.pasdenom.info!dedibox.gegeweb.org!gegeweb.eu!nntpfeed.proxad.net!proxad.net!feeder1-2.proxad.net!usenet-fr.net!nerim.net!novso.com!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path	<ethan@stoneleaf.us>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.001
X-Spam-Evidence	'H': 1.00; 'S': 0.00; 'defaults': 0.05; 'matches': 0.07; 'override': 0.07; 'subject:question': 0.08; 'from:addr:ethan': 0.09; 'from:addr:stoneleaf.us': 0.09; 'from:name:ethan furman': 0.09; 'indexes': 0.09; 'lost.': 0.09; 'message-id:@stoneleaf.us': 0.09; 'received:184.172': 0.09; 'received:gator410.hostgator.com': 0.09; 'subclass': 0.09; 'subject:()': 0.09; 'tuple': 0.09; '~ethan~': 0.09; 'index': 0.13; 'nearest': 0.16; 'received:72.11': 0.16; 'received:72.11.125': 0.16; 'received:72.11.125.166': 0.16; 'subject:API': 0.16; 'thoughts?': 0.16; 'raise': 0.24; 'header:User-Agent:1': 0.26; 'question': 0.27; '(as': 0.27; 'found.': 0.27; 'error': 0.30; "skip:' 20": 0.32; 'raising': 0.33; 'to:addr:python-list': 0.33; "can't": 0.34; 'done': 0.34; 'returning': 0.35; 'method': 0.36; 'anything': 0.36; 'should': 0.36; 'problems': 0.36; 'one,': 0.37; 'option': 0.37; 'usual': 0.37; 'instead': 0.39; 'to:addr:python.org': 0.39; 'where': 0.40; 'header:Received:5': 0.40; 'range': 0.60; 'skip:n 10': 0.63; 'more': 0.63; 'fun': 0.64; 'here': 0.65; 'received:67.18': 0.65; 'special': 0.73; 'etc),': 0.84; 'safer,': 0.84; 'to:name:python': 0.84
Date	Wed, 15 Aug 2012 16:26:09 -0700
From	Ethan Furman <ethan@stoneleaf.us>
User-Agent	Thunderbird 1.5.0.10 (Windows/20070221)
MIME-Version	1.0
To	Python <python-list@python.org>
Subject	dbf.py API question concerning Index.index_search()
Content-Type	text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding	7bit
X-AntiAbuse	This header was added to track abuse, please include it with any abuse report
X-AntiAbuse	Primary Hostname - gator410.hostgator.com
X-AntiAbuse	Original Domain - python.org
X-AntiAbuse	Originator/Caller UID/GID - [47 12] / [47 12]
X-AntiAbuse	Sender Address Domain - stoneleaf.us
X-BWhitelist	no
X-Source
X-Source-Args
X-Source-Dir
X-Source-Sender	([192.168.10.136]) [72.11.125.166]:2378
X-Source-Auth	ethan+stoneleaf.us
X-Email-Count	2
X-Source-Cap	dG9idWs7dG9idWs7Z2F0b3I0MTAuaG9zdGdhdG9yLmNvbQ==
X-BeenThere	python-list@python.org
X-Mailman-Version	2.1.12
Precedence	list
List-Id	General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe	<http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.3329.1345072870.4697.python-list@python.org> (permalink)
Lines	34
NNTP-Posting-Host	2001:888:2000:d::a6
X-Trace	1345072870 news.xs4all.nl 6984 [2001:888:2000:d::a6]:38455
X-Complaints-To	abuse@xs4all.nl
Xref	csiph.com comp.lang.python:27117

Show key headers only | View raw

Indexes have a new method (rebirth of an old one, really):

   .index_search(
      match,
      start=None,
      stop=None,
      nearest=False,
      partial=False )

The defaults are to search the entire index for exact matches and raise
NotFoundError if it can't find anything.

match is the search criteria
start and stop is the range to search in
nearest returns where the match should be instead of raising an error
partial will find partial matches

The question is what should the return value be?

I don't like the usual pattern of -1 meaning not found (as in
'nothere'.find('a')), so I thought a fun and interesting way would be to
subclass long and override the __nonzero__ method to return True/False
based on whether the (partial) match was found.  The main problems I see
here is that the special return value reverts to a normal int/long if
anything is done to it (adding, subtracting, etc), and the found status
is lost.

The other option is returning a (number, bool) tuple -- safer, yet more
boring... ;)

Thoughts?

~Ethan~

Back to comp.lang.python | Previous | Next — Next in thread | Find similar | Unroll thread

Thread

dbf.py API question concerning Index.index_search() Ethan Furman <ethan@stoneleaf.us> - 2012-08-15 16:26 -0700
  Re: dbf.py API question concerning Index.index_search() Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2012-08-16 00:52 +0000
    Re: dbf.py API question concerning Index.index_search() Ethan Furman <ethan@stoneleaf.us> - 2012-08-15 18:22 -0700
    Re: dbf.py API question concerning Index.index_search() MRAB <python@mrabarnett.plus.com> - 2012-08-16 03:21 +0100
    Re: dbf.py API question concerning Index.index_search() Ethan Furman <ethan@stoneleaf.us> - 2012-08-16 09:13 -0700
    Re: dbf.py API question concerning Index.index_search() MRAB <python@mrabarnett.plus.com> - 2012-08-16 17:43 +0100
    Re: dbf.py API question concerning Index.index_search() Ethan Furman <ethan@stoneleaf.us> - 2012-08-16 10:46 -0700
  Re: dbf.py API question concerning Index.index_search() Hans Mulder <hansmu@xs4all.nl> - 2012-08-16 12:34 +0200

csiph-web