Ценовое предложение образец рб: Коммерческое предложение скачать бланк РБ

octokit / octokit.rb: набор инструментов Ruby для GitHub API

Набор инструментов Ruby для GitHub API.

Обновление? Ознакомьтесь с руководством по обновлению, прежде чем переходить к новому основная версия.

Содержание

1. Философия
2. Быстрый старт
3. Запросы
4. Потребление ресурсов
5. Доступ к HTTP-ответам
6. Аутентификация
   1. Базовая аутентификация
   2. токенов доступа OAuth
   3. Двухфакторная аутентификация
   4. Использование файла.netrc файл
   5. Аутентификация приложения
7. Пагинация
   1. Автоматическая разбивка на страницы
8. Работа с GitHub Enterprise
   1. Взаимодействие с API GitHub.com в GitHub Enterprise
   2. Взаимодействие с GitHub Enterprise Admin API
   3. Взаимодействие с API-интерфейсами GitHub Enterprise Management Console
9. Ошибки подключения SSL
10. Конфигурация и настройки по умолчанию
    1. Настройка модуля по умолчанию
    2. Использование переменных ENV
    3. Таймауты
11. Агент гипермедиа
    1. Гипермедиа в Octokit
    2. Шаблоны URI
    3. Полная версия Hypermedia Experience ™
12. Руководство по обновлению
    1. Обновление с 1.x.x
13. Расширенное использование
    1. Отладка
    2. Кэширование
14. Взлом Octokit.rb
    1. Кодекс поведения
    2. Запуск и написание новых тестов
15. Поддерживаемые версии Ruby
16. Управление версиями
17. Создание повторяющихся запросов
18. Лицензия

Философия

обертки API должны отражать идиомы языка, на котором они были написано. Octokit.rb превращает API GitHub в плоский API клиент, который следует соглашениям Ruby и требует небольшого знания REST.Большинство методов имеют позиционные аргументы для обязательного ввода и хэш параметров. для дополнительных параметров, заголовков или других опций:

 client = Octokit :: Client.new

# Получить README с заголовком Accept для формата HTML
client.readme 'al3x / суверен',: accept => 'application / vnd.github.html' 

Быстрый старт

Установить через Rubygems

... или добавьте в свой Gemfile

Доступ к библиотеке на Ruby:

Отправка запросов

методов API доступны как методы экземпляра клиента.

 # Укажите учетные данные для аутентификации
client = Octokit :: Client.new (: access_token => 'personal_access_token')

# Вы по-прежнему можете использовать синтаксис имени пользователя и пароля, заменив значение пароля на свой PAT.
# client = Octokit :: Client.new (: login => 'defunkt',: password => 'personal_access_token')

# Получить текущего пользователя
client.user 

Дополнительные параметры запроса

При передаче дополнительных параметров в запрос на основе GET используйте следующий синтаксис:

 # query: {имя_параметра: 'значение'}
 # Пример: получить список репозитория по владельцу в возрастающем порядке
 клиент.репо ({}, запрос: {тип: 'владелец', сортировка: 'по возрастанию'})

 # Пример: получить содержимое репозитория по ссылке
 # https://api.github.com/repos/octokit/octokit.rb/contents/path/to/file.rb?ref=some-other-branch
 client.contents ('octokit / octokit.rb', путь: 'путь / к / file.rb', запрос: {ref: 'some-other-branch'}) 

Потребление ресурсов

Большинство методов возвращают объект Resource , который обеспечивает точечную нотацию и [] доступ к полям, возвращаемым в ответе API.

 клиент = Octokit :: Client.новый

# Получить пользователя
пользователь = client.user 'jbarnette'
помещает user.name
# => "Джон Барнетт"
помещает user.fields
# => 
помещает пользователя [: компания]
# => "GitHub"
user.rels [: gists] .href
# => "https://api.github.com/users/jbarnette/gists" 

Примечание: поля URL выделены в отдельную коллекцию .rels для упрощения Поддержка гипермедиа.

Доступ к HTTP-ответам

