chore: better usage example in README.md and test renamed

Author: sajidurrahman

README.md

@@ -27,14 +27,20 @@ pip install git+https://github.com/userlike/python-clamd.git
 
 ```python
 import clamd
+from io import BytesIO
 
 # Connect via network
 cd = clamd.ClamdNetworkSocket(host='127.0.0.1', port=3310)
 
 # Ping the daemon
-cd.ping()
+cd.ping() # Returns PONG, otherwise raise ConnectionError or ResponseError
 
-# Scan a file
+# Scan content using instream (recommended - works with remote ClamAV)
+result = cd.instream(BytesIO(b'file content here'))
+# Returns: {'stream': ('OK', None)} for clean files
+# Returns: {'stream': ('FOUND', 'VirusName')} for infected files
+
+# Scan a file by path (only works if ClamAV can access the path)
 cd.scan('/path/to/file')
 
 # Get version info

src/tests/test_api.py

@@ -26,11 +26,14 @@ def test_reload(self):
         assert self.cd.reload() == 'RELOADING'
 
 
-    def test_instream(self):
+    def test_instream_found(self):
+        # Case: True positive
         expected = {'stream': ('FOUND', 'Eicar-Test-Signature')}
         assert self.cd.instream(BytesIO(clamd.EICAR)) == expected
 
-    def test_insteam_success(self):
+
+    def test_instream_ok(self):
+        # Case True negative
         assert self.cd.instream(BytesIO(b"foo")) == {'stream': ('OK', None)}