getsources 0.0.1__py3-none-any.whl

getsources/__init__.py

@@ -0,0 +1,2 @@
+from getsources.base import getsource as getsource
+from getsources.clear import getclearsource as getclearsource

getsources/base.py

@@ -0,0 +1,11 @@
+from inspect import getsource as original_getsource
+from typing import Any, Callable
+
+from dill.source import getsource as dill_getsource  # type: ignore[import-untyped]
+
+
+def getsource(function: Callable[..., Any]) -> str:
+    try:
+        return original_getsource(function)
+    except OSError:  # pragma: no cover
+        return dill_getsource(function)  # type: ignore[no-any-return]

getsources/clear.py

@@ -0,0 +1,20 @@
+from typing import Any, Callable
+
+from getsources import getsource
+
+
+def getclearsource(function: Callable[..., Any]) -> str:
+    source_code = getsource(function)
+
+    splitted_source_code = source_code.split('\n')
+
+    indent = 0
+    for letter in splitted_source_code[0]:  # pragma: no branch
+        if letter.isspace():
+            indent += 1
+        else:
+            break
+
+    new_splitted_source_code = [x[indent:] for x in splitted_source_code]
+
+    return '\n'.join(new_splitted_source_code).rstrip('\n')

getsources-0.0.1.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Mutating Company
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

getsources-0.0.1.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.1
+Name: getsources
+Version: 0.0.1
+Summary: A way to get the source code of functions
+Author-email: Evgeniy Blinov <zheni-b@yandex.ru>
+Project-URL: Source, https://github.com/mutating/getsources
+Project-URL: Tracker, https://github.com/mutating/getsources/issues
+Keywords: inspect
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Free Threading
+Classifier: Programming Language :: Python :: Free Threading :: 3 - Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dill==0.4.0
+
+<details>
+  <summary>ⓘ</summary>
+
+[![Downloads](https://static.pepy.tech/badge/getsources/month)](https://pepy.tech/project/getsources)
+[![Downloads](https://static.pepy.tech/badge/getsources)](https://pepy.tech/project/getsources)
+[![Coverage Status](https://coveralls.io/repos/github/mutating/getsources/badge.svg?branch=main)](https://coveralls.io/github/mutating/getsources?branch=main)
+[![Lines of code](https://sloc.xyz/github/mutating/getsources/?category=code)](https://github.com/boyter/scc/)
+[![Hits-of-Code](https://hitsofcode.com/github/mutating/getsources?branch=main)](https://hitsofcode.com/github/mutating/getsources/view?branch=main)
+[![Test-Package](https://github.com/mutating/getsources/actions/workflows/tests_and_coverage.yml/badge.svg)](https://github.com/mutating/getsources/actions/workflows/tests_and_coverage.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/getsources.svg)](https://pypi.python.org/pypi/getsources)
+[![PyPI version](https://badge.fury.io/py/getsources.svg)](https://badge.fury.io/py/getsources)
+[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/mutating/getsources)
+
+</details>
+
+![logo](https://raw.githubusercontent.com/mutating/getsources/develop/docs/assets/logo_1.svg)
+
+
+This library is needed to obtain the source code of functions at runtime. It can be used, for example, as a basis for libraries that work with [AST](https://en.wikipedia.org/wiki/Abstract_syntax_tree) on the fly. In fact, it is a thin layer built around [`inspect.getsource`](https://docs.python.org/3/library/inspect.html#inspect.getsource) and [`dill.source.getsource`](https://dill.readthedocs.io/en/latest/dill.html#dill.source.getsource).
+
+
+## Installation
+
+You can install [`getsources`](https://pypi.python.org/pypi/getsources) using pip:
+
+```bash
+pip install getsources
+```
+
+You can also quickly try out this and other packages without having to install using [instld](https://github.com/pomponchik/instld).
+
+
+## Usage
+
+The basic function of the library is `getsource`, which works similarly to the function of the same name from the standard library:
+
+```python
+from getsources import getsource
+
+def function():
+    ...
+
+print(getsource(function))
+#> def function():
+#>     ...
+```
+
+Unlike its counterpart from the standard library, this thing can also work:
+
+- With lambda functions
+- With functions defined inside REPL
+
+We also often need to trim excess indentation from a function object to make it easier to further process the resulting code. To do this, use the `getclearsource` function:
+
+```python
+from getsources import getclearsource
+
+class SomeClass:
+    @staticmethod
+    def method():
+        ...
+
+print(getclearsource(SomeClass.method))
+#> def method():
+#>     ...
+```
+
+As you can see, the resulting source code text has no extra indentation, but in all other respects this function is completely identical to the usual `getsource`.

getsources-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+getsources/__init__.py,sha256=Ko3yOyc8g7eVdHLu1hGx1Ie238rTohhu0KVYWIY5joc,113
+getsources/base.py,sha256=x-gLU6aCksooM5ppySO2d2J79qa1GkK2_abf5hrHSsQ,388
+getsources/clear.py,sha256=oatYIvj38kgd-vgMwdZ-ynVz9FYv3C4gyiX6h9ogKmk,517
+getsources/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+getsources-0.0.1.dist-info/LICENSE,sha256=CgGm6IfD4q2LC7FBpn8bCauae9gfb1SZRdtaJ_X7dmk,1077
+getsources-0.0.1.dist-info/METADATA,sha256=kFpFOUq-g3_J1o_-GoKyjPz1biYO2o4NeZO5Uv5IcYA,4491
+getsources-0.0.1.dist-info/WHEEL,sha256=hPN0AlP2dZM_3ZJZWP4WooepkmU9wzjGgCLCeFjkHLA,92
+getsources-0.0.1.dist-info/top_level.txt,sha256=etO6cCATcVRlw_B0TINeqoabyfrkdWgxkBKYOhaTvOw,11
+getsources-0.0.1.dist-info/RECORD,,

getsources-0.0.1.dist-info/WHEEL

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

getsources-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+getsources