Использование GitHub Copilot для миграции project на другой язык программирования

Чат GitHub Copilot может помочь переместить проект на другой язык. В этом руководстве описывается, что связано с процессом миграции и приведен пример миграции PHP в Python.

В этой статье

Введение

Миграция project на новый язык программирования может быть сложной и трудоёмкой задачей. GitHub Copilot вы можете помочь в этом процессе, объяснив изменения, которые необходимо внести и предложить код замены на новом языке.

Принципы миграции project на новый язык

Прежде чем начать процесс миграции, рассмотрите следующие моменты:

  • Знания по написанию кода

    Убедитесь, что у вас есть хорошее представление о обоих языках программирования. Хотя Copilot вы можете перевести код, вам нужно понять варианты, которые он предлагает, и решить, хотите ли вы использовать свои предложения или попросите альтернативное предложение.

  • Знание системы, перенесенной

    Убедитесь, что вы понимаете архитектуру и логику текущей системы, помимо функциональных возможностей и функций, предоставляемых пользователям. Необходимо убедиться, что переведенный код выполняет все те же операции, что и исходный код, и создает одинаковые результаты.

  • Использование ИИ для помощи вам

    Если вы не понимаете определенную часть кода, который вы хотите перевести, используйте Copilotфункцию "объяснить" либо в целом файле, либо выбранную часть кода в файле. См. Задавать вопросы GitHub Copilot в вашем IDE.

  • Расписание завершения миграции

    Преобразование — это многоэтапный процесс. Чем больше project вы конвертируете, тем больше вам предстоит выполнить шаги. Убедитесь, что вы разрешаете много времени для завершения всего процесса.

  • Работа итеративно

    Старайтесь конвертировать отдельные части вашего project отдельно. Убедитесь, что вы проверили все внесенные изменения, прежде чем перейти к другой части project. Пишите тесты для отдельных частей project по ходу работы, чтобы убедиться, что каждый из новых компонентов работает как следует.

  • Избегайте внедрения сложности процесса

    Сначала стоит to do аналогичной конвертации. Это невозможно для всего кода в вашем project. Однако, чтобы избежать добавления сложности в задачу миграции, следует попытаться ограничить количество новых изменений, которые вы вводите, кроме преобразования кода и использования новой платформы и соответствующих зависимостей.

  • Тест и рефакторинг преобразованного кода

    Завершив начальное преобразование, и у вас есть рабочая система, вы можете выполнить тестирование для сравнения старых и новых систем. Теперь можно рефакторинг кода на новом языке. Это возможность оптимизировать код и сократить технический долг.

Использование Copilot для переноса проекта на новый язык

Если вы уже ознакомились с существующим проектом, хороший способ начать миграцию — открыть ветвь репозитория в редакторе и обратиться Copilot за помощью.

  1. Откройте панель в редакторе Копилот Чат . См. Задавать вопросы GitHub Copilot в вашем IDE.

  2. Попросите Copilot указать шаги, которые необходимо выполнить для переноса проекта на новый язык.

    Например, для миграции с PHP на Python можно попросить:

    Copilot prompt
    @workspace I want to migrate this project from PHP to Python. Give me a high-level overview of the steps I need to take. Don't go into detail at this stage.

    Примечание.

    Участник @workspace чата задает файлы в текущей рабочей области в качестве контекста для интересующего вас вопроса.

Copilot Обычно возвращается список шагов, которые необходимо выполнить для переноса проекта.

  1. Скопируйте Copilotответ и сохраните его где-то, чтобы ссылаться на весь процесс.

  2. Проработайте каждый шаг процесса, запрашивая подробную справку по Copilot мере необходимости.

    Внимательно рассмотрим каждое предложение Copilot . Убедитесь, что вы понимаете код, который он предлагает, и оцените, подходит ли он вашему project. Если вы не уверены, попросите Copilot объяснить вам код.

    Если вы считаете, что изменение, предлагаемое Copilot не так ли, каким-то образом, попросите альтернативное предложение.

  3. Как только вы перенесли компонент в состояние, которое можно запустить, убедитесь, что он работает должным образом. Если она создает ошибку, скопируйте ошибку в Копилот Чат представление и попросите Copilot ее исправить.

  4. После завершения первоначального преобразования используйте Copilot для рефакторинга кода на новом языке. Для получения дополнительной информации см. Рефакторинг кода с помощью GitHub Copilot.

