yfrake.openapi.modules.company_overview   A
last analyzed

Complexity

Total Complexity 0

Size/Duplication

Total Lines 90
Duplicated Lines 0 %

Importance

Changes 0
Metric Value
eloc 49
dl 0
loc 90
rs 10
c 0
b 0
f 0
wmc 0
1
# ================================================================================== #
2
#   company_overview.py - This file is part of the yfrake package.                   #
3
# ================================================================================== #
4
#                                                                                    #
5
#   MIT License                                                                      #
6
#                                                                                    #
7
#   Copyright (c) 2022 Mattias Aabmets                                               #
8
#                                                                                    #
9
#   Permission is hereby granted, free of charge, to any person obtaining a copy     #
10
#   of this software and associated documentation files (the "Software"), to deal    #
11
#   in the Software without restriction, including without limitation the rights     #
12
#   to use, copy, modify, merge, publish, distribute, sublicense, and/or sell        #
13
#   copies of the Software, and to permit persons to whom the Software is            #
14
#   furnished to do so, subject to the following conditions:                         #
15
#                                                                                    #
16
#   The above copyright notice and this permission notice shall be included in all   #
17
#   copies or substantial portions of the Software.                                  #
18
#                                                                                    #
19
#   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR       #
20
#   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,         #
21
#   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE      #
22
#   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER           #
23
#   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,    #
24
#   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE    #
25
#   SOFTWARE.                                                                        #
26
#                                                                                    #
27
# ================================================================================== #
28
summary = 'Company Overview'
29
description = 'Returns the company overview of a security identifier.'
30
31
# ---------------------------------------------------------------------------------- #
32
parameters = [
33
    {
34
        'name': 'symbol',
35
        'description': 'Any valid equity security identifier.',
36
        'required': True,
37
        'in': 'query',
38
        'schema': {
39
            'type': str
40
        }
41
    }
42
]
43
44
# ---------------------------------------------------------------------------------- #
45
response = {
46
    'address1': str,
47
    'city': str,
48
    'state': str,
49
    'zip': str,
50
    'country': str,
51
    'phone': str,
52
    'website': str,
53
    'industry': str,
54
    'sector': str,
55
    'longBusinessSummary': str,
56
    'fullTimeEmployees': int,
57
    'companyOfficers': [
58
        {
59
            'maxAge': int,
60
            'name': str,
61
            'age': int,
62
            'title': str,
63
            'yearBorn': int,
64
            'fiscalYear': int,
65
            'totalPay': {
66
                'raw': int,
67
                'fmt': str,
68
                'longFmt': str
69
            },
70
            'exercisedValue': {
71
                'raw': int,
72
                'fmt': str,
73
                'longFmt': str
74
            },
75
            'unexercisedValue': {
76
                'raw': int,
77
                'fmt': str,
78
                'longFmt': str
79
            }
80
        }
81
    ],
82
    'auditRisk': int,
83
    'boardRisk': int,
84
    'compensationRisk': int,
85
    'shareHolderRightsRisk': int,
86
    'overallRisk': int,
87
    'governanceEpochDate': int,
88
    'compensationAsOfEpochDate': int,
89
    'maxAge': int
90
}
91