commit-maker 0.2.1__tar.gz → 0.2.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. {commit_maker-0.2.1 → commit_maker-0.2.2}/LICENSE +21 -21
  2. {commit_maker-0.2.1 → commit_maker-0.2.2}/PKG-INFO +154 -119
  3. commit_maker-0.2.1/src/commit_maker.egg-info/PKG-INFO → commit_maker-0.2.2/README.md +140 -119
  4. {commit_maker-0.2.1 → commit_maker-0.2.2}/pyproject.toml +32 -17
  5. {commit_maker-0.2.1 → commit_maker-0.2.2}/setup.cfg +4 -4
  6. {commit_maker-0.2.1 → commit_maker-0.2.2}/src/commit_maker/main.py +614 -573
  7. commit_maker-0.2.1/README.md → commit_maker-0.2.2/src/commit_maker.egg-info/PKG-INFO +154 -106
  8. {commit_maker-0.2.1 → commit_maker-0.2.2}/src/commit_maker.egg-info/SOURCES.txt +1 -1
  9. commit_maker-0.2.2/src/commit_maker.egg-info/requires.txt +2 -0
  10. commit_maker-0.2.1/setup.py +0 -28
  11. {commit_maker-0.2.1 → commit_maker-0.2.2}/src/commit_maker/__init__.py +0 -0
  12. {commit_maker-0.2.1 → commit_maker-0.2.2}/src/commit_maker.egg-info/dependency_links.txt +0 -0
  13. {commit_maker-0.2.1 → commit_maker-0.2.2}/src/commit_maker.egg-info/entry_points.txt +0 -0
  14. {commit_maker-0.2.1 → commit_maker-0.2.2}/src/commit_maker.egg-info/top_level.txt +0 -0
{commit_maker-0.2.1 → commit_maker-0.2.2}/LICENSE RENAMED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Alex Bulgakov
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Alex Bulgakov
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
{commit_maker-0.2.1 → commit_maker-0.2.2}/PKG-INFO RENAMED
@@ -1,119 +1,154 @@
1
- Metadata-Version: 2.1
2
- Name: commit-maker
3
- Version: 0.2.1
4
- Summary: CLI-утилита для генерации git-коммитов с помощью ИИ
5
- Home-page: https://github.com/Sashayerty/commit_maker
6
- Author: Alex Bulgakov
7
- Author-email: Alex Bulgakov <sashayerty@ya.ru>
8
- License: MIT
9
- Project-URL: Homepage, https://github.com/sashayerty/commit_maker
10
- Requires-Python: >=3.8
11
- Description-Content-Type: text/markdown
12
- License-File: LICENSE
13
-
14
- # Commit Maker [![Created with Python](https://img.shields.io/badge/Created_with-Python-blue)](https://www.python.org/) [![Created with uv](https://img.shields.io/badge/Created_with-uv-purple)](https://docs.astral.sh/uv/) [![Created with ollama](https://img.shields.io/badge/Created_with-ollama-white)](https://ollama.com/) [![PyPi](https://img.shields.io/badge/Available_on-pypi-orange)](https://pypi.org/project/commit-maker/)
15
-
16
- ![Демонстрация](./commit_maker.svg)
17
-
18
- ## Все коммиты в репозитории - результат работы программы
19
-
20
- Эта CLI-утилита автоматически создает осмысленные сообщения для git-коммитов, используя локальные модели через ollama/Mistral AI API на основе вывода команд `git status` и `git diff`. Реализована в виде одного файла для удобства перевода в исполняемый файл.
21
-
22
- 1. [Возможности](#возможности)
23
- 2. [Требования](#требования)
24
- - [Mistral](#получение-api-ключа-mistral-ai)
25
- - [Ollama](#установка-ollama)
26
- 3. [Установка](#установка)
27
- 4. [Настройка переменных окружения](#настройка-переменных-окружения)
28
- - [Windows](#windows)
29
- - [Linux/MacOS](#linuxmacos)
30
- 5. [Использование](#использование)
31
- 6. [Примечания](#примечания)
32
- 7. [Лицензия](#лицензия)
33
-
34
- ## Возможности
35
-
36
- - Автоматически генерирует содержательные сообщения коммитов на русском языке
37
- - Интерактивное подтверждение перед созданием коммита
38
- - Работает как с существующими Git-репозиториями, так и с новыми
39
- - Использование локальных моделей/Mistral AI API для формирования сообщений коммитов на основе изменений в репозитории.
40
-
41
- ## Требования
42
-
43
- - Установленный Git в системе
44
- - API-ключ Mistral (для использования Mistral AI API)
45
- - Установленная ollama в системе (для использования локальных моделей)
46
-
47
- ### Получение API ключа Mistral AI
48
-
49
- Для получения ключа необходимо перейти сайт консоли [Mistral](https://console.mistral.ai/api-keys) и создать API ключ. Для получения необходим аккаунт [Mistral](https://auth.mistral.ai/ui/login).
50
-
51
- ### Установка ollama
52
-
53
- Для установки ollama переходим на сайт [Ollama](https://ollama.com/download) и выбираем способ, подходящий для Вашей системы.
54
-
55
- ## Установка
56
-
57
- ```bash
58
- # Windows
59
- pip install commit_maker
60
- # Linux/MacOS
61
- pip3 install commit_maker
62
- ```
63
-
64
- ## Настройка переменных окружения
65
-
66
- ### Windows
67
-
68
- 1. Откройте Командную строку от имени Администратора
69
- 2. Установите API-ключ Mistral:
70
-
71
- ```cmd
72
- setx MISTRAL_API_KEY "ваш_api_ключ_здесь"
73
- ```
74
-
75
- 3. Перезапустите терминал/IDE для применения изменений
76
-
77
- ### Linux/macOS
78
-
79
- 1. Откройте терминал
80
- 2. Добавьте в файл конфигурации вашей оболочки (`~/.bashrc`, `~/.zshrc` или `~/.bash_profile`):
81
-
82
- ```bash
83
- export MISTRAL_API_KEY="ваш_api_ключ_здесь"
84
- ```
85
-
86
- 3. Перезагрузите конфигурацию:
87
-
88
- ```bash
89
- source ~/.bashrc # или другой файл, который вы редактировали
90
- ```
91
-
92
- ## Использование
93
-
94
- ```bash
95
- commit_maker [OPTION] [VALUE]
96
- ```
97
-
98
- ### Пример использования
99
-
100
- **`-h`**, **`--help`** - вывод помощи
101
- **`-l`**, **`--local-models`** - использование локальных моделей
102
- **`-m`**, **`--max-symbols`** - ограничение длины сообщения коммита
103
- **`-M`**, **`--model`** - какую локальную модель использовать (при **`-l`**)
104
- **`-d`**, **`--dry-run`** - вывод сообщения на основе зайстейдженных изменений, без создания коммита
105
-
106
- ```bash
107
- commit_maker -l -m 300 -M qwen2.5:14b # Используем локальные модели, ограничение длины сообщения коммита 300 символов, используем qwen2.5:14b
108
- ```
109
-
110
- ## Примечания
111
-
112
- - Для просмотра всех возможных опций выполнения скрипта добавьте флаг `--help`
113
- - Скрипт покажет сгенерированное сообщение коммита перед его созданием
114
- - Вы можете повторно сгенерировать сообщение, нажав 'r' при запросе подтверждения
115
- - По умолчанию сообщения генерируются на русском языке (можно изменить в скрипте)
116
-
117
- ## Лицензия
118
-
119
- Commit Maker лицензирован [MIT](LICENSE)
1
+ Metadata-Version: 2.4
2
+ Name: commit-maker
3
+ Version: 0.2.2
4
+ Summary: CLI-утилита для генерации git-коммитов с помощью ИИ
5
+ Author-email: Alex Bulgakov <sashayerty@ya.ru>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/sashayerty/commit_maker
8
+ Requires-Python: >=3.8
9
+ Description-Content-Type: text/markdown
10
+ License-File: LICENSE
11
+ Requires-Dist: requests>=2.32.3
12
+ Requires-Dist: rich-argparse>=1.7.0
13
+ Dynamic: license-file
14
+
15
+ # Commit Maker [![Created with Python](https://img.shields.io/badge/Created_with-Python-blue)](https://www.python.org/) [![Created with uv](https://img.shields.io/badge/Created_with-uv-purple)](https://docs.astral.sh/uv/) [![Created with ollama](https://img.shields.io/badge/Created_with-ollama-white)](https://ollama.com/) [![PyPi](https://img.shields.io/badge/Available_on-pypi-orange)](https://pypi.org/project/commit-maker/)
16
+
17
+ ![Демонстрация](./commit_maker.svg)
18
+
19
+ ## Все коммиты в репозитории - результат работы программы
20
+
21
+ Эта CLI-утилита автоматически создает осмысленные сообщения для git-коммитов, используя локальные модели через ollama/Mistral AI API на основе вывода команд `git status` и `git diff`. Реализована в виде одного файла для удобства перевода в исполняемый файл.
22
+
23
+ 1. [Возможности](#возможности)
24
+ 2. [Требования](#требования)
25
+ - [Mistral](#получение-api-ключа-mistral-ai)
26
+ - [Ollama](#установка-ollama)
27
+ 3. [Установка](#установка)
28
+ 4. [Настройка переменных окружения](#настройка-переменных-окружения)
29
+ - [Windows](#windows)
30
+ - [Linux/MacOS](#linuxmacos)
31
+ 5. [Использование](#использование)
32
+ 6. [Примечания](#примечания)
33
+ 7. [Лицензия](#лицензия)
34
+
35
+ ## Возможности
36
+
37
+ - Автоматически генерирует содержательные сообщения коммитов на русском языке
38
+ - Интерактивное подтверждение перед созданием коммита
39
+ - Работает как с существующими Git-репозиториями, так и с новыми
40
+ - Использование локальных моделей/Mistral AI API для формирования сообщений коммитов на основе изменений в репозитории.
41
+
42
+ ## Требования
43
+
44
+ - Установленный Git в системе
45
+ - API-ключ Mistral (для использования Mistral AI API)
46
+ - Установленная ollama в системе (для использования локальных моделей)
47
+
48
+ ### Получение API ключа Mistral AI
49
+
50
+ Для получения ключа необходимо перейти сайт консоли [Mistral](https://console.mistral.ai/api-keys) и создать API ключ. Для получения необходим аккаунт [Mistral](https://auth.mistral.ai/ui/login).
51
+
52
+ ### Установка ollama
53
+
54
+ Для установки ollama переходим на сайт [Ollama](https://ollama.com/download) и выбираем способ, подходящий для Вашей системы.
55
+
56
+ ## Установка
57
+
58
+ ### Pip
59
+
60
+ Установка последнего релиза с pypi.
61
+ ```bash
62
+ # Windows
63
+ pip install commit_maker
64
+ # Linux/MacOS
65
+ pip3 install commit_maker
66
+ ```
67
+
68
+ ### Из исходников
69
+
70
+ При установке из исходников используется флаг `-e`, что позволяет после `git pull` иметь сразу же свежую версию утилиты **без переустановки**!
71
+ ```bash
72
+ git clone https://github.com/Sashayerty/commit_maker
73
+ cd ./commit_maker
74
+ # Windows
75
+ pip install -r requirements.txt
76
+ # Linux/MacOS
77
+ pip3 install -r requirements.txt
78
+ ```
79
+
80
+ ## Настройка переменных окружения
81
+
82
+ После установки утилиты нужно обязательно добавить переменную окружения `MISTRAL_API_KEY`
83
+
84
+ ### Windows
85
+
86
+ 1. Откройте Командную строку от имени Администратора
87
+ 2. Установите API-ключ Mistral:
88
+
89
+ ```cmd
90
+ setx MISTRAL_API_KEY "ваш_api_ключ_здесь"
91
+ ```
92
+
93
+ 3. Перезапустите терминал/IDE для применения изменений
94
+
95
+ ### Linux/macOS
96
+
97
+ 1. Откройте терминал
98
+ 2. Добавьте в файл конфигурации вашей оболочки (`~/.bashrc`, `~/.zshrc` или `~/.bash_profile`):
99
+
100
+ ```bash
101
+ export MISTRAL_API_KEY="ваш_api_ключ_здесь"
102
+ ```
103
+
104
+ 3. Перезагрузите конфигурацию:
105
+
106
+ ```bash
107
+ source ~/.bashrc # или другой файл, который вы редактировали
108
+ ```
109
+
110
+ ## Использование
111
+
112
+ ```bash
113
+ commit_maker [OPTION] [VALUE]
114
+ ```
115
+
116
+ ### Пример использования
117
+
118
+ **`-h`**, **`--help`** - вывод помощи
119
+ **`-l`**, **`--local-models`** - использование локальных моделей
120
+ **`-m`**, **`--max-symbols`** - ограничение длины сообщения коммита
121
+ **`-M`**, **`--model`** - какую локальную модель использовать (при **`-l`**)
122
+ **`-d`**, **`--dry-run`** - вывод сообщения на основе зайстейдженных изменений, без создания коммита
123
+ **`-t`**, **`--temperature`** - температура модели при создании месседжа
124
+ **`-e`**, **`--exclude`** - файлы, которые нужно игнорировать при создании сообщения коммита
125
+ **`--version`** - показывает версию
126
+
127
+ 1. Используем локальные модели, ограничение длины сообщения коммита 300 символов, используем qwen2.5:12b
128
+
129
+ ```bash
130
+ commit_maker -l -m 300 -M qwen2.5:12b
131
+ ```
132
+
133
+ 2. Используем Mistral, температура 1.3, dry run
134
+
135
+ ```bash
136
+ commit_maker -t 1.3 -d
137
+ ```
138
+
139
+ 3. Локальные модели, интерактивный выбор модели
140
+
141
+ ```bash
142
+ commit_maker -l
143
+ ```
144
+
145
+ ## Примечания
146
+
147
+ - Для просмотра всех возможных опций выполнения скрипта добавьте флаг `--help`
148
+ - Скрипт покажет сгенерированное сообщение коммита перед его созданием
149
+ - Вы можете повторно сгенерировать сообщение, нажав `r` при запросе подтверждения
150
+ - По умолчанию сообщения генерируются на русском языке (можно изменить в скрипте)
151
+
152
+ ## Лицензия
153
+
154
+ Commit Maker лицензирован [MIT](LICENSE)
commit_maker-0.2.1/src/commit_maker.egg-info/PKG-INFO → commit_maker-0.2.2/README.md RENAMED
@@ -1,119 +1,140 @@
1
- Metadata-Version: 2.1
2
- Name: commit-maker
3
- Version: 0.2.1
4
- Summary: CLI-утилита для генерации git-коммитов с помощью ИИ
5
- Home-page: https://github.com/Sashayerty/commit_maker
6
- Author: Alex Bulgakov
7
- Author-email: Alex Bulgakov <sashayerty@ya.ru>
8
- License: MIT
9
- Project-URL: Homepage, https://github.com/sashayerty/commit_maker
10
- Requires-Python: >=3.8
11
- Description-Content-Type: text/markdown
12
- License-File: LICENSE
13
-
14
- # Commit Maker [![Created with Python](https://img.shields.io/badge/Created_with-Python-blue)](https://www.python.org/) [![Created with uv](https://img.shields.io/badge/Created_with-uv-purple)](https://docs.astral.sh/uv/) [![Created with ollama](https://img.shields.io/badge/Created_with-ollama-white)](https://ollama.com/) [![PyPi](https://img.shields.io/badge/Available_on-pypi-orange)](https://pypi.org/project/commit-maker/)
15
-
16
- ![Демонстрация](./commit_maker.svg)
17
-
18
- ## Все коммиты в репозитории - результат работы программы
19
-
20
- Эта CLI-утилита автоматически создает осмысленные сообщения для git-коммитов, используя локальные модели через ollama/Mistral AI API на основе вывода команд `git status` и `git diff`. Реализована в виде одного файла для удобства перевода в исполняемый файл.
21
-
22
- 1. [Возможности](#возможности)
23
- 2. [Требования](#требования)
24
- - [Mistral](#получение-api-ключа-mistral-ai)
25
- - [Ollama](#установка-ollama)
26
- 3. [Установка](#установка)
27
- 4. [Настройка переменных окружения](#настройка-переменных-окружения)
28
- - [Windows](#windows)
29
- - [Linux/MacOS](#linuxmacos)
30
- 5. [Использование](#использование)
31
- 6. [Примечания](#примечания)
32
- 7. [Лицензия](#лицензия)
33
-
34
- ## Возможности
35
-
36
- - Автоматически генерирует содержательные сообщения коммитов на русском языке
37
- - Интерактивное подтверждение перед созданием коммита
38
- - Работает как с существующими Git-репозиториями, так и с новыми
39
- - Использование локальных моделей/Mistral AI API для формирования сообщений коммитов на основе изменений в репозитории.
40
-
41
- ## Требования
42
-
43
- - Установленный Git в системе
44
- - API-ключ Mistral (для использования Mistral AI API)
45
- - Установленная ollama в системе (для использования локальных моделей)
46
-
47
- ### Получение API ключа Mistral AI
48
-
49
- Для получения ключа необходимо перейти сайт консоли [Mistral](https://console.mistral.ai/api-keys) и создать API ключ. Для получения необходим аккаунт [Mistral](https://auth.mistral.ai/ui/login).
50
-
51
- ### Установка ollama
52
-
53
- Для установки ollama переходим на сайт [Ollama](https://ollama.com/download) и выбираем способ, подходящий для Вашей системы.
54
-
55
- ## Установка
56
-
57
- ```bash
58
- # Windows
59
- pip install commit_maker
60
- # Linux/MacOS
61
- pip3 install commit_maker
62
- ```
63
-
64
- ## Настройка переменных окружения
65
-
66
- ### Windows
67
-
68
- 1. Откройте Командную строку от имени Администратора
69
- 2. Установите API-ключ Mistral:
70
-
71
- ```cmd
72
- setx MISTRAL_API_KEY "ваш_api_ключ_здесь"
73
- ```
74
-
75
- 3. Перезапустите терминал/IDE для применения изменений
76
-
77
- ### Linux/macOS
78
-
79
- 1. Откройте терминал
80
- 2. Добавьте в файл конфигурации вашей оболочки (`~/.bashrc`, `~/.zshrc` или `~/.bash_profile`):
81
-
82
- ```bash
83
- export MISTRAL_API_KEY="ваш_api_ключ_здесь"
84
- ```
85
-
86
- 3. Перезагрузите конфигурацию:
87
-
88
- ```bash
89
- source ~/.bashrc # или другой файл, который вы редактировали
90
- ```
91
-
92
- ## Использование
93
-
94
- ```bash
95
- commit_maker [OPTION] [VALUE]
96
- ```
97
-
98
- ### Пример использования
99
-
100
- **`-h`**, **`--help`** - вывод помощи
101
- **`-l`**, **`--local-models`** - использование локальных моделей
102
- **`-m`**, **`--max-symbols`** - ограничение длины сообщения коммита
103
- **`-M`**, **`--model`** - какую локальную модель использовать (при **`-l`**)
104
- **`-d`**, **`--dry-run`** - вывод сообщения на основе зайстейдженных изменений, без создания коммита
105
-
106
- ```bash
107
- commit_maker -l -m 300 -M qwen2.5:14b # Используем локальные модели, ограничение длины сообщения коммита 300 символов, используем qwen2.5:14b
108
- ```
109
-
110
- ## Примечания
111
-
112
- - Для просмотра всех возможных опций выполнения скрипта добавьте флаг `--help`
113
- - Скрипт покажет сгенерированное сообщение коммита перед его созданием
114
- - Вы можете повторно сгенерировать сообщение, нажав 'r' при запросе подтверждения
115
- - По умолчанию сообщения генерируются на русском языке (можно изменить в скрипте)
116
-
117
- ## Лицензия
118
-
119
- Commit Maker лицензирован [MIT](LICENSE)
1
+ # Commit Maker [![Created with Python](https://img.shields.io/badge/Created_with-Python-blue)](https://www.python.org/) [![Created with uv](https://img.shields.io/badge/Created_with-uv-purple)](https://docs.astral.sh/uv/) [![Created with ollama](https://img.shields.io/badge/Created_with-ollama-white)](https://ollama.com/) [![PyPi](https://img.shields.io/badge/Available_on-pypi-orange)](https://pypi.org/project/commit-maker/)
2
+
3
+ ![Демонстрация](./commit_maker.svg)
4
+
5
+ ## Все коммиты в репозитории - результат работы программы
6
+
7
+ Эта CLI-утилита автоматически создает осмысленные сообщения для git-коммитов, используя локальные модели через ollama/Mistral AI API на основе вывода команд `git status` и `git diff`. Реализована в виде одного файла для удобства перевода в исполняемый файл.
8
+
9
+ 1. [Возможности](#возможности)
10
+ 2. [Требования](#требования)
11
+ - [Mistral](#получение-api-ключа-mistral-ai)
12
+ - [Ollama](#установка-ollama)
13
+ 3. [Установка](#установка)
14
+ 4. [Настройка переменных окружения](#настройка-переменных-окружения)
15
+ - [Windows](#windows)
16
+ - [Linux/MacOS](#linuxmacos)
17
+ 5. [Использование](#использование)
18
+ 6. [Примечания](#примечания)
19
+ 7. [Лицензия](#лицензия)
20
+
21
+ ## Возможности
22
+
23
+ - Автоматически генерирует содержательные сообщения коммитов на русском языке
24
+ - Интерактивное подтверждение перед созданием коммита
25
+ - Работает как с существующими Git-репозиториями, так и с новыми
26
+ - Использование локальных моделей/Mistral AI API для формирования сообщений коммитов на основе изменений в репозитории.
27
+
28
+ ## Требования
29
+
30
+ - Установленный Git в системе
31
+ - API-ключ Mistral (для использования Mistral AI API)
32
+ - Установленная ollama в системе (для использования локальных моделей)
33
+
34
+ ### Получение API ключа Mistral AI
35
+
36
+ Для получения ключа необходимо перейти сайт консоли [Mistral](https://console.mistral.ai/api-keys) и создать API ключ. Для получения необходим аккаунт [Mistral](https://auth.mistral.ai/ui/login).
37
+
38
+ ### Установка ollama
39
+
40
+ Для установки ollama переходим на сайт [Ollama](https://ollama.com/download) и выбираем способ, подходящий для Вашей системы.
41
+
42
+ ## Установка
43
+
44
+ ### Pip
45
+
46
+ Установка последнего релиза с pypi.
47
+ ```bash
48
+ # Windows
49
+ pip install commit_maker
50
+ # Linux/MacOS
51
+ pip3 install commit_maker
52
+ ```
53
+
54
+ ### Из исходников
55
+
56
+ При установке из исходников используется флаг `-e`, что позволяет после `git pull` иметь сразу же свежую версию утилиты **без переустановки**!
57
+ ```bash
58
+ git clone https://github.com/Sashayerty/commit_maker
59
+ cd ./commit_maker
60
+ # Windows
61
+ pip install -r requirements.txt
62
+ # Linux/MacOS
63
+ pip3 install -r requirements.txt
64
+ ```
65
+
66
+ ## Настройка переменных окружения
67
+
68
+ После установки утилиты нужно обязательно добавить переменную окружения `MISTRAL_API_KEY`
69
+
70
+ ### Windows
71
+
72
+ 1. Откройте Командную строку от имени Администратора
73
+ 2. Установите API-ключ Mistral:
74
+
75
+ ```cmd
76
+ setx MISTRAL_API_KEY "ваш_api_ключ_здесь"
77
+ ```
78
+
79
+ 3. Перезапустите терминал/IDE для применения изменений
80
+
81
+ ### Linux/macOS
82
+
83
+ 1. Откройте терминал
84
+ 2. Добавьте в файл конфигурации вашей оболочки (`~/.bashrc`, `~/.zshrc` или `~/.bash_profile`):
85
+
86
+ ```bash
87
+ export MISTRAL_API_KEY="ваш_api_ключ_здесь"
88
+ ```
89
+
90
+ 3. Перезагрузите конфигурацию:
91
+
92
+ ```bash
93
+ source ~/.bashrc # или другой файл, который вы редактировали
94
+ ```
95
+
96
+ ## Использование
97
+
98
+ ```bash
99
+ commit_maker [OPTION] [VALUE]
100
+ ```
101
+
102
+ ### Пример использования
103
+
104
+ **`-h`**, **`--help`** - вывод помощи
105
+ **`-l`**, **`--local-models`** - использование локальных моделей
106
+ **`-m`**, **`--max-symbols`** - ограничение длины сообщения коммита
107
+ **`-M`**, **`--model`** - какую локальную модель использовать (при **`-l`**)
108
+ **`-d`**, **`--dry-run`** - вывод сообщения на основе зайстейдженных изменений, без создания коммита
109
+ **`-t`**, **`--temperature`** - температура модели при создании месседжа
110
+ **`-e`**, **`--exclude`** - файлы, которые нужно игнорировать при создании сообщения коммита
111
+ **`--version`** - показывает версию
112
+
113
+ 1. Используем локальные модели, ограничение длины сообщения коммита 300 символов, используем qwen2.5:12b
114
+
115
+ ```bash
116
+ commit_maker -l -m 300 -M qwen2.5:12b
117
+ ```
118
+
119
+ 2. Используем Mistral, температура 1.3, dry run
120
+
121
+ ```bash
122
+ commit_maker -t 1.3 -d
123
+ ```
124
+
125
+ 3. Локальные модели, интерактивный выбор модели
126
+
127
+ ```bash
128
+ commit_maker -l
129
+ ```
130
+
131
+ ## Примечания
132
+
133
+ - Для просмотра всех возможных опций выполнения скрипта добавьте флаг `--help`
134
+ - Скрипт покажет сгенерированное сообщение коммита перед его созданием
135
+ - Вы можете повторно сгенерировать сообщение, нажав `r` при запросе подтверждения
136
+ - По умолчанию сообщения генерируются на русском языке (можно изменить в скрипте)
137
+
138
+ ## Лицензия
139
+
140
+ Commit Maker лицензирован [MIT](LICENSE)
{commit_maker-0.2.1 → commit_maker-0.2.2}/pyproject.toml RENAMED
@@ -1,17 +1,32 @@
1
- [project]
2
- name = "commit-maker"
3
- version = "0.2.1"
4
- authors = [
5
- { name="Alex Bulgakov", email="sashayerty@ya.ru" }
6
- ]
7
- description = "CLI-утилита для генерации git-коммитов с помощью ИИ"
8
- readme = "README.md"
9
- license = { text = "MIT" }
10
- requires-python = ">=3.8"
11
- dependencies = []
12
-
13
- [project.scripts]
14
- commit_maker = "commit_maker.main:main"
15
-
16
- [project.urls]
17
- Homepage = "https://github.com/sashayerty/commit_maker"
1
+ [project]
2
+ name = "commit-maker"
3
+ version = "0.2.2"
4
+ authors = [
5
+ { name="Alex Bulgakov", email="sashayerty@ya.ru" }
6
+ ]
7
+ description = "CLI-утилита для генерации git-коммитов с помощью ИИ"
8
+ readme = "README.md"
9
+ license = { text = "MIT" }
10
+ requires-python = ">=3.8"
11
+ dependencies = [
12
+ "requests>=2.32.3",
13
+ "rich-argparse>=1.7.0",
14
+ ]
15
+
16
+ [project.scripts]
17
+ commit_maker = "commit_maker.main:main"
18
+
19
+ [project.urls]
20
+ Homepage = "https://github.com/sashayerty/commit_maker"
21
+
22
+ [build-system]
23
+ requires = ["setuptools>=61.0"]
24
+ build-backend = "setuptools.build_meta"
25
+
26
+ [tool.setuptools.packages.find]
27
+ where = ["src"]
28
+
29
+ [dependency-groups]
30
+ requests-ver = [
31
+ "requests>=2.32.3",
32
+ ]