Merge branch 'main' of github.com:dostonnabotov/quicksnip

Author: saminjay

CONTRIBUTING.md

@@ -65,7 +65,7 @@ If your function doesn't return anything just show how to use it. If the result
 
 To ensure your snippet isn’t refused, consider these questions:
 - **Does the standard library of my language provide an easy way of doing this ?**
-- **Does that snippet have a real, and practical use case ?**
+- **Does that snippet not have a real, and practical use case ?**
 - **Could it be split into separate parts to be better understood ?**
 
 If any answer is yes, then your snippet will most likely get rejected.

public/consolidated/python.json

@@ -535,16 +535,17 @@
                 "code": "def snake_to_camel(s):\n    parts = s.split('_')\n    return parts[0] + ''.join(word.capitalize() for word in parts[1:])\n\n# Usage:\nsnake_to_camel('hello_world') # Returns: 'helloWorld'\n"
             },
             {
-                "title": "Convert String to ASCII",
-                "description": "Converts a string into its ASCII representation.",
+                "title": "Convert String to Unicode",
+                "description": "Converts a string into its Unicode representation.",
                 "author": "axorax",
                 "tags": [
                     "string",
                     "ascii",
+                    "unicode",
                     "convert"
                 ],
                 "contributors": [],
-                "code": "def string_to_ascii(s):\n    return [ord(char) for char in s]\n\n# Usage:\nstring_to_ascii('hello') # Returns: [104, 101, 108, 108, 111]\n"
+                "code": "def string_to_unicode(s):\n    return [ord(char) for char in s]\n\n# Usage:\nstring_to_unicode('hello') # Returns: [104, 101, 108, 108, 111]\n"
             },
             {
                 "title": "Count Character Frequency",
@@ -626,6 +627,18 @@
                 "contributors": [],
                 "code": "import random\nimport string\n\ndef random_string(length):\n    letters_and_digits = string.ascii_letters + string.digits\n    return ''.join(random.choice(letters_and_digits) for _ in range(length))\n\n# Usage:\nrandom_string(10) # Results: Random 10-character string\n"
             },
+            {
+                "title": "Remove Characters",
+                "description": "Removes specific characters from a string.",
+                "author": "axorax",
+                "tags": [
+                    "string",
+                    "remove",
+                    "characters"
+                ],
+                "contributors": [],
+                "code": "def remove_chars(s, chars):\n    return ''.join(c for c in s if c not in chars)\n\n# Usage:\nremove_chars('hello world', 'eo') # Returns: 'hll wrld'\n"
+            },
             {
                 "title": "Remove Duplicate Characters",
                 "description": "Removes duplicate characters from a string while maintaining the order.",
@@ -650,18 +663,6 @@
                 "contributors": [],
                 "code": "import string\n\ndef remove_punctuation(s):\n    return s.translate(str.maketrans('', '', string.punctuation))\n\n# Usage:\nremove_punctuation('Hello, World!') # Returns: 'Hello World'\n"
             },
-            {
-                "title": "Remove Specific Characters",
-                "description": "Removes specific characters from a string.",
-                "author": "axorax",
-                "tags": [
-                    "string",
-                    "remove",
-                    "characters"
-                ],
-                "contributors": [],
-                "code": "def remove_chars(s, chars):\n    return ''.join(c for c in s if c not in chars)\n\n# Usage:\nremove_chars('hello world', 'eo') # Returns: 'hll wrld'\n"
-            },
             {
                 "title": "Remove Whitespace",
                 "description": "Removes all whitespace from a string.",
@@ -683,7 +684,7 @@
                     "reverse"
                 ],
                 "contributors": [],