Хотя большинство методов возвращают объект Resource или логическое значение, иногда вы можете нужен доступ к необработанным заголовкам HTTP-ответов. Вы можете получить доступ к последнему HTTP ответ с Client # last_response :

 пользователь = client.user 'andrewpthorp'
response = client.last_response
etag = response.headers [: etag] 

Аутентификация

Octokit поддерживает различные методы аутентификации, поддерживаемые GitHub. API:

Базовая проверка подлинности

Использование имени пользователя и пароля GitHub - самый простой способ начать работу отправка аутентифицированных запросов:

 клиент = Octokit :: Client.новый (: логин => 'defunkt',: пароль => 'c0d3b4ssssss!')

пользователь = client.user
Логин пользователя
# => "defunkt" 

В то время как обычная проверка подлинности позволяет быстро приступить к работе, доступ OAuth токены - это предпочтительный способ аутентификации от имени пользователей.

токенов доступа OAuth

OAuth обеспечивают два основных преимущества по сравнению с использованием вашего имени пользователя. и пароль:

• Отзыв . Жетоны доступа можно отозвать, исключив доступ только за этот токен без необходимости везде менять пароль.
• Ограниченный доступ . У токенов доступа есть области доступа, которые позволяют детальный доступ к ресурсам API. Например, вы можете предоставить третьей стороне доступ к вашим сущностям, но не к вашим личным репозиториям.

Чтобы использовать токен доступа с клиентом Octokit, передайте свой токен в : параметр access_token вместо вашего имени пользователя и пароля:

 client = Octokit :: Client.new (: access_token => "<ваш токен 40 символов>")

пользователь = клиент.Пользователь
Логин пользователя
# => "defunkt" 

Вы можете создать токены доступа в настройках учетной записи GitHub. или с базовым аутентифицированным клиентом Octokit:

 client = Octokit :: Client.new (: login => 'defunkt',: password => 'c0d3b4ssssss!')

client.create_authorization (: scopes => ["пользователь"],: note => "Имя токена")
# => <ваш новый токен oauth> 

Двухфакторная аутентификация

Двухфакторная аутентификация обеспечивает дополнительную безопасность учетной записи, требуя дополнительной информации для входа в систему.

Использовать двухфакторную аутентификацию для вызовов API так же просто, как добавить требуемый заголовок в качестве опции:

 клиент = Octokit :: Client.new \
  : логин => 'defunkt',
  : пароль => 'c0d3b4ssssss!'

user = client.user ("defunkt",: headers => {"X-GitHub-OTP" => "<ваш токен 2FA>"}) 

Как вы понимаете, это быстро раздражает, поскольку двухфакторные токены аутентификации очень недолговечны. Поэтому рекомендуется создать токен oauth для взаимодействия пользователя с API:

 клиент = Octokit :: Client.новый \
  : логин => 'defunkt',
  : пароль => 'c0d3b4ssssss!'

client.create_authorization (: scopes => ["user"],: note => "Имя токена",
                            : headers => {"X-GitHub-OTP" => "<ваш токен 2FA>"})
# => <ваш новый токен oauth> 

Использование файла .netrc

Octokit поддерживает чтение учетных данных из файла netrc (по умолчанию ~ / .netrc ). Учитывая эти строки в вашем netrc:

  машина api.github.com
  войти в систему
  пароль c0d3b4ssssss!
  

Теперь вы можете создать клиента с этими учетными данными:

 клиент = Octokit :: Client.новый (: netrc => true)
client.login
# => "defunkt" 

Но я хочу использовать OAuth скажете вы. Поскольку GitHub API поддерживает использование OAuth токен в качестве базового пароля, вы можете:

  машина api.github.com
  войти в систему
  пароль <ваш токен из 40 символов>
  

Примечание: Для поддержки netrc требуется добавить гем netrc в ваш Gemfile. или .gemspec .

Аутентификация приложения

Octokit также поддерживает аутентификацию только приложения с использованием клиента приложения OAuth. реквизиты для входа.Использование учетных данных приложения приведет к созданию анонимные вызовы API от имени приложения, чтобы воспользоваться преимуществами более высокий предел скорости.

 клиент = Octokit :: Client.new \
  : client_id => "<ваш идентификатор из 20 символов>",
  : client_secret => "<ваш секрет из 40 символов>"