Пример: миграция PHP-project на Python

В следующем примере описывается миграция простого веб-приложения из PHP в Python. Даже если это не те языки программирования, которые вы используете для миграции, возможно, будет полезно следовать описанным здесь шагам, чтобы ознакомиться с миграцией project. Шаги будут аналогичны для переноса других небольших проектов с одного языка на другой.

Снимок экрана: "Простой веб-сайт PHP" перед миграцией с PHP на Python.

В коде из этого примера предполагается следующее:

  • Вы работаете Visual Studio Codeв .
  • Установлены оба языка: PHP и Python версии 3.12 или более поздней.

Миграция простого сайта project

Мы будем переносить код в этом общедоступном репозитории на GitHub: docs/simple-php-site.

Репозиторий состоит из следующих файлов.

.gitignore
.htaccess
LICENSE
content
├── 404.phtml
├── about-us.phtml
├── contact.phtml
├── home.phtml
└── products.phtml
includes
├── config.php
└── functions.php
index.php
readme.md
template
├── style.css
└── template.php

В этом примере приведены запросы, которые можно ввести Копилот Чат для завершения миграции, и ответы, возвращенные Copilot для одного экземпляра этой миграции. Модель GPT-4.1 использовалась для создания этих ответов. Копилот Чат ответы являются недетерминированными, поэтому вы, вероятно, получите немного разные ответы на те, которые показаны здесь.

Во время процесса миграции, скорее всего, возникают ошибки, которые необходимо исправить перед переходом вперед. Copilot это поможет вам. В этом примере содержатся некоторые ошибки и показано, как можно Copilot устранить их.

Так как ответы, от Копилот Чат которых вы получите, скорее всего, отличаются от приведенных здесь, могут возникнуть различные ошибки. Таким образом, вы можете легко выполнить этот пример миграции, используя ответы, показанные здесь, а не те, которые вы получаете от Copilot себя.

После завершения этой миграции вы сможете использовать ту же методологию на своём project.

  1. Начните с клонирования копии репозитория на локальный компьютер.

  2. Запустите приложение, чтобы проверить его работу.

    To do этого в терминале перейдите к корню клонированного репозитория и выполните следующую команду:

    Shell
     php -S localhost:8000

    Затем в браузере перейдите к: http://localhost:8000

  3. Щелкните по веб-сайту, чтобы узнать его, чтобы убедиться, что миграция выполнена успешно.

  4. Создайте рабочую ветвь в репозитории и откройте ее в качестве новой рабочей области.Visual Studio Code

  5. Ознакомьтесь с содержанием и архитектурой существующего project. Copilot Это поможет вам:

    1. Копилот Чат Откройте представление.

    2. Введите запрос, например:

      Copilot prompt
      @workspace Describe this project in detail, explaining what the various components do and how they interact.

  6. Попросите Copilot общий обзор процесса миграции:

    Copilot prompt
    @workspace I want to migrate this project from PHP to Python. Give me a high-level overview of the steps I need to take. Don't go into detail at this stage.

Copilot ответит на такие инструкции, как:

To migrate this project from PHP to Python, follow these high-level steps:

1. Set Up Python Environment:
   - Install Python and set up a virtual environment.
   - Install necessary packages (e.g., Flask for web framework).

2. Convert Configuration:
   - Translate the configuration settings from config.php to a Python configuration file.

3. Rewrite Functions:
   - Convert PHP functions in functions.php to Python functions.

4. Create Flask Application:
   - Set up a Flask application to handle routing and views.
   - Map the routes to corresponding views.

5. Convert Templates:
   - Translate template.php to a Jinja2 template.
   - Update the CSS file path in the template.

6. Convert Content Pages:
   - Convert .phtml content files to HTML or Jinja2 templates.

7. Update .htaccess Rules:
   - Translate .htaccess rewrite rules to Flask route handling.

8. Run and Test:
   - Run the Flask application and test all routes and functionalities.
   - Ensure the site works as expected and fix any issues.