-                "code": "def reverse_string(s):\n    return s[::-1]\n\n# Usage:\nreverse_string('hello') # Returns: 'olleh'\n"
+                "code": "def reverse_string(s:str) -> str:\n    return s[::-1]\n\n# Usage:\nreverse_string('hello') # Returns: 'olleh'\n"
             },
             {
                 "title": "Split Camel Case",
@@ -698,15 +699,17 @@
                 "code": "import re\n\ndef split_camel_case(s):\n    return ' '.join(re.findall(r'[A-Z][a-z]*|[a-z]+', s))\n\n# Usage:\nsplit_camel_case('camelCaseString') # Returns: 'camel Case String'\n"
             },
             {
-                "title": "Truncate String",
-                "description": "Truncates a string to a specified length and adds an ellipsis.",
+                "title": "Truncate",
+                "description": "Truncates a string to a specified length and a toggleable truncation notation.",
                 "author": "axorax",
                 "tags": [
                     "string",
                     "truncate"
                 ],
-                "contributors": [],
-                "code": "def truncate_string(s, length):\n    return s[:length] + '...' if len(s) > length else s\n\n# Usage:\ntruncate_string('This is a long string', 10) # Returns: 'This is a ...'\n"
+                "contributors": [
+                    "MinerMinerMods"
+                ],
+                "code": "def truncate(s:str, length:int, suffix:bool = True) -> str :\n    return (s[:length] + (\"...\" if suffix else \"\")) if len(s) > length else s\n\n# Usage:\ntruncate('This is a long string', 10) # Returns: 'This is a ...'\ntruncate('This is a long string', 10, False) # Returns: 'This is a '\n"
             }
         ]
     }

snippets/java/date-time/date-time-formatting-american.md

@@ -0,0 +1,32 @@
+---
+title: Date time formatting american
+description: Formats a timestamp to a human-readable date-time string in the format "MM/dd/yyyy hh:mm:ss a"
+author: Mcbencrafter
+tags: date,time,date-time,formatting,american
+---
+
+```java
+import java.time.Instant;
+import java.time.ZoneId;
+import java.time.format.DateTimeFormatter;
+import java.util.concurrent.TimeUnit;
+
+// using the system default time zone
+public static String formatDateTimeAmerican(long time, TimeUnit timeUnit) {
+    return formatDateTimeAmerican(time, timeUnit, ZoneId.systemDefault());
+}
+
+public static String formatDateTimeAmerican(long time, TimeUnit timeUnit, ZoneId timeZone) {
+    return DateTimeFormatter.ofPattern("MM/dd/yyyy hh:mm:ss a")
+            .withZone(
+                timeZone != null ? timeZone : ZoneId.systemDefault()
+            )
+            .format(Instant.ofEpochSecond(
+                timeUnit.toSeconds(time)
+            ));
+}
+
+// Usage:
+System.out.println(formatDateTimeAmerican(1735689599, TimeUnit.SECONDS)); // "12/31/2024 | 11:59:59 PM" for GMT+0000
+System.out.println(formatDateTimeAmerican(1735689599, TimeUnit.SECONDS, ZoneId.of("GMT+0000"))); // "12/31/2024 | 11:59:59 PM"
+```

snippets/java/date-time/date-time-formatting-european.md

@@ -0,0 +1,32 @@
+---
+title: Date time formatting european
+description: Formats a timestamp to a human-readable date-time string in the format "dd.MM.yyyy HH:mm:ss"
+author: Mcbencrafter
+tags: date,time,date-time,formatting,european
+---
+
+```java
+import java.time.Instant;
+import java.time.ZoneId;
+import java.time.format.DateTimeFormatter;
+import java.util.concurrent.TimeUnit;
+
+// using the system default time zone
+public static String formatDateTimeEuropean(long time, TimeUnit timeUnit) {
+    return formatDateTimeEuropean(time, timeUnit, ZoneId.systemDefault());
+}
+
+public static String formatDateTimeEuropean(long time, TimeUnit timeUnit, ZoneId timeZone) {
+    return DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm:ss")
+            .withZone(
+                timeZone != null ? timeZone : ZoneId.systemDefault()
+            )
+            .format(Instant.ofEpochSecond(
+                    timeUnit.toSeconds(time)
+            ));
+}
+
+// Usage:
+System.out.println(formatDateTimeEuropean(1735689599, TimeUnit.SECONDS)); // "31.12.2024 | 23:59:59" for GMT+0000
+System.out.println(formatDateTimeEuropean(1735689599, TimeUnit.SECONDS, ZoneId.of("GMT+0000"))); // "31.12.2024 | 23:59:59"
+```

