Metadata-Version: 2.4
Name: pysignalclirestapi
Version: 0.3.25
Summary: Small python library for the Signal Cli REST API
Home-page: https://github.com/bbernhard/pysignalclirestapi
Author: Bernhard B.
Author-email: bernhard@liftingcoder.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=2.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: requests
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

Small python library for the [Signal Cli REST API](https://github.com/bbernhard/signal-cli-rest-api)

### Quickstart
If you have set up the REST API already, you can start sending and receiving messages in Python!

Intialize the client
```
# Seperated for clarity
SERVER = "http://localhose:8080" # Your server address and port
SERVER_NUMBER ="+123456789" # The phone number you registered with the API


signal = SignalCliRestApi(SERVER,SERVER_NUMBER) 
```

Send a message
```
myMessage = "Hello World" # Your message
myFriendSteve = +987654321 # The number you want to message (must be registered with Signal)

sendMe = signal.send_message(message=myMessage,recipients=myFriendSteve)

```
receive messages
```
myMessages = signal.receive(send_read_receipts=True) # Send read receipts so everyone knows you have seen their message
```

## Endpoint progress tracking
Anything that was already part of the package before I added stuff should work, but I haven't fully tested all the ones I have added, which is why I haven't tried to merge yet!  If an endpoint is not listed, assume it is not added.

### General
| Service | Status | Function Name | Notes |
| --- | --- | --- | --- |
| about | Working | about() | Was already here. |
No other general endpoints have been added.
### Devices
No device endpoints have been added.
### Accounts
No accounts endpoints have been added.
### Groups
| Service | Status | Function Name | Notes |
| --- | --- | --- | --- |
| GET groups | Working | list_groups() |  |
| POST groups | In Progress | create_group() | Have not run into any issues yet |
| GET group | Working | get_group() | Want to try messing with the group IDs to see how it reacts |
| PUT group | Working | update_group() | Images now work |
| DELETE group | In Progress | delete_group() | Need to try deleting a group that I do not own |
| POST group admins | In Progress | add_group_admins() | Need to try different number types and formats |
| DELETE group admins | In Progress | remove_group_admins() | Need to try different number types and formats |
| POST block group | Untested | block_group() | Need a group I didn't create to test with |
| POST join group | Untested | join_group() | Need a group I didn't create to test with |
| POST group members | In Progress | add_group_members() | Need to try different number types and formats |
| DELETE group members | In Progress | remove_group_members() | Need to try different number types and formats |
| POST quit group | Untested | leave_group() | Need a group I didn't create to test with |

### Messages
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| receive | Working | receive() | Was working when I got here, added some more args and a docstring |
| send | Working* | send_message() | Have not tested with API V1 |

### Attachments
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| attachments | Working | list_attachments() | Converted to new sender |
| GET attachment | Working | get_attachment() | Converted to new sender |
| DELETE attachment | Working | delete_attachment() | Haven't touched |

### Profiles
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| profiles | Testing | update_profile | Converted to new sender, no issues yet |

### Identities
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| identities | Working | list_identities() |  |
| trust identities | In Progress | verify_identity() | Not sure if this should be renamed, also had some issues with the trust all known keys |

### Reactions
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| POST reaction | Working | add_reaction() |  |
| DELETE reaction | Working | remove_reaction() |  |

### Receipts
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| receipts | In Progress | send_receipt() |  |
### Search
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| search | Working* | search() | Seems to only work with numbers in your account region? |

### Sticker Packs
No sticker pack endpoints have been added.

### Contacts
| Service | Status | Function Name | Description |
| --- | --- | --- | --- |
| GET contacts | Working | get_contacts() |  |
| POST contacts | Untested | update_contact() | Must have API set up as main device, which mine is not |
| sync contacts | Untested | sync_contacts() | Must have API set up as main device, which mine is not |

