feilian 1.3.4__py3-none-any.whl

feilian-1.3.4.dist-info/METADATA

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: feilian
+Version: 1.3.4
+Summary: General data processing tool.
+Author-email: darkpeath <darkpeath@gmail.com>
+Project-URL: Homepage, https://github.com/darkpeath/feilian
+Description-Content-Type: text/markdown
+Requires-Dist: chardet
+Requires-Dist: pandas
+Provides-Extra: extra
+Requires-Dist: tqdm; extra == "extra"
+Requires-Dist: ijson; extra == "extra"
+
+# feilian
+
+General data processing tool.
+
+## Features
+
+- More default values, less necessary arg.
+- Encapsulation of panda dataframe for simple usage.
+
+## Usage
+
+### Process data with pandas dataframe
+
+#### Read a file as dataframe
+
+```python
+import feilian
+
+input_file = ''     # file can be any csv, json, parquet or xlsx format
+df = feilian.read_dataframe(input_file)
+```
+
+#### Write dataframe to a file
+
+```python
+import feilian
+import pandas as pd
+
+df = pd.DataFrame(dict(a=[1, 2, 3], b=[4, 5, 6]))
+output_file = ''  # file can be any csv, json, parquet or xlsx format
+feilian.save_dataframe(output_file, df)
+```
+
+#### Iter a dataframe with a progress bar
+
+```python
+import feilian
+import pandas as pd
+
+df = pd.DataFrame(dict(a=[1, 2, 3], b=[4, 5, 6]))
+feilian.iter_dataframe(data=df, progress_bar="process")
+```
+
+#### Extract sample from a dataframe
+
+```python
+import feilian
+import pandas as pd
+
+df = pd.DataFrame(dict(a=[1, 2, 3], b=[4, 5, 6]))
+sample = feilian.extract_dataframe_sample(size=2, shuffle=True)
+```
+
+#### Test text value in dataframe
+
+```python
+import feilian
+
+s = ''
+
+# test if s is na or empty string
+feilian.is_empty_text(s)
+
+# test if s is not na and non-empty string
+feilian.is_nonempty_text(s)
+
+# test if s is na or blank string
+feilian.is_blank_text(s)
+
+# test if s is not na and non-blank string
+feilian.is_non_blank_text(s)
+```
+
+#### Merge same id rows to one row
+
+```python
+import feilian
+import pandas as pd
+
+df = pd.DataFrame([
+    {"a": "1", "b": "2", "c": "5"},
+    {"a": "2", "b": 6, "c": "8"},
+    {"a": "1", "b": 8, "c": "9"},
+])
+
+res = feilian.merge_dataframe_rows(df, col_id="a", join_sep=",")
+```
+
+### IO for json file
+
+#### Read a json file
+
+```python
+import feilian
+
+input_file = ''
+data = feilian.read_json(input_file)
+```
+
+#### Write a json file
+
+```python
+import feilian
+
+data = [
+    {"a": "1", "b": "2", "c": "5"},
+    {"a": "2", "b": 6, "c": "8"},
+    {"a": "1", "b": 8, "c": "9"},
+]
+output_file = ''
+feilian.save_dataframe(output_file, data)
+```
+
+### Datetime format
+
+```python
+import feilian
+import datetime
+
+d = datetime.datetime.now()
+
+# format a date string
+feilian.format_date(d, sep='-')
+
+# format a time string
+feilian.format_time(d, fmt='%H:%M:%S')
+```
+
+### Process dict
+
+#### Flatten dict value
+
+```python
+import feilian
+
+data = {
+    "a": 12,
+    "b": ["4", "s"],
+    "c": {
+        "l": 0,
+        "j": {
+            "se": "we",
+            "t": 5,
+        }
+    },
+    "f": 7,
+    "g": {
+        "ts": "9w",
+        "j2": 8,
+    },
+    "w": {
+        "s": {
+            "ge": 89,
+            "00": "ej",
+        },
+        "r": {
+            "le": 33,
+            "03": "ef",
+        }
+    },
+    "sk": {
+        "a": "23",
+        "b": {
+            "s": 9,
+            "g": 0,
+            "p": 4,
+        },
+        "c": {
+            "s": 8,
+            "t": "w",
+            "j": "23",
+        }
+    },
+}
+res = feilian.flatten_dict(data, frozen={"g", "w.s", "sk."}, exclude="f")
+```
+
+### Process args 
+
+```python
+from feilian import ArgValueParser
+
+value = ''
+
+# split value
+ArgValueParser.split_strs_to_list(value)
+ArgValueParser.split_strs_to_set(value)
+
+# bound value
+ArgValueParser.bound_set_if_singleton(value)
+ArgValueParser.bound_tuple_if_singleton(value)
+ArgValueParser.bound_list_if_singleton(value)
+
+# force value type
+ArgValueParser.ensure_set(value)
+ArgValueParser.ensure_list(value)
+ArgValueParser.ensure_tuple(value)
+```
+

feilian-1.3.4.dist-info/RECORD

@@ -0,0 +1,18 @@
+feilian/__init__.py,sha256=JR16Mf0rQPgA60-AOQ7KeCU7VQ9zWj-d8UTHiQMeqkA,1286
+feilian/_dist_ver.py,sha256=Sa15b0h5dPrBwT68O64sv25FwCwLjEg7GYtgnB6S3mg,148
+feilian/_typing.py,sha256=5wYeuPbTmweCnP8NwC6qNCCbtTf9D62iAsd7Rn7iAX4,119
+feilian/arg.py,sha256=NEhrSEtQdSnJ0fhTAt1ctbJ7Xh19jzfjcmeMCLUz8DI,8319
+feilian/dataframe.py,sha256=SqvegQEq3jEvDcJoPhBtvYNIc9QAQYwKwcvHZK4I09w,12594
+feilian/datetime.py,sha256=-rZjp2IbYCqoV172CKxstx-psexT9Wca8kuMwUH_in8,765
+feilian/excel.py,sha256=jyPrs4uQ0zKlov2tn10MO6d5jWVGJ4zYzrTF3KveiVM,3418
+feilian/io.py,sha256=aYN3QwWcLoRKzhGMNutqdkmxArVcXfeWXzxCB07LcFc,155
+feilian/json.py,sha256=G51fXAxCzAH28hF6XnDpubxD4GfYTQzUmm_aeQle9T0,8298
+feilian/process.py,sha256=Xk7hnO1qhcn9Wuf53psjBLx9AeikkQvEFAJXxrYa6pk,3269
+feilian/string.py,sha256=YnA6Sz-O9ibj6hKiZHzzSVGS0aLlzzfCqDLGABtL18U,372
+feilian/txt.py,sha256=NNHV4hbGYUtdTRyvN4FQQzL6e0v9aixJwEv2i7LYXjA,2220
+feilian/utils.py,sha256=NfjLsjTG0nj4KaGzKud7IYua8NsY4Xt2DjxCsxmt9ds,2650
+feilian/version.py,sha256=oH_DvE7jRCWlCCX9SSadwxwRJXFas_rIisYLBGPYZn4,350
+feilian-1.3.4.dist-info/METADATA,sha256=1F48OrnKnfNzpZiA1VOLFnZblUhLRfNqsuECN3FkYNY,3784
+feilian-1.3.4.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+feilian-1.3.4.dist-info/top_level.txt,sha256=1Q2-B6KJrcTr7drW_kik35PTVEUJLPP4wVrn0kYKwGw,8
+feilian-1.3.4.dist-info/RECORD,,

feilian-1.3.4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (79.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

feilian-1.3.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+feilian