пользователь = client.user 'defunkt' 

Результаты по умолчанию на страницу

По умолчанию результаты GitHub API равны 30, если вы хотите добавить больше, вы должны сделать это во время настройки Octokit.

 Octokit :: Клиент.new (access_token: "<ваш токен из 40 символов>", per_page: 100) 

Разбиение на страницы

Многие ресурсы API GitHub разбиты на страницы. Хотя у вас может возникнуть соблазн начать добавляя параметры : страница к вашим вызовам, API возвращает ссылки на следующие, предыдущая и последняя страницы для вас в заголовке ответа Link как Hypermedia связь отношений.

 issues = client.issues 'rails / rails'
issues.concat client.get (client.last_response.rels [: следующий] .href) 

Автоматическая разбивка на страницы

Для небольших списков ресурсов Octokit обеспечивает автоматическую разбивку на страницы.Когда это включено, вызовы ресурсов с разбивкой на страницы будут извлекать и объединять результаты с каждой страницы в единый массив:

 client.auto_paginate = true
issues = client.issues 'рельсы / рельсы'
issues.length

# => 702 

Вы также можете включить автоматическую разбивку на страницы для всех клиентских экземпляров Octokit:

 Octokit.configure do | c |
  c.auto_paginate = true
конец 

Примечание: В то время как автоматическая разбивка на страницы Octokit устанавливает максимальный размер страницы 100 , и старайтесь не выходить за пределы допустимой скорости, вы, вероятно, захотите использовать нестандартный шаблон для обхода больших списков.

Работа с GitHub Enterprise

После небольшой настройки вы также можете использовать Octokit с вашим экземпляром GitHub Enterprise.

Взаимодействие с API GitHub.com в GitHub Enterprise

Чтобы взаимодействовать с «обычными» API GitHub.com в GitHub Enterprise, просто настройте api_endpoint в соответствии с вашим именем хоста. Например:

 Octokit.configure do | c |
  c.api_endpoint = "https: // <имя хоста> / api / v3 /"
конец

client = Octokit :: Клиент.new (: access_token => "<ваш токен из 40 символов>") 

Взаимодействие с GitHub Enterprise Admin API

API-интерфейсы администратора GitHub Enterprise находятся под другим клиентом: EnterpriseAdminClient . Для использования этих API вам потребуется учетная запись администратора.

 admin_client = Octokit :: EnterpriseAdminClient.new (
  : access_token => "<ваш токен из 40 символов>",
  : api_endpoint => "https: // <имя хоста> / api / v3 /"
)

# или
Octokit.configure do | c |
  c.api_endpoint = "https: // <имя хоста> / api / v3 /"
  c.access_token = "<ваш токен из 40 символов>"
конец

admin_client = Octokit.enterprise_admin_client.new 

Взаимодействие с API-интерфейсами GitHub Enterprise Management Console

API-интерфейсы GitHub Enterprise Management Console также находятся под отдельным клиентом: EnterpriseManagementConsoleClient . Чтобы использовать его, вам необходимо предоставить как пароль консоли управления, так и конечную точку консоли управления.Это отличается от конечной точки API, указанной выше.

 management_console_client = Octokit :: EnterpriseManagementConsoleClient.new (
  : management_console_password => "секрет",
  : management_console_endpoint = "https: // имя хоста: 8633"
)

# или
Octokit.configure do | c |
  c.management_console_endpoint = "https: // имя хоста: 8633"
  c.management_console_password = "секрет"
конец

management_console_client = Octokit.enterprise_management_console_client.new 

Ошибки подключения SSL

Вам, , может понадобиться временно отключить SSL при первой настройке установки GitHub Enterprise.Вы можете сделать это со следующей конфигурацией:

 client.connection_options [: ssl] = {: verify => false} 

Не забудьте повернуть : проверить обратно на истинный , так как это важно для безопасной связи.

Конфигурация и значения по умолчанию

