base62-py 1.3.13__tar.gz

base62_py-1.3.13/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cyril Dever
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS 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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

base62_py-1.3.13/MANIFEST.in

@@ -0,0 +1,2 @@
+exclude publish.sh
+exclude *.jsonl

base62_py-1.3.13/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.1
+Name: base62-py
+Version: 1.3.13
+Summary: Custom Base-62 Encoder in Python
+Author-email: Cyril Dever <cdever@pep-s.com>
+License: MIT License
+        
+        Copyright (c) 2024 Cyril Dever
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS 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. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/cyrildever/base62
+Keywords: base62,base-62,encoder,decoder
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10.2
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: py-utls>=0.3.0
+
+# base62-ts
+_Custom Base-62 Encoder_
+
+![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/cyrildever/base62)
+![GitHub last commit](https://img.shields.io/github/last-commit/cyrildever/base62)
+![GitHub issues](https://img.shields.io/github/issues/cyrildever/base62)
+![npm](https://img.shields.io/npm/dw/base62-ts)
+![NPM](https://img.shields.io/npm/l/base62-ts)
+
+This repository contains the version of my encoder/decoder for Base-62 in three languages:
+* [Golang](https://github.com/cyrildever/base62);
+* Python;
+* [TypeScript](https://github.com/cyrildever/base62/ts).
+
+
+### Motivation
+
+I needed an efficient way to apply a Base-62 encoding/decoding algorithm working the same way in TypeScript/Javascript, Golang and Python environments.
+
+
+### Usage
+
+Both versions use the same following dictionary:
+
+| Value | Character | Value | Character | Value | Character | Value | Character | Value | Character |
+|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|
+|   0   |    `0`    |   13  |    `d`    |   26  |    `q`    |   39  |    `D`    |   52  |    `Q`    |
+|   1   |    `1`    |   14  |    `e`    |   27  |    `r`    |   40  |    `E`    |   53  |    `R`    |
+|   2   |    `2`    |   15  |    `f`    |   28  |    `s`    |   41  |    `F`    |   54  |    `S`    |
+|   3   |    `3`    |   16  |    `g`    |   29  |    `t`    |   42  |    `G`    |   55  |    `T`    |
+|   4   |    `4`    |   17  |    `h`    |   30  |    `u`    |   43  |    `H`    |   56  |    `U`    |
+|   5   |    `5`    |   18  |    `i`    |   31  |    `v`    |   44  |    `I`    |   57  |    `V`    |
+|   6   |    `6`    |   19  |    `j`    |   32  |    `w`    |   45  |    `J`    |   58  |    `W`    |
+|   7   |    `7`    |   20  |    `k`    |   33  |    `x`    |   46  |    `K`    |   59  |    `X`    |
+|   8   |    `8`    |   21  |    `l`    |   34  |    `y`    |   47  |    `L`    |   60  |    `Y`    |
+|   9   |    `9`    |   22  |    `m`    |   35  |    `z`    |   48  |    `M`    |   61  |    `Z`    |
+|   10  |    `a`    |   23  |    `n`    |   36  |    `A`    |   49  |    `N`    |       |           |
+|   11  |    `b`    |   24  |    `o`    |   37  |    `B`    |   50  |    `O`    |       |           |
+|   12  |    `c`    |   25  |    `p`    |   38  |    `C`    |   51  |    `P`    |       |           |
+
+In other words, they use the following base: `0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ`.
+
+```console
+pip install base62-py
+```
+
+```python
+from base62 import decode, encode
+
+value = 18969
+
+encoded = encode(value)
+
+# 4VX
+print(encoded)
+
+decoded = decode(encoded)
+
+assert value == decoded
+```
+
+
+### Tests
+
+```console
+$ pip install -e . && python3 -m unittest discover
+```
+
+
+### License
+
+Both versions are available under a MIT license (see [LICENSE](LICENSE)).
+
+
+<hr />
+&copy; 2021-2024 Cyril Dever. All rights reserved.

base62_py-1.3.13/README.md

@@ -0,0 +1,76 @@
+# base62-ts
+_Custom Base-62 Encoder_
+
+![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/cyrildever/base62)
+![GitHub last commit](https://img.shields.io/github/last-commit/cyrildever/base62)
+![GitHub issues](https://img.shields.io/github/issues/cyrildever/base62)
+![npm](https://img.shields.io/npm/dw/base62-ts)
+![NPM](https://img.shields.io/npm/l/base62-ts)
+
+This repository contains the version of my encoder/decoder for Base-62 in three languages:
+* [Golang](https://github.com/cyrildever/base62);
+* Python;
+* [TypeScript](https://github.com/cyrildever/base62/ts).
+
+
+### Motivation
+
+I needed an efficient way to apply a Base-62 encoding/decoding algorithm working the same way in TypeScript/Javascript, Golang and Python environments.
+
+
+### Usage
+
+Both versions use the same following dictionary:
+
+| Value | Character | Value | Character | Value | Character | Value | Character | Value | Character |
+|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|
+|   0   |    `0`    |   13  |    `d`    |   26  |    `q`    |   39  |    `D`    |   52  |    `Q`    |
+|   1   |    `1`    |   14  |    `e`    |   27  |    `r`    |   40  |    `E`    |   53  |    `R`    |
+|   2   |    `2`    |   15  |    `f`    |   28  |    `s`    |   41  |    `F`    |   54  |    `S`    |
+|   3   |    `3`    |   16  |    `g`    |   29  |    `t`    |   42  |    `G`    |   55  |    `T`    |
+|   4   |    `4`    |   17  |    `h`    |   30  |    `u`    |   43  |    `H`    |   56  |    `U`    |
+|   5   |    `5`    |   18  |    `i`    |   31  |    `v`    |   44  |    `I`    |   57  |    `V`    |
+|   6   |    `6`    |   19  |    `j`    |   32  |    `w`    |   45  |    `J`    |   58  |    `W`    |
+|   7   |    `7`    |   20  |    `k`    |   33  |    `x`    |   46  |    `K`    |   59  |    `X`    |
+|   8   |    `8`    |   21  |    `l`    |   34  |    `y`    |   47  |    `L`    |   60  |    `Y`    |
+|   9   |    `9`    |   22  |    `m`    |   35  |    `z`    |   48  |    `M`    |   61  |    `Z`    |
+|   10  |    `a`    |   23  |    `n`    |   36  |    `A`    |   49  |    `N`    |       |           |
+|   11  |    `b`    |   24  |    `o`    |   37  |    `B`    |   50  |    `O`    |       |           |
+|   12  |    `c`    |   25  |    `p`    |   38  |    `C`    |   51  |    `P`    |       |           |
+
+In other words, they use the following base: `0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ`.
+
+```console
+pip install base62-py
+```
+
+```python
+from base62 import decode, encode
+
+value = 18969
+
+encoded = encode(value)
+
+# 4VX
+print(encoded)
+
+decoded = decode(encoded)
+
+assert value == decoded
+```
+
+
+### Tests
+
+```console
+$ pip install -e . && python3 -m unittest discover
+```
+
+
+### License
+
+Both versions are available under a MIT license (see [LICENSE](LICENSE)).
+
+
+<hr />
+&copy; 2021-2024 Cyril Dever. All rights reserved.

base62_py-1.3.13/pyproject.toml

@@ -0,0 +1,34 @@
+# pyproject.toml
+
+[build-system]
+requires = ["setuptools>=58.1.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "base62-py"
+version = "1.3.13"
+description = "Custom Base-62 Encoder in Python"
+readme = "README.md"
+authors = [{ name = "Cyril Dever", email = "cdever@pep-s.com" }]
+license = { file = "LICENSE" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+keywords = [
+    "base62",
+    "base-62",
+    "encoder",
+    "decoder"
+]
+dependencies = [
+    "py-utls>=0.3.0"
+]
+requires-python = ">=3.10.2"
+
+[project.urls]
+Homepage = "https://github.com/cyrildever/base62"
+
+[project.scripts]
+base62-py = "base62.__main__:main"

base62_py-1.3.13/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

base62_py-1.3.13/src/base62/__init__.py

@@ -0,0 +1,7 @@
+# __init__.py
+
+__version__ = "1.3.13"
+
+from .base62 import *
+from .decoder import *
+from .encoder import *

base62_py-1.3.13/src/base62/__main__.py

@@ -0,0 +1,33 @@
+import argparse
+
+
+def main(args):
+    """
+    Encode/Decode an integer back-and-forth its Base-62 string representation
+
+    Arguments
+    ---------
+    value: string
+        the value to encode or decode
+    -o --operation: string
+        the operation to process: decode|encode
+
+    Usage
+    -----
+    $ python -m base62 -o decode 4VX
+    """
+    print(args)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("value", help="the value to encode or decode", required=True)
+    parser.add_argument(
+        "-o",
+        "--operation",
+        help="the operation to process: decode|encode",
+        required=True,
+    )
+    args = parser.parse_args()
+
+    main(args)

base62_py-1.3.13/src/base62/base62.py

@@ -0,0 +1 @@
+CHARSET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"

base62_py-1.3.13/src/base62/decoder.py

@@ -0,0 +1,22 @@
+import math
+
+from base62 import CHARSET
+
+
+def decode(value: str) -> int:
+    """
+    Takes an encoded base-62 string and returns its integer value
+
+    :param value: The Base-62 encoded string
+    :type value: str
+    :return: The decoded number
+    :rtype: int
+    """
+    decoded = 0
+    for i in range(len(value)):
+        idx = len(value) - i - 1
+        n = CHARSET.index(value[idx])
+        if n == -1:
+            raise Exception("not a base-62 input")
+        decoded += int(n * math.pow(62, i))
+    return decoded

base62_py-1.3.13/src/base62/encoder.py

@@ -0,0 +1,21 @@
+from pyutls import euclidean_division
+
+from base62 import CHARSET
+
+
+def encode(value: int) -> str:
+    """
+    Returns the Base62-encoded string representation of the passed number
+
+    :param value: The integer to encode
+    :type value: int
+    :return: The base-62 representation
+    :rtype: str
+    """
+    if value == 0:
+        return "0"
+    encoded = ""
+    while value > 0:
+        value, idx = euclidean_division(value, 62)
+        encoded = CHARSET[idx] + encoded
+    return encoded

base62_py-1.3.13/src/base62_py.egg-info/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.1
+Name: base62-py
+Version: 1.3.13
+Summary: Custom Base-62 Encoder in Python
+Author-email: Cyril Dever <cdever@pep-s.com>
+License: MIT License
+        
+        Copyright (c) 2024 Cyril Dever
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS 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. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/cyrildever/base62
+Keywords: base62,base-62,encoder,decoder
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10.2
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: py-utls>=0.3.0
+
+# base62-ts
+_Custom Base-62 Encoder_
+
+![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/cyrildever/base62)
+![GitHub last commit](https://img.shields.io/github/last-commit/cyrildever/base62)
+![GitHub issues](https://img.shields.io/github/issues/cyrildever/base62)
+![npm](https://img.shields.io/npm/dw/base62-ts)
+![NPM](https://img.shields.io/npm/l/base62-ts)
+
+This repository contains the version of my encoder/decoder for Base-62 in three languages:
+* [Golang](https://github.com/cyrildever/base62);
+* Python;
+* [TypeScript](https://github.com/cyrildever/base62/ts).
+
+
+### Motivation
+
+I needed an efficient way to apply a Base-62 encoding/decoding algorithm working the same way in TypeScript/Javascript, Golang and Python environments.
+
+
+### Usage
+
+Both versions use the same following dictionary:
+
+| Value | Character | Value | Character | Value | Character | Value | Character | Value | Character |
+|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|:-----:|:---------:|
+|   0   |    `0`    |   13  |    `d`    |   26  |    `q`    |   39  |    `D`    |   52  |    `Q`    |
+|   1   |    `1`    |   14  |    `e`    |   27  |    `r`    |   40  |    `E`    |   53  |    `R`    |
+|   2   |    `2`    |   15  |    `f`    |   28  |    `s`    |   41  |    `F`    |   54  |    `S`    |
+|   3   |    `3`    |   16  |    `g`    |   29  |    `t`    |   42  |    `G`    |   55  |    `T`    |
+|   4   |    `4`    |   17  |    `h`    |   30  |    `u`    |   43  |    `H`    |   56  |    `U`    |
+|   5   |    `5`    |   18  |    `i`    |   31  |    `v`    |   44  |    `I`    |   57  |    `V`    |
+|   6   |    `6`    |   19  |    `j`    |   32  |    `w`    |   45  |    `J`    |   58  |    `W`    |
+|   7   |    `7`    |   20  |    `k`    |   33  |    `x`    |   46  |    `K`    |   59  |    `X`    |
+|   8   |    `8`    |   21  |    `l`    |   34  |    `y`    |   47  |    `L`    |   60  |    `Y`    |
+|   9   |    `9`    |   22  |    `m`    |   35  |    `z`    |   48  |    `M`    |   61  |    `Z`    |
+|   10  |    `a`    |   23  |    `n`    |   36  |    `A`    |   49  |    `N`    |       |           |
+|   11  |    `b`    |   24  |    `o`    |   37  |    `B`    |   50  |    `O`    |       |           |
+|   12  |    `c`    |   25  |    `p`    |   38  |    `C`    |   51  |    `P`    |       |           |
+
+In other words, they use the following base: `0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ`.
+
+```console
+pip install base62-py
+```
+
+```python
+from base62 import decode, encode
+
+value = 18969
+
+encoded = encode(value)
+
+# 4VX
+print(encoded)
+
+decoded = decode(encoded)
+
+assert value == decoded
+```
+
+
+### Tests
+
+```console
+$ pip install -e . && python3 -m unittest discover
+```
+
+
+### License
+
+Both versions are available under a MIT license (see [LICENSE](LICENSE)).
+
+
+<hr />
+&copy; 2021-2024 Cyril Dever. All rights reserved.

base62_py-1.3.13/src/base62_py.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+src/base62/__init__.py
+src/base62/__main__.py
+src/base62/base62.py
+src/base62/decoder.py
+src/base62/encoder.py
+src/base62_py.egg-info/PKG-INFO
+src/base62_py.egg-info/SOURCES.txt
+src/base62_py.egg-info/dependency_links.txt
+src/base62_py.egg-info/entry_points.txt
+src/base62_py.egg-info/requires.txt
+src/base62_py.egg-info/top_level.txt
+tests/test_base62.py

base62_py-1.3.13/src/base62_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

base62_py-1.3.13/src/base62_py.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+base62-py = base62.__main__:main

base62_py-1.3.13/src/base62_py.egg-info/requires.txt

@@ -0,0 +1 @@
+py-utls>=0.3.0

base62_py-1.3.13/src/base62_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+base62

base62_py-1.3.13/tests/test_base62.py

@@ -0,0 +1,26 @@
+from unittest import TestCase
+
+from base62 import decode, encode
+
+
+class TestEncoder(TestCase):
+    def test_decode(self):
+        ref = 18969
+        value = "4VX"
+        found = decode(value)
+        self.assertEqual(found, ref)
+
+        with self.assertRaises(Exception):
+            decode("not-a-base-62%")
+
+        found = decode("0")
+        self.assertEqual(found, 0)
+
+    def test_encode(self):
+        value = 18969
+        expected = "4VX"
+        found = encode(value)
+        self.assertEqual(found, expected)
+
+        found = encode(0)
+        self.assertEqual(found, "0")