hspylib-clitt 0.9.118__py3-none-any.whl → 0.9.119__py3-none-any.whl

build/lib/clitt/utils/git_utils.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.utils
+      @file: git_utils.py
+   @created: Nov 14, 2019
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.term.terminal import Terminal
+from hspylib.modules.application.exit_status import ExitStatus
+from typing import Tuple
+
+
+class GitTools:
+    """TODO"""
+
+    @staticmethod
+    def top_level_dir() -> Tuple[str, ExitStatus]:
+        """TODO"""
+        return Terminal.shell_exec("git rev-parse --show-toplevel")
+
+    @staticmethod
+    def current_branch() -> Tuple[str, ExitStatus]:
+        """TODO"""
+        return Terminal.shell_exec("git symbolic-ref --short HEAD")
+
+    @staticmethod
+    def changelog(from_tag: str, to_tag: str) -> Tuple[str, ExitStatus]:
+        """TODO"""
+        return Terminal.shell_exec(f"git log --oneline --pretty='format:%h %ad %s' --date=short {from_tag}^..{to_tag}^")
+
+    @staticmethod
+    def unreleased() -> Tuple[str, ExitStatus]:
+        """TODO"""
+        latest_tag = Terminal.shell_exec("git describe --tags --abbrev=0 HEAD^")
+        return Terminal.shell_exec(f"git log --oneline --pretty='format:%h %ad %s' --date=short '{latest_tag}'..HEAD")
+
+    @staticmethod
+    def release_date(tag_name: str) -> Tuple[str, ExitStatus]:
+        """TODO"""
+        return Terminal.shell_exec(f"git log -1 --pretty='format:%ad' --date=short {tag_name}")
+
+    @staticmethod
+    def tag_list() -> Tuple[str, ExitStatus]:
+        """TODO"""
+        return Terminal.shell_exec("git log --tags --simplify-by-decoration --pretty='format:%ci %d'")
+
+    @staticmethod
+    def create_tag(version: str, commit_id: str = "HEAD", description: str = None) -> Tuple[str, ExitStatus]:
+        """TODO"""
+        return Terminal.shell_exec(f"git tag -a v{version} {commit_id} -m '{description or version}'")
+
+    @staticmethod
+    def search_logs(filter_by: str = ".*") -> Tuple[str, ExitStatus]:
+        """TODO"""
+        return Terminal.shell_exec(f"git log --grep='{filter_by}' --pretty=format:'%h %ad %s' --date=short")
+
+    @staticmethod
+    def show_file(filename: str, commit_id: str = "HEAD") -> Tuple[str, ExitStatus]:
+        return Terminal.shell_exec(f"git show {commit_id}:{filename}")

clitt/.version

@@ -1 +1 @@
-0.9.118
+0.9.119

