atomicshop 2.7.5__py3-none-any.whl → 2.7.6__py3-none-any.whl

atomicshop/__init__.py

@@ -1,4 +1,4 @@
 """Atomic Basic functions and classes to make developer life easier"""
 
 __author__ = "Den Kras"
-__version__ = '2.7.5'
+__version__ = '2.7.6'

atomicshop/uuids.py

@@ -0,0 +1,45 @@
+import uuid
+
+
+"""
+Choosing Between UUID Versions
+UUID1: Use it if you need to trace back the machine that generated the UUID.
+UUID4: Use it for almost everything else, where you need a unique ID without any other implications.
+UUID3 and UUID5: Use them if you need consistent UUIDs generated from the same namespace and name.
+
+Most of the time, uuid4() is preferred due to its simplicity and randomness, 
+ensuring a very low probability of ID collision without depending on the machine's identity or the exact timestamp.
+
+Collisions:
+The number of random version-4 UUIDs which need to be generated in order to have a 50% probability of at least 
+one collision is 2.71 quintillion. This number is equivalent to generating 1 billion UUIDs per second for about
+85 years. The probability of one collision would be approximately 50% if every person on earth owns 600 million UUIDs.
+https://en.wikipedia.org/wiki/Universally_unique_identifier#Random_UUID_probability_of_duplicates
+"""
+
+
+def generate_uuid4_random(convert_to_hex: bool = True) -> str:
+    """
+    Generate a random UUID4.
+
+    The hex attribute of a UUID object in Python returns the hexadecimal representation of the UUID as a
+    string of 32 hexadecimal digits. This is a more compact form compared to the standard string representation
+    returned by str(uuid.uuid4()), which includes hyphens.
+
+    Here's a comparison:
+    With Hyphens (Default String Representation): The default string representation of a UUID includes hyphens,
+    separating it into five groups, such as 12345678-1234-5678-1234-567812345678.
+    This format is easy to read and is often used in textual representations where readability is a concern.
+
+    Hexadecimal (Compact Representation): The hex attribute removes the hyphens and returns the UUID as a continuous
+    string of 32 hexadecimal characters, like 12345678123456781234567812345678.
+    This compact form might be preferred when you need a shorter version of the UUID for systems that
+    don't accept hyphens or when saving space is a priority.
+
+    :return:
+    """
+
+    if convert_to_hex:
+        return uuid.uuid4().hex
+    else:
+        return str(uuid.uuid4())

atomicshop/wrappers/elasticsearchw/queries/info.py

@@ -0,0 +1,58 @@
+"""
+Query types:
+
+Term Query
+Usage: The term query is used for exact matches. It looks for the exact term in the inverted index and doesn’t analyze the query string. This is useful for searching on fields that are exact values (like IDs, tags, etc.).
+Example: If your field value is "Quick Brown Fox" and you search with a term query for "quick" or "Quick", it will not match because it looks for the exact term in the field.
+
+Match Query
+Usage: The match query is more flexible. It analyzes the query string before executing the search. This means it will consider things like tokenization and stemming. It’s suitable for full-text search.
+Example: Using the match query for "quick" or "Quick" on the field with "Quick Brown Fox" will likely return a match because it analyzes and tokenizes the string.
+
+Match Phrase Query
+Usage: The match_phrase query is like the match query but it also takes the order of the words into account. It is used when you want to find exact phrases or words in a specific order.
+Example: If you search for "Quick Brown" with a match_phrase query on a field with the value "The Quick Brown Fox", it will match. However, searching for "Brown Quick" won't match.
+
+Additional Query Types
+Bool Query: This allows you to combine multiple queries using boolean logic (like must, should, must_not).
+Range Query: Useful for finding numbers or dates in a given range.
+Wildcard Query: For searches with wildcards, useful when the exact value is partially known.
+Prefix Query: Finds documents containing terms that start with the specified prefix.
+Fuzzy Query: Useful for dealing with typos and spelling variations.
+"""
+
+
+"""
+AND OR:
+"must" is AND
+"should" is OR
+"must_not" is NOT
+
+Example with AND and OR:
+You want to find all files with file_path = "/home/test1/test2/final_archive.zip" and
+file_path = "test4.zip" or file_path = "_test4.zip"
+Meaning you want to find all files with file_path = "/home/test1/test2/final_archive.zip/test4.zip" or
+file_path = "/home/test1/test2/final_archive.zip/_test4.zip"
+Since your file can be both "test4.zip" and "_test4.zip" at the same time, you need to use AND and OR.
+
+query = {
+    "query": {
+        "bool": {
+            "must": [
+                {"match_phrase": {"file_path": "/home/test1/test2/final_archive.zip"}},
+                {
+                    "bool": {
+                        "should": [
+                            {"match_phrase": {"file_path": "test4.zip"}},
+                            {"match_phrase": {"file_path": "_test4.zip"}}
+                        ]
+                    }
+                }
+            ]
+        }
+    }
+}
+
+This is similar to Kibana KQL:
+file_path : "/home/test1/test2/final_archive.zip" and (file_path : "test4.zip") or (file_path : "_test4.zip")
+"""

