upa-url 0.0.2__tar.gz

upa_url-0.0.2/CMakeLists.txt

@@ -0,0 +1,47 @@
+# INFO:
+# https://nanobind.readthedocs.io/en/latest/building.html
+#
+cmake_minimum_required(VERSION 3.15...3.27)
+project(upa_url_py LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+if (CMAKE_VERSION VERSION_LESS 3.18)
+  set(DEV_MODULE Development)
+else()
+  set(DEV_MODULE Development.Module)
+endif()
+
+find_package(Python 3.8
+  COMPONENTS Interpreter ${DEV_MODULE} REQUIRED
+  OPTIONAL_COMPONENTS Development.SABIModule)
+
+find_package(nanobind CONFIG REQUIRED)
+
+if (NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
+  set(CMAKE_BUILD_TYPE Release CACHE STRING "Choose the type of build." FORCE)
+  set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "MinSizeRel" "RelWithDebInfo")
+endif()
+
+include_directories(ext)
+
+nanobind_add_module(
+  # Module name
+  upa_url
+
+  # Target the stable ABI for Python 3.12+, which reduces
+  # the number of binary wheels that must be built. This
+  # does nothing on older Python versions
+  STABLE_ABI
+
+  # Build libnanobind statically and merge it into the
+  # extension (which itself remains a shared library)
+  NB_STATIC
+
+  # Source code
+  src/upa_url_bind.cpp
+  ext/upa/url.cpp)
+
+# Install directive for scikit-build-core
+install(TARGETS upa_url LIBRARY DESTINATION upa_url)

upa_url-0.0.2/LICENSE

@@ -0,0 +1,102 @@
+BSD 2-Clause License
+
+Copyright (c) 2016-2025 Rimas Misevičius
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+-------------------------------------------------------------------------------
+
+Files buffer.h, url.h, url_percent_encode.h contains portions of modified code
+from the Chromium project licensed as follows:
+
+// Copyright 2015 The Chromium Authors. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+-------------------------------------------------------------------------------
+
+Files config.h, url_utf.h contains portions of modified code from the ICU
+project licensed as follows:
+
+UNICODE LICENSE V3
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright © 2016-2023 Unicode, Inc.
+
+NOTICE TO USER: Carefully read the following legal agreement. BY
+DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR
+SOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT
+DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of data files and any associated documentation (the "Data Files") or
+software and any associated documentation (the "Software") to deal in the
+Data Files or Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, and/or sell
+copies of the Data Files or Software, and to permit persons to whom the
+Data Files or Software are furnished to do so, provided that either (a)
+this copyright and permission notice appear with all copies of the Data
+Files or Software, or (b) this copyright and permission notice appear in
+associated Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
+THIRD PARTY RIGHTS.
+
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE
+BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
+OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA
+FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder shall
+not be used in advertising or otherwise to promote the sale, use or other
+dealings in these Data Files or Software without prior written
+authorization of the copyright holder.

upa_url-0.0.2/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: upa_url
+Version: 0.0.2
+Summary: WHATWG URL Standard compliant URL parser library
+Author-Email: =?utf-8?q?Rimas_Misevi=C4=8Dius?= <rmisev3@gmail.com>
+License-Expression: BSD-2-Clause
+License-File: LICENSE
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python :: 3
+Project-URL: Homepage, https://github.com/upa-url/upa_url-py
+Project-URL: Issues, https://github.com/upa-url/upa_url-py/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# upa_url package
+
+This package provides Python bindings for [Upa URL](https://github.com/upa-url/upa) – a library compliant with the [WHATWG URL standard](https://url.spec.whatwg.org/). This is the same standard followed by modern browsers and JavaScript runtimes such as Bun, Deno, and Node.js.
+
+This package is designed to be as close to the URL standard as possible. It uses the same class names ([URL](https://url.spec.whatwg.org/#url-class), [URLSearchParams](https://url.spec.whatwg.org/#interface-urlsearchparams)), their function names, the same function parameters, and the same behavior.
+
+## Installation
+
+```sh
+pip install upa_url
+```
+
+If the binary wheel is not available for your platform, then you will need a C++ compiler that supports C++17 and CMake to build the Python package.
+
+## Getting started
+
+First you need import classes:
+```python
+from upa_url import URL, URLSearchParams
+```
+
+### URL class
+
+The `URL` class provides a structured way to parse, manipulate, and serialize URLs.
+
+An URL can be parsed using one of two methods:
+1. Use `URL` constructor. It throws an exception on error:
+   ```python
+   try:
+       url = URL('https://upa-url.github.io/docs/')
+       print(url.href)
+   except Exception:
+       print('URL parse error')
+   ```
+2. Use `URL.parse` fucntion. It returns `None` on error:
+   ```python
+   url = URL.parse('docs', 'https://upa-url.github.io')
+   if url is not None:
+       print(url.href)
+   ```
+The parsed URL object components can be accessed using getters and setters: `href`, `origin` (only get value), `protocol`, `username`, `password`, `host`, `hostname`, `port`, `pathname`, `search` and `hash`. Also you can get and change search parameters using `searchParams` getter which returns `URLSearchParams` object associated with URL:
+```python
+url = URL.parse('https://example.org')
+if url is not None:
+    url.searchParams.append('lang', 'lt')
+    print(url.href) # https://example.org/?lang=lt
+```
+
+To serialize parsed URL use `url.href` or `str(url)`.
+
+If you need only check URL validity, then `URL.canParse` function can be used:
+```python
+if URL.canParse('docs', 'https://upa-url.github.io'):
+    print('URL is valid')
+```
+
+### URLSearchParams class
+
+The `URLSearchParams` class provides a structured way to parse, manipulate, and serialize the query string of a URL.
+
+An `URLSearchParams` object can be created by using constructor:
+1. To create empty: `params = URLSearchParams()`
+2. Create from string: `params = URLSearchParams('lang=lt&id=123')`
+3. Create from dictionary or list:
+   ```python
+   params1 = URLSearchParams({'lang': 'lt', 'id': '123'})
+   params2 = URLSearchParams([('lang', 'lt'), ['id', '123']])
+   ```
+
+Use `get` or `getAll` to retrieve parameter values:
+```python
+params = URLSearchParams('a=b&a=c&b=10')
+print(params.get('a'))    # b
+print(params.getAll('a')) # ['b', 'c']
+```
+
+To check for name and optionally value in parameters, use the `has` function:
+```python
+print(params.has('a'))      # True
+print(params.has('a', 'c')) # True
+print(params.has('c'))      # False
+```
+
+Iterate over all parameters:
+```python
+params = URLSearchParams('a=1&b=2')
+# Get all name - value pairs:
+for name, value in params:
+    print(name, '=', value)
+# Get all parameter names
+for name in params.keys():
+    print(name)
+# Get all parameter values
+for value in params.values():
+    print(value)
+```
+
+Count parameters:
+```python
+print(params.size) # 2
+print(len(params)) # 2
+```
+
+To serialize `URLSearchParams` object use `str(params)`.
+
+There are functions to manipulate search parameters:
+1. Add or replace parameters:
+   ```python
+   params = URLSearchParams('a=a')
+   params.append('a', 'aa')
+   params.append('b', 'bb')
+   print(params) # a=a&a=aa&b=bb
+   params.set('a', '1')
+   print(params) # a=1&b=bb
+   ```
+2. Remove parameters:
+   ```python
+   params = URLSearchParams('a=a&a=aa&b=b&b=bb')
+   params.delete('a')
+   print(params) # b=b&b=bb
+   params.delete('b', 'bb')
+   print(params) # b=b
+   ```
+3. Sort parameters by name:
+   ```python
+   params = URLSearchParams('c=1&b=2&a=3')
+   params.sort()
+   print(params) # a=3&b=2&c=1
+   ```
+
+## License
+
+This package is licensed under the [BSD 2-Clause License](https://opensource.org/license/bsd-2-clause/) (see `LICENSE` file).

upa_url-0.0.2/README.md

@@ -0,0 +1,133 @@
+# upa_url package
+
+This package provides Python bindings for [Upa URL](https://github.com/upa-url/upa) – a library compliant with the [WHATWG URL standard](https://url.spec.whatwg.org/). This is the same standard followed by modern browsers and JavaScript runtimes such as Bun, Deno, and Node.js.
+
+This package is designed to be as close to the URL standard as possible. It uses the same class names ([URL](https://url.spec.whatwg.org/#url-class), [URLSearchParams](https://url.spec.whatwg.org/#interface-urlsearchparams)), their function names, the same function parameters, and the same behavior.
+
+## Installation
+
+```sh
+pip install upa_url
+```
+
+If the binary wheel is not available for your platform, then you will need a C++ compiler that supports C++17 and CMake to build the Python package.
+
+## Getting started
+
+First you need import classes:
+```python
+from upa_url import URL, URLSearchParams
+```
+
+### URL class
+
+The `URL` class provides a structured way to parse, manipulate, and serialize URLs.
+
+An URL can be parsed using one of two methods:
+1. Use `URL` constructor. It throws an exception on error:
+   ```python
+   try:
+       url = URL('https://upa-url.github.io/docs/')
+       print(url.href)
+   except Exception:
+       print('URL parse error')
+   ```
+2. Use `URL.parse` fucntion. It returns `None` on error:
+   ```python
+   url = URL.parse('docs', 'https://upa-url.github.io')
+   if url is not None:
+       print(url.href)
+   ```
+The parsed URL object components can be accessed using getters and setters: `href`, `origin` (only get value), `protocol`, `username`, `password`, `host`, `hostname`, `port`, `pathname`, `search` and `hash`. Also you can get and change search parameters using `searchParams` getter which returns `URLSearchParams` object associated with URL:
+```python
+url = URL.parse('https://example.org')
+if url is not None:
+    url.searchParams.append('lang', 'lt')
+    print(url.href) # https://example.org/?lang=lt
+```
+
+To serialize parsed URL use `url.href` or `str(url)`.
+
+If you need only check URL validity, then `URL.canParse` function can be used:
+```python
+if URL.canParse('docs', 'https://upa-url.github.io'):
+    print('URL is valid')
+```
+
+### URLSearchParams class
+
+The `URLSearchParams` class provides a structured way to parse, manipulate, and serialize the query string of a URL.
+
+An `URLSearchParams` object can be created by using constructor:
+1. To create empty: `params = URLSearchParams()`
+2. Create from string: `params = URLSearchParams('lang=lt&id=123')`
+3. Create from dictionary or list:
+   ```python
+   params1 = URLSearchParams({'lang': 'lt', 'id': '123'})
+   params2 = URLSearchParams([('lang', 'lt'), ['id', '123']])
+   ```
+
+Use `get` or `getAll` to retrieve parameter values:
+```python
+params = URLSearchParams('a=b&a=c&b=10')
+print(params.get('a'))    # b
+print(params.getAll('a')) # ['b', 'c']
+```
+
+To check for name and optionally value in parameters, use the `has` function:
+```python
+print(params.has('a'))      # True
+print(params.has('a', 'c')) # True
+print(params.has('c'))      # False
+```
+
+Iterate over all parameters:
+```python
+params = URLSearchParams('a=1&b=2')
+# Get all name - value pairs:
+for name, value in params:
+    print(name, '=', value)
+# Get all parameter names
+for name in params.keys():
+    print(name)
+# Get all parameter values
+for value in params.values():
+    print(value)
+```
+
+Count parameters:
+```python
+print(params.size) # 2
+print(len(params)) # 2
+```
+
+To serialize `URLSearchParams` object use `str(params)`.
+
+There are functions to manipulate search parameters:
+1. Add or replace parameters:
+   ```python
+   params = URLSearchParams('a=a')
+   params.append('a', 'aa')
+   params.append('b', 'bb')
+   print(params) # a=a&a=aa&b=bb
+   params.set('a', '1')
+   print(params) # a=1&b=bb
+   ```
+2. Remove parameters:
+   ```python
+   params = URLSearchParams('a=a&a=aa&b=b&b=bb')
+   params.delete('a')
+   print(params) # b=b&b=bb
+   params.delete('b', 'bb')
+   print(params) # b=b
+   ```
+3. Sort parameters by name:
+   ```python
+   params = URLSearchParams('c=1&b=2&a=3')
+   params.sort()
+   print(params) # a=3&b=2&c=1
+   ```
+
+## License
+
+This package is licensed under the [BSD 2-Clause License](https://opensource.org/license/bsd-2-clause/) (see `LICENSE` file).