clitt/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt
+# Package: main.build.lib.clitt
 """Package initialization."""
 
 __all__ = [
@@ -10,4 +10,4 @@ __all__ = [
     'core', 
     'utils'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/addons/__init__.py

@@ -1,12 +1,12 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.addons
+# Package: main.build.lib.clitt.addons
 """Package initialization."""
 
 __all__ = [
     'appman', 
     'widman'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/addons/appman/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.addons.appman
+# Package: main.build.lib.clitt.addons.appman
 """Package initialization."""
 
 __all__ = [
@@ -10,4 +10,4 @@ __all__ = [
     'appman_enums', 
     'templates'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/addons/appman/templates/__init__.py

@@ -1,11 +1,11 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.addons.appman.templates
+# Package: main.build.lib.clitt.addons.appman.templates
 """Package initialization."""
 
 __all__ = [
     
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/addons/widman/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.addons.widman
+# Package: main.build.lib.clitt.addons.widman
 """Package initialization."""
 
 __all__ = [
@@ -11,4 +11,4 @@ __all__ = [
     'widgets', 
     'widman'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/addons/widman/widgets/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.addons.widman.widgets
+# Package: main.build.lib.clitt.addons.widman.widgets
 """Package initialization."""
 
 __all__ = [
@@ -11,4 +11,4 @@ __all__ = [
     'widget_send_msg', 
     'widget_time_calc'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core
+# Package: main.build.lib.clitt.core
 """Package initialization."""
 
 __all__ = [
@@ -12,4 +12,4 @@ __all__ = [
     'term', 
     'tui'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/exception/__init__.py

@@ -1,11 +1,11 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.exception
+# Package: main.build.lib.clitt.core.exception
 """Package initialization."""
 
 __all__ = [
     'exceptions'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/icons/__init__.py

@@ -1,12 +1,12 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.icons
+# Package: main.build.lib.clitt.core.icons
 """Package initialization."""
 
 __all__ = [
     'emojis', 
     'font_awesome'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/icons/emojis/__init__.py

@@ -1,12 +1,12 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.icons.emojis
+# Package: main.build.lib.clitt.core.icons.emojis
 """Package initialization."""
 
 __all__ = [
     'emojis', 
     'face_smiling'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/icons/font_awesome/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.icons.font_awesome
+# Package: main.build.lib.clitt.core.icons.font_awesome
 """Package initialization."""
 
 __all__ = [
@@ -15,4 +15,4 @@ __all__ = [
     'trickplay_icons', 
     'widget_icons'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/term/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.term
+# Package: main.build.lib.clitt.core.term
 """Package initialization."""
 
 __all__ = [
@@ -11,4 +11,4 @@ __all__ = [
     'screen', 
     'terminal'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/term/commons.py

@@ -13,18 +13,16 @@
    Copyright 2024, HSPyLib team
 """
 
-from clitt.core.exception.exceptions import NotATerminalError
-from hspylib.core.enums.enumeration import Enumeration
-from hspylib.core.tools.commons import is_debugging
-from hspylib.modules.cli.vt100.vt_100 import Vt100
-from shutil import get_terminal_size
-from typing import Callable, Tuple, TypeAlias, Union
-
-import logging as log
 import re
 import sys
 import termios
 import tty
+from shutil import get_terminal_size
+from typing import Callable, Tuple, TypeAlias, Union
+
+from hspylib.core.enums.enumeration import Enumeration
+from hspylib.core.tools.commons import is_debugging
+from hspylib.modules.cli.vt100.vt_100 import Vt100
 
 # fmt: off
 Dimension       : TypeAlias = Tuple[int, int]
@@ -37,7 +35,10 @@ EraseDirection  : TypeAlias = Union["Direction", "Portion"]
 
 def is_a_tty() -> bool:
     """Checks whether we are under a tty environment."""
-    return sys.stdout.isatty() and sys.stdin.isatty()
+    try:
+        return sys.stdout.isatty() and sys.stdin.isatty()
+    except ValueError:
+        return sys.stdout.isatty()
 
 
 class Direction(Enumeration):
@@ -65,7 +66,6 @@ def get_dimensions(fallback: Tuple[int, int] = (24, 80)) -> Tuple[int, int]:
     :return lines, columns
     """
     if not is_a_tty():
-        log.warning(NotATerminalError("get_dimensions:: Requires a terminal (TTY)"))
         return fallback
     dim = get_terminal_size((fallback[1], fallback[0]))
     return dim.lines, dim.columns
@@ -81,7 +81,6 @@ def get_cursor_position(fallback: Tuple[int, int] = (0, 0)) -> Tuple[int, int]:
         return pos
 
     if not is_a_tty():
-        log.warning(NotATerminalError("get_cursor_position:: Requires a terminal (TTY)"))
         return pos
 
     buf, re_query_resp = "", r"^\x1b\[(\d*);(\d*)R"
@@ -99,7 +98,7 @@ def get_cursor_position(fallback: Tuple[int, int] = (0, 0)) -> Tuple[int, int]:
             groups = matches.groups()
             pos = int(groups[0]), int(groups[1])
     except termios.error:
-        log.warning(NotATerminalError("get_cursor_position:: Requires a terminal (TTY)"))
+        pass
     finally:
         if stdin and attrs:
             termios.tcsetattr(stdin, termios.TCSANOW, attrs)  # Reset terminal attributes

clitt/core/tui/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui
+# Package: main.build.lib.clitt.core.tui
 """Package initialization."""
 
 __all__ = [
@@ -17,4 +17,4 @@ __all__ = [
     'tui_component', 
     'tui_preferences'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/tui/line_input/__init__.py

@@ -1,12 +1,12 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui.line_input
+# Package: main.build.lib.clitt.core.tui.line_input
 """Package initialization."""
 
 __all__ = [
     'keyboard_input', 
     'line_input'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/tui/mchoose/__init__.py

@@ -1,12 +1,12 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui.mchoose
+# Package: main.build.lib.clitt.core.tui.mchoose
 """Package initialization."""
 
 __all__ = [
     'mchoose', 
     'menu_choose'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/tui/mdashboard/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui.mdashboard
+# Package: main.build.lib.clitt.core.tui.mdashboard
 """Package initialization."""
 
 __all__ = [
@@ -11,4 +11,4 @@ __all__ = [
     'mdashboard', 
     'menu_dashboard'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/tui/menu/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui.menu
+# Package: main.build.lib.clitt.core.tui.menu
 """Package initialization."""
 
 __all__ = [
@@ -13,4 +13,4 @@ __all__ = [
     'tui_menu_ui', 
     'tui_menu_view'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/tui/minput/__init__.py

@@ -1,8 +1,8 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui.minput
+# Package: main.build.lib.clitt.core.tui.minput
 """Package initialization."""
 
 __all__ = [
@@ -16,4 +16,4 @@ __all__ = [
     'minput', 
     'minput_utils'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/tui/mselect/__init__.py

@@ -1,12 +1,12 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui.mselect
+# Package: main.build.lib.clitt.core.tui.mselect
 """Package initialization."""
 
 __all__ = [
     'menu_select', 
     'mselect'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/core/tui/table/__init__.py

@@ -1,12 +1,12 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.core.tui.table
+# Package: main.build.lib.clitt.core.tui.table
 """Package initialization."""
 
 __all__ = [
     'table_enums', 
     'table_renderer'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

clitt/utils/__init__.py

@@ -1,11 +1,11 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.118
+# hspylib-clitt v0.9.119
 #
-# Package: main.clitt.utils
+# Package: main.build.lib.clitt.utils
 """Package initialization."""
 
 __all__ = [
     'git_utils'
 ]
-__version__ = '0.9.118'
+__version__ = '0.9.119'

{hspylib_clitt-0.9.118.dist-info → hspylib_clitt-0.9.119.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hspylib-clitt
-Version: 0.9.118
+Version: 0.9.119
 Summary: HsPyLib - CLI Terminal Tools
 Home-page: https://github.com/yorevs/hspylib
 Author: Hugo Saporetti Junior
@@ -35,7 +35,7 @@ Requires-Dist: urllib3 <2.0.0
 ## Create professional CLI applications
 
 [![License](https://badgen.net/badge/license/MIT/gray)](LICENSE.md)
-[![Release](https://badgen.net/badge/release/v0.9.118/gray)](CHANGELOG.md#unreleased)
+[![Release](https://badgen.net/badge/release/v0.9.119/gray)](CHANGELOG.md#unreleased)
 [![PyPi](https://badgen.net/badge/icon/python?icon=pypi&label)](https://pypi.org/project/hspylib-clitt)
 [![GitHub](https://badgen.net/badge/icon/github?icon=github&label)](https://github.com/yorevs/hspylib)
 [![Gitter](https://badgen.net/badge/icon/gitter?icon=gitter&label)](https://gitter.im/hspylib/community)