В то время как Octokit :: Client принимает ряд параметров при создании нового клиента Например, API конфигурации Octokit позволяет вам установить вашу конфигурацию варианты на уровне модуля. Это особенно удобно, если вы создаете количество клиентских экземпляров на основе некоторых общих значений по умолчанию.Изменение параметров влияет только на новые экземпляры и не изменяет существующие Octokit :: Client экземпляры, созданные с предыдущими параметрами.

Настройка модуля по умолчанию

Каждый доступный для записи атрибут в {Octokit :: Configurable} может быть установлен по одному:

 Octokit.api_endpoint = 'http://api.github.dev'
Octokit.web_endpoint = 'http://github.dev' 

или в партии:

 Octokit.configure do | c |
  c.api_endpoint = 'http://api.github.dev'
  c.web_endpoint = 'http: // github.Dev '
конец 

Использование переменных ENV

Значения конфигурации по умолчанию указаны в {Octokit :: Default}. Много атрибуты будут искать значение по умолчанию из ENV перед возвратом Octokit по умолчанию.

 # Учитывая, что $ OCTOKIT_API_ENDPOINT - это "http://api.github.dev"
client.api_endpoint

# => "http://api.github.dev" 

Предупреждения об устаревании и конечные точки API в предупреждениях предварительной версии разработки печатается в STDOUT по умолчанию, их можно отключить, установив ENV OCTOKIT_SILENT = истина .

Таймауты

По умолчанию Octokit не выполняет тайм-аут сетевых запросов. Чтобы установить тайм-аут, передайте настройки тайм-аута Фарадея в настройку Octokit connection_options .

 Octokit.configure do | c |
  c.api_endpoint = ENV.fetch ('GITHUB_API_ENDPOINT', 'https://api.github.com/')
  c.connection_options = {
    запрос: {
      open_timeout: 5,
      тайм-аут: 5
    }
  }
конец 

Вы должны установить тайм-аут, чтобы избежать модуля Ruby Timeout, который может привести к утечке вашего сервера.Вот несколько ресурсов для получения дополнительной информации по этому поводу:

Агент гипермедиа

Начиная с версии 2.0 Octokit поддерживает гипермедиа. Под капотом, {Octokit :: Client} использует Sawyer, гипермедиа-клиент, созданный на основе Фарадея.

Гипермедиа в Octokit

Ресурсы, возвращаемые методами Octokit, содержат не только данные, но и гипермедиа отношения ссылок:

 пользователь = client.user 'technoweenie'

# Получить репозиторий rel, возвращенный из API
# как repos_url в ресурсе
Пользователь.rels [: репозиторий] .href
# => "https://api.github.com/users/technoweenie/repos"

репозитории = user.rels [: репозитории] .get.data
repos.last.name
# => "faraday-zeromq" 

При обработке ответов API все атрибуты * _url отбираются в ссылку Коллекция отношений. Любой атрибут url становится .rels [: self] .

Шаблоны URI

Вы могли заметить, что во многих отношениях ссылок есть переменные-заполнители. Octokit поддерживает шаблоны URI для параметризованного расширения URI:

 репо = клиент.репо 'pengwynn / pingwynn'
rel = repo.rels [: issues]
# => # 

# Получите страницу с проблемами
rel.get.data

# Получить выпуск №2
rel.get (: uri => {: number => 2}). data 

Полный опыт Hypermedia ™

Если вы хотите использовать Octokit в качестве чистого гипермедийного API-клиента, вы можете начать с корень API и следуйте ссылкам оттуда:

 корень = client.root
root.rels [: репозиторий] .get: uri => {: owner => "octokit",: repo => "octokit.rb "}
root.rels [: user_repositories] .get: uri => {: user => "octokit"},
                                  : query => {: type => "owner"} 

Octokit 3.0 ориентирован на гипермедиа, удаляя внутренний URL-адрес. конструкция в настоящее время используется на всей территории клиента.

Руководство по обновлению

Версия 4.0

Версия 3.0 включает несколько критических изменений при обновлении с v2.x.x:

Тип носителя по умолчанию теперь v3 вместо beta .Если вам нужно запросить более старый тип носителя, вы можете установить тип носителя по умолчанию для клиента:

 Octokit.default_media_type = "application / vnd.github.beta + json" 

или по запросу

 client.emails (: accept => "application / vnd.github.beta + json") 

