ark-rest 0.9.3

REST client for Ark server communication
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

#!/usr/bin/env python3
"""
Script to merge multiple OpenAPI 3.0 files into a single specification.
This merges admin.openapi.json, indexer.openapi.json, service.openapi.json,
signer_manager.openapi.json, types.openapi.json, and wallet.openapi.json
"""

import json
import sys
from typing import Dict, Any

def deep_merge(base: Dict[str, Any], update: Dict[str, Any]) -> Dict[str, Any]:
    """Deep merge two dictionaries"""
    for key, value in update.items():
        if key in base:
            if isinstance(base[key], dict) and isinstance(value, dict):
                base[key] = deep_merge(base[key], value)
            elif isinstance(base[key], list) and isinstance(value, list):
                # For arrays, extend without duplicates
                for item in value:
                    if item not in base[key]:
                        base[key].append(item)
            else:
                # For other types, update overwrites base
                base[key] = value
        else:
            base[key] = value
    return base

def merge_openapi_files():
    """Merge the OpenAPI files into one"""

    # List of OpenAPI files to merge
    openapi_files = [
        'swagger/types.openapi.json',        # Base types first
        'swagger/service.openapi.json',      # Main service API
        'swagger/indexer.openapi.json',      # Indexer API
        'swagger/admin.openapi.json',        # Admin API
        'swagger/signer_manager.openapi.json', # Signer manager API
        'swagger/wallet.openapi.json',       # Wallet API
    ]

    # Read and merge all files
    merged = None

    for file_path in openapi_files:
        try:
            with open(file_path, 'r') as f:
                spec = json.load(f)

            if merged is None:
                # First file - use as base
                merged = spec.copy()
                # Update info section for merged spec
                merged['info'] = {
                    'title': 'Ark API',
                    'version': '1.0.0',
                    'description': 'Combined Ark Service, Indexer, Admin, Signer Manager, and Wallet API'
                }
            else:
                # Merge subsequent files
                # Merge tags
                if 'tags' in spec:
                    if 'tags' not in merged:
                        merged['tags'] = []
                    for tag in spec['tags']:
                        if tag not in merged['tags']:
                            merged['tags'].append(tag)

                # Merge paths
                if 'paths' in spec:
                    if 'paths' not in merged:
                        merged['paths'] = {}
                    merged['paths'] = deep_merge(merged['paths'], spec['paths'])

                # Merge components/schemas
                if 'components' in spec and 'schemas' in spec['components']:
                    if 'components' not in merged:
                        merged['components'] = {}
                    if 'schemas' not in merged['components']:
                        merged['components']['schemas'] = {}
                    merged['components']['schemas'] = deep_merge(
                        merged['components']['schemas'],
                        spec['components']['schemas']
                    )

                # Merge servers if needed
                if 'servers' in spec:
                    if 'servers' not in merged:
                        merged['servers'] = []
                    for server in spec['servers']:
                        if server not in merged['servers']:
                            merged['servers'].append(server)

        except FileNotFoundError:
            print(f"⚠️  Warning: {file_path} not found, skipping...")
            continue

    # Write the merged OpenAPI file
    with open('swagger/merged.openapi.json', 'w') as f:
        json.dump(merged, f, indent=2)

    print("✅ Successfully merged OpenAPI files into swagger/merged.openapi.json")


if __name__ == '__main__':
    try:
        merge_openapi_files()
    except Exception as e:
        print(f"❌ Error merging OpenAPI files: {e}", file=sys.stderr)
        sys.exit(1)