Практические Примеры
Здесь вы найдете коллекцию практических примеров, которые показывают, как инструмент Text Diff может использоваться в различных сценариях.
Разработка Кода
Обновление Функции JavaScript
Файл A (Оригинал):
function calculateTotal(items) {
let total = 0;
for (let i = 0; i < items.length; i++) {
total += items[i].price;
}
return total;
}
Файл B (Улучшенный):
function calculateTotal(items) {
if (!items || items.length === 0) {
return 0;
}
return items.reduce((total, item) => {
return total + (item.price || 0);
}, 0);
}
Результат Diff:
+ 2 2 | if (!items || items.length === 0) {
+ 3 3 | return 0;
+ 4 4 | }
+ 5 5 |
- 2 6 | let total = 0;
- 3 7 | for (let i = 0; i < items.length; i++) {
- 4 8 | total += items[i].price;
- 5 9 | }
- 6 10 | return total;
+ 6 7 | return items.reduce((total, item) => {
+ 7 8 | return total + (item.price || 0);
+ 8 9 | }, 0);
Рефакторинг React Компонента
Файл A (Классовый Компонент):
import React, { Component } from 'react';
class UserProfile extends Component {
constructor(props) {
super(props);
this.state = {
user: null,
loading: true,
};
}
componentDidMount() {
this.fetchUser();
}
fetchUser = async () => {
try {
const response = await fetch(`/api/users/${this.props.userId}`);
const user = await response.json();
this.setState({ user, loading: false });
} catch (error) {
console.error('Error fetching user:', error);
this.setState({ loading: false });
}
};
render() {
const { user, loading } = this.state;
if (loading) return <div>Загрузка...</div>;
if (!user) return <div>Пользователь не найден</div>;
return (
<div>
<h1>{user.name}</h1>
<p>{user.email}</p>
</div>
);
}
}
Файл B (Функциональный Компонент с Хуками):
import React, { useState, useEffect } from 'react';
const UserProfile = ({ userId }) => {
const [user, setUser] = useState(null);
const [loading, setLoading] = useState(true);
useEffect(() => {
const fetchUser = async () => {
try {
const response = await fetch(`/api/users/${userId}`);
const userData = await response.json();
setUser(userData);
} catch (error) {
console.error('Error fetching user:', error);
} finally {
setLoading(false);
}
};
fetchUser();
}, [userId]);
if (loading) return <div>Загрузка...</div>;
if (!user) return <div>Пользователь не найден</div>;
return (
<div>
<h1>{user.name}</h1>
<p>{user.email}</p>
</div>
);
};
Управление Конфигурацией
Конфигурация Docker Compose
Файл A (Разработка):
version: '3.8'
services:
web:
build: .
ports:
- '3000:3000'
environment:
- NODE_ENV=development
- DATABASE_URL=postgresql://localhost:5432/myapp_dev
volumes:
- .:/app
- /app/node_modules
database:
image: postgres:13
environment:
- POSTGRES_DB=myapp_dev
- POSTGRES_USER=dev
- POSTGRES_PASSWORD=dev123
ports:
- '5432:5432'
Файл B (Продакшн):
version: '3.8'
services:
web:
build: .
ports:
- '80:3000'
environment:
- NODE_ENV=production
- DATABASE_URL=${DATABASE_URL}
restart: unless-stopped
depends_on:
- database
database:
image: postgres:13
environment:
- POSTGRES_DB=${POSTGRES_DB}
- POSTGRES_USER=${POSTGRES_USER}
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
volumes:
- postgres_data:/var/lib/postgresql/data
restart: unless-stopped
volumes:
postgres_data:
Зависимости Package.json
Файл A (До Обновления):
{
"dependencies": {
"react": "^17.0.2",
"react-dom": "^17.0.2",
"axios": "^0.21.1",
"lodash": "^4.17.20"
},
"devDependencies": {
"@types/react": "^17.0.0",
"typescript": "^4.2.3",
"webpack": "^5.24.0"
}
}
Файл B (После Обновления):
{
"dependencies": {
"react": "^18.0.0",
"react-dom": "^18.0.0",
"axios": "^1.3.0",
"lodash": "^4.17.21"
},
"devDependencies": {
"@types/react": "^18.0.0",
"typescript": "^4.9.0",
"webpack": "^5.75.0",
"vite": "^4.0.0"
}
}
Разработка API
Спецификация OpenAPI
Файл A (Версия 1.0):
openapi: 3.0.0
info:
title: User API
version: 1.0.0
description: API для управления пользователями
paths:
/users:
get:
summary: Получить всех пользователей
responses:
'200':
description: Список пользователей
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/User'
components:
schemas:
User:
type: object
properties:
id:
type: integer
name:
type: string
email:
type: string
Файл B (Версия 2.0):
openapi: 3.0.0
info:
title: User API
version: 2.0.0
description: Улучшенная API для управления пользователями
paths:
/users:
get:
summary: Получить всех пользователей
parameters:
- name: limit
in: query
schema:
type: integer
default: 10
- name: offset
in: query
schema:
type: integer
default: 0
responses:
'200':
description: Пагинированный список пользователей
content:
application/json:
schema:
$ref: '#/components/schemas/UserList'
'400':
description: Неверный запрос
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/users/{id}:
get:
summary: Получить пользователя по ID
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
'200':
description: Детали пользователя
content:
application/json:
schema:
$ref: '#/components/schemas/User'
'404':
description: Пользователь не найден
components:
schemas:
User:
type: object
properties:
id:
type: integer
name:
type: string
email:
type: string
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
UserList:
type: object
properties:
users:
type: array
items:
$ref: '#/components/schemas/User'
total:
type: integer
limit:
type: integer
offset:
type: integer
Error:
type: object
properties:
message:
type: string
code:
type: string
Документация
README Markdown
Файл A (Базовая Версия):
# Мой Проект
Простое веб-приложение, построенное с React.
## Установка
```bash
npm install
```
Использование
npm start
Функции
- Аутентификация пользователей
- Визуализация данных
- Адаптивный дизайн
**Файл B (Расширенная Версия):**
```markdown
# Мой Проект
Современное веб-приложение, построенное с React и TypeScript, включающее визуализацию данных в реальном времени и продвинутое управление пользователями.
## Содержание
- [Установка](#установка)
- [Использование](#использование)
- [Функции](#функции)
- [Документация API](#документация-api)
- [Вклад](#вклад)
- [Лицензия](#лицензия)
## Установка
### Предварительные Требования
- Node.js 16.0 или выше
- npm 8.0 или выше
### Настройка
```bash
# Клонировать репозиторий
git clone https://github.com/user/my-project.git
cd my-project
# Установить зависимости
npm install
# Настроить переменные окружения
cp .env.example .env
Использование
Разработка
npm run dev
Продакшн
npm run build
npm start
Функции
Основные Функции
- Аутентификация Пользователей: Безопасный вход с JWT токенами
- Визуализация Данных: Интерактивные графики и таблицы
- Адаптивный Дизайн: Mobile-first подход
- Обновления в Реальном Времени: WebSocket интеграция
- API Интеграция: RESTful API с поддержкой GraphQL
Продвинутые Функции
- Темный Режим: Переключение между светлой и темной темами
- Интернационализация: Многоязычная поддержка
- Доступность: Соответствие WCAG 2.1 AA
- Производительность: Оптимизированный размер пакета и время загрузки
Документация API
См. API.md для подробной документации API.
Вклад
- Форк репозитория
- Создать ветку функции
- Внести изменения
- Добавить тесты
- Отправить pull request
Лицензия
MIT Лицензия - см. LICENSE для деталей.
## Анализ Данных
### **JSON Конфигурация**
**Файл A (Конфигурация Разработки):**
```json
{
"database": {
"host": "localhost",
"port": 5432,
"name": "myapp_dev",
"username": "dev_user",
"password": "dev_password"
},
"redis": {
"host": "localhost",
"port": 6379,
"password": null
},
"logging": {
"level": "debug",
"file": "logs/app.log"
},
"features": {
"enableAnalytics": false,
"enableDebugMode": true,
"enableExperimentalFeatures": true
}
}
Файл B (Конфигурация Продакшна):
{
"database": {
"host": "prod-db.example.com",
"port": 5432,
"name": "myapp_prod",
"username": "prod_user",
"password": "${DB_PASSWORD}",
"ssl": true,
"pool": {
"min": 5,
"max": 20
}
},
"redis": {
"host": "prod-redis.example.com",
"port": 6379,
"password": "${REDIS_PASSWORD}",
"cluster": {
"enabled": true,
"nodes": ["redis-1.example.com:6379", "redis-2.example.com:6379", "redis-3.example.com:6379"]
}
},
"logging": {
"level": "info",
"file": "/var/log/myapp/app.log",
"maxSize": "100MB",
"maxFiles": 5
},
"features": {
"enableAnalytics": true,
"enableDebugMode": false,
"enableExperimentalFeatures": false
},
"monitoring": {
"enabled": true,
"endpoint": "https://monitoring.example.com",
"apiKey": "${MONITORING_API_KEY}"
}
}
Лучшие Практики
Эффективное Использование
- Регулярные Сравнения: Сравнивайте файлы регулярно для отслеживания изменений
- Описательные Имена: Используйте значимые имена для ваших файлов
- Использование Истории: Сохраняйте важные сравнения в истории
- Настройка Опций: Экспериментируйте с различными опциями сравнения
Советы по Производительности
- Размер Файла: Держите файлы под 10,000 строк для оптимальной производительности
- Кэш Браузера: Очистите кэш браузера при проблемах
- Современные Браузеры: Используйте актуальные версии браузеров
Заметки о Безопасности
- Чувствительные Данные: Избегайте сравнения паролей или API ключей
- Локальная Обработка: Вся обработка происходит локально в вашем браузере
- Очистка Истории: Удаляйте историю регулярно
Эти примеры показывают универсальность и мощь инструмента Text Diff в различных сценариях применения.