Quote classes

CHANGES.rst

@@ -6,6 +6,10 @@ CHANGES
 
 * Use fast path if quoted string does not need requoting (#154)
 
+* Speed up quoting/unquoting by `_Quoter` and `_Unquoter` classes (#155)
+
+* Drop `yarl.quote` and `yarl.unquote` public functions (#155)
+
 0.18.0 (2018-01-10)
 -------------------
 

benchmark.py

@@ -2,43 +2,51 @@
 
 
 cython_setup = """\
-from yarl.quoting import _quote as quote
-from yarl.quoting import _unquote as unquote
+from yarl.quoting import _Quoter as Quoter
+from yarl.quoting import _Unquoter as Unquoter
 """
 
 python_setup = """\
-from yarl.quoting import _py_quote as quote
-from yarl.quoting import _py_unquote as unquote
+from yarl.quoting import _PyQuoter as Quoter
+from yarl.quoting import _PyUnquoter as Unquoter
 """
 
 
 print("Cython quote ascii: {:.3f} sec".format(
-    timeit.timeit("quote(s, safe='/')", cython_setup+"s='/path/to'")))
+    timeit.timeit("q(s)",
+                  cython_setup+"s='/path/to';q=Quoter(safe='/')")))
 
 
 print("Python quote ascii: {:.3f} sec".format(
-    timeit.timeit("quote(s, safe='/')", python_setup+"s='/path/to'")))
+    timeit.timeit("q(s)",
+                  python_setup+"s='/path/to';q=Quoter(safe='/')")))
 
 
 print("Cython quote PCT: {:.3f} sec".format(
-    timeit.timeit("quote(s)", cython_setup+"s='abc%0a'")))
+    timeit.timeit("q(s)",
+                  cython_setup+"s='abc%0a';q=Quoter()")))
 
 
 print("Python quote PCT: {:.3f} sec".format(
-    timeit.timeit("quote(s)", python_setup+"s='abc%0a'")))
+    timeit.timeit("q(s)",
+                  python_setup+"s='abc%0a';q=Quoter()")))
 
 
 print("Cython quote: {:.3f} sec".format(
-    timeit.timeit("quote(s)", cython_setup+"s='/путь/файл'")))
+    timeit.timeit("q(s)",
+                  cython_setup+"s='/путь/файл';q=Quoter()")))
 
 
 print("Python quote: {:.3f} sec".format(
-    timeit.timeit("quote(s)", python_setup+"s='/путь/файл'")))
+    timeit.timeit("q(s)",
+                  python_setup+"s='/путь/файл';q=Quoter()")))
 
 
 print("Cython unquote: {:.3f} sec".format(
-    timeit.timeit("unquote(s)", cython_setup+"s='/path/to'")))
+    timeit.timeit("u(s)",
+                  cython_setup+"s='/path/to';u=Unquoter()")))
 
 
 print("Python unquote: {:.3f} sec".format(
-    timeit.timeit("unquote(s)", python_setup+"s='/path/to'")))
+    timeit.timeit("u(s)",
+                  python_setup+"s='/path/to';u=Unquoter()")))