Ravenports generated: 10 Aug 2021 02:58
[ravenports.git] / bucket_92 / python-uritemplate
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-uritemplate
4 VERSION=                3.0.1
5 KEYWORDS=               python
6 VARIANTS=               py38 py39
7 SDESC[py38]=            URI templates (PY38)
8 SDESC[py39]=            URI templates (PY39)
9 HOMEPAGE=               https://uritemplate.readthedocs.org
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/bf/0c/60d82c077998feb631608dca3cc1fe19ac074e772bf0c24cf409b977b815
14 DISTFILE[1]=            uritemplate-3.0.1-py2.py3-none-any.whl:main
15 DF_INDEX=               1
16 SPKGS[py38]=            single
17 SPKGS[py39]=            single
18
19 OPTIONS_AVAILABLE=      PY38 PY39
20 OPTIONS_STANDARD=       none
21 VOPTS[py38]=            PY38=ON PY39=OFF
22 VOPTS[py39]=            PY38=OFF PY39=ON
23
24 DISTNAME=               uritemplate-3.0.1.dist-info
25
26 GENERATED=              yes
27
28 [PY38].USES_ON=                         python:py38,wheel
29
30 [PY39].USES_ON=                         python:py39,wheel
31
32 [FILE:2495:descriptions/desc.single]
33 uritemplate
34 ===========
35
36 Documentation_ -- GitHub_ -- Travis-CI_
37
38 Simple python library to deal with `URI Templates`_. The API looks like
39
40 .. code-block:: python
41
42     from uritemplate import URITemplate, expand
43
44     # NOTE: URI params must be strings not integers
45
46     gist_uri = 'https://api.github.com/users/sigmavirus24/gists{/gist_id}'
47     t = URITemplate(gist_uri)
48     print(t.expand(gist_id='123456'))
49     # => https://api.github.com/users/sigmavirus24/gists/123456
50
51     # or
52     print(expand(gist_uri, gist_id='123456'))
53
54     # also
55     t.expand({'gist_id': '123456'})
56     print(expand(gist_uri, {'gist_id': '123456'}))
57
58 Where it might be useful to have a class
59
60 .. code-block:: python
61
62     import requests
63
64     class GitHubUser(object):
65         url = URITemplate('https://api.github.com/user{/login}')
66         def __init__(self, name):
67             self.api_url = url.expand(login=name)
68             response = requests.get(self.api_url)
69             if response.status_code == 200:
70                 self.__dict__.update(response.json())
71
72 When the module containing this class is loaded, ``GitHubUser.url`` is 
73 evaluated and so the template is created once. It's often hard to notice in
74
75 Python, but object creation can consume a great deal of time and so can the
76
77 re module which uritemplate relies on. Constructing the object once should 
78 reduce the amount of time your code takes to run.
79
80 Installing
81 ----------
82
83 ::
84
85     pip install uritemplate
86
87 License
88 -------
89
90 Modified BSD license_
91
92 .. _Documentation: https://uritemplate.readthedocs.io/
93 .. _GitHub: https://github.com/python-hyper/uritemplate
94 .. _Travis-CI: https://travis-ci.org/python-hyper/uritemplate
95 .. _URI Templates: http://tools.ietf.org/html/rfc6570
96 .. _license:
97 https://github.com/python-hyper/uritemplate/blob/master/LICENSE
98
99 Changelog - uritemplate
100 =======================
101
102 3.0.1 - 2019-12-19
103 ------------------
104
105 - Update to Python 3.6, 3.7, and 3.8
106 - Drop support for Python 2.6, 3.2, and 3.3
107 - Ignore None in list argument expansion
108 - Handle a list with an empty string appropriately
109
110 3.0.0 - 2016-08-29
111 ------------------
112
113 - Match major version number of uritemplate.py
114
115 2.0.0 - 2016-08-29
116 ------------------
117
118 - Merge uritemplate.py into uritemplate
119
120 Changelog - uritemplate.py
121 ==========================
122
123 3.0.2 - 2015-08-30
124 ------------------
125
126 - Fix meta-package requirements.
127
128 3.0.1 - 2015-08-29
129 ------------------
130
131 - Deprecate in favor of uritemplate. This package is now a metapackage that
132   depends on uritemplate.
133
134
135 [FILE:117:distinfo]
136 07620c3f3f8eed1f12600845892b0e036a2420acf513c53f7de0abd911a5894f        15615 uritemplate-3.0.1-py2.py3-none-any.whl
137