Metadata-Version: 2.1
Name: ursine
Version: 0.3.1
Summary: library for SIP url handling/maninupation
Home-page: https://github.com/sangoma/ursine
Author: Terry Kerr
Author-email: t@xnr.ca
License: Apache 2
Keywords: sip,voip,url
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Communications :: Telephony
Classifier: Topic :: Communications :: Internet Phone
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: multidict

# ursine - a bearable sip uri library

[![Build Status](https://travis-ci.org/sangoma/ursine.svg?branch=master)](https://travis-ci.org/sangoma/ursine)

----
## installing
ursine is packaged and available on [pypi](https://pypi.org/project/ursine)

```sh
pip install ursine
```

----
## basic usage

```python
from ursine import URI, Header

# build new URIs / Headers
uri = URI.build(scheme='sip', host='10.10.10.10', transport='tcp')
print(uri)  # sip:10.10.10.10;transport=tcp
header = Header.build(display_name='Alice', uri=uri, tag='xyz')
print(header)  # "Alice" <sip:10.10.10.10;transport=tcp>;tag=xyz

# parse existing ones
uri = URI('sips:[::1]:5080')
uri.scheme == 'sips'
uri.host == '[::1]'
uri.transport == 'tcp'

header = Header('"Bob" <sips:[::1]:5080>;tag=abc')
header.display_name == 'Bob'
header.tag == 'abc'
header.uri.scheme == 'sips'

# Header and URI objects are immutable
alice_uri = URI('sip:alice@10.10.10.10')
modified_uri = alice_uri.with_user(None)  # 'sip:10.10.10.10;transport=udp'
modified_uri != alice_uri
```


