From a2d3be20bbcd42699a46e36ffab69bae0db54843 Mon Sep 17 00:00:00 2001
From: Peter Annabel <peter.annabel@gmail.com>
Date: Thu, 7 Aug 2025 11:36:12 -0500
Subject: [PATCH] Update readme

---
 README.md | 115 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 114 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index aa6ffcc..85627c5 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,114 @@
-# pysimplesat
\ No newline at end of file
+# pysimplesat - An API library for SimpleSAT, written in Python
+
+pySimpleSAT is a full-featured, type annotated API client written in Python for the SimpleSAT APIs.
+
+This library has been developed with the intention of making the SimpleSAT APIs simple and accessible to non-coders while allowing experienced coders to utilize all features the API has to offer without the boilerplate.
+
+Features:
+=========
+- **100% API Coverage.** All endpoints and response models.
+- **Non-coder friendly.** 100% annotated for full IDE auto-completion. Clients handle requests and authentication - just plug the right details in and go!
+- **Fully annotated.** This library has a strong focus on type safety and type hinting. Models are declared and parsed using [Pydantic](https://github.com/pydantic/pydantic)
+
+pySimpleSAT is currently in **development**.
+
+Known Issues:
+=============
+- As this project is still a WIP, documentation or code commentary may not always align.
+- SimpleSAT Managed SAT post not built
+
+Road Map:
+=============
+- Add support for post
+- Add required parameters when calling completion_certificat endpoint
+
+How-to:
+=============
+- [Install](#install)
+- [Initializing the API Client](#initializing-the-api-client)
+    - [SimpleSAT-API](#simplesat-api)
+- [Working with Endpoints](#working-with-endpoints)
+    - [Get many](#get-many)
+    - [Get one](#get-one)
+    - [Get with params](#get-with-params)
+- [Pagination](#pagination)
+- [Contributing](#contributing)
+- [Supporting the project](#supporting-the-project)
+
+# Install
+Open a terminal and run ```pip install pysimplesat```
+
+# Initializing the API Clients
+
+### SimpleSAT API
+```python
+from pysimplesat import SimpleSATAPIClient
+
+# init client
+sat_api_client = SimpleSATAPIClient(
+  # your api private key,
+)
+```
+
+
+# Working with Endpoints
+Endpoints are 1:1 to what's available for SimpleSAT.
+
+For more information, check out the following resources:
+- [SimpleSAT API Docs](https://developer.simplesat.io/api/)
+
+### Get many
+```python
+# sends GET request to /company/companies endpoint
+companies = sat_api_client.company.companies.get()
+```
+
+### Get one
+```python
+# sends GET request to /company/companies/{id} endpoint
+accounts = sat_api_client.accounts.id("abc123").get()
+```
+
+### Get with params
+```python
+# sends GET request to /company/companies with a conditions query string
+conditional_company = sat_api_client.company.companies.get(params={
+  'conditions': 'company/id=250'
+})
+```
+
+# Pagination
+To make working with paginated data easy, Endpoints that implement a GET response with an array also supply a ```paginated()``` method. Under the hood this wraps a GET or POST request as required, but does a lot of neat stuff to make working with pages easier.
+
+Working with pagination
+```python
+# initialize a PaginatedResponse instance for /agents, starting on page 1 with a pageSize of 100
+paginated_agents = sat_api_client.agents.paginated(1,100)
+
+# access the data from the current page using the .data field
+page_one_data = paginated_agents.data
+
+# if there's a next page, retrieve the next page worth of data
+paginated_agents.get_next_page()
+
+# if there's a previous page, retrieve the previous page worth of data
+paginated_agents.get_previous_page()
+
+# iterate over all companies on the current page
+for agent in paginated_agents:
+  # ... do things ...
+
+# iterate over all companies in all pages
+# this works by yielding every item on the page, then fetching the next page and continuing until there's no data left
+for agent in paginated_agents.all():
+  # ... do things ...
+```
+
+# Contributing
+Contributions to the project are welcome. If you find any issues or have suggestions for improvement, please feel free to open an issue or submit a pull request.
+
+# Supporting the project
+:heart:
+
+# Inspiration and Stolen Code
+The premise behind this came from the [pyConnectWise](https://github.com/HealthITAU/pyconnectwise) package and I stole **most** of the code and adapted it to the SimpleSAT API endpoints.
\ No newline at end of file