Added documention for accessing low level client.
This commit is contained in:
		
							parent
							
								
									8a8c94fb5f
								
							
						
					
					
						commit
						1e8ba35f08
					
				
					 2 changed files with 65 additions and 0 deletions
				
			
		
							
								
								
									
										33
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										33
									
								
								README.md
									
										
									
									
									
								
							| 
						 | 
				
			
			@ -35,6 +35,7 @@ span
 | 
			
		|||
- [🔎 Rich Queries and Embedded Models](#-rich-queries-and-embedded-models)
 | 
			
		||||
  - [Querying](#querying)
 | 
			
		||||
  - [Embedded Models](#embedded-models)
 | 
			
		||||
- [Calling Other Redis Commands](#-calling-other-redis-commands)
 | 
			
		||||
- [💻 Installation](#-installation)
 | 
			
		||||
- [📚 Documentation](#-documentation)
 | 
			
		||||
- [⛏️ Troubleshooting](#️-troubleshooting)
 | 
			
		||||
| 
						 | 
				
			
			@ -288,6 +289,38 @@ Customer.find(Customer.address.city == "San Antonio",
 | 
			
		|||
              Customer.address.state == "TX")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Calling Other Redis Commands
 | 
			
		||||
 | 
			
		||||
Sometimes you'll need to run a Redis command directly.  Redis OM supports this through the `db` method on your model's class.  This returns a connected Redis client instance which exposes a function named for each Redis command.  For example, let's perform some basic set operations:
 | 
			
		||||
 | 
			
		||||
```python
 | 
			
		||||
from redis_om import HashModel
 | 
			
		||||
 | 
			
		||||
class Demo(HashModel):
 | 
			
		||||
    some_field: str
 | 
			
		||||
 | 
			
		||||
redis_conn = Demo.db()
 | 
			
		||||
 | 
			
		||||
redis_conn.sadd("myset", "a", "b", "c", "d")
 | 
			
		||||
 | 
			
		||||
# Prints False
 | 
			
		||||
print(redis_conn.sismember("myset", "e"))
 | 
			
		||||
 | 
			
		||||
# Prints True
 | 
			
		||||
print(redis_conn.sismember("myset", "b"))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
The parameters expected by each command function are those documented on the command's page on [redis.io](https://redis.io/commands/).
 | 
			
		||||
 | 
			
		||||
If you don't want to get a Redis connection from a model class, you can also use `get_redis_connection`:
 | 
			
		||||
 | 
			
		||||
```python
 | 
			
		||||
from redis_om import get_redis_connection
 | 
			
		||||
 | 
			
		||||
redis_conn = get_redis_conection()
 | 
			
		||||
redis_conn.set("hello", "world")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## 💻 Installation
 | 
			
		||||
 | 
			
		||||
Installation is simple with `pip`, Poetry, or Pipenv.
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -693,6 +693,38 @@ Customer.find((Customer.last_name == "Brookins") | (
 | 
			
		|||
) & (Customer.last_name == "Smith")).all()
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Calling Other Redis Commands
 | 
			
		||||
 | 
			
		||||
Sometimes you'll need to run a Redis command directly.  Redis OM supports this through the `db` method on your model's class.  This returns a connected Redis client instance which exposes a function named for each Redis command.  For example, let's perform some basic set operations:
 | 
			
		||||
 | 
			
		||||
```python
 | 
			
		||||
from redis_om import HashModel
 | 
			
		||||
 | 
			
		||||
class Demo(HashModel):
 | 
			
		||||
    some_field: str
 | 
			
		||||
 | 
			
		||||
redis_conn = Demo.db()
 | 
			
		||||
 | 
			
		||||
redis_conn.sadd("myset", "a", "b", "c", "d")
 | 
			
		||||
 | 
			
		||||
# Prints False
 | 
			
		||||
print(redis_conn.sismember("myset", "e"))
 | 
			
		||||
 | 
			
		||||
# Prints True
 | 
			
		||||
print(redis_conn.sismember("myset", "b"))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
The parameters expected by each command function are those documented on the command's page on [redis.io](https://redis.io/commands/).
 | 
			
		||||
 | 
			
		||||
If you don't want to get a Redis connection from a model class, you can also use `get_redis_connection`:
 | 
			
		||||
 | 
			
		||||
```python
 | 
			
		||||
from redis_om import get_redis_connection
 | 
			
		||||
 | 
			
		||||
redis_conn = get_redis_conection()
 | 
			
		||||
redis_conn.set("hello", "world")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Next Steps
 | 
			
		||||
 | 
			
		||||
Now that you know the basics of working with Redis OM, start playing around with it in your project!
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue