Всі ми любимо нічого не робити працювати з добре документованим API. За допомогою стандартів API Blueprint або Swagger можна отримати читану машиною і людиною документацію, а значить і інструменти перевірки API на основі цієї документації.
Apiary пропонує інтерактивні інструменти для перевірки API вручну, підставляючи потрібні параметри форми, що генеруються на основі документації. Але можна отримати набагато більше користі, якщо API буде перевірятися автоматично. Це позбавляє від необхідності писати окремі тести на кожен інтерфейс, але накладає певні обмеження на структуру і якість самої документації.
image
У цьому tutorial поговоримо про утиліті Dredd на прикладі API від GitHub.
Читати далі →

Logo
Працюючи в конструкторському відділі, я зіткнувся із завданням — розрахувати трудомісткість розробки конструкторської документації. Якщо брати за основу документ: «Типові нормативи часу на розроблення конструкторської документації. ШИФР 13.01.01" (затв. Минтрудом Росії 07.03.2014 N 003)», то для розрахунку трудомісткості креслення деталі нам необхідні наступні дані:
  • Формат креслення та кількість аркушів
  • Масштаб
  • Кількість розмірів на кресленні (включаючи знаки шорсткості і виносні лінії)
  • Кількість технічних вимог
З наявних інструментів на підприємстві маємо: Kompas 3D v14 і Python 3.5.
В інтернеті не так багато статей про написання програм з використанням API Kompas 3D, і ще менше інформації про те, як це зробити на Python. Спробую розповісти по кроках, як вирішувалася поставлена задача і на які граблі доводилося наступати. Стаття розрахована на людей, які володіють основами програмування і знайомих з мовою Python. Отже, приступимо.

Читати далі →

Є одна дуже цікава новина, яка залишилася мало висвітленою, особливо в руском сегменті Інтернету. Perspective API від Google тепер доступний для розробників. Що це ще за чергова хрень запитаєте ви? Якщо коротко, то це API або сервіс, який дозволяє оцінити «токсичність» коментарів у мережі. Так, це не жарт, все саме так. Ви навіть можете зайти і перевірити свій коментар на цю саму «токсичність». Серед партнерів проекту такі новинні агентства як The New York Times, The Guardian, The Economist та інтернет енциклопедія Wikipedia.

Читати далі →

нещодавно Вирішив написати невелике ASP.Net MVC додаток після багаторічної перерви і знаючі люди на Хабре підказали спробувати новий ASP.Net Core, тим більше, що він працює в Лінуксі з коробки без необхідності задіяти mono, і, судячи з останніми тестами, навіть показує непогану продуктивність. За основу взяв аналогічну статтю для Mac, але тут на відміну від надихнула мене статті хочу описати процес покроково в одному місці, для того, щоб не довелося лазити по перехресним посиланням, намагаючись розібратися як встановити незрозуміло для чого призначені програми та пакети. Таке докладний опис процесу можливо допоможе багатьом уникнути граблів, з якими довелося зіткнутися мені. Кілька фраз і малюнків, в частині однаковою для будь-якої платформи, з правками і доповненнями взяті з статті для Mac.


Читати далі →


Оригнинальная стаття є роздуми на тему чому документація в світі микросервисов критично потрібна і як її можна створювати та публікувати використовуючи swagger. Покрокової інструкції по налаштуванню вона точно не є.

Читати далі →

Вітаю всіх. У сьогоднішній статті мова піде про те, як можна реалізувати власний високорівневий API в керованому коді для роботи з пристроями друку, від встановлення нового монітора друку в системі і до отримання обробленого драйвером пристрою друку документа з порту принтера.

Як і в минулий раз, стаття буде корисна для ознайомлення розробникам молодшого та середнього ланки. В процесі вивчення матеріалу, Ви дізнаєтеся як можна звертатися до низькорівневим DLL WinAPI в C# з допомогою P/Invoke, як встановити, налаштувати і видалити з системи монітори друку, драйвер принтера, сам пристрій друку, відкрити і зв'язати порт для перенаправлення вхідних даних з пристрою друку на монітор, познайомитеся з ключовими моментами застосування маршалирования. Так само ми на практичному прикладі розберемося, як за допомогою нашого API можна зручно маніпулювати пристроями друку в системі, дізнаємося, як можна перехопити оброблені дані після друку принтера і, наприклад, відправити їх на сервер.

Читати далі →

Повідомлення про проблеми з вашим сайтом через Телеграм та інші можливості Хосттрекера

По-перше, по численних проханнях ХостТрекер обзавівся контактом через Телеграм. По-друге — нижче ми розповімо, що ще корисного можна зробити, щоб клієнтам було зручніше отримувати розсилки і оповіщення. У разі ХостТрекера — про стан сайтів.



Читати далі →

Практичні прийоми використання багатопоточних обчислень при роботі з Revit API

Я архітектор, довгий час проектував будівлі та споруди, але от з літа минулого року почав програмувати на C# використовуючи Revit API. У мене вже є кілька модулів-надбудов для Revit і тепер я хочу поділитися деяким досвідом розробки для Revit. Передбачається, що читачі вміють писати макроси для Revit на C#.

Revit API не містить методів для паралельних обчислень. Навіть при спробі розмістити об'єкти Revit API в паралельних потоках, виникне помилка часу виконання програми. Тому я зараз хочу показати як можна виконувати все таки паралельні обчислення, працюючи при цьому з Revit API.

Уявімо наступну практичну задачу, яку виконаємо в паралельному і послідовному режимі. Виділимо кілька сотень стін, знайдемо центр кожної стіни в плані. Після перевіримо відстань між центрами стін, і знайдемо дві найбільш близько розташовані стіни щодо їх центрів.
Читати далі →