Удален давно устаревший метод Octokit :: Client # create_download .

Обновление 1.x.x

Версия 2.0 включает полностью переписанную фабрику клиента , которая теперь запоминает клиентские экземпляры на основе уникальных параметров конфигурации.Критические изменения также включают:

• : oauth_token теперь : access_token
• : auto_traversal теперь : auto_paginate
• Hashie :: Mash удален. Ответы теперь возвращают Sawyer :: Resource объект. Этот новый тип ведет себя в основном как Ruby Hash , но не полностью поддерживают API Hashie :: Mash .
• При необходимости возникают два новых типа ошибок клиента: Octokit :: TooManyRequests и Octokit :: TooManyLoginAttempts
• Методы search_ * из v1.x теперь находятся по адресу legacy_search_ *
• Для поддержки netrc необходимо включить гем netrc в ваш Gemfile или gemspec.
• Поля DateTime теперь являются правильными объектами DateTime . Предыдущие версии выводили поля DateTime как строковые объекты.

Расширенное использование

Поскольку Octokit использует Фарадея под капотом, некоторое поведение может быть расширяется через промежуточное ПО.

Отладка

Часто помогает узнать, что Octokit делает под капотом.Вы можете добавить logger к промежуточному программному обеспечению, которое позволяет вам заглядывать в базовый HTTP трафик:

 stack = Faraday :: RackBuilder.new do | builder |
  builder.use Faraday :: Request :: Retry, исключения: [Octokit :: ServerError]
  builder.use Octokit :: Middleware :: FollowRedirects
  builder.use Octokit :: Response :: RaiseError
  builder.use Octokit :: Response :: FeedParser
  builder.response: регистратор
  builder.adapter Faraday.default_adapter
конец
Octokit.middleware = стек

