nuclear 2.2.0__tar.gz → 2.2.2__tar.gz

{nuclear-2.2.0 → nuclear-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nuclear
-Version: 2.2.0
+Version: 2.2.2
 Summary: Declarative parser for command line interfaces
 Home-page: https://github.com/igrek51/nuclear
 Author: igrek51
@@ -136,13 +136,13 @@ with the following **modifiers**:
 - `.nodocs` to hide documentation for functions and classes
 - `.all` to include all available information
 
-You can chain modifiers, e.g. `wat.long.dunder / object`.
+You can chain modifiers, e.g. `wat.long.dunder.nodocs / object`.
 
 Call `wat()` to inspect `locals()` variables.
 
 Type `wat` in the interpreter to learn more about this object itself.
 
-## Use cases
+## Use Cases Examples
 
 ### Determine type
 In a dynamic typing language like Python, it's often hard to determine the type of an object. WAT Inspector can help you with that by showing the name of the type with the module it comes from.
@@ -162,12 +162,14 @@ type: django.contrib.auth.models.User
 parents: django.contrib.auth.models.AbstractUser, django.contrib.auth.base_user.AbstractBaseUser, django.contrib.auth.models.PermissionsMixin, django.db.models.base.Model, django.db.models.utils.AltersData
 ```
 
+Now that you've identified the actual type, you can put the type annotations in your code to reduce the confusion.
+
 ### Look up methods
 Listing methods, functions and looking up their signature is extremely beneficial to see how to use them.
 Plus, you can read their docstrings.
 
 ```python
-wat('stringy')
+wat / 'stringy'
 ```
 
 ![](https://github.com/igrek51/nuclear/blob/master/docs/img/wat-string.png?raw=true)
@@ -176,13 +178,13 @@ wat('stringy')
 See the docstrings and the signature of a function or a method to see how to use it.
 
 ```python
-wat(str.split)
+wat / str.split
 ```
 
 ![](https://github.com/igrek51/nuclear/blob/master/docs/img/wat-str-split.png?raw=true)
 
-### Look up variables
-Check what's inside, list the value of variables and their types to see what's really inside the inspected object.
+### Look up attributes
+List the attribues and their types to see what's really inside the inspected object.
 ```python
 wat / re.match('(\d)_(.*)', '1_title')
 ```
@@ -244,6 +246,13 @@ wat / __builtins__
 ### Look up local variables
 ```python
 wat()
+# or
+wat.locals
+```
+
+### Look up global variables
+```python
+wat.globals
 ```
 
 

{nuclear-2.2.0 → nuclear-2.2.2}/README.md

@@ -121,13 +121,13 @@ with the following **modifiers**:
 - `.nodocs` to hide documentation for functions and classes
 - `.all` to include all available information
 
-You can chain modifiers, e.g. `wat.long.dunder / object`.
+You can chain modifiers, e.g. `wat.long.dunder.nodocs / object`.
 
 Call `wat()` to inspect `locals()` variables.
 
 Type `wat` in the interpreter to learn more about this object itself.
 
-## Use cases
+## Use Cases Examples
 
 ### Determine type
 In a dynamic typing language like Python, it's often hard to determine the type of an object. WAT Inspector can help you with that by showing the name of the type with the module it comes from.
@@ -147,12 +147,14 @@ type: django.contrib.auth.models.User
 parents: django.contrib.auth.models.AbstractUser, django.contrib.auth.base_user.AbstractBaseUser, django.contrib.auth.models.PermissionsMixin, django.db.models.base.Model, django.db.models.utils.AltersData
 ```
 
+Now that you've identified the actual type, you can put the type annotations in your code to reduce the confusion.
+
 ### Look up methods
 Listing methods, functions and looking up their signature is extremely beneficial to see how to use them.
 Plus, you can read their docstrings.
 
 ```python
-wat('stringy')
+wat / 'stringy'
 ```
 
 ![](https://github.com/igrek51/nuclear/blob/master/docs/img/wat-string.png?raw=true)
@@ -161,13 +163,13 @@ wat('stringy')
 See the docstrings and the signature of a function or a method to see how to use it.
 
 ```python
-wat(str.split)
+wat / str.split
 ```
 
 ![](https://github.com/igrek51/nuclear/blob/master/docs/img/wat-str-split.png?raw=true)
 
-### Look up variables
-Check what's inside, list the value of variables and their types to see what's really inside the inspected object.
+### Look up attributes
+List the attribues and their types to see what's really inside the inspected object.
 ```python
 wat / re.match('(\d)_(.*)', '1_title')
 ```
@@ -229,6 +231,13 @@ wat / __builtins__
 ### Look up local variables
 ```python
 wat()
+# or
+wat.locals
+```
+
+### Look up global variables
+```python
+wat.globals
 ```
 
 

{nuclear-2.2.0 → nuclear-2.2.2}/nuclear/inspection/inspection.py

@@ -141,7 +141,7 @@ def _iter_attributes(obj: Any, config: InspectConfig) -> Iterable[InspectAttribu
 def _get_attribute_value(obj: Any, key: str) -> Any:
     try:
         return getattr(obj, key)
-    except AttributeError as e:
+    except BaseException as e:
         return e
 
 
@@ -171,8 +171,8 @@ def _get_callable_signature(name: str, obj: Any) -> Optional[str]:
 def _get_source_code(obj: Any) -> Optional[str]:
     try:
         return std_inspect.getsource(obj)
-    except (OSError, TypeError, IndentationError):
-        return None
+    except (OSError, TypeError, IndentationError) as e:
+        return f'failed to get source code: {type(e)}: {e}'
 
 
 def _get_doc(obj: Any, long: bool) -> Optional[str]:
@@ -244,9 +244,9 @@ def _format_dict_value(dic: Dict, indent: int) -> str:
         return f'{STYLE_YELLOW}{{}}{RESET}'
 
 
-def _format_list_value(l: List, indent: int) -> str:
+def _format_list_value(lst: List, indent: int) -> str:
     lines: List[str] = []
-    for value in l:
+    for value in lst:
         value_str = _format_value(value, indent)
         lines.append('    ' * indent + f'{value_str},')
     if lines:

{nuclear-2.2.0 → nuclear-2.2.2}/nuclear/sublog/context_error.py

@@ -22,7 +22,7 @@ class ContextError(RuntimeError):
             self.__cause__ = cause
 
     def __str__(self) -> str:
-        e: Exception = self
+        e: Optional[BaseException] = self
         layers = []
         while e is not None:
             if isinstance(e, ContextError):

{nuclear-2.2.0 → nuclear-2.2.2}/nuclear/sublog/exception.py

@@ -17,7 +17,7 @@ def exception_details(e: BaseException) -> str:
     traceback_str = ', '.join(traceback_lines)
     cause = _root_cause_type(e)
     error_msg = _error_message(e)
-    return f'{error_msg}: cause={cause}, traceback={traceback_str}'
+    return f'{error_msg}, cause={cause}, traceback={traceback_str}'
 
 
 def extended_exception_details(e: BaseException) -> Tuple[str, Dict]:

{nuclear-2.2.0 → nuclear-2.2.2}/nuclear/sublog/logging.py

@@ -101,7 +101,7 @@ class ContextLogger:
             if display_context:
                 if message.endswith(':'):
                     message = message[:-1]
-                logger_func(f'{message}: {display_context}')
+                logger_func(f'{message}, {display_context}')
             else:
                 logger_func(message)
         

{nuclear-2.2.0 → nuclear-2.2.2}/nuclear/utils/collections.py

@@ -9,7 +9,7 @@ def chunks(lst: List[T], n: int) -> Iterable[List[T]]:
         yield lst[i:i + n]
 
 
-def deduplicate_latest(items: list[T], key: Callable[[T], Any]) -> list[T]:
+def deduplicate_latest(items: List[T], key: Callable[[T], Any]) -> List[T]:
     """Deduplicate items in the list by key. Keep the earliest items first, remove the latest duplicates"""
     ids = set()
     dedup_items: List[T] = []
@@ -21,7 +21,7 @@ def deduplicate_latest(items: list[T], key: Callable[[T], Any]) -> list[T]:
     return dedup_items
 
 
-def deduplicate_earliest(items: list[T], key: Callable[[T], Any]) -> list[T]:
+def deduplicate_earliest(items: List[T], key: Callable[[T], Any]) -> List[T]:
     """Deduplicate items in the list by key. Keep the latest items, remove the earliest duplicates"""
     ids = set()
     dedup_items: List[T] = []

nuclear-2.2.2/nuclear/version.py

@@ -0,0 +1 @@
+__version__ = "2.2.2"

{nuclear-2.2.0 → nuclear-2.2.2}/nuclear.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nuclear
-Version: 2.2.0
+Version: 2.2.2
 Summary: Declarative parser for command line interfaces
 Home-page: https://github.com/igrek51/nuclear
 Author: igrek51
@@ -136,13 +136,13 @@ with the following **modifiers**:
 - `.nodocs` to hide documentation for functions and classes
 - `.all` to include all available information
 
-You can chain modifiers, e.g. `wat.long.dunder / object`.
+You can chain modifiers, e.g. `wat.long.dunder.nodocs / object`.
 
 Call `wat()` to inspect `locals()` variables.
 
 Type `wat` in the interpreter to learn more about this object itself.
 
-## Use cases
+## Use Cases Examples
 
 ### Determine type
 In a dynamic typing language like Python, it's often hard to determine the type of an object. WAT Inspector can help you with that by showing the name of the type with the module it comes from.
@@ -162,12 +162,14 @@ type: django.contrib.auth.models.User
 parents: django.contrib.auth.models.AbstractUser, django.contrib.auth.base_user.AbstractBaseUser, django.contrib.auth.models.PermissionsMixin, django.db.models.base.Model, django.db.models.utils.AltersData
 ```
 
+Now that you've identified the actual type, you can put the type annotations in your code to reduce the confusion.
+
 ### Look up methods
 Listing methods, functions and looking up their signature is extremely beneficial to see how to use them.
 Plus, you can read their docstrings.
 
 ```python
-wat('stringy')
+wat / 'stringy'
 ```
 
 ![](https://github.com/igrek51/nuclear/blob/master/docs/img/wat-string.png?raw=true)
@@ -176,13 +178,13 @@ wat('stringy')
 See the docstrings and the signature of a function or a method to see how to use it.
 
 ```python
-wat(str.split)
+wat / str.split
 ```
 
 ![](https://github.com/igrek51/nuclear/blob/master/docs/img/wat-str-split.png?raw=true)
 
-### Look up variables
-Check what's inside, list the value of variables and their types to see what's really inside the inspected object.
+### Look up attributes
+List the attribues and their types to see what's really inside the inspected object.
 ```python
 wat / re.match('(\d)_(.*)', '1_title')
 ```
@@ -244,6 +246,13 @@ wat / __builtins__
 ### Look up local variables
 ```python
 wat()
+# or
+wat.locals
+```
+
+### Look up global variables
+```python
+wat.globals
 ```
 
 

nuclear-2.2.0/nuclear/version.py

@@ -1 +0,0 @@
-__version__ = "2.2.0"