pyggester下载 - pyggester源代码下载

中文(简体)

中文(简体) 中文(繁体) 한국어 日本語 English Português Español Русский العربية Indonesia Deutsch Français ภาษาไทย

首页>JSP源码>其他类别

pyggester

其他类别

v1.0: Optimize Your Python Data Structures - Dynamic & Static Analysis Unleashed

下载

Alacritty徽标

Pyggester-动态/静态Python分析

关于

Pyggester-（Python + Suggester）起动态和静态分析仪的作用。它的主要目的在于提供建议，以通过解决数据结构的次优使用来提高Python代码的效率。

特征

Pyggester为其功能提供了相当不错的CLI界面。 CLI建在Typer的顶部

Execution command ：

pyggest

output ：

                                          _____
_____________  ________ _______ ______________  /_____________
___  __ _  / / /_  __ `/_  __ `/  _ _  ___/  __/  _ _  ___/
__  /_/ /  /_/ /_  /_/ /_  /_/ //  __/(__  )/ /_ /  __/  /
_  .___/___, / ___, / ___, / ___//____/ __/ ___//_/
/_/     /____/  /____/  /____/


Usage: pyggest [OPTIONS] COMMAND [ARGS]...

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion          Install completion for the current shell.                                                                      │
│ --show-completion             Show completion for the current shell, to copy it or customize the installation.                               │
│ --help                        Show this message and exit.                                                                                    │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ static                 Perform static analysis using PyggestStatic.                                                                          │
│ transform              Perform dynamic transformation using PyggesterDynamic.                                                                │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Pyggester CLI提出了两个不同的特征：

静态分析：此功能无需执行代码，全面检查您的代码，提供有关其结构和潜在改进的洞察力。
Execution command
[！注意]存在“静态”子命令，但没有实施功能，因为我们已经拥有良好的静态分析仪（Pylint，Ruff，Flake8）。在将来的迭代中，如果我们确定可以通过静态分析确定的建议，我们将它们纳入此功能。
```
pyggest static
```
动态/自动转换：此功能为Python文件添加了额外的代码，以在运行时分析您的数据结构。您的原始代码保持不变；它不会改变。创建一个新文件，就像原始文件一样，但带有其他代码。这适用于单个文件和整个目录（完整的项目结构）。
Execution command
```
pyggest transform
```

[！信息] Pyggester提供内置文档，用于详细使用

pyggest transform --help 
pyggest static --help # NOT IMPLEMENTED

？安装

使用PIP

您可以使用PIP轻松安装Python库。打开终端并运行以下命令：

pip install pyggester

克隆github存储库

