source4/lib/ldb/tests/python/api.py

   1 #!/usr/bin/python
   2 # Simple tests for the ldb python bindings.
   3 # Copyright (C) 2007 Jelmer Vernooij <jelmer@samba.org>
   4
   5 import os, sys
   6 import unittest
   7
   8 # Required for the standalone LDB build
   9 sys.path.append("build/lib.linux-i686-2.4")
  10
  11 import ldb
  12
  13 class NoContextTests(unittest.TestCase):
  14     def test_valid_attr_name(self):
  15         self.assertTrue(ldb.valid_attr_name("foo"))
  16         self.assertFalse(ldb.valid_attr_name("24foo"))
  17
  18     def test_timestring(self):
  19         self.assertEquals("19700101000000.0Z", ldb.timestring(0))
  20         self.assertEquals("20071119191012.0Z", ldb.timestring(1195499412))
  21
  22     def test_string_to_time(self):
  23         self.assertEquals(0, ldb.string_to_time("19700101000000.0Z"))
  24         self.assertEquals(1195499412, ldb.string_to_time("20071119191012.0Z"))
  25
  26
  27 class SimpleLdb(unittest.TestCase):
  28     def test_connect(self):
  29         ldb.Ldb("foo.ldb")
  30
  31     def test_connect_none(self):
  32         ldb.Ldb()
  33
  34     def test_connect_later(self):
  35         x = ldb.Ldb()
  36         x.connect("foo.ldb")
  37
  38     def test_repr(self):
  39         x = ldb.Ldb()
  40         self.assertTrue(repr(x).startswith("<ldb connection"))
  41
  42     def test_set_create_perms(self):
  43         x = ldb.Ldb()
  44         x.set_create_perms(0600)
  45
  46     def test_set_modules_dir(self):
  47         x = ldb.Ldb()
  48         x.set_modules_dir("/tmp")
  49
  50     def test_modules_none(self):
  51         x = ldb.Ldb()
  52         self.assertEquals([], x.modules())
  53
  54     def test_modules_tdb(self):
  55         x = ldb.Ldb("bar.ldb")
  56         self.assertEquals("[<ldb module 'tdb'>]", repr(x.modules()))
  57
  58     def test_search(self):
  59         l = ldb.Ldb("foo.ldb")
  60         self.assertEquals(len(l.search()), 1)
  61
  62     def test_search_controls(self):
  63         l = ldb.Ldb("foo.ldb")
  64         self.assertEquals(len(l.search(controls=["paged_results:0:5"])), 1)
  65
  66     def test_search_attrs(self):
  67         l = ldb.Ldb("foo.ldb")
  68         self.assertEquals(len(l.search(ldb.Dn(l, ""), ldb.SCOPE_SUBTREE, "(dc=*)", ["dc"])), 0)
  69
  70     def test_search_string_dn(self):
  71         l = ldb.Ldb("foo.ldb")
  72         self.assertEquals(len(l.search("", ldb.SCOPE_SUBTREE, "(dc=*)", ["dc"])), 0)
  73
  74     def test_search_attr_string(self):
  75         l = ldb.Ldb("foo.tdb")
  76         self.assertRaises(TypeError, l.search, attrs="dc")
  77
  78     def test_opaque(self):
  79         l = ldb.Ldb("foo.ldb")
  80         l.set_opaque("my_opaque", l)
  81         self.assertTrue(l.get_opaque("my_opaque") is not None)
  82         self.assertEquals(None, l.get_opaque("unknown"))
  83
  84     def test_parse_control_strings(self):
  85         l = ldb.Ldb("foo.ldb")
  86         self.assertRaises(ldb.LdbError, l.parse_control_strings, ["foo", "bar"])
  87         self.assertTrue(l.parse_control_strings(["paged_results:0:5"]) is not None)
  88
  89     def test_search_scope_base(self):
  90         l = ldb.Ldb("foo.ldb")
  91         self.assertEquals(len(l.search(ldb.Dn(l, "dc=foo"),
  92                           ldb.SCOPE_ONELEVEL)), 0)
  93
  94     def test_delete(self):
  95         l = ldb.Ldb("foo.ldb")
  96         self.assertRaises(ldb.LdbError, lambda: l.delete(ldb.Dn(l, "dc=foo")))
  97
  98     def test_contains(self):
  99         l = ldb.Ldb("foo.ldb")
 100         self.assertFalse(ldb.Dn(l, "dc=foo") in l)
 101         l = ldb.Ldb("foo.ldb")
 102         m = ldb.Message()
 103         m.dn = ldb.Dn(l, "dc=foo")
 104         m["b"] = ["a"]
 105         l.add(m)
 106         try:
 107             self.assertTrue(ldb.Dn(l, "dc=foo") in l)
 108         finally:
 109             l.delete(m.dn)
 110
 111     def test_get_config_basedn(self):
 112         l = ldb.Ldb("foo.ldb")
 113         self.assertEquals(None, l.get_config_basedn())
 114
 115     def test_get_root_basedn(self):
 116         l = ldb.Ldb("foo.ldb")
 117         self.assertEquals(None, l.get_root_basedn())
 118
 119     def test_get_schema_basedn(self):
 120         l = ldb.Ldb("foo.ldb")
 121         self.assertEquals(None, l.get_schema_basedn())
 122
 123     def test_get_default_basedn(self):
 124         l = ldb.Ldb("foo.ldb")
 125         self.assertEquals(None, l.get_default_basedn())
 126
 127     def test_add(self):
 128         l = ldb.Ldb("foo.ldb")
 129         m = ldb.Message()
 130         m.dn = ldb.Dn(l, "dc=foo")
 131         m["bla"] = "bla"
 132         self.assertEquals(len(l.search()), 1)
 133         l.add(m)
 134         try:
 135             self.assertEquals(len(l.search()), 2)
 136         finally:
 137             l.delete(ldb.Dn(l, "dc=foo"))
 138
 139     def test_add_dict(self):
 140         l = ldb.Ldb("foo.ldb")
 141         m = {"dn": ldb.Dn(l, "dc=foo"),
 142              "bla": "bla"}
 143         self.assertEquals(len(l.search()), 1)
 144         l.add(m)
 145         try:
 146             self.assertEquals(len(l.search()), 2)
 147         finally:
 148             l.delete(ldb.Dn(l, "dc=foo"))
 149
 150     def test_add_dict_string_dn(self):
 151         l = ldb.Ldb("foo.ldb")
 152         m = {"dn": "dc=foo", "bla": "bla"}
 153         self.assertEquals(len(l.search()), 1)
 154         l.add(m)
 155         try:
 156             self.assertEquals(len(l.search()), 2)
 157         finally:
 158             l.delete(ldb.Dn(l, "dc=foo"))
 159
 160     def test_rename(self):
 161         l = ldb.Ldb("foo.ldb")
 162         m = ldb.Message()
 163         m.dn = ldb.Dn(l, "dc=foo")
 164         m["bla"] = "bla"
 165         self.assertEquals(len(l.search()), 1)
 166         l.add(m)
 167         try:
 168             l.rename(ldb.Dn(l, "dc=foo"), ldb.Dn(l, "dc=bar"))
 169             self.assertEquals(len(l.search()), 2)
 170         finally:
 171             l.delete(ldb.Dn(l, "dc=bar"))
 172
 173     def test_rename_string_dns(self):
 174         l = ldb.Ldb("foo.ldb")
 175         m = ldb.Message()
 176         m.dn = ldb.Dn(l, "dc=foo")
 177         m["bla"] = "bla"
 178         self.assertEquals(len(l.search()), 1)
 179         l.add(m)
 180         try:
 181             l.rename("dc=foo", "dc=bar")
 182             self.assertEquals(len(l.search()), 2)
 183         finally:
 184             l.delete(ldb.Dn(l, "dc=bar"))
 185
 186     def test_modify_delete(self):
 187         l = ldb.Ldb("foo.ldb")
 188         m = ldb.Message()
 189         m.dn = ldb.Dn(l, "dc=modifydelete")
 190         m["bla"] = ["1234"]
 191         l.add(m)
 192         rm = l.search(m.dn)[0]
 193         self.assertEquals(["1234"], list(rm["bla"]))
 194         try:
 195             m = ldb.Message()
 196             m.dn = ldb.Dn(l, "dc=modifydelete")
 197             m["bla"] = ldb.MessageElement([], ldb.CHANGETYPE_DELETE, "bla")
 198             l.modify(m)
 199             rm = l.search(m.dn)[0]
 200             self.assertEquals(1, len(rm))
 201         finally:
 202             l.delete(ldb.Dn(l, "dc=modifydelete"))
 203
 204     def test_modify_add(self):
 205         l = ldb.Ldb("foo.ldb")
 206         m = ldb.Message()
 207         m.dn = ldb.Dn(l, "dc=add")
 208         m["bla"] = ["1234"]
 209         l.add(m)
 210         try:
 211             m = ldb.Message()
 212             m.dn = ldb.Dn(l, "dc=add")
 213             m["bla"] = ldb.MessageElement(["456"], ldb.CHANGETYPE_ADD, "bla")
 214             l.modify(m)
 215             rm = l.search(m.dn)[0]
 216             self.assertEquals(2, len(rm))
 217             self.assertEquals(["1234", "456"], list(rm["bla"]))
 218         finally:
 219             l.delete(ldb.Dn(l, "dc=add"))
 220
 221     def test_modify_modify(self):
 222         l = ldb.Ldb("foo.ldb")
 223         m = ldb.Message()
 224         m.dn = ldb.Dn(l, "dc=modify2")
 225         m["bla"] = ["1234", "456"]
 226         l.add(m)
 227         try:
 228             m = ldb.Message()
 229             m.dn = ldb.Dn(l, "dc=modify2")
 230             m["bla"] = ldb.MessageElement(["456"], ldb.CHANGETYPE_MODIFY, "bla")
 231             l.modify(m)
 232             rm = l.search(m.dn)[0]
 233             self.assertEquals(2, len(rm))
 234             self.assertEquals(["1234"], list(rm["bla"]))
 235         finally:
 236             l.delete(ldb.Dn(l, "dc=modify2"))
 237
 238     def test_transaction_commit(self):
 239         l = ldb.Ldb("foo.ldb")
 240         l.transaction_start()
 241         m = ldb.Message(ldb.Dn(l, "dc=foo"))
 242         m["foo"] = ["bar"]
 243         l.add(m)
 244         l.transaction_commit()
 245         l.delete(m.dn)
 246
 247     def test_transaction_cancel(self):
 248         l = ldb.Ldb("foo.ldb")
 249         l.transaction_start()
 250         m = ldb.Message(ldb.Dn(l, "dc=foo"))
 251         m["foo"] = ["bar"]
 252         l.add(m)
 253         l.transaction_cancel()
 254         self.assertEquals(0, len(l.search(ldb.Dn(l, "dc=foo"))))
 255
 256     def test_set_debug(self):
 257         def my_report_fn(level, text):
 258             pass
 259         l = ldb.Ldb("foo.ldb")
 260         l.set_debug(my_report_fn)
 261
 262
 263 class DnTests(unittest.TestCase):
 264     def setUp(self):
 265         self.ldb = ldb.Ldb("foo.ldb")
 266
 267     def test_eq(self):
 268         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 269         y = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 270         self.assertEquals(x, y)
 271
 272     def test_str(self):
 273         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 274         self.assertEquals(x.__str__(), "dc=foo,bar=bloe")
 275
 276     def test_repr(self):
 277         x = ldb.Dn(self.ldb, "dc=foo,bla=blie")
 278         self.assertEquals(x.__repr__(), "Dn('dc=foo,bla=blie')")
 279
 280     def test_get_casefold(self):
 281         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 282         self.assertEquals(x.get_casefold(), "DC=FOO,BAR=bloe")
 283
 284     def test_validate(self):
 285         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 286         self.assertTrue(x.validate())
 287
 288     def test_parent(self):
 289         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 290         self.assertEquals("bar=bloe", x.parent().__str__())
 291
 292     def test_compare(self):
 293         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 294         y = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 295         self.assertEquals(x, y)
 296         z = ldb.Dn(self.ldb, "dc=foo,bar=blie")
 297         self.assertNotEquals(z, y)
 298
 299     def test_is_valid(self):
 300         x = ldb.Dn(self.ldb, "dc=foo,dc=bloe")
 301         self.assertTrue(x.is_valid())
 302         x = ldb.Dn(self.ldb, "")
 303         # is_valid()'s return values appears to be a side effect of
 304         # some other ldb functions. yuck.
 305         # self.assertFalse(x.is_valid())
 306
 307     def test_is_special(self):
 308         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 309         self.assertFalse(x.is_special())
 310         x = ldb.Dn(self.ldb, "@FOOBAR")
 311         self.assertTrue(x.is_special())
 312
 313     def test_check_special(self):
 314         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 315         self.assertFalse(x.check_special("FOOBAR"))
 316         x = ldb.Dn(self.ldb, "@FOOBAR")
 317         self.assertTrue(x.check_special("@FOOBAR"))
 318
 319     def test_len(self):
 320         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 321         self.assertEquals(2, len(x))
 322         x = ldb.Dn(self.ldb, "dc=foo")
 323         self.assertEquals(1, len(x))
 324
 325     def test_add_child(self):
 326         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 327         self.assertTrue(x.add_child(ldb.Dn(self.ldb, "bla=bloe")))
 328         self.assertEquals("bla=bloe,dc=foo,bar=bloe", x.__str__())
 329
 330     def test_add_base(self):
 331         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 332         base = ldb.Dn(self.ldb, "bla=bloe")
 333         self.assertTrue(x.add_base(base))
 334         self.assertEquals("dc=foo,bar=bloe,bla=bloe", x.__str__())
 335
 336     def test_add(self):
 337         x = ldb.Dn(self.ldb, "dc=foo")
 338         y = ldb.Dn(self.ldb, "bar=bla")
 339         self.assertEquals("dc=foo,bar=bla", str(y + x))
 340
 341     def test_parse_ldif(self):
 342         msgs = self.ldb.parse_ldif("dn: foo=bar\n")
 343         msg = msgs.next()
 344         self.assertEquals("foo=bar", str(msg[1].dn))
 345         self.assertTrue(isinstance(msg[1], ldb.Message))
 346
 347     def test_parse_ldif_more(self):
 348         msgs = self.ldb.parse_ldif("dn: foo=bar\n\n\ndn: bar=bar")
 349         msg = msgs.next()
 350         self.assertEquals("foo=bar", str(msg[1].dn))
 351         msg = msgs.next()
 352         self.assertEquals("bar=bar", str(msg[1].dn))
 353
 354     def test_canonical_string(self):
 355         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 356         self.assertEquals("/bloe/foo", x.canonical_str())
 357
 358     def test_canonical_ex_string(self):
 359         x = ldb.Dn(self.ldb, "dc=foo,bar=bloe")
 360         self.assertEquals("/bloe\nfoo", x.canonical_ex_str())
 361
 362
 363 class LdbMsgTests(unittest.TestCase):
 364     def setUp(self):
 365         self.msg = ldb.Message()
 366
 367     def test_init_dn(self):
 368         self.msg = ldb.Message(ldb.Dn(ldb.Ldb(), "dc=foo"))
 369         self.assertEquals("dc=foo", str(self.msg.dn))
 370
 371     def test_iter_items(self):
 372         self.assertEquals(0, len(self.msg.items()))
 373         self.msg.dn = ldb.Dn(ldb.Ldb("foo.tdb"), "dc=foo")
 374         self.assertEquals(1, len(self.msg.items()))
 375
 376     def test_repr(self):
 377         self.msg.dn = ldb.Dn(ldb.Ldb("foo.tdb"), "dc=foo")
 378         self.msg["dc"] = "foo"
 379         self.assertEquals("Message({'dn': Dn('dc=foo'), 'dc': MessageElement(['foo'])})", repr(self.msg))
 380
 381     def test_len(self):
 382         self.assertEquals(0, len(self.msg))
 383
 384     def test_notpresent(self):
 385         self.assertRaises(KeyError, lambda: self.msg["foo"])
 386
 387     def test_del(self):
 388         del self.msg["foo"]
 389
 390     def test_add_value(self):
 391         self.assertEquals(0, len(self.msg))
 392         self.msg["foo"] = ["foo"]
 393         self.assertEquals(1, len(self.msg))
 394
 395     def test_add_value_multiple(self):
 396         self.assertEquals(0, len(self.msg))
 397         self.msg["foo"] = ["foo", "bla"]
 398         self.assertEquals(1, len(self.msg))
 399         self.assertEquals(["foo", "bla"], list(self.msg["foo"]))
 400
 401     def test_set_value(self):
 402         self.msg["foo"] = ["fool"]
 403         self.assertEquals(["fool"], list(self.msg["foo"]))
 404         self.msg["foo"] = ["bar"]
 405         self.assertEquals(["bar"], list(self.msg["foo"]))
 406
 407     def test_keys(self):
 408         self.msg.dn = ldb.Dn(ldb.Ldb("foo.tdb"), "@BASEINFO")
 409         self.msg["foo"] = ["bla"]
 410         self.msg["bar"] = ["bla"]
 411         self.assertEquals(["dn", "foo", "bar"], self.msg.keys())
 412
 413     def test_dn(self):
 414         self.msg.dn = ldb.Dn(ldb.Ldb("foo.ldb"), "@BASEINFO")
 415         self.assertEquals("@BASEINFO", self.msg.dn.__str__())
 416
 417     def test_get_dn(self):
 418         self.msg.dn = ldb.Dn(ldb.Ldb("foo.tdb"), "@BASEINFO")
 419         self.assertEquals("@BASEINFO", self.msg.get("dn").__str__())
 420
 421     def test_get_other(self):
 422         self.msg["foo"] = ["bar"]
 423         self.assertEquals("bar", self.msg.get("foo")[0])
 424
 425     def test_get_unknown(self):
 426         self.assertEquals(None, self.msg.get("lalalala"))
 427
 428
 429 class MessageElementTests(unittest.TestCase):
 430     def test_cmp_element(self):
 431         x = ldb.MessageElement(["foo"])
 432         y = ldb.MessageElement(["foo"])
 433         z = ldb.MessageElement(["bzr"])
 434         self.assertEquals(x, y)
 435         self.assertNotEquals(x, z)
 436
 437     def test_create_iterable(self):
 438         x = ldb.MessageElement(["foo"])
 439         self.assertEquals(["foo"], list(x))
 440
 441     def test_repr(self):
 442         x = ldb.MessageElement(["foo"])
 443         self.assertEquals("MessageElement(['foo'])", repr(x))
 444         x = ldb.MessageElement(["foo", "bla"])
 445         self.assertEquals(2, len(x))
 446         self.assertEquals("MessageElement(['foo','bla'])", repr(x))
 447
 448     def test_get_item(self):
 449         x = ldb.MessageElement(["foo", "bar"])
 450         self.assertEquals("foo", x[0])
 451         self.assertEquals("bar", x[1])
 452         self.assertEquals("bar", x[-1])
 453         self.assertRaises(IndexError, lambda: x[45])
 454
 455     def test_len(self):
 456         x = ldb.MessageElement(["foo", "bar"])
 457         self.assertEquals(2, len(x))
 458
 459     def test_eq(self):
 460         x = ldb.MessageElement(["foo", "bar"])
 461         y = ldb.MessageElement(["foo", "bar"])
 462         self.assertEquals(y, x)
 463         x = ldb.MessageElement(["foo"])
 464         self.assertNotEquals(y, x)
 465         y = ldb.MessageElement(["foo"])
 466         self.assertEquals(y, x)
 467
 468
 469 class ModuleTests(unittest.TestCase):
 470     def test_register_module(self):
 471         class ExampleModule:
 472             name = "example"
 473         ldb.register_module(ExampleModule)
 474
 475     def test_use_module(self):
 476         ops = []
 477         class ExampleModule:
 478             name = "bla"
 479
 480             def __init__(self, ldb, next):
 481                 ops.append("init")
 482                 self.next = next
 483
 484             def search(self, *args, **kwargs):
 485                 return self.next.search(*args, **kwargs)
 486
 487         ldb.register_module(ExampleModule)
 488         if os.path.exists("usemodule.ldb"):
 489             os.unlink("usemodule.ldb")
 490         l = ldb.Ldb("usemodule.ldb")
 491         l.add({"dn": "@MODULES", "@LIST": "bla"})
 492         self.assertEquals([], ops)
 493         l = ldb.Ldb("usemodule.ldb")
 494         self.assertEquals(["init"], ops)
 495
 496 if __name__ == '__main__':
 497     import unittest
 498     unittest.TestProgram()