9. Documentation:
   - Update the readme.md with new instructions for running the Python project.

  1. Скопируйте Copilotответ и сохраните его где-то, чтобы ссылаться на оставшуюся часть этого процесса. Вы будете работать с каждым из этих шагов, запрашивая Copilot справку по мере продолжения.

  2. Если вы еще не решили, какую Python платформу вы хотите использовать, вы можете обратиться Copilot за советом:

    Copilot prompt
    @workspace What Python frameworks can I use for this project once it is migrated to Python? Give me a selection of options, with a brief summary of the pros and cons of each in relation to this website project. Which framework would you recommend?

Copilot ответы с информацией о различных платформах и завершают следующее:

For a project like yours - which is a simple, content-driven website - Flask is highly recommended. Its simplicity, flexibility, and ease of use (especially with its templating system that can easily replace your current PHP template structure) make it a great fit.

Мы будем принимать Copilotсоветы и использовать Flask.

  1. Возвращаясь к Copilotвысокому уровню обзора, первым шагом является настройка среды Python и установка необходимых пакетов. Чтобы узнать, как это сделать, введите Копилот Чат:

    Copilot prompt
    @workspace I want to use Flask. Tell me how to set up a virtual environment and install the necessary packages.

Copilot ответит на такие инструкции, как:

1. Create a virtual environment:
   - Open a terminal and navigate to your project directory.
   - Run the following command to create a virtual environment:
     python3 -m venv venv

2. Activate the virtual environment:
   - On macOS and Linux:
     source venv/bin/activate

   - On Windows:
     venv\Scripts\activate

3. Install Flask and necessary packages:
   - With the virtual environment activated, run the following command
     to install Flask and other necessary packages:
     pip install Flask

4. Verify the installation:
   - You can verify that Flask is installed by running:
     pip list

  1. Следуйте Copilotинструкциям и используйте pip list для проверки установки Flask.

  2. Возвращаясь к Copilotобзору процесса миграции, следующим шагом является преобразование конфигурации. Обратитесь Copilot за помощью к этому. Например:

    Copilot prompt
    @workspace As the first step in migrating this project from PHP to Python, create a Python configuration file by converting the functions in functions.php to Python functions. Tell me where to locate the Python config file in the project.

Copilot предполагает создание файла, вызываемого config.py в каталоге includes , содержащего следующий код.

Python
config = {
   'name': 'Simple Python Website',
   'site_url': '',
   'pretty_uri': False,
   'nav_menu': {
      '': 'Home',
      'about-us': 'About Us',
      'products': 'Products',
      'contact': 'Contact',
   },
  'template_path': 'template',
  'content_path': 'content',
  'version': 'v3.1',
}

def get_config(key=''):
   return config.get(key, None)

def site_name():
   return get_config('name')

def site_url():
   return get_config('site_url')

def site_version():
   return get_config('version')

def nav_menu(sep=' | '):
   nav_menu = ''
   nav_items = get_config('nav_menu')

   for uri, name in nav_items.items():
      query_string = request.args.get('page', '')
      class_active = ' active' if query_string == uri else ''
      url = f"{get_config('site_url')}/{'' if get_config('pretty_uri') or uri == '' else '?page='}{uri}"

      nav_menu += f'<a href="{url}" title="{name}" class="item{class_active}">{name}</a>{sep}'

   return nav_menu.strip(sep)

def page_title():
   page = request.args.get('page', 'Home')
   return ' '.join(word.capitalize() for word in page.split('-'))

def page_content():
   page = request.args.get('page', 'home')
   path = os.path.join(os.getcwd(), get_config('content_path'), f'{page}.phtml')

   if not os.path.exists(path):
      path = os.path.join(os.getcwd(), get_config('content_path'), '404.phtml')

   with open(path, 'r') as file:
      return file.read()

def init():
   template_path = os.path.join(get_config('template_path'), 'template.html')
   with open(template_path, 'r') as file:
      return file.read()

  1. includes/config.py Создайте файл и удалите существующий includes/config.php файл.

  2. Вернитесь к обзору еще раз, попросите Copilot перезаписать функции PHP.

    Copilot prompt
    @workspace Continuing the migration of this project from PHP to Python, create Python functions to replace the existing PHP functions. Tell me where to locate the Python functions in the project.

