fix: new arguments

Author: krypton-byte

docs/getstarted.rst

@@ -0,0 +1,81 @@
+Getting Started with Neonize
+===========================
+
+What is Neonize?
+--------------
+
+Neonize is a Python library that provides an asynchronous client interface for WhatsApp messaging. It allows developers to build applications that can programmatically send and receive WhatsApp messages, handle various media types, and interact with WhatsApp features.
+
+Installation
+-----------
+
+You can install Neonize using pip:
+
+.. code-block:: bash
+
+    pip install neonize
+
+For the development version, you can install directly from GitHub:
+
+.. code-block:: bash
+
+    pip install git+https://github.com/krypton-byte/neonize.git
+
+Requirements
+~~~~~~~~~~~
+
+- Python 3.10 or higher
+- Async/await support
+
+Basic Usage
+----------
+
+Here's a simple example of how to use Neonize:
+
+.. code-block:: python
+
+    import asyncio
+    from neonize import NewAClient
+    from neonize.events import MessageEv
+
+    async def handler(client: NewAClient, message: MessageEv):
+        # Get the chat and text from the message
+        chat = message.Info.MessageSource.Chat
+        text = message.Message.conversation
+        
+        # Simple ping-pong example
+        if text == "ping":
+            await client.send_message(chat, "pong!")
+
+    async def main():
+        # Initialize the client
+        client = NewAClient()
+        
+        # Register the message handler
+        client.register_callback(handler)
+        
+        # Connect and start listening
+        await client.connect()
+        
+        # Keep the client running
+        while client.connected:
+            await asyncio.sleep(1)
+
+    if __name__ == "__main__":
+        asyncio.run(main())
+
+Features
+--------
+
+Neonize supports many WhatsApp features, including:
+
+* Sending and receiving text messages
+* Handling media (images, videos, audio, documents)
+* Creating and interacting with polls
+* Building and sending stickers
+* Message editing
+* Interactive buttons and lists
+* Chat settings management (muting, pinning, archiving)
+* And much more!
+
+For more detailed documentation and examples, please check the API reference and examples sections.

docs/index.rst

@@ -9,8 +9,22 @@ Welcome to neonize's documentation!
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
+
+   getstarted
+
+.. toctree::
+   :maxdepth: 2
+   :caption: API Reference:
+
    source/modules
 
+.. toctree::
+   :maxdepth: 1
+   :caption: Development:
+
+   GitHub Repository <https://github.com/krypton-byte/neonize>
+   Issue Tracker <https://github.com/krypton-byte/neonize/issues>
+
 
 Indices and tables
 ==================

examples/async_basic.py

@@ -21,7 +21,7 @@
 )
 from neonize.types import MessageServerID
 from neonize.utils import log
-from neonize.utils.enum import ReceiptType
+from neonize.utils.enum import ReceiptType, VoteType
 
 sys.path.insert(0, os.getcwd())
 
@@ -230,6 +230,14 @@ async def handler(client: NewAClient, message: MessageEv):
             await client.send_message(
                 chat, (await client.chat_settings.get_chat_settings(chat)).__str__()
             )
+        case "poll_vote":
+            await client.send_message(chat, await client.build_poll_vote_creation(
+                "Food",
+                ["Pizza", "Burger", "Sushi"],
+                VoteType.SINGLE,
+            ))
+        case "send_react":
+            await client.send_message(chat, await client.build_reaction(chat, message.Info.MessageSource.Sender, message.Info.ID, reaction="🗿"))
         case "edit_message":
             text = "Hello World"
             id_msg = None

examples/basic.py

@@ -21,7 +21,7 @@
 )
 from neonize.types import MessageServerID
 from neonize.utils import log, build_jid
-from neonize.utils.enum import ReceiptType
+from neonize.utils.enum import ReceiptType, VoteType
 
 sys.path.insert(0, os.getcwd())
 
@@ -226,6 +226,14 @@ def handler(client: NewClient, message: MessageEv):
             client.chat_settings.put_archived(chat, False)
         case "get_chat_settings":
             client.send_message(chat, client.chat_settings.get_chat_settings(chat).__str__())
+        case "poll_vote":
+            client.send_message(chat, client.build_poll_vote_creation(
+                "Food",
+                ["Pizza", "Burger", "Sushi"],
+                VoteType.SINGLE,
+            ))
+        case "send_react":
+            client.send_message(chat, client.build_reaction(chat, message.Info.MessageSource.Sender, message.Info.ID, reaction="🗿"))
         case "edit_message":
             text = "Hello World"
             id_msg = None

goneonize/chat_settings_store.go

