Test search method

Author: tomgross

CHANGES.rst

@@ -6,6 +6,7 @@ Changelog
 
 - Use `pyproject.toml` instead of `setup.py` [tomgross]
 - Document `eapi`-endpoint for fs.opener [tomgross]
+- Implement undocumented `search`-method (#93) [tomgross]
 
 1.4 (2024-12-29)
 ----------------

README.rst

@@ -81,6 +81,14 @@ b) from data:
   >>> img.save(bio, format='jpeg')
   >>> pc.uploadfile(data=bio.getvalue(), filename="image.jpg", path='/path-to-pcloud-dir')
 
+Searching files
+---------------
+
+The pCloud-API allows searching files, even this is not documented in the official
+pCloud documentation.
+
+  >>> pcapi.search(query="foo", offset=20, limit=10)
+
 PyFilesystem integration
 ++++++++++++++++++++++++
 

src/pcloud/tests/test_integration.py

@@ -16,6 +16,7 @@ def pycloud():
     return PyCloud(username, password, endpoint="eapi")
 
 
+testfilename = "Getting started with pCloud.pdf"
 folder_for_tests = "integration-test"
 # upload `data/upload.txt` to integration test instance,
 # generate a public link (code) and insert the code below.
@@ -65,7 +66,6 @@ def test_publink_zip(pycloud):
 
 
 def test_copyfile(pycloud, testfolder):
-    testfilename = "Getting started with pCloud.pdf"
     tofilename = f"/{folder_for_tests}/{testfilename}"
     resp = pycloud.copyfile(path=f"/{testfilename}", topath=tofilename)
     assert resp["result"] == 0
@@ -76,6 +76,10 @@ def test_copyfile(pycloud, testfolder):
         == "df745d42f69266c49141ea7270c45240cf883b9cdb6a14fffcdff33c04c5304c"
     ), f"Failure with checksum in {resp}"
 
+def test_search(pycloud):
+    resp = pycloud.search(query=testfilename, limit=1)
+    assert len(resp['items']) == 1
+    assert resp['items'][0]['name'] == testfilename
 
 def test_listtokens(pycloud):
     result = pycloud.listtokens()