克隆存储库：打开您的终端并运行以下命令将GitHub存储库克隆到您的本地计算机：
```
git clone [email protected]:ValdonVitija/pyggester.git
```
导航到存储库：将您的工作目录更改为克隆的存储库：
```
 cd pyggester
```
将Pyggester安装为当地的Pacakge：
[！
```
pip install .
```

用法（分步）

单文件使用

假设您有一个要动态分析的Python文件（运行时分析）

1。准备

在与Pyggester进行代码转换之前：

(venv) root@user: ~ /my_app > ls
app.py

app.py的内容：

 def sum_of_integers ( integer_list ):
    total = sum ( integer_list )
    return total

my_list = [ 1 , 2 , 3 , 4 , 5 ]
print ( sum_of_integers ( my_list ))

2。转换

重要的

在进入下一步之前，请确保您在虚拟环境中安装了Pyggester。

(venv) root@devs04: ~ /my_app > pyggest transform app.py
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ File transformed successfully !                                                                                                               │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

3。转变后

(venv) root@devs04: ~ /my_app > ls
app.py  app_transformed.py

app_transformed.py的内容：

 from pyggester . observable_collector import OBSERVABLE_COLLECTOR
from pyggester . observables import ObservableNumpyArray , ObservableNamedTuple , ObservableSet , ObservablePandasDataFrame , ObservableList , ObservableDict , ObservableTuple


def sum_of_integers ( integer_list ):
    total = sum ( integer_list )
    return total


my_list = ObservableList ([ 1 , 2 , 3 , 4 , 5 ])
OBSERVABLE_COLLECTOR . append ( my_list )
print ( sum_of_integers ( my_list ))

for observable in OBSERVABLE_COLLECTOR :
    observable . run ()

重要的

现在，我们有一个自动创建的新文件，该文件镜像原始文件。该新文件包括原始文件的所有内容，以及用于在运行时分析代码的额外代码。现在，您应该运行“ App_transformed.py”，而不是运行原始的“ app.py”。请放心，“ app.py”中的所有内容都保留在“ app_transformed.py”中。

4。运行转换的代码

(venv) root@devs04: ~ /my_app > python3 app_transformed.py
15
╭────────────────────────────────────────────────────────────────────────────╮
│ 10 | Suggestions(/root/my_app/app_transformed.py):                         │
│     [ * ] Consider using an array.array instead of a list, for optimal       │
│ memory consumption                                                         │
│     [ * ] Consider using a set instead of a list, because of unique elements │
╰────────────────────────────────────────────────────────────────────────────╯

目录用法

假设您有一个要动态分析的Python项目（目录/仓库）（运行时分析）

1。准备

在与Pyggester进行代码转换之前：

(venv) root@devs04: ~ /python_demo/app_dir > ls
__pycache__  app.py  temperature.py  weather.py

app.py的内容：

 import weather
import temperature


def main ():
    city = input ( 'Enter a city name: ' )
    weather_condition = weather . get_weather ( city )
    avg_temp = temperature . get_average_temperature ()
    print ( f'Weather in { city } : { weather_condition } ' )
    print ( f'Average temperature: { avg_temp } degrees Celsius' )


main ()

温度含量。

 temperatures = list ([ 20 , 22 , 15 , 18 , 20 , 21 , 22 , 22 , 18 , 17 , 20 ])


def get_average_temperature ():
    return sum ( temperatures ) / len ( temperatures )

天气的内容：py：

 weather_conditions = [ 'Sunny' , 'Rainy' , 'Cloudy' , 'Windy' , 'Sunny' , 'Cloudy' ]

def get_weather ( city ):
    return weather_conditions . pop ()

2。转换

重要的

在进入下一步之前，请确保您在虚拟环境中安装了Pyggester。

(venv) root@devs04: ~ /python_demo > pyggest transform app_dir/
Enter the name of the main file: app.py
╭──────────────────────────────────────────────────────────────────────────╮
│ Directory transformed successfully !                                      │
╰──────────────────────────────────────────────────────────────────────────╯

重要的

当将目录或项目指定为参数时，Pyggester会提示我们指定项目的主文件。该文件应为您的项目的输入点，以其文件名表示。

3。转变后

(venv) root@devs04: ~ /python_demo > ls
app_dir  app_dir_transformed

app_dir_transformed/：：

( venv ) root @ devs04 : ~ / python_demo / app_dir_transformed > ls
app . py  temperature . py  weather . py

app.py的内容：

 from pyggester . observable_collector import OBSERVABLE_COLLECTOR
from pyggester . observables import ObservableNumpyArray , ObservableList , ObservablePandasDataFrame , ObservableNamedTuple , ObservableSet , ObservableDict , ObservableTuple
import weather
import temperature


def main ():
    city = input ( 'Enter a city name: ' )
    weather_condition = weather . get_weather ( city )
    avg_temp = temperature . get_average_temperature ()
    print ( f'Weather in { city } : { weather_condition } ' )
    print ( f'Average temperature: { avg_temp } degrees Celsius' )


main ()
for observable in OBSERVABLE_COLLECTOR :
    observable . run ()

温度含量。

 from pyggester . observable_collector import OBSERVABLE_COLLECTOR
from pyggester . observables import ObservableNumpyArray , ObservableList , ObservablePandasDataFrame , ObservableNamedTuple , ObservableSet , ObservableDict , ObservableTuple
temperatures = ObservableList ( list ([ 20 , 22 , 15 , 18 , 20 , 21 , 22 , 22 , 18 , 17 ,
    20 ]))
OBSERVABLE_COLLECTOR . append ( temperatures )


def get_average_temperature ():
    return sum ( temperatures ) / len ( temperatures )

天气的内容：py：

 from pyggester . observable_collector import OBSERVABLE_COLLECTOR
from pyggester . observables import ObservableNumpyArray , ObservableList , ObservablePandasDataFrame , ObservableNamedTuple , ObservableSet , ObservableDict , ObservableTuple
weather_conditions = ObservableList ([ 'Sunny' , 'Rainy' , 'Cloudy' , 'Windy' ,
    'Sunny' , 'Cloudy' ])
OBSERVABLE_COLLECTOR . append ( weather_conditions )


def get_weather ( city ):
    return weather_conditions . pop ()

重要的

现在，我们有一个自动创建的新目录，它反映了原始目录。该新目录包括原始目录的所有内容，以及在运行时分析代码的额外代码。现在，您应该运行“ app_dir_transformed/'”中的原始“ app.py”，而是运行“ app.py”。请放心，“ app_dir”中的所有内容都保留在'app_dir_transformed/'中。

4。运行转换的代码

(venv) root@devs04: ~ /python_demo/app_dir_transformed > python3 app.py
Enter a city name: Pristina
Weather in Pristina: Cloudy
Average temperature: 19.545454545454547 degrees Celsius
╭─────────────────────────────────────────────────────────────────────────────────────╮
│ 3 | Suggestions(/root/python_demo/app_dir_transformed/temperature.py):              │
│     [ * ] Consider using an array.array instead of a list, for optimal memory         │
│ consumption                                                                         │
╰─────────────────────────────────────────────────────────────────────────────────────╯

？目录结构

 .
├── LICENSE
├── README.md # main readme file. The one you are currently reading.
├── VERSION # version of pyggester
├── contributing.md
├── pyggester # directory containing the full source code of pyggester
│   ├── __init__.py
│   ├── cli.py # defines the typer cli structure(command & options)
│   ├── command_handlers.py # Handles subcommands and every option variation per subcommand.
│   ├── data # data/config files related to pyggester. 
│   │   └── help_files # build in help files for the pyggester cli
│   │       ├── __init__.py
│   │       ├── transform_helper.md # detailed built-in documentation for the transform subcommand of pyggest
│   │       └── static_helper.md # detailed built-in documentation for the static subcommand of pyggest
│   ├── helpers.py  # helper functions to be used by other modules
│   ├── main.py # The entry point of pyggest execution. Initializes the typer cli app and prints the ascii logo of pyggester
│   ├── message_handler.py # Manages how the collected messages will be printed to the user.
│   ├── module_importer.py # Contains the mechanism to automatically import observables
│   ├── observable_collector.py # Contains the list that will be used to collect all observables.
│   ├── observable_transformations.py # Contains the mechanism that will automatically add code that collects observables and glues together all ast modules
│   ├── observables.py # Contains all the defined observables(enhanced version of python collections)
│   ├── pyggester.py # The 'engine' of pyggester. This module glues everything together
│   ├── text_formatters.py # Contains text formatters, to beautify text in stdout.
│   └── wrappers.py # Contains the mechanism that wrap each observable.
├── pyggester_abstract_execution_flow.png
├── pyggester_logo.png
├── pytest.ini # pytest config file
├── requirements.txt # Every pyggester dependecy resides here
├── setup.py # Creates the pyggester pacakge and defines pyggest as the entry point command to execute pyggester
└── tests 
    ├── __init__.py
    ├── test_cli.py
    ├── test_command_handlers.py
    ├── test_file.py
    ├── test_file_transformed.py
    ├── test_helpers.py
    ├── test_main.py
    ├── test_message_handler.py
    ├── test_module_importer.py
    ├── test_observable_transformations.py
    ├── test_observables.py
    ├── test_pyggester.py
    └── test_wrappers.py