@@ -14,6 +14,7 @@ import (
 	"github.com/krypton-byte/neonize/utils"
 )
 import (
+	"context"
 	"time"
 
 	"google.golang.org/protobuf/proto"
@@ -23,7 +24,7 @@ import (
 func PutMutedUntil(id *C.char, user *C.uchar, userSize C.int, mutedUntil C.float) *C.char {
 	var JID defproto.JID
 	proto.Unmarshal(getByteByAddr(user, userSize), &JID)
-	err := clients[C.GoString(id)].Store.ChatSettings.PutMutedUntil(utils.DecodeJidProto(&JID), time.Unix(int64(mutedUntil), 0))
+	err := clients[C.GoString(id)].Store.ChatSettings.PutMutedUntil(context.Background(), utils.DecodeJidProto(&JID), time.Unix(int64(mutedUntil), 0))
 	if err != nil {
 		return C.CString(err.Error())
 	}
@@ -34,7 +35,7 @@ func PutMutedUntil(id *C.char, user *C.uchar, userSize C.int, mutedUntil C.float
 func GetChatSettings(id *C.char, user *C.uchar, userSize C.int) C.struct_BytesReturn {
 	var JID defproto.JID
 	proto.Unmarshal(getByteByAddr(user, userSize), &JID)
-	local_chat_settings, err := clients[C.GoString(id)].Store.ChatSettings.GetChatSettings(utils.DecodeJidProto(&JID))
+	local_chat_settings, err := clients[C.GoString(id)].Store.ChatSettings.GetChatSettings(context.Background(), utils.DecodeJidProto(&JID))
 	return_ := defproto.ReturnFunctionWithError{}
 	if err != nil {
 		return_.Error = proto.String(err.Error())

goneonize/contact_store.go

@@ -7,7 +7,11 @@ import (
 	"github.com/krypton-byte/neonize/utils"
 	"google.golang.org/protobuf/proto"
 )
-import "go.mau.fi/whatsmeow/store"
+import (
+	"context"
+
+	"go.mau.fi/whatsmeow/store"
+)
 
 //export PutPushName
 func PutPushName(id *C.char, user *C.uchar, userSize C.int, pushname *C.char) C.struct_BytesReturn {
@@ -17,7 +21,7 @@ func PutPushName(id *C.char, user *C.uchar, userSize C.int, pushname *C.char) C.
 		panic(err)
 	}
 	return_ := defproto.ContactsPutPushNameReturnFunction{}
-	status, prev_name, err := clients[C.GoString(id)].Store.Contacts.PutPushName(utils.DecodeJidProto(&userJID), C.GoString(pushname))
+	status, prev_name, err := clients[C.GoString(id)].Store.Contacts.PutPushName(context.Background(), utils.DecodeJidProto(&userJID), C.GoString(pushname))
 	return_.PreviousName = proto.String(prev_name)
 	return_.Status = &status
 	if err != nil {
@@ -38,7 +42,7 @@ func PutBusinessName(id *C.char, user *C.uchar, userSize C.int, businessName *C.
 		panic(err)
 	}
 	return_ := defproto.ContactsPutPushNameReturnFunction{}
-	status, prev_name, err := clients[C.GoString(id)].Store.Contacts.PutBusinessName(utils.DecodeJidProto(&userJID), C.GoString(businessName))
+	status, prev_name, err := clients[C.GoString(id)].Store.Contacts.PutBusinessName(context.Background(), utils.DecodeJidProto(&userJID), C.GoString(businessName))
 	return_.PreviousName = proto.String(prev_name)
 	return_.Status = &status
 	if err != nil {
@@ -58,7 +62,7 @@ func PutContactName(id *C.char, user *C.uchar, userSize C.int, fullName, firstNa
 	if err != nil {
 		panic(err)
 	}
-	err_ := clients[C.GoString(id)].Store.Contacts.PutContactName(utils.DecodeJidProto(&userJID), C.GoString(fullName), C.GoString(firstName))
+	err_ := clients[C.GoString(id)].Store.Contacts.PutContactName(context.Background(), utils.DecodeJidProto(&userJID), C.GoString(fullName), C.GoString(firstName))
 	if err_ != nil {
 		return C.CString(err_.Error())
 	}
@@ -76,7 +80,7 @@ func PutAllContactNames(id *C.char, contacts *C.uchar, contactsSize C.int) *C.ch
 	for i, centry := range entry.ContactEntry {
 		contactEntry[i] = *utils.DecodeContactEntry(centry)
 	}
-	err_r := clients[C.GoString(id)].Store.Contacts.PutAllContactNames(contactEntry)
+	err_r := clients[C.GoString(id)].Store.Contacts.PutAllContactNames(context.Background(), contactEntry)
 	if err_r != nil {
 		return C.CString(err_r.Error())
 	}
@@ -90,7 +94,7 @@ func GetContact(id *C.char, user *C.uchar, userSize C.int) C.struct_BytesReturn
 	if err != nil {
 		panic(err)
 	}
-	contact_info, err_ := clients[C.GoString(id)].Store.Contacts.GetContact(utils.DecodeJidProto(&userJID))
+	contact_info, err_ := clients[C.GoString(id)].Store.Contacts.GetContact(context.Background(), utils.DecodeJidProto(&userJID))
 	return_ := defproto.ContactsGetContactReturnFunction{
 		ContactInfo: utils.EncodeContactInfo(contact_info),
 	}
@@ -106,7 +110,7 @@ func GetContact(id *C.char, user *C.uchar, userSize C.int) C.struct_BytesReturn
 
 //export GetAllContacts
 func GetAllContacts(id *C.char) C.struct_BytesReturn {
-	contacts, err := clients[C.GoString(id)].Store.Contacts.GetAllContacts()
+	contacts, err := clients[C.GoString(id)].Store.Contacts.GetAllContacts(context.Background())
 	return_ := defproto.ContactsGetAllContactsReturnFunction{
 		Contact: utils.EncodeContacts(contacts),
 	}