Copilot предполагает создание файла, вызываемого functions.py в каталоге includes , содержащего следующий код.

Python
import os
from flask import request
from .config import get_config

def site_name():
   return get_config('name')

def site_url():
   return get_config('site_url')

def site_version():
   return get_config('version')

def nav_menu(sep=' | '):
   nav_menu = ''
   nav_items = get_config('nav_menu')

   for uri, name in nav_items.items():
      query_string = request.args.get('page', '')
      class_active = ' active' if query_string == uri else ''
      url = f"{get_config('site_url')}/{'' if get_config('pretty_uri') or uri == '' else '?page='}{uri}"

      nav_menu += f'<a href="{url}" title="{name}" class="item{class_active}">{name}</a>{sep}'

   return nav_menu.strip(sep)

def page_title():
   page = request.args.get('page', 'Home')
   return ' '.join(word.capitalize() for word in page.split('-'))

def page_content():
   page = request.args.get('page', 'home')
   path = os.path.join(os.getcwd(), get_config('content_path'), f'{page}.phtml')

   if not os.path.exists(path):
      path = os.path.join(os.getcwd(), get_config('content_path'), '404.phtml')

   with open(path, 'r') as file:
      return file.read()

def init():
   template_path = os.path.join(get_config('template_path'), 'template.html')
   with open(template_path, 'r') as file:
      return file.read()

  1. includes/functions.py Создайте файл и удалите существующий includes/functions.php файл.

  2. Продолжая обзор, следующим шагом является создание приложения Flask. Попросите Copilot вас помочь в этом:

    Copilot prompt
    @workspace Set up a Flask application to handle routing and views, and map the routes to corresponding views. Tell me the location of any files that need to be created or changed.

Copilot предполагает создание файла, вызываемого app.py в корне проекта, содержащего следующий код.

Python
from flask import Flask, render_template, request
import os

app = Flask(__name__)

config = {
   'name': 'Simple Python Website',
   'site_url': '',
   'pretty_uri': False,
   'nav_menu': {
      '': 'Home',
      'about-us': 'About Us',
      'products': 'Products',
      'contact': 'Contact',
   },
   'template_path': 'template',
   'content_path': 'content',
   'version': 'v3.1',
}

def get_config(key=''):
   return config.get(key, None)

@app.route('/')
@app.route('/<page>')
def index(page='home'):
   page_content = get_page_content(page)
   page_title = get_page_title(page)
   nav_menu = get_nav_menu()
   return render_template('template.html', page_title=page_title, page_content=page_content, nav_menu=nav_menu)

def get_page_title(page):
   return ' '.join(word.capitalize() for word in page.split('-'))

def get_page_content(page):
   path = os.path.join(os.getcwd(), get_config('content_path'), f'{page}.phtml')
   if not os.path.exists(path):
      path = os.path.join(os.getcwd(), get_config('content_path'), '404.phtml')
   with open(path, 'r') as file:
      return file.read()

def get_nav_menu(sep=' | '):
   nav_menu = ''
   nav_items = get_config('nav_menu')
   for uri, name in nav_items.items():
      query_string = request.args.get('page', '')
      class_active = ' active' if query_string == uri else ''
      url = f"{get_config('site_url')}/{'' if get_config('pretty_uri') or uri == '' else '?page='}{uri}"
      nav_menu += f'<a href="{url}" title="{name}" class="item{class_active}">{name}</a>{sep}'
   return nav_menu.strip(sep)

if __name__ == '__main__':
   app.run(debug=True)

Copilot также предлагает переименовать template/template.php``template/template.html и обновить файл для использования синтаксиса шаблонов Jinja2:

HTML

<!DOCTYPE html>
<html>
<head>
   <meta charset="utf-8" />
   <meta http-equiv="x-ua-compatible" content="ie=edge"/>
   <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"/>
   <title>{{ page_title }} | {{ get_config('name') }}</title>
   <link href="{{ get_config('site_url') }}/template/style.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div class="wrap">

   <header>
      <h1>{{ get_config('name') }}</h1>
      <nav class="menu">
         {{ nav_menu|safe }}
      </nav>
   </header>

   <article>
      <h2>{{ page_title }}</h2>
      {{ page_content|safe }}
   </article>

   <footer>
      <small>&copy;{{ get_config('version') }} {{ get_config('name') }}.<br>{{ get_config('version') }}</small>
   </footer>