atomicshop/wrappers/elasticsearchw/queries/query_multi.py

@@ -1,18 +1,33 @@
-def match(search_terms: dict) -> dict:
+def match_and_booleans(search_terms: dict) -> dict:
     """
     Generates an Elasticsearch query based on the provided search terms.
 
     :param search_terms: A dictionary of field names and their corresponding search values.
     :return: A dictionary representing the Elasticsearch query.
 
-    Usage:
+    Usage for strings:
     search_terms = {
         "field_name1": "search_term1",
         "field_name2": "search_term2"
     }
+
+    Usage for strings and booleans:
+    search_terms = {
+        "field_name1": "search_term1",
+        "field_name2": True
+    }
     """
 
-    must_clauses = [{"match": {field: value}} for field, value in search_terms.items()]
+    must_clauses = []
+    for field, value in search_terms.items():
+        if isinstance(value, bool):
+            # Use term query for boolean values
+            must_clauses.append({"term": {field: value}})
+        else:
+            # Use match query for text and other types
+            must_clauses.append({"match": {field: value}})
+
+    # must_clauses = [{"term": {field: value}} for field, value in search_terms.items()]
 
     query = {
         "query": {

{atomicshop-2.7.5.dist-info → atomicshop-2.7.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: atomicshop
-Version: 2.7.5
+Version: 2.7.6
 Summary: Atomic functions and classes to make developer life easier
 Author: Denis Kras
 License: MIT License

{atomicshop-2.7.5.dist-info → atomicshop-2.7.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-atomicshop/__init__.py,sha256=jj6l_4UewSjOyv8e3hk7g07iNvhuQeQGLztfNXZpz3g,122
+atomicshop/__init__.py,sha256=DoGkKi75FQlqIpSnJTBu70jSyzfi3tC2S62u0x9o08M,122
 atomicshop/_basics_temp.py,sha256=6cu2dd6r2dLrd1BRNcVDKTHlsHs_26Gpw8QS6v32lQ0,3699
 atomicshop/_patch_import.py,sha256=ENp55sKVJ0e6-4lBvZnpz9PQCt3Otbur7F6aXDlyje4,6334
 atomicshop/appointment_management.py,sha256=N3wVGJgrqJfsj_lqiRfaL3FxMEe57by5Stzanh189mk,7263
@@ -40,6 +40,7 @@ atomicshop/system_resources.py,sha256=CMJfhDv6dI9K3IejpyKu-6qRlfeTphaOCd2RaLxXDy
 atomicshop/tempfiles.py,sha256=uq1ve2WlWehZ3NOTXJnpBBMt6HyCdBufqedF0HyzA6k,2517
 atomicshop/timer.py,sha256=KxBBgVM8po6pUJDW8TgY1UXj0iiDmRmL5XDCq0VHAfU,1670
 atomicshop/urls.py,sha256=CQl1j1kjEVDlAuYJqYD9XxPF1SUSgrmG8PjlcXNEKsQ,597
+atomicshop/uuids.py,sha256=JSQdm3ZTJiwPQ1gYe6kU0TKS_7suwVrHc8JZDGYlydM,2214
 atomicshop/virtualization.py,sha256=LPP4vjE0Vr10R6DA4lqhfX_WaNdDGRAZUW0Am6VeGco,494
 atomicshop/web.py,sha256=K3UndqJqHO9bTogZUWDz-IEZN776KNhpk28m3Ct_pbc,11069
 atomicshop/addons/PlayWrightCodegen.cmd,sha256=Z5cnllsyXD4F1W2h-WLEnyFkg5nZy0-hTGHRWXVOuW4,173
@@ -157,8 +158,9 @@ atomicshop/wrappers/elasticsearchw/config_basic.py,sha256=nMtWYBlkQwzUMTLBaL3US8
 atomicshop/wrappers/elasticsearchw/elasticsearchw.py,sha256=KCU1OgzqG4YALQkVZqF6tpsCG-gU_SkJa1HQK6zV07A,7301
 atomicshop/wrappers/elasticsearchw/queries/__init__.py,sha256=KBjT-bAt75CJsx1Apko9mpuFU4pfZV8DcGWQvpX65RU,78
 atomicshop/wrappers/elasticsearchw/queries/aggregation.py,sha256=N9a5yMMnb10sMa_x1qJBFQpgyJ49UWo8_vxuqmUtZ1A,1742
+atomicshop/wrappers/elasticsearchw/queries/info.py,sha256=e2O_vW8admhs5-kyoSGkZYHGK2O-hfdAOsWuMZzY0D4,2821
 atomicshop/wrappers/elasticsearchw/queries/pagination.py,sha256=ySPJuXZOMiNAo7SDycxVOg35uP-CK59GzrLbs-0CqcM,509
-atomicshop/wrappers/elasticsearchw/queries/query_multi.py,sha256=cNvE4emJ5tXka522uLNwIzangVR4Cc4evVgznQmxTV8,656
+atomicshop/wrappers/elasticsearchw/queries/query_multi.py,sha256=hiqLqX3_Go_QKZpcyEXr9Qvyxf6uKHP3IS6JSNzChL4,1167
 atomicshop/wrappers/elasticsearchw/queries/query_single.py,sha256=HdYBW17vIvmHTI3nviOBmMspefDCT4xWXXnK7cbE2gQ,2662
 atomicshop/wrappers/elasticsearchw/queries/size.py,sha256=ZThvspfxpXRBI6Mht9kkb5lO-9KtprXqll_jBxDggns,319
 atomicshop/wrappers/elasticsearchw/queries/sort.py,sha256=-CUhgcs_AVRvncRlLTl5IJZE8K3RgDNLYSIHnn0j7aE,1274
@@ -220,8 +222,8 @@ atomicshop/wrappers/socketw/socket_server_tester.py,sha256=AhpurHJmP2kgzHaUbq5ey
 atomicshop/wrappers/socketw/socket_wrapper.py,sha256=aXBwlEIJhFT0-c4i8iNlFx2It9VpCEpsv--5Oqcpxao,11624
 atomicshop/wrappers/socketw/ssl_base.py,sha256=k4V3gwkbq10MvOH4btU4onLX2GNOsSfUAdcHmL1rpVE,2274
 atomicshop/wrappers/socketw/statistics_csv.py,sha256=t3dtDEfN47CfYVi0CW6Kc2QHTEeZVyYhc57IYYh5nmA,826
-atomicshop-2.7.5.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
-atomicshop-2.7.5.dist-info/METADATA,sha256=AIuzrvfrjYEu2KcejaTW1v_XlHLUOofsz3krDbTY3iY,10369
-atomicshop-2.7.5.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-atomicshop-2.7.5.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
-atomicshop-2.7.5.dist-info/RECORD,,
+atomicshop-2.7.6.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
+atomicshop-2.7.6.dist-info/METADATA,sha256=ouPceXaGo8HF2r-OEYqADM0a2mpeM_V7zvxoLrqJTwE,10369
+atomicshop-2.7.6.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+atomicshop-2.7.6.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
+atomicshop-2.7.6.dist-info/RECORD,,