feat: base64编码、解码

.gitignore

@@ -0,0 +1,7 @@
+.idea
+*.py[cod]
+__pycache__
+.pytest_cache
+*egg*
+build
+dist

README.rst

@@ -0,0 +1,21 @@
+pyzafa
+===============================================================================
+
+Python自用小功能。安装:
+
+.. code-block:: text
+
+    pip install pyzafa
+
+数据编码
+------------------------------------------------------------------------------
+
+1. unicode字符与base64字符相互转换
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    from pyzafa.data_encoding import base64encode, base64decode
+
+    base64encode('你好，世界')
+    base64decode('5L2g5aW977yM5LiW55WM')

pyzafa/__init__.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

pyzafa/data_encoding.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+"""数据编码"""
+import base64
+
+
+def base64encode(string, encoding='utf-8'):
+    """把一个unicode字符串编码成base64字符串"""
+    if isinstance(string, str):
+        string = string.encode(encoding)
+    return base64.b64encode(string).decode(encoding)
+
+
+def base64decode(string, encoding='utf-8'):
+    """把一个base64字符串解码生unicode字符串"""
+    if isinstance(string, str):
+        string = string.encode(encoding)
+    return base64.b64decode(string).decode(encoding)

setup.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+# Note: To use the 'upload' functionality of this file, you must:
+#   $ pipenv install twine --dev
+
+import io
+import os
+import sys
+from shutil import rmtree
+
+from setuptools import find_packages, setup, Command
+
+# Package meta-data.
+NAME = 'pyzafa'
+DESCRIPTION = 'Python自用小功能'
+URL = 'https://github.com/taishengxin/pyzafa'
+EMAIL = 'taishengxin@gmail.com'
+AUTHOR = 'taishengxin'
+REQUIRES_PYTHON = '>=3.6.0'
+VERSION = '1.0.0'
+
+# What packages are required for this module to be executed?
+REQUIRED = [
+]
+
+# What packages are optional?
+EXTRAS = {
+    # 'fancy feature': ['django'],
+}
+
+# The rest you shouldn't have to touch too much :)
+# ------------------------------------------------
+# Except, perhaps the License and Trove Classifiers!
+# If you do change the License, remember to change the Trove Classifier for that!
+
+here = os.path.abspath(os.path.dirname(__file__))
+
+# Import the README and use it as the long-description.
+# Note: this will only work if 'README.md' is present in your MANIFEST.in file!
+try:
+    with io.open(os.path.join(here, 'README.md'), encoding='utf-8') as f:
+        long_description = '\n' + f.read()
+except FileNotFoundError:
+    long_description = DESCRIPTION
+
+# Load the package's __version__.py module as a dictionary.
+about = {}
+if not VERSION:
+    project_slug = NAME.lower().replace("-", "_").replace(" ", "_")
+    with open(os.path.join(here, project_slug, '__version__.py')) as f:
+        exec(f.read(), about)
+else:
+    about['__version__'] = VERSION
+
+
+class UploadCommand(Command):
+    """Support setup.py upload."""
+
+    description = 'Build and publish the package.'
+    user_options = []
+
+    @staticmethod
+    def status(s):
+        """Prints things in bold."""
+        print('\033[1m{0}\033[0m'.format(s))
+
+    def initialize_options(self):
+        pass
+
+    def finalize_options(self):
+        pass
+
+    def run(self):
+        try:
+            self.status('Removing previous builds…')
+            rmtree(os.path.join(here, 'dist'))
+        except OSError:
+            pass
+
+        self.status('Building Source and Wheel (universal) distribution…')
+        os.system('{0} setup.py sdist bdist_wheel --universal'.format(sys.executable))
+
+        self.status('Uploading the package to PyPI via Twine…')
+        os.system('twine upload dist/*')
+
+        self.status('Pushing git tags…')
+        os.system('git tag v{0}'.format(about['__version__']))
+        os.system('git push --tags')
+
+        sys.exit()
+
+
+# Where the magic happens:
+setup(
+    name=NAME,
+    version=about['__version__'],
+    description=DESCRIPTION,
+    long_description=long_description,
+    long_description_content_type='text/x-rst',
+    author=AUTHOR,
+    author_email=EMAIL,
+    python_requires=REQUIRES_PYTHON,
+    url=URL,
+    packages=find_packages(exclude=["tests", "*.tests", "*.tests.*", "tests.*"]),
+    # If your package is a single module, use this instead of 'packages':
+    # py_modules=['geo_furnace'],
+
+    entry_points={
+        # 'console_scripts': ['geo-furnace=geo_furnace:main'],
+    },
+    install_requires=REQUIRED,
+    extras_require=EXTRAS,
+    include_package_data=True,
+    license='MIT',
+    classifiers=[
+        # Trove classifiers
+        # Full list: https://pypi.python.org/pypi?%3Aaction=list_classifiers
+        'License :: OSI Approved :: MIT License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: Implementation :: CPython',
+        'Programming Language :: Python :: Implementation :: PyPy',
+        'Topic :: Scientific/Engineering :: Bio-Informatics',
+    ],
+    # $ setup.py publish support.
+    cmdclass={
+        'upload': UploadCommand,
+    },
+)

tests/__init__.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

tests/test_data_encoding.py

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-
+from pyzafa.data_encoding import base64decode, base64encode
+
+
+def test_base64_encode():
+    assert base64encode('你好，世界') == '5L2g5aW977yM5LiW55WM'
+
+
+def test_base64_decode():
+    assert base64decode('5L2g5aW977yM5LiW55WM') == '你好，世界'