client = Octokit :: Client.new
клиент.пользователь 'pengwynn' 

  I, [2013-08-22T15: 54: 38.583300 # 88227] ИНФОРМАЦИЯ -: получить https://api.github.com/users/pengwynn
D, [2013-08-22T15: 54: 38.583401 # 88227] ОТЛАДКА - запрос: Принять: "application / vnd.github.beta + json"
Пользовательский агент: "Octokit Ruby Gem 2.0.0.rc4"
I, [2013-08-22T15: 54: 38.843313 # 88227] ИНФОРМАЦИЯ - Статус: 200
D, [2013-08-22T15: 54: 38.843459 # 88227] DEBUG - ответ: сервер: "GitHub.com"
date: "Thu, 22 Aug 2013 20:54:40 GMT"
тип содержимого: "приложение / json; charset = utf-8"
кодирование передачи: "фрагментировано"
соединение: "закрыть"
статус: «200 ОК»
x-ratelimit-limit: "60"
остаточный x-ratelimit: "39"
x-ratelimit-reset: "1377205443"
...
  

См. README Фарадея, чтобы узнать больше о магии промежуточного программного обеспечения.

Кэширование

Если вы хотите повысить производительность, увеличьте ограничение скорости API или не платите налог на гипермедиа, вы можете использовать Faraday Http Cache.

Добавьте драгоценный камень в свой Gemfile

Затем создайте собственное промежуточное ПО Фарадея:

 stack = Faraday :: RackBuilder.new do | builder |
  builder.use Faraday :: HttpCache, сериализатор: Marshal, shared_cache: false
  builder.use Octokit :: Response :: RaiseError
  строитель.адаптер Faraday.default_adapter
конец
Octokit.middleware = стек 

После настройки промежуточное ПО будет хранить ответы в кеше на основе ETag. отпечаток пальца и служить его резервным копированием для будущих 304 ответов на то же ресурс. См. Проект README для расширенного использования.

Взлом Octokit.rb

Если вы хотите взломать Octokit локально, мы постараемся сделать загрузку проект максимально безболезненно. Чтобы начать взлом, клонируйте и запускайте:

Это установит зависимости проекта и запустит вас.Если хочешь чтобы запустить консоль Ruby, чтобы тыкать в Octokit, вы можете запустить ее с помощью:

Использование сценариев в ./script вместо bundle exec rspec , bundle console и т. Д. Гарантирует, что ваши зависимости актуальны.

Кодекс поведения

Мы хотим, чтобы и Octokit.rb, и более крупные сообщества Octokit были открытыми и гостеприимная обстановка. Пожалуйста, прочтите и следуйте как по духу, так и по буквенный Кодекс поведения.

Запуск и написание новых тестов

Octokit использует видеомагнитофон для записи и воспроизведения приборов API во время тестирования работает.Эти кассеты (приспособления) являются частью проекта Git в спецификации / кассеты папка. Если вы не записываете новые кассеты, вы можете запустить спецификации с существующими кассеты с:

Octokit использует переменные среды для хранения учетных данных, используемых при тестировании. Если вы тестируете конечную точку API, которая не требует аутентификации, вы можно обойтись без дополнительной настройки. По большей части тесты использовать аутентифицированного клиента, используя токен, хранящийся в ENV ['OCTOKIT_TEST_GITHUB_TOKEN'] .В API используется несколько различных методов аутентификации. Вот полный список настраиваемых переменных среды для тестирования. Октокит:

Поскольку мы периодически обновляем наши кассеты, помните о некоторых моментах. при написании новых спецификаций.

• Спецификации должны быть идемпотентными . HTTP-вызовы, сделанные во время спецификации, должны быть может быть запущен снова и снова. Это означает удаление известного ресурса до создавая его, если имя должно быть уникальным.
• Спецификации должны запускаться в произвольном порядке. Если спецификация зависит от другой ресурс как приспособление, убедитесь, что он создан в рамках spec и не зависеть от предыдущей спецификации для создания необходимых данных.
• Не зависит от информации аутентифицированного пользователя. Вместо утверждения фактические значения в ресурсах, попробуйте подтвердить существование ключа или ответ - это массив. Мы тестируем клиента, а не API.

Поддерживаемые версии Ruby

Эта библиотека предназначена для поддержки и протестирована на следующих Ruby внедрений:

• Рубин 2.5
• Рубин 2,6
• Рубин 2,7

Если что-то не работает в одной из этих версий Ruby, это ошибка.

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

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

Управление версиями

Эта библиотека стремится придерживаться семантического управления версиями 2.0.0. Нарушения об этой схеме следует сообщать как об ошибках. В частности, если второстепенный или патч выпущена версия, которая нарушает обратную совместимость, эта версия должна быть немедленно выдернуты и / или должна быть немедленно выпущена новая версия, которая восстанавливает совместимость.Критические изменения в общедоступном API будут представлен с новыми основными версиями. В результате этой политики вы можете (и следует) указать зависимость от этого драгоценного камня с помощью пессимистической версии Ограничение с точностью до двух цифр. Например:

  spec.add_dependency 'octokit', '~> 3.0'
  

Изменения, сделанные между версиями, можно увидеть на странице релизов проекта.

Создание повторяющихся запросов

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

 Octopoller.poll (тайм-аут: 15 секунд) делать
  начинать
    client.request_progress # пример. запросить статус длительной работы
  ошибка спасения
    : re_poll
  конец
конец 

Это полезно при выполнении запросов на выполнение длительного задания (например, при запросе выполнения импорта исходного кода).

Лицензия

Copyright (c) 2009-2014 Wynn Netherland, Адам Стаковяк, Эрик Майклс-Обер

Разрешение предоставляется бесплатно любому лицу, получившему копию этого программного обеспечения и связанных файлов документации ( «Программное обеспечение») для работы с Программным обеспечением без ограничений, включая без ограничения права на использование, копирование, изменение, объединение, публикацию, распространять, сублицензировать и / или продавать копии Программного обеспечения, а также разрешить лицам, которым предоставляется Программное обеспечение, делать это, при условии следующие условия:

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

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ ​​ГАРАНТИЯМИ КОММЕРЧЕСКАЯ ЦЕННОСТЬ, ПРИГОДНОСТЬ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ И НЕПРАВОМОЧНОСТЬ. НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ АВТОРЫ ИЛИ ВЛАДЕЛЬЦЫ АВТОРСКИХ ПРАВ НЕ ДОЛЖНЫ БЫТЬ ОТВЕТСТВЕННОСТЬ ЗА ЛЮБЫЕ ПРЕТЕНЗИИ, УБЫТКИ ИЛИ ДРУГИЕ ОТВЕТСТВЕННОСТЬ В ДЕЙСТВИИ ДОГОВОРА, ПРАВОНАРУШЕНИЯ ИЛИ ИНОГО СЛУЧАЯ, ВЫВОДЯЩИХСЯ ИЗ, ИЗ ИЛИ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ ИЛИ ДРУГИМИ ДЕЙСТВИЯМИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.

Подать жалобу

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

Жалобы на завышение цен, полученные в Отдел по работе с потребителями, рассматриваются индивидуально. Повышение цен обычно рассматривается путем оценки увеличения затрат на топливо, ранее существовавших договоренностей о ценах и увеличения затрат, налагаемых поставщиками. Если окажется, что произошло завышение цен, жалоба может быть рассмотрена и / или расследована Управлением по защите прав потребителей генерального прокурора на предмет потенциальных нарушений Закона о защите прав потребителей штата Теннесси.Генеральный прокурор может потребовать временного запретительного судебного приказа, временного судебного запрета или постоянного судебного запрета, потребовать взыскания в гражданском порядке до 1000 долларов за нарушение и / или провести переговоры и принять гарантию добровольного соблюдения

Отдел защиты прав потребителей рассматривает жалобы на завышение цен в соответствии с двумя различными законодательными актами: Первый, Закон о занижении цен от 2002 года, применяется только в периоды, когда губернатор объявляет о ненормальном экономическом сбое и запрещает взимать с «любого другого человека плату за следующее. товары или услуги [если заказ не ограничен только определенными типами товаров], которые значительно превышают цену, обычно взимаемую за те же или аналогичные товары или услуги в ходе обычной деятельности:

(A) Потребительские продукты питания;

(B) Ремонтные или строительные услуги;

(C) Предметы первой необходимости;

(D) Предметы медицинского назначения;

(E) Строительные материалы;

(F) Бензин;

(G) Транспортные, грузовые и складские услуги; или

(H) Жилье.”

Во-вторых, даже если не заявлено об аномальных экономических нарушениях, это является нарушением Закона штата Теннесси о защите прав потребителей для любого лица «[необоснованно повышать [e] цены или необоснованно ограничивать [] поставки товаров первой необходимости, товаров или услуг в прямой ответ на преступление, террористический акт, войну или стихийное бедствие, независимо от того, произошло ли такое преступление, террористический акт, война или стихийное бедствие в штате Теннесси ». Принимая во внимание широту охвата этих и других положений, потребителям рекомендуется подавать жалобу в отношении любого подозреваемого завышения цен.Это помогает гарантировать, что Подразделение сможет оценить жалобу для принятия дальнейших соответствующих мер и помочь защитить граждан Теннесси.

Модель роста Гордона (GGM) Определение и формула

Что такое модель роста Гордона (GGM)?

Модель роста Гордона (GGM) используется для определения внутренней стоимости акции на основе будущей серии дивидендов, которые растут с постоянной скоростью. Это популярный и простой вариант модели дисконтирования дивидендов (DDM).GGM предполагает, что дивиденды растут с постоянной скоростью на неограниченный срок, и рассчитывает текущую стоимость бесконечного ряда будущих дивидендов. Поскольку модель предполагает постоянные темпы роста, она обычно используется только для компаний со стабильными темпами роста дивидендов на акцию.

Ключевые выводы

• Модель роста Гордона (GGM) предполагает, что компания существует вечно и что при оценке акций компании наблюдается постоянный рост дивидендов.
• GGM берет бесконечную серию дивидендов на акцию и дисконтирует их обратно в настоящее время с использованием требуемой нормы прибыли.
• GGM - это вариант модели дисконтирования дивидендов (DDM).
• GGM идеально подходит для компаний с устойчивыми темпами роста, учитывая постоянный рост дивидендов.

Понимание модели роста Гордона (GGM)

Модель роста Гордона оценивает акции компании, исходя из предположения о постоянном росте выплат, которые компания производит своим акционерам. Три ключевых параметра модели - это дивиденды на акцию (DPS), темп роста дивидендов на акцию и требуемая норма доходности (RoR).

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

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

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

п знак равно D 1 р - грамм куда: п знак равно Текущая цена акций грамм знак равно Ожидается постоянный рост дивиденды, бессрочно р знак равно Постоянная стоимость собственного капитала для компания (или норма прибыли) D 1 знак равно Размер дивидендов в следующем году \ begin {align} & P = \ frac {D_1} {r - g} \\ & \ textbf {where:} \\ & P = \ text {Текущая цена акций} \\ & g = \ text {Ожидается постоянный темп роста} \\ & \ text {дивиденды на неограниченный срок} \\ & r = \ text {Постоянная стоимость собственного капитала для} \\ & \ text {компании (или доходности)} \\ & D_1 = \ text {Стоимость следующего годовые дивиденды} \\ \ end {выровнены} P = r − gD1, где: P = текущая цена акций g = постоянный ожидаемый темп роста дивидендов на неограниченный срок r = постоянная стоимость собственного капитала для компании (или норма прибыли) D1 = размер дивидендов в следующем году

Источник: Школа бизнеса Стерна, Нью-Йоркский университет.

Основное ограничение модели роста Гордона заключается в ее предположении о постоянном росте дивидендов на акцию.Компании очень редко демонстрируют постоянный рост своих дивидендов из-за бизнес-циклов и неожиданных финансовых трудностей или успехов. Таким образом, модель ограничивается фирмами, демонстрирующими стабильные темпы роста.

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

Модель роста Гордона (GGM), пример

В качестве гипотетического примера рассмотрим компанию, акции которой торгуются по 110 долларов за акцию. Эта компания требует минимальной нормы прибыли (r) 8% и в следующем году выплатит дивиденды в размере 3 долларов на акцию (D ₁ ), которые, как ожидается, будут увеличиваться на 5% ежегодно (g).

Внутренняя стоимость (P) акций рассчитывается следующим образом:

п знак равно $ 3 . 08 - . 05 знак равно $ 100 \ begin {align} & \ text {P} = \ frac {\ $ 3} {.08 - .05} = \ $ 100 \\ \ end {выровнено} P = 0,08 − 0,05 3 доллара США = 100 долларов США

Согласно модели роста Гордона, в настоящее время акции на рынке переоценены на 10 долларов.

Часто задаваемые вопросы

Что вам говорит модель роста Гордона (GGM)?

Модель роста Гордона (GGM) пытается рассчитать справедливую стоимость акции независимо от преобладающих рыночных условий и принимает во внимание факторы выплаты дивидендов и ожидаемую рыночную доходность.Если значение GGM выше текущей рыночной цены акции, то акция считается недооцененной и ее следует покупать. И наоборот, если стоимость ниже текущей рыночной цены акции, то акция считается переоцененной и ее следует продать.

Каковы исходные данные для модели роста Гордона (GGM)?

Три ключевых параметра GGM - это дивиденды на акцию (DPS), темп роста дивидендов на акцию и требуемая норма доходности (RoR). DPS - это годовые выплаты, которые компания делает своим акционерам, владеющим обыкновенными акциями, а темпы роста DPS - это годовые темпы увеличения дивидендов.Требуемая норма прибыли - это минимальная норма прибыли, которую инвесторы готовы принять при покупке акций компании.

Каковы недостатки модели роста Гордона (GGM)?

Основное ограничение GGM заключается в предположении о постоянном росте дивидендов на акцию. Компании очень редко демонстрируют постоянный рост своих дивидендов из-за бизнес-циклов и неожиданных финансовых трудностей или успехов. Таким образом, модель ограничивается компаниями со стабильными темпами роста дивидендов на акцию.Другая проблема возникает в связи между коэффициентом дисконтирования и темпом роста, используемым в модели. Если требуемая норма прибыли меньше скорости роста дивидендов на акцию, результатом будет отрицательное значение, что сделает модель бесполезной. Кроме того, если требуемая норма прибыли совпадает с темпами роста, стоимость акции приближается к бесконечности.