snippets/java/date-time/duration-formatting-hours-minutes-seconds.md

@@ -0,0 +1,33 @@
+---
+title: Duration formatting hours minutes seconds
+description: Converts a given time duration to a human-readable string in the format "hh:mm(:ss)"
+author: Mcbencrafter
+tags: time,formatting,hours,minutes,seconds
+---
+
+```java
+import java.util.concurrent.TimeUnit;
+    
+public static String formatDurationToHoursMinutesAndSeconds(int time, TimeUnit timeUnit, boolean showSeconds) {
+    long totalSeconds = timeUnit.toSeconds(time);
+
+    if (totalSeconds < 0)
+        throw new IllegalArgumentException("Duration must be a non-negative value.");
+
+    // These variables can be directly used in the return statement,
+    // but are kept as separate variables here for better readability.
+    long hours = totalSeconds / 3600;
+    long minutes = (totalSeconds % 3600) / 60;
+    long seconds = totalSeconds % 60;
+
+    if (showSeconds) {
+        return String.format("%02d:%02d:%02d", hours, minutes, seconds);
+    } else {
+        return String.format("%02d:%02d", hours, minutes);
+    }
+}
+
+// Usage:
+System.out.println(formatDurationToHoursMinutesAndSeconds(3810, TimeUnit.SECONDS, true)); // "01:03:30"
+System.out.println(formatDurationToHoursMinutesAndSeconds(3810, TimeUnit.SECONDS, false)); // "01:03"
+```

snippets/java/date-time/duration-formatting-minutes-seconds.md

@@ -0,0 +1,28 @@
+---
+title: Duration formatting minutes seconds
+description: Converts a given time duration to a human-readable string in the format "mm:ss"
+author: Mcbencrafter
+tags: time,formatting,minutes,seconds
+---
+
+```java
+import java.util.concurrent.TimeUnit;
+
+public static String formatDurationToMinutesAndSeconds(int time, TimeUnit timeUnit) {
+    long totalSeconds = timeUnit.toSeconds(time);
+
+    if (totalSeconds < 0)
+        throw new IllegalArgumentException("Duration must be a non-negative value.");
+
+    // These variables can be directly used in the return statement,
+    // but are kept here as separate variables for better readability.
+    long minutes = totalSeconds / 60;
+    long seconds = totalSeconds % 60;
+
+    return String.format("%02d:%02d", minutes, seconds);
+}
+
+// Usage:
+System.out.println(formatDurationToMinutesAndSeconds(120, TimeUnit.SECONDS)); // "02:00"
+System.out.println(formatDurationToMinutesAndSeconds(75, TimeUnit.SECONDS)); // "01:15"
+```

snippets/python/string-manipulation/convert-string-to-ascii.md

@@ -0,0 +1,14 @@
+---
+title: Convert String to Unicode
+description: Converts a string into its Unicode representation.
+author: axorax
+tags: string,ascii,unicode,convert
+---
+
+```py
+def string_to_unicode(s):
+    return [ord(char) for char in s]
+
+# Usage:
+string_to_unicode('hello') # Returns: [104, 101, 108, 108, 111]
+```

snippets/python/string-manipulation/convert-string-to-unicode.md

@@ -1,5 +1,5 @@
 ---
-title: Remove Specific Characters
+title: Remove Characters
 description: Removes specific characters from a string.
 author: axorax
 tags: string,remove,characters

snippets/python/string-manipulation/remove-specific-characters.md renamed to snippets/python/string-manipulation/remove-characters.md

@@ -6,7 +6,7 @@ tags: string,reverse
 ---
 
 ```py
-def reverse_string(s):
+def reverse_string(s:str) -> str:
     return s[::-1]
 
 # Usage: