YAML

# Это комментарий
name: Иван  # комментарий после значения

# Строка (кавычки не обязательны)
name: Иван

# Число
age: 30

# Логическое
is_active: true

# null (пустое значение)
phone: null
phone: ~    # альтернативная запись

# JSON стиль (но без кавычек и скобок)
user:
  name: Иван
  age: 30
  address:
    city: Москва
    street: Тверская

# Альтернативный синтаксис (блочный, для краткости)
user: {name: Иван, age: 30}

# Каждый элемент на новой строке с дефисом
phones:
  - +7-999-123-45-67
  - +7-495-123-45-67

# Альтернативный синтаксис (в одну строку)
phones: [+7-999-123-45-67, +7-495-123-45-67]

users:
  - name: Иван
    age: 30
    phones:
      - +7-999-123-45-67
      - +7-495-123-45-67
  - name: Петр
    age: 25
    phones:
      - +7-999-765-43-21

description: |
  Это первая строка.
  Это вторая строка.
  Это третья строка.

# Результат: "Это первая строка.\nЭто вторая строка.\nЭто третья строка.\n"

description: >
  Это длинное предложение,
  которое разбито на несколько строк,
  но в итоге будет одной строкой.

# Результат: "Это длинное предложение, которое разбито на несколько строк, но в итоге будет одной строкой.\n"

# Сохранить переносы в конце
text: |-
  Строка без переноса в конце

# Добавить перенос в конце
text: |+
  Строка с переносом в конце

# Количество отступов для блока
code: |2
    def hello():
        print("Hello")

# Без кавычек
name: Иван

# В двойных кавычках (экранирование)
path: "C:\\Users\\ivan"

# В одинарных кавычках (без экранирования)
regex: '\d+'

# Пустая строка
empty: ''

integer: 42
float: 3.14
negative: -10
exponential: 1.5e3
hex: 0x2A
octal: 0o52
binary: 0b101010
infinity: .inf
not_a_number: .nan

true_value: true
false_value: false

# Альтернативные записи (лучше не использовать)
yes_value: yes
no_value: no
on_value: on
off_value: off

date: 2024-01-15
datetime: 2024-01-15T10:30:00Z
datetime_with_offset: 2024-01-15T10:30:00+03:00

empty: null
empty2: ~
empty3:   # просто ничего после двоеточия

# Определение якоря &defaults
defaults: &defaults
  timeout: 30
  retries: 3
  backoff: 2

# Использование ссылки *defaults
production:
  <<: *defaults
  url: https://prod.example.com

development:
  <<: *defaults
  url: http://localhost:8080
  timeout: 60  # переопределение

production:
  timeout: 30
  retries: 3
  backoff: 2
  url: https://prod.example.com

development:
  timeout: 60
  retries: 3
  backoff: 2
  url: http://localhost:8080

users:
  - &admin
    name: Admin
    role: admin
  - &user
    name: User
    role: user

# Ссылки
admins:
  - *admin
  - name: BackupAdmin
    role: admin

users_copy: [*admin, *user]

# Явное указание типа
not_string: !!str 42
not_float: !!int 3.14
binary_data: !!binary SGVsbG8gV29ybGQ=
timestamp: !!timestamp 2024-01-15T10:30:00Z

# Уникальные значения (редко используется)
colors: !!set
  ? red
  ? green
  ? blue

version: '3.8'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html
    restart: always
  
  db:
    image: postgres:15
    environment:
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: myapp
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
  labels:
    app: myapp
spec:
  replicas: 3
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
        - name: myapp
          image: myapp:1.0.0
          ports:
            - containerPort: 8080
          env:
            - name: DATABASE_URL
              value: postgres://db:5432/myapp
          resources:
            limits:
              memory: "512Mi"
              cpu: "500m"

name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      - run: pip install -r requirements.txt
      - run: pytest tests/

- name: Установка и настройка веб-сервера
  hosts: webservers
  become: yes
  tasks:
    - name: Установка nginx
      apt:
        name: nginx
        state: present
    
    - name: Копирование конфигурации
      template:
        src: nginx.conf.j2
        dest: /etc/nginx/nginx.conf
      notify: reload nginx
  
  handlers:
    - name: reload nginx
      service:
        name: nginx
        state: reloaded

openapi: 3.0.0
info:
  title: User API
  version: 1.0.0
paths:
  /users/{id}:
    get:
      summary: Получить пользователя
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Успех
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string

# Правильно (2 пробела)
user:
  name: Иван
  age: 30

# Ошибка (смесь пробелов и табуляций)
user:
    name: Иван   # табуляция
  age: 30        # пробелы

# Неожиданное число
version: 1.0   # станет числом 1.0, не строкой

# Неожиданный null
null_value: null   # null
empty:             # null (пустое значение)

# Неожиданное логическое
on: on            # true
off: off          # false
yes: yes          # true
no: no            # false

version: "1.0"
on: "on"
empty: ""

# Опасно
import yaml
data = yaml.load(user_input)   # может выполнить код

# Безопасно
data = yaml.safe_load(user_input)

{
    "database": {
        "host": "localhost",
        "port": 5432,
        "name": "myapp",
        "user": "admin",
        "password": "secret"
    },
    "redis": {
        "host": "localhost",
        "port": 6379
    },
    "features": ["analytics", "logging", "notifications"]
}

# Конфигурация приложения
database:
  host: localhost
  port: 5432
  name: myapp
  user: admin
  password: secret

redis:
  host: localhost
  port: 6379

features:
  - analytics
  - logging
  - notifications

# Плохо (табуляция)
user:
	name: Иван

# Хорошо (2 пробела)
user:
  name: Иван

# Плохо (разное количество пробелов)
user:
  name: Иван
    age: 30

# Хорошо
user:
  name: Иван
  age: 30

# Плохо (станет числом 1.0)
version: 1.0

# Плохо (станет true)
feature_enabled: on

# Хорошо (строка)
version: "1.0"
feature_enabled: "on"

# Плохо (null, но может быть неожиданностью)
phone:

# Лучше (явно)
phone: null
phone: ~

# Плохо (синтаксическая ошибка)
name:Иван

# Хорошо
name: Иван

# Плохо
phones:
  -+7-999-123-45-67

# Хорошо
phones:
  - +7-999-123-45-67