</div>
</body>
</html>

  1. app.py Создайте и template/template.html файлы, как показано ниже.

  2. Copilot также может предложить, что, создав эти файлы, теперь вы запускаете python app.py в терминале, из корневого каталога репозитория, а затем перейдите к http://127.0.0.1:5000.

    Примечание.

    В зависимости от того, как Python установлен на компьютере, может потребоваться использовать команду python3 app.py вместо python app.py того, чтобы убедиться, что используется правильная версия Python.

    При этом в браузере будут отображаться сообщения об ошибках.

  3. Скопируйте исходное TemplateNotFound сообщение об ошибке Копилот Чат в представление и спросите, как это исправить. Например:

    Copilot prompt
    @workspace When I run `python3 app.py`, I get the following error in the browser: `jinja2.exceptions.TemplateNotFound: template.html`. How can I fix this?

Copilot Возвращает сообщение об ошибке, указывающее, что Flask не может найти template.html файл.

Он показывает, что по умолчанию Flask ищет шаблоны в папке templates в корневой директории вашего project. Однако файл template.html находится в каталоге template . Чтобы устранить эту проблему, необходимо указать правильную папку шаблона при создании приложения Flask. Он советует обновить app.py файл, изменив назначение app = Flask(__name__) , чтобы включить template_folder параметр:

Python
app = Flask(__name__, template_folder='template')

  1. Если сервер разработки Flask по-прежнему запущен, при обновлении страницы http://127.0.0.1:5000/браузера появится новая ошибка, связанная с get_config функцией.

    Скопируйте это сообщение об ошибке в представление и попросите Копилот Чат справку.

    Copilot prompt
    @workspace When I run `python3 app.py`, I get the following error in the browser: `jinja2.exceptions.UndefinedError: 'get_config' is undefined.` How can I fix this?

Copilot возвращает сообщение об ошибке, так как get_config недоступно в контексте шаблона Jinja2. Он советует добавить следующий код в app.py файл непосредственно перед строкой @app.route('/'):

Python
app.jinja_env.globals.update(get_config=get_config)

  1. Обновите браузер и теперь увидите веб-сайт.

    Снимок экрана: "Простой веб-сайт Python" без стилей CSS.

    Однако ни один из стилей CSS не применяется. Далее мы исправим эту проблему.

  2. Спросите Copilot:

    Copilot prompt
    @workspace The deployed website does not use the CSS styles. How can I fix this?

Copilot сообщает, что Flask ожидает, что CSS-файл будет находиться в каталоге с именем static. Он предлагает переместить существующий style.css файл из template каталога в новый static каталог, а затем обновить путь к style.css файлу в head пределах части template.html файла. Измените следующее:

HTML

<link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">

При обновлении браузера веб-сайт должен правильно отображаться.

Чтобы завершить начальную миграцию, продолжайте работать с инструкциями, описанными в кратком обзоре, который Copilot дал вам, запросив помощь по мере необходимости.

Завершение миграции

Дальнейшие действия по успешному выполнению процесса миграции будут включать:

  • Тщательно проверьте начальную миграцию.
  • Исправление ошибок. Например, в приведенном здесь примере ссылки на страницы работают только в том случае, если задано pretty_uri``True значение в config разделе app.py файла. Если вы хотите использовать параметры строки запроса в URL-адресах страницы или удалить этот параметр из кода, вы можете обратиться Copilot за помощью к этому.
  • Writing tests для мигрированных project.
  • Очистка project удаляя все файлы, которые больше не нужны.
  • Рефакторинг кода на новом языке. Процесс миграции привёл к созданию Python-проекта, архитектура которого основана на оригинальном PHP-project. Выполнив начальную миграцию, теперь можно рефакторинг кода, чтобы лучше всего использовать функции языка Python и платформы Flask.
  • Обновление документации. Теперь readme.md файл устарел и должен быть перезаписан.