docs: Improve README with installation, usage, and API reference

Author: ctoth

README.md

@@ -1,20 +1,67 @@
 # Libloader
 
-Libloader provides a way to quickly and easily load shared libraries on macOS, Windows and Linux.
+Libloader is a cross-platform Python library that simplifies loading shared libraries on macOS, Windows, and Linux. It handles platform-specific differences automatically, making your code more portable.
 
-It also provides a COM module (libloader.com), making it easier to load COM DLLs on Windows.
+It also provides a COM module (`libloader.com`), making it easier to load COM DLLs on Windows.
 
-## Functions.
+## Installation
 
-### com
+```bash
+pip install libloader
+```
 
-* prepare_gencache(): Prepare the gencache for COM. Not mandatory to be called by you, because load_com() calls it.
-* load_com(*names): Let's you load a COM object. If you pass more than one, if the first fails, it will try the next one, until one works, or it runs out of objects.
+## Usage
+
+### Loading Shared Libraries
+
+```python
+from libloader import load_library
+
+# Load a library with default paths
+my_lib = load_library("mylibrary")
+
+# Load a library with custom paths for 32-bit and 64-bit versions
+my_lib = load_library("mylibrary", x86_path="./lib/x86", x64_path="./lib/x64")
+
+# Call a function from the library
+result = my_lib.some_function(arg1, arg2)
+```
+
+### Working with COM Objects (Windows)
+
+```python
+from libloader.com import load_com
+
+# Load a COM object
+excel = load_com("Excel.Application")
+
+# Try multiple COM objects until one succeeds
+speech = load_com("SAPI.SpVoice", "SpeechLib.SpVoice")
+```
+
+## API Reference
 
 ### libloader
 
-* load_library(library, x86_path=".", x64_path=".", *args, **kwargs): Load a library with the given name.
-* _do_load(file, *args, **kwargs): Attempts to actually load the library. Used by load_library, although you can call it yourself.
-* find_library_path(libname, x86_path=".", x64_path="."): Finds the path of the given library.
-* get_functype(): Returns the ctypes functype of the given platform.
-* get_library_extension(): Get the extension of the library for your current platform.
+* `load_library(library, x86_path=".", x64_path=".", *args, **kwargs)`: Load a library with the given name.
+* `find_library_path(libname, x86_path=".", x64_path=".")`: Finds the path of the given library.
+* `get_functype()`: Returns the ctypes functype for the current platform.
+* `get_library_extension()`: Get the extension of the library for your current platform.
+* `_do_load(file, *args, **kwargs)`: Attempts to actually load the library. Used internally by load_library.
+
+### libloader.com
+
+* `load_com(*names)`: Load a COM object. If you pass multiple names, it will try each one until one works.
+* `prepare_gencache()`: Prepare the gencache for COM. Called automatically by load_com().
+
+## Platform Support
+
+Libloader automatically handles the differences between platforms:
+
+* Windows: `.dll` files
+* macOS: `.dylib` files
+* Linux: `.so` files
+
+## License
+
+See the LICENSE file for details.

setup.py

@@ -1,19 +1,29 @@
 from setuptools import find_packages, setup
+import os
 
 from libloader import __author__, __author_email__, __doc__, __version__
 
+# Read the long description from README.md
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
 setup(
     name="libloader",
     version=__version__,
     author=__author__,
     author_email=__author_email__,
     description=__doc__,
+    long_description=long_description,
+    long_description_content_type="text/markdown",
     packages=find_packages(),
     zip_safe=False,
     classifiers=[
         "Development Status :: 3 - Alpha",
         "Intended Audience :: Developers",
         "Programming Language :: Python",
         "Topic :: Software Development :: Libraries",
+        "Operating System :: OS Independent",
+        "License :: OSI Approved :: MIT License",
     ],
+    python_requires=">=3.6",
 )