{"id":461411,"date":"2025-05-29T15:01:19","date_gmt":"2025-05-29T15:01:19","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=461411"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=461411","title":{"rendered":"<span>EasyP: from zero to hero<\/span>"},"content":{"rendered":"<div><!--[--><!--]--><\/div>\n<div id=\"post-content-body\">\n<div>\n<div class=\"article-formatted-body article-formatted-body article-formatted-body_version-2\">\n<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<p>\u0414\u0430\u043d\u043d\u0430\u044f \u0441\u0442\u0430\u0442\u044c\u044f \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0435\u043d\u0438\u0435\u043c <a href=\"https:\/\/habr.com\/ru\/articles\/912350\/\" rel=\"noopener noreferrer nofollow\">\u0441\u0442\u0430\u0442\u044c\u0438<\/a>, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 <a class=\"mention\" href=\"\/users\/ZergsLaw\">@ZergsLaw<\/a> \u0443\u0436\u0435 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u043b, \u0437\u0430\u0447\u0435\u043c \u043c\u044b \u043d\u0430\u0447\u0430\u043b\u0438 \u0434\u0435\u043b\u0430\u0442\u044c <strong>EasyP<\/strong> \u0438 \u043f\u043e\u0447\u0435\u043c\u0443 \u043c\u044b \u0441\u0442\u0430\u0440\u0430\u043b\u0438\u0441\u044c \u043f\u043e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0442\u044c \u043e\u0431\u0449\u0438\u0435 \u0444\u043e\u0440\u043c\u0430\u0442\u044b \u0441 <strong>Buf<\/strong>. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u043f\u043e\u0432\u0442\u043e\u0440\u044f\u0442\u044c\u0441\u044f \u043d\u0435 \u0431\u0443\u0434\u0435\u043c \u0438 \u0441\u0440\u0430\u0437\u0443 \u043f\u0435\u0440\u0435\u0439\u0434\u0435\u043c \u043a \u0442\u043e\u043c\u0443, \u043a\u0430\u043a \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c <strong>EasyP<\/strong> \u0432 \u0441\u0432\u043e\u0438\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445.<\/p>\n<h3>\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430<\/h3>\n<p>\u041d\u0430\u0447\u043d\u0435\u043c, \u043a\u043e\u043d\u0435\u0447\u043d\u043e \u0436\u0435, \u0441 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 <strong>EasyP<\/strong>:<\/p>\n<ul>\n<li>\n<p>\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0435\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 \u0441 GitHub:<\/p>\n<pre><code class=\"bash\">go install github.com\/easyp-tech\/easyp\/cmd\/easyp@latest<\/code><\/pre>\n<\/li>\n<li>\n<p>\u041d\u0435\u0434\u0430\u0432\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u043b\u0438 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 \u0447\u0435\u0440\u0435\u0437 <strong>brew<\/strong>:<\/p>\n<pre><code class=\"bash\">brew install easyp-tech\/tap\/easyp<\/code><\/pre>\n<\/li>\n<\/ul>\n<h3>\u041b\u0438\u043d\u0442\u0438\u043d\u0433<\/h3>\n<figure class=\"full-width\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/upload_files\/fc7\/cc7\/cd5\/fc7cc7cd528435c51b9a8c3a56f8f83f.png\" width=\"1168\" height=\"657\" sizes=\"auto, (max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/upload_files\/fc7\/cc7\/cd5\/fc7cc7cd528435c51b9a8c3a56f8f83f.png 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/upload_files\/fc7\/cc7\/cd5\/fc7cc7cd528435c51b9a8c3a56f8f83f.png 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u0425\u043e\u043b\u0438\u0432\u0430\u0440\u044b \u0432 <strong>PR<\/strong> \u043f\u043e \u043f\u043e\u0432\u043e\u0434\u0443 \u043e\u0442\u0441\u0442\u0443\u043f\u043e\u0432, \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0438 \u0442. \u043f., \u0432 \u0438\u0434\u0435\u0430\u043b\u0435, \u0440\u0435\u0448\u0430\u044e\u0442\u0441\u044f \u0441\u0442\u0438\u043b\u0435\u0432\u044b\u043c\u0438 \u0433\u0430\u0439\u0434\u0430\u043c\u0438. \u041d\u043e \u0435\u0441\u0442\u044c \u043b\u0438 \u043e\u043d\u0438 \u0443 \u0432\u0441\u0435\u0445 \u043a\u043e\u043c\u0430\u043d\u0434?<br \/> \u0423 \u043f\u0438\u0442\u043e\u043d\u0438\u0441\u0442\u043e\u0432 \u0435\u0441\u0442\u044c <strong>PEP<\/strong>, \u043d\u043e \u0434\u0430\u0436\u0435 \u043e\u043d \u043d\u0435 \u043f\u043e\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0432\u0441\u0435 \u0432\u043e\u043f\u0440\u043e\u0441\u044b.<br \/> \u0414\u0430 \u0438 \u0434\u0430\u0436\u0435 \u043f\u0440\u0438 \u043d\u0430\u043b\u0438\u0447\u0438\u0438 styleguide \u0433\u0434\u0435-\u0442\u043e \u043d\u0430 \u0432\u0438\u043a\u0438 \u0442\u0440\u0430\u0442\u0438\u0442\u044c \u0432\u0440\u0435\u043c\u044f \u043d\u0430 \u0430\u043d\u0430\u043b\u0438\u0437 \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0438\u044f \u043a\u043e\u0434\u0430 \u0432 <strong>PR<\/strong> \u2014 \u043d\u0435 \u043b\u0443\u0447\u0448\u0430\u044f \u0438\u0434\u0435\u044f.<\/p>\n<p>\u0423\u0436\u0435 \u0434\u0430\u0432\u043d\u043e \u0432\u0441\u0451 \u044d\u0442\u043e \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043e \u043b\u0438\u043d\u0442\u0435\u0440\u0430\u043c\u0438, \u043b\u0435\u0433\u043a\u043e \u0432\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u043c\u044b\u043c\u0438 \u0432 <strong>CI\/CD<\/strong>.<br \/> \u041d\u043e \u043f\u043e\u0447\u0435\u043c\u0443-\u0442\u043e \u044f \u0447\u0430\u0441\u0442\u043e \u0441\u0442\u0430\u043b\u043a\u0438\u0432\u0430\u044e\u0441\u044c \u0441 \u0443\u0434\u0438\u0432\u043b\u0435\u043d\u0438\u0435\u043c \u043d\u0430 \u0432\u043e\u043f\u0440\u043e\u0441: <em>\u00ab\u0410 \u043a\u0430\u043a\u043e\u0439 \u043b\u0438\u043d\u0442\u0435\u0440 \u0434\u043b\u044f Protobuf \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435?\u00bb<\/em>.<br \/> \u041f\u0440\u0438 \u044d\u0442\u043e\u043c \u0434\u043b\u044f \u041d\u0415 protobuf \u043b\u0438\u043d\u0442\u0435\u0440\u044b, \u0435\u0441\u0442\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043b\u0438, \u0430 \u0434\u043b\u044f protobuf \u2014 \u043f\u043e\u0447\u0435\u043c\u0443-\u0442\u043e \u043d\u0435\u0442.<br \/> \u0425\u043e\u0442\u044f \u043d\u0430\u0432\u0435\u0441\u0442\u0438 \u0431\u0435\u0441\u043f\u043e\u0440\u044f\u0434\u043e\u043a \u0432 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b\u0430\u0445 \u043d\u0438\u0447\u0443\u0442\u044c \u043d\u0435 \u0441\u043b\u043e\u0436\u043d\u0435\u0435.<\/p>\n<p>\u0414\u043e\u043f\u0443\u0441\u0442\u0438\u043c, \u0435\u0441\u0442\u044c \u043d\u0435\u043a\u0438\u0439 \u0441\u0435\u0440\u0432\u0438\u0441:<\/p>\n<pre><code>service ServiceAPI {   rpc example_one(google.protobuf.Empty) returns (google.protobuf.Empty); }<\/code><\/pre>\n<p>\u041f\u043e\u0442\u043e\u043c \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 \u0434\u0440\u0443\u0433\u043e\u0439 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u0438 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u0435\u0449\u0451 \u043e\u0434\u0438\u043d \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442:<\/p>\n<pre><code>service ServiceAPI {   rpc example_one(google.protobuf.Empty) returns (google.protobuf.Empty);   rpc ExampleTwo(google.protobuf.Empty) returns (google.protobuf.Empty); }<\/code><\/pre>\n<p>\u041a\u043e\u0434 \u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439, \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u043d\u0435 \u0432\u044b\u0434\u0430\u0441\u0442 \u043e\u0448\u0438\u0431\u043e\u043a, \u043d\u043e \u043e\u0431\u0449\u0430\u044f \u0441\u0442\u0438\u043b\u0438\u0441\u0442\u0438\u043a\u0430 \u0443\u0436\u0435 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0430.<\/p>\n<p>\u0418\u043b\u0438 \u0434\u0440\u0443\u0433\u043e\u0439, \u0431\u043e\u043b\u0435\u0435 \u043a\u0440\u0438\u0442\u0438\u0447\u043d\u044b\u0439 \u043f\u0440\u0438\u043c\u0435\u0440:<\/p>\n<pre><code>enum Example {   example_one = 0;   ExampleOne = 1; }<\/code><\/pre>\n<p>\u041a\u0440\u043e\u043c\u0435 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0438\u044f \u0441\u0442\u0438\u043b\u0438\u0441\u0442\u0438\u043a\u0438, \u043f\u043e\u043b\u0443\u0447\u0438\u043c \u043e\u0448\u0438\u0431\u043a\u0443 \u043f\u0440\u0438 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438:<\/p>\n<pre><code>Enum name ExampleOne has the same name as example_one if you ignore case and strip out the enum name prefix (if any). (If you are using allow_alias, please assign the same number to each enum value name.)<\/code><\/pre>\n<p>\u0425\u043e\u0442\u0435\u043b\u043e\u0441\u044c \u0431\u044b \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043f\u043e\u0438\u0441\u043a \u043f\u043e\u0434\u043e\u0431\u043d\u044b\u0445 \u043f\u0440\u043e\u0431\u043b\u0435\u043c \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0432 <strong>CI<\/strong> \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0434\u0441\u0432\u0435\u0447\u0438\u0432\u0430\u0442\u044c \u043e\u0448\u0438\u0431\u043a\u0438, \u044d\u043a\u043e\u043d\u043e\u043c\u044f \u0432\u0440\u0435\u043c\u044f \u043d\u0430 \u0440\u0435\u0432\u044c\u044e.<\/p>\n<p>\u0418 \u0442\u0443\u0442 \u043d\u0430 \u0441\u0446\u0435\u043d\u0443 \u0432\u044b\u0445\u043e\u0434\u0438\u0442 \u043b\u0438\u043d\u0442\u0435\u0440 <strong>EasyP<\/strong>.<\/p>\n<p>\u0414\u0430\u0432\u0430\u0439\u0442\u0435 \u0432\u0437\u0433\u043b\u044f\u043d\u0435\u043c \u043d\u0430 \u0435\u0433\u043e \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e.<\/p>\n<p><strong>YAML-\u043a\u043e\u043d\u0444\u0438\u0433<\/strong>:<\/p>\n<pre><code class=\"yaml\">lint:   use:     - MINIMAL<\/code><\/pre>\n<p>\u0417\u0434\u0435\u0441\u044c \u043c\u043e\u0436\u043d\u043e \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u043a\u0430\u043a \u043d\u0430\u0431\u043e\u0440 \u043f\u0440\u0430\u0432\u0438\u043b \u0441\u043f\u0438\u0441\u043a\u043e\u043c, \u0442\u0430\u043a \u0438 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u0433\u0440\u0443\u043f\u043f\u044b: <strong>MINIMAL<\/strong>, <strong>BASIC<\/strong>, <strong>DEFAULT<\/strong>, <strong>COMMENTS<\/strong> \u0438\u043b\u0438 <strong>UNARY_RPC<\/strong>.<br \/> \u0414\u043b\u044f \u043f\u0440\u043e\u0441\u0442\u043e\u0442\u044b \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u044f \u043f\u0440\u0430\u0432\u0438\u043b \u043c\u044b \u043f\u043e\u0437\u0430\u0438\u043c\u0441\u0442\u0432\u043e\u0432\u0430\u043b\u0438 \u0443 <strong>Buf<\/strong> \ud83d\ude42<\/p>\n<p>\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u043c <strong>EasyP<\/strong>:<\/p>\n<pre><code class=\"bash\">easyp lint --path .<\/code><\/pre>\n<p>\u0415\u0441\u043b\u0438 \u0435\u0441\u0442\u044c \u043e\u0448\u0438\u0431\u043a\u0438, \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c \u0432\u044b\u0432\u043e\u0434:<\/p>\n<pre><code>super_api\/v1\/services.proto:11:3:CORPUS_UNSPECIFIED enum zero value suffix is not valid (ENUM_ZERO_VALUE_SUFFIX)<\/code><\/pre>\n<p>\u0424\u043e\u0440\u043c\u0430\u0442 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0432\u043a\u043b\u044e\u0447\u0430\u0435\u0442 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u043e\u0431\u044a\u0435\u043a\u0442\u0430 \u0441 \u043e\u0448\u0438\u0431\u043a\u043e\u0439 \u0438 \u043f\u0440\u0430\u0432\u0438\u043b\u043e.<br \/> \u0421\u0435\u0439\u0447\u0430\u0441 \u0432 \u043f\u043b\u0430\u043d\u0430\u0445 \u2014 \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u0444\u043e\u0440\u043c\u0430\u0442\u0430 <strong>code-quality<\/strong>.<\/p>\n<p>\u041d\u043e \u0438\u043d\u043e\u0433\u0434\u0430 \u043d\u0443\u0436\u043d\u043e \u043e\u0442\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u0441\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u043d\u0438\u0435 \u043b\u0438\u043d\u0442\u0435\u0440\u0430 \u043d\u0430 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0451\u043d\u043d\u0443\u044e \u0441\u0442\u0440\u043e\u043a\u0443 (\u043f\u0440\u0438\u0447\u0438\u043d\u044b \u0432\u044b\u0445\u043e\u0434\u044f\u0442 \u0437\u0430 \u0440\u0430\u043c\u043a\u0438 \u0441\u0442\u0430\u0442\u044c\u0438). \u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u0435\u0441\u0442\u044c \u0434\u0432\u0430 \u043f\u0443\u0442\u0438:<\/p>\n<ol>\n<li>\n<p>\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c <code>buf:lint:ignore $\u0418\u041c\u042f_\u041f\u0420\u0410\u0412\u0418\u041b\u0410<\/code> (\u0434\u043b\u044f \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438 \u0441 <strong>Buf<\/strong>).<\/p>\n<\/li>\n<li>\n<p>\u0418\u043b\u0438 <code>nolint: $\u0418\u041c\u042f_\u041f\u0420\u0410\u0412\u0418\u041b\u0410<\/code>.<\/p>\n<\/li>\n<\/ol>\n<p>\u041d\u043e \u043a\u0440\u043e\u043c\u0435 \u043d\u0435\u0441\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f <strong>API<\/strong>, \u0435\u0441\u0442\u044c \u0434\u0440\u0443\u0433\u0430\u044f, \u0431\u043e\u043b\u0435\u0435 \u0441\u0435\u0440\u044c\u0451\u0437\u043d\u0430\u044f \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430&#8230;<\/p>\n<h3>\u041e\u0431\u0440\u0430\u0442\u043d\u0430\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c<\/h3>\n<p>\u0420\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0438\u043c \u0441\u0438\u0442\u0443\u0430\u0446\u0438\u044e: \u0435\u0441\u0442\u044c \u0441\u0435\u0440\u0432\u0438\u0441, \u0443\u0436\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0449\u0438\u0439 \u0432 \u043f\u0440\u043e\u0434\u0435.<br \/> \u041d\u043e \u0431\u0438\u0437\u043d\u0435\u0441 \u043d\u0435 \u0441\u0442\u043e\u0438\u0442 \u043d\u0430 \u043c\u0435\u0441\u0442\u0435, \u0438 \u0432 \u043e\u0434\u0438\u043d \u0434\u0435\u043d\u044c \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 <strong>PO<\/strong> \u0438 \u0433\u043e\u0432\u043e\u0440\u0438\u0442: <em>\u00ab\u041d\u0430\u043c \u043d\u0443\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043b\u043e\u0433\u0438\u043d \u043f\u043e \u043f\u043e\u0447\u0442\u0435\u00bb<\/em>.<\/p>\n<p>\u041e\u043a, \u0438\u0434\u0451\u043c \u0432 \u043d\u0430\u0448 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b:<\/p>\n<pre><code>message LoginRequest {   string username = 1;   string password = 2; }<\/code><\/pre>\n<p>\u0421\u0435\u0439\u0447\u0430\u0441 \u043c\u043e\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e <strong>username<\/strong>. \u0414\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c \u043f\u043e\u043b\u0435 \u0441 \u043f\u043e\u0447\u0442\u043e\u0439.<br \/> \u041b\u043e\u0433\u0438\u043a\u0430 \u0442\u0430\u043a\u0430\u044f: \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u043c\u043e\u0436\u0435\u0442 \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u043a\u0430\u043a <strong>username<\/strong>, \u0442\u0430\u043a \u0438 <strong>email<\/strong>, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0434\u0435\u043b\u0430\u0435\u043c \u0442\u0430\u043a, \u0447\u0442\u043e\u0431\u044b \u043e\u0434\u043d\u043e \u043f\u043e\u043b\u0435 \u043c\u043e\u0433\u043b\u043e \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0442\u044c \u0434\u0432\u0430 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f:<\/p>\n<pre><code>message LoginRequest {   oneof login {     string username = 1;     string email = 2;   }   string password = 2; }<\/code><\/pre>\n<p>\u041a\u043e\u043c\u043c\u0438\u0442\u0438\u043c, \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0435\u043c \u043d\u0430 \u0440\u0435\u0432\u044c\u044e, \u0434\u0435\u043f\u043b\u043e\u0438\u043c.<br \/> \u0418 \u0447\u0442\u043e \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c?<\/p>\n<figure class=\"full-width\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/upload_files\/445\/6d0\/ea9\/4456d0ea9a0171c0e65b6a9422938401.png\" width=\"1000\" height=\"667\" sizes=\"auto, (max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/upload_files\/445\/6d0\/ea9\/4456d0ea9a0171c0e65b6a9422938401.png 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/upload_files\/445\/6d0\/ea9\/4456d0ea9a0171c0e65b6a9422938401.png 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u041f\u0440\u0438\u0447\u0451\u043c \u044d\u0442\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u0441\u043b\u0443\u0447\u0430\u0439 \u043d\u0430 \u043e\u0434\u043d\u043e\u043c \u0438\u0437 \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432. \u041d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0447\u0435\u043b\u043e\u0432\u0435\u043a \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u043b\u0438 <strong>PR<\/strong> \u0441 \u044d\u0442\u0438\u043c \u043a\u043e\u0434\u043e\u043c \u0438 \u043f\u0440\u043e\u043f\u0443\u0441\u0442\u0438\u043b\u0438.<br \/> \u0412 \u043e\u0431\u0449\u0435\u043c, \u0447\u0435\u043b\u043e\u0432\u0435\u0447\u0435\u0441\u043a\u0438\u0439 \u0444\u0430\u043a\u0442\u043e\u0440 \u2014 \u0438 \u043d\u0438\u043a\u0443\u0434\u0430 \u043e\u0442 \u043d\u0435\u0433\u043e \u043d\u0435 \u0434\u0435\u0442\u044c\u0441\u044f.<\/p>\n<p>\u041d\u043e \u0443 \u043d\u0430\u0441 \u0436\u0435 \u0435\u0441\u0442\u044c \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0441\u0440\u0435\u0434\u0441\u0442\u0432\u0430 \u0434\u043b\u044f \u0430\u043d\u0430\u043b\u0438\u0437\u0430 \u0441\u0442\u0438\u043b\u044f, \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0438 \u0442. \u043f.<br \/> \u0427\u0442\u043e, \u0435\u0441\u043b\u0438 \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0443\u044e \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438 <strong>API<\/strong>, \u0447\u0442\u043e\u0431\u044b \u0438\u0441\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u0447\u0435\u043b\u043e\u0432\u0435\u0447\u0435\u0441\u043a\u0438\u0439 \u0444\u0430\u043a\u0442\u043e\u0440? \u041c\u0430\u0448\u0438\u043d\u0443 \u043d\u0435 \u043e\u0431\u043c\u0430\u043d\u0435\u0448\u044c, \u0438 \u0434\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u0431\u0443\u0434\u0435\u0442 <strong>false-positive<\/strong>, \u044d\u0442\u043e \u043b\u0438\u0448\u043d\u0438\u0439 \u043f\u043e\u0432\u043e\u0434 \u043f\u0435\u0440\u0435\u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c, \u0438 \u0448\u0430\u043d\u0441 \u043e\u0448\u0438\u0431\u043e\u043a \u0443\u043c\u0435\u043d\u044c\u0448\u0438\u0442\u0441\u044f.<\/p>\n<p>\u041a\u0430\u043a \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c? \u041a\u0430\u043a\u0438\u0435 \u044d\u0442\u0430\u043f\u044b \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438?<br \/> \u0412\u0441\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u043e\u0441\u043d\u043e\u0432\u043d\u0443\u044e \u0432\u0435\u0442\u043a\u0443 \u0434\u043e\u043b\u0436\u043d\u044b \u043f\u0440\u043e\u0445\u043e\u0434\u0438\u0442\u044c \u0447\u0435\u0440\u0435\u0437 <strong>Pull Request<\/strong>, \u043f\u043e\u0441\u043b\u0435 \u0443\u0441\u043f\u0435\u0448\u043d\u043e\u0433\u043e \u043f\u0440\u043e\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u044f \u0442\u0435\u0441\u0442\u043e\u0432, \u043b\u0438\u043d\u0442\u0435\u0440\u0430 \u0438 \u0440\u0435\u0432\u044c\u044e (\u0441\u043f\u0430\u0441\u0438\u0431\u043e, \u043a\u044d\u043f).<br \/> \u0414\u043e\u0431\u0430\u0432\u0438\u043c \u0441\u044e\u0434\u0430 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 \u043d\u0430 \u043e\u0431\u0440\u0430\u0442\u043d\u0443\u044e \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c: \u0435\u0441\u043b\u0438 \u0447\u0442\u043e-\u0442\u043e \u0441\u043b\u043e\u043c\u0430\u043b\u043e\u0441\u044c \u2014 \u043f\u0430\u0434\u0430\u0435\u043c, \u043d\u0435 \u0434\u0430\u0451\u043c \u0432\u043b\u0438\u0442\u044c <strong>PR<\/strong>.<br \/> \u041f\u0440\u0438 \u044d\u0442\u043e\u043c \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0435\u043c \u0442\u0435\u043a\u0443\u0449\u0438\u0439 \u043a\u043e\u0434 \u0441 \u043a\u043e\u0434\u043e\u043c \u0438\u0437 \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439 \u0432\u0435\u0442\u043a\u0438.<\/p>\n<pre><code class=\"bash\">easyp breaking<\/code><\/pre>\n<p>\u0412 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 <strong>EasyP<\/strong> \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0432\u0435\u0442\u043a\u0443 \u0434\u043b\u044f \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u044f:<\/p>\n<pre><code class=\"yaml\">breaking:   against_git_ref: master<\/code><\/pre>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u0440\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0438\u043c \u043d\u0430\u0448 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439:<\/p>\n<ol>\n<li>\n<p>\u0418\u0441\u0445\u043e\u0434\u043d\u044b\u0439 <strong>message<\/strong>:<\/p>\n<pre><code>message LoginRequest {   string username = 1;   string password = 2; }<\/code><\/pre>\n<\/li>\n<li>\n<p>\u041d\u0430\u0448\u0438 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f:<\/p>\n<pre><code>message LoginRequest {   oneof login {     string username = 1;     string email = 2;   }   string password = 2; }<\/code><\/pre>\n<\/li>\n<li>\n<p>\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u043c <strong>EasyP<\/strong> \u0438 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c:<\/p>\n<pre><code>messages\/v1\/messages.proto:15:1: Previously present field \"1\" with name \"username\" on message \"LoginRequest\" was deleted. (BREAKING_CHECK)<\/code><\/pre>\n<\/li>\n<\/ol>\n<p>\u0412\u043e\u0442! <strong>EasyP<\/strong> \u00ab\u0434\u0430\u0451\u0442 \u043f\u043e \u0440\u0443\u043a\u0430\u043c\u00bb \u2014 <strong>PR<\/strong> \u0443\u0436\u0435 \u043d\u0435 \u0432\u043b\u0438\u0442\u044c, \u0430 \u0437\u043d\u0430\u0447\u0438\u0442, \u0438 \u043f\u0440\u043e\u0434 \u043d\u0435 \u0441\u043b\u043e\u043c\u0430\u0442\u044c.<br \/> \u041b\u0438\u0431\u043e \u0434\u0435\u043b\u0430\u0439 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0431\u0435\u0437 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0438\u044f \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438, \u043b\u0438\u0431\u043e \u0441\u043e\u0437\u0434\u0430\u0432\u0430\u0439 \u043d\u043e\u0432\u0443\u044e \u0432\u0435\u0440\u0441\u0438\u044e <strong>API<\/strong>.<\/p>\n<h4>\u041a\u0430\u043a \u044d\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043f\u043e\u0434 \u043a\u0430\u043f\u043e\u0442\u043e\u043c?<\/h4>\n<p><strong>EasyP<\/strong> \u0434\u0435\u043b\u0430\u0435\u0442 \u00ab\u0441\u043b\u0435\u043f\u043a\u0438\u00bb \u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u043e\u0432: \u043e\u0434\u0438\u043d \u0441\u043b\u0435\u043f\u043e\u043a \u2014 \u0442\u0435\u043a\u0443\u0449\u0438\u0439 \u043a\u043e\u0434, \u0432\u0442\u043e\u0440\u043e\u0439 \u2014 \u043a\u043e\u0434 \u0438\u0437 \u0432\u0435\u0442\u043a\u0438, \u0441 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0435\u043c.<br \/> \u0417\u0430\u0442\u0435\u043c \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442\u0441\u044f \u043f\u0440\u043e\u0446\u0435\u0441\u0441 \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u044f: <strong>EasyP<\/strong> \u0441\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u00ab\u043a\u0430\u0440\u0442\u0443\u00bb \u0432\u0441\u0435\u0445 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b\u043e\u0432 \u0441\u043e \u0432\u0441\u0435\u043c\u0438 \u0432\u043b\u043e\u0436\u0435\u043d\u0438\u044f\u043c\u0438: \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f\u043c\u0438, \u0441\u0435\u0440\u0432\u0438\u0441\u0430\u043c\u0438, enum\u2019\u0430\u043c\u0438 \u0438 \u0442. \u043f.<br \/> \u041f\u0440\u0438 \u044d\u0442\u043e\u043c \u0443\u0447\u0438\u0442\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043f\u0430\u043a\u0435\u0442, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u043e\u0431\u044a\u0435\u043a\u0442: \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c \u0434\u0432\u0430 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0441 \u043e\u0434\u0438\u043d\u0430\u043a\u043e\u0432\u044b\u043c \u0438\u043c\u0435\u043d\u0435\u043c, \u043d\u043e \u0432 \u0440\u0430\u0437\u043d\u044b\u0445 \u043f\u0430\u043a\u0435\u0442\u0430\u0445, <strong>EasyP<\/strong> \u044d\u0442\u043e \u043f\u043e\u0439\u043c\u0451\u0442 \u0438 \u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u0440\u0443\u0433\u0430\u0442\u044c\u0441\u044f.<\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0432\u0430\u0436\u043d\u043e, \u0447\u0442\u043e \u0432 \u0440\u0430\u043c\u043a\u0430\u0445 \u043e\u0434\u043d\u043e\u0433\u043e \u043f\u0430\u043a\u0435\u0442\u0430, \u0435\u0441\u043b\u0438 \u043c\u044b \u043f\u0435\u0440\u0435\u043c\u0435\u0441\u0442\u0438\u043b\u0438 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u0432 \u0434\u0440\u0443\u0433\u043e\u0439 \u0444\u0430\u0439\u043b (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043f\u0440\u0438 \u0440\u0435\u0444\u0430\u043a\u0442\u043e\u0440\u0438\u043d\u0433\u0435), \u043d\u043e \u043d\u0435 \u043c\u0435\u043d\u044f\u043b\u0438 \u0442\u0435\u0433\u0438 \u0438 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u044f \u043f\u043e\u043b\u0435\u0439 (\u0442\u043e \u0435\u0441\u0442\u044c \u043d\u0435 \u043d\u0430\u0440\u0443\u0448\u0438\u043b\u0438 \u043e\u0431\u0440\u0430\u0442\u043d\u0443\u044e \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c), <strong>EasyP<\/strong> \u044d\u0442\u043e \u043f\u043e\u0439\u043c\u0451\u0442 \u0438 \u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u0441\u0447\u0438\u0442\u0430\u0442\u044c \u044d\u0442\u043e \u043e\u0448\u0438\u0431\u043a\u043e\u0439.<br \/> \u041a \u0441\u043b\u043e\u0432\u0443, <strong>Buf<\/strong> \u043d\u0430 \u0442\u0430\u043a\u043e\u0435 \u0440\u0443\u0433\u0430\u0435\u0442\u0441\u044f \u0438 \u0433\u043e\u0432\u043e\u0440\u0438\u0442: <em>\u00ab\u041f\u0435\u0440\u0435\u0434\u0435\u043b\u044b\u0432\u0430\u0439\u00bb<\/em>, \u0447\u0442\u043e \u0441\u0442\u0440\u0430\u043d\u043d\u043e, \u0432\u0435\u0434\u044c \u043e\u0431\u0440\u0430\u0442\u043d\u0430\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u043d\u0435 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0430.<\/p>\n<h3>\u041f\u0430\u043a\u0435\u0442\u043d\u044b\u0439 \u043c\u0435\u043d\u0435\u0434\u0436\u0435\u0440<\/h3>\n<p>\u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 \u0434\u0435\u0442\u0430\u043b\u0438 \u0440\u0430\u0431\u043e\u0442\u044b <strong>EasyP<\/strong> \u0443\u0436\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u044b \u0432 \u0441\u0442\u0430\u0442\u044c\u0435 \u042d\u0434\u0433\u0430\u0440\u0430. \u0417\u0434\u0435\u0441\u044c \u0436\u0435 \u043f\u043e\u0433\u043e\u0432\u043e\u0440\u0438\u043c \u043f\u0440\u043e \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e \u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435.<\/p>\n<p>\u0421\u043f\u0438\u0441\u043e\u043a \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u043c\u043e\u0436\u043d\u043e \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 \u0432 \u0441\u0435\u043a\u0446\u0438\u0438 <strong>deps<\/strong>:<\/p>\n<pre><code class=\"yaml\">deps:   - github.com\/googleapis\/googleapis   - github.com\/bufbuild\/protovalidate@v0.3.1   - github.com\/grpc-ecosystem\/grpc-gateway@v2.19.1<\/code><\/pre>\n<p>\u041f\u043e \u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0438 \u0441 <strong>go mod<\/strong>, \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0441\u0441\u044b\u043b\u043a\u0443 \u043d\u0430 <strong>Git<\/strong>-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0430 \u043f\u043e\u0441\u043b\u0435 <code>@<\/code> \u2014 \u0432\u0435\u0440\u0441\u0438\u044e (\u044d\u0442\u043e \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0442\u0435\u0433 \u0438\u043b\u0438 \u0445\u044d\u0448 \u043a\u043e\u043c\u043c\u0438\u0442\u0430).<br \/> \u0415\u0441\u043b\u0438 \u0432\u0435\u0440\u0441\u0438\u044f \u043d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d\u0430, <strong>EasyP<\/strong> \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0439 \u043a\u043e\u043c\u043c\u0438\u0442 \u0438\u0437 \u0434\u0435\u0444\u043e\u043b\u0442\u043d\u043e\u0439 \u0432\u0435\u0442\u043a\u0438.<\/p>\n<p><strong>EasyP<\/strong> \u0444\u0438\u043a\u0441\u0438\u0440\u0443\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0432 <strong>lock<\/strong>-\u0444\u0430\u0439\u043b\u0435.<\/p>\n<p>\u041a\u043e\u043c\u0430\u043d\u0434\u044b:<\/p>\n<ul>\n<li>\n<p><code>easyp download<\/code> \u2014 \u0441\u043a\u0430\u0447\u0438\u0432\u0430\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0438\u0437 <strong>lock<\/strong>-\u0444\u0430\u0439\u043b\u0430 (\u0435\u0441\u043b\u0438 \u0435\u0433\u043e \u043d\u0435\u0442 \u2014 \u0441\u0442\u0430\u0432\u0438\u0442 \u0432\u0435\u0440\u0441\u0438\u0438 \u0438\u0437 <strong>YAML<\/strong>).<\/p>\n<\/li>\n<li>\n<p><code>easyp update<\/code> \u2014 \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0435\u0442 lock \u0444\u0430\u0439\u043b, \u0441\u0442\u0430\u0432\u0438\u0442 \u0432\u0435\u0440\u0441\u0438\u0438 \u0438\u0437 <strong>YAML<\/strong> \u0438 \u043f\u0435\u0440\u0435\u0437\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 lock \u0444\u0430\u0439\u043b.<\/p>\n<\/li>\n<li>\n<p><code>easyp vendor<\/code> \u2014 \u043a\u043e\u043f\u0438\u0440\u0443\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0432 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u0443\u044e \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044e \u043f\u0440\u043e\u0435\u043a\u0442\u0430.<\/p>\n<\/li>\n<\/ul>\n<p>\u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u043a\u0435\u0448 \u0445\u0440\u0430\u043d\u0438\u0442\u0441\u044f \u0432 <code>~\/.easyp<\/code>, \u043d\u043e \u044d\u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0438\u0437\u043c\u0435\u043d\u0438\u0442\u044c \u0447\u0435\u0440\u0435\u0437 \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f <code>EASYPPATH<\/code>.<\/p>\n<p>\u041d\u043e \u0432\u0441\u0451 \u044d\u0442\u043e \u043d\u0435 \u0438\u043c\u0435\u043b\u043e \u0431\u044b \u0441\u043c\u044b\u0441\u043b\u0430 \u0431\u0435\u0437 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438 \u043a\u043e\u0434\u0430.<\/p>\n<h3>\u0413\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043a\u043e\u0434\u0430<\/h3>\n<p>\u0412\u0441\u044f \u043c\u043e\u0449\u044c <strong>Protobuf<\/strong> \u0440\u0430\u0441\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u044f \u043f\u043b\u0430\u0433\u0438\u043d\u0430\u043c.<br \/> \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u0440\u0430\u0437\u043d\u044b\u0445 \u044f\u0437\u044b\u043a\u043e\u0432, \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0438 \u0434\u0440\u0443\u0433\u0438\u0435 \u0445\u043e\u0442\u0435\u043b\u043a\u0438 \u043b\u0435\u0433\u043a\u043e \u0440\u0435\u0448\u0430\u044e\u0442\u0441\u044f \u0441 \u0438\u0445 \u043f\u043e\u043c\u043e\u0449\u044c\u044e.<\/p>\n<p>\u041f\u0440\u0438\u043c\u0435\u0440 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0441 <strong>protoc<\/strong>:<\/p>\n<pre><code class=\"bash\">protoc --go_out=. \\   --go_opt=paths=source_relative \\    --go-grpc_out=. \\   --go-grpc_opt=paths=source_relative \\    --java_out=gen\/proto\/java \\    --rust_out=gen\/proto\/rust \\    --swift_out=gen\/proto\/swift \\    helloworld\/helloworld.proto<\/code><\/pre>\n<p>\u0410 \u0432\u043e\u0442 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f <strong>EasyP<\/strong>:<\/p>\n<pre><code class=\"yaml\">generate:   plugins:     - name: go       out: .       opts:         paths: source_relative     - name: go-grpc       out: .       opts:         paths: source_relative         require_unimplemented_servers: false     - name: grpc-gateway       out: .       opts:         paths: source_relative     - name: openapiv2       out: .       opts:         simple_operation_ids: false         generate_unbound_methods: false     - name: validate-go       out: .       opts:         paths: source_relative<\/code><\/pre>\n<p>\u0423\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0438\u043c\u044f \u043f\u043b\u0430\u0433\u0438\u043d\u0430 \u0438 \u0435\u0433\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 (\u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u043e \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c \u0434\u043b\u044f <strong>protoc<\/strong>).<br \/> \u041f\u043e\u0434 \u043a\u0430\u043f\u043e\u0442\u043e\u043c, \u043a\u0441\u0442\u0430\u0442\u0438, \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0438\u043c\u0435\u043d\u043d\u043e <strong>protoc<\/strong>.<\/p>\n<p>\u041d\u043e \u0441 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 \u044d\u0442\u043e \u0435\u0449\u0451 \u043d\u0435 \u0432\u0441\u0451. <strong>EasyP<\/strong> \u0434\u043e\u043b\u0436\u0435\u043d \u0437\u043d\u0430\u0442\u044c, \u0433\u0434\u0435 \u043d\u0430\u0445\u043e\u0434\u044f\u0442\u0441\u044f \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u0435 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b\u044b.<br \/> \u041e\u043d\u0438 \u043c\u043e\u0433\u0443\u0442 \u0431\u044b\u0442\u044c \u043a\u0430\u043a \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u043c\u0438, \u0442\u0430\u043a \u0438 \u0432 \u0443\u0434\u0430\u043b\u0451\u043d\u043d\u043e\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438:<\/p>\n<p><strong>\u0423\u0434\u0430\u043b\u0451\u043d\u043d\u044b\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439<\/strong>:<\/p>\n<pre><code class=\"yaml\">generate:   inputs:     - git_repo:         url: \"URL TO REMOTE REPO\"         sub_directory: \"DIR WITH PROTO FILES\"<\/code><\/pre>\n<p><strong>\u041b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u0435 \u0444\u0430\u0439\u043b\u044b<\/strong>:<\/p>\n<pre><code class=\"yaml\">generate:   inputs:     - directory: \"WHERE YOUR PROTO FILES ARE\"<\/code><\/pre>\n<h3>\u0410\u0432\u0442\u043e\u0434\u043e\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435<\/h3>\n<p>\u0427\u0442\u043e\u0431\u044b \u043d\u0435 \u0437\u0430\u043f\u043e\u043c\u0438\u043d\u0430\u0442\u044c \u0432\u0441\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b (\u0438\u0445 \u043f\u043e\u043a\u0430 \u043d\u0435 \u0442\u0430\u043a \u043c\u043d\u043e\u0433\u043e \ud83d\ude0a), \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0430\u0432\u0442\u043e\u0434\u043e\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435.<br \/> \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f <strong>bash<\/strong> \u0438 <strong>zsh<\/strong>.<\/p>\n<p><strong>\u0414\u043b\u044f zsh<\/strong>:<br \/> \u0414\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0432 <code>.zshrc<\/code>:<\/p>\n<pre><code class=\"bash\">source &lt;(easyp completion zsh)<\/code><\/pre>\n<p><strong>\u0414\u043b\u044f bash<\/strong>:<br \/> \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c <code>bash-completion<\/code>, \u0437\u0430\u0442\u0435\u043c \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0432 <code>.bashrc<\/code>:<\/p>\n<pre><code class=\"bash\">source &lt;(easyp completion bash)<\/code><\/pre>\n<p>\u0421\u0442\u0430\u0432\u044c\u0442\u0435 \u0437\u0432\u0451\u0437\u0434\u044b \u043d\u0430 <a href=\"https:\/\/github.com\/easyp-tech\/easyp\/\" rel=\"noopener noreferrer nofollow\">GitHub<\/a>!<br \/> \u0412\u0441\u0442\u0443\u043f\u0430\u0439\u0442\u0435 \u0432 \u043d\u0430\u0448\u0443 <a href=\"https:\/\/t.me\/+KDE8eR7hlhphYjMy\" rel=\"noopener noreferrer nofollow\">\u0433\u0440\u0443\u043f\u043f\u0443 \u0432 TG<\/a> \u2014 \u0441 \u0440\u0430\u0434\u043e\u0441\u0442\u044c\u044e \u043e\u0442\u0432\u0435\u0442\u0438\u043c \u043d\u0430 \u0432\u0441\u0435 \u0432\u043e\u043f\u0440\u043e\u0441\u044b!<\/p>\n<\/div>\n<\/div>\n<\/div>\n<p><!----><!----><\/div>\n<p><!----><!----><br \/> \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/913948\/\"> https:\/\/habr.com\/ru\/articles\/913948\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<div><!--[--><!--]--><\/div>\n<div id=\"post-content-body\">\n<div>\n<div class=\"article-formatted-body article-formatted-body article-formatted-body_version-2\">\n<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<p>\u0414\u0430\u043d\u043d\u0430\u044f \u0441\u0442\u0430\u0442\u044c\u044f \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0435\u043d\u0438\u0435\u043c <a href=\"https:\/\/habr.com\/ru\/articles\/912350\/\" rel=\"noopener noreferrer nofollow\">\u0441\u0442\u0430\u0442\u044c\u0438<\/a>, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 <a class=\"mention\" href=\"\/users\/ZergsLaw\">@ZergsLaw<\/a> \u0443\u0436\u0435 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u043b, \u0437\u0430\u0447\u0435\u043c \u043c\u044b \u043d\u0430\u0447\u0430\u043b\u0438 \u0434\u0435\u043b\u0430\u0442\u044c <strong>EasyP<\/strong> \u0438 \u043f\u043e\u0447\u0435\u043c\u0443 \u043c\u044b \u0441\u0442\u0430\u0440\u0430\u043b\u0438\u0441\u044c \u043f\u043e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0442\u044c \u043e\u0431\u0449\u0438\u0435 \u0444\u043e\u0440\u043c\u0430\u0442\u044b \u0441 <strong>Buf<\/strong>. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u043f\u043e\u0432\u0442\u043e\u0440\u044f\u0442\u044c\u0441\u044f \u043d\u0435 \u0431\u0443\u0434\u0435\u043c \u0438 \u0441\u0440\u0430\u0437\u0443 \u043f\u0435\u0440\u0435\u0439\u0434\u0435\u043c \u043a \u0442\u043e\u043c\u0443, \u043a\u0430\u043a \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c <strong>EasyP<\/strong> \u0432 \u0441\u0432\u043e\u0438\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445.<\/p>\n<h3>\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430<\/h3>\n<p>\u041d\u0430\u0447\u043d\u0435\u043c, \u043a\u043e\u043d\u0435\u0447\u043d\u043e \u0436\u0435, \u0441 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 <strong>EasyP<\/strong>:<\/p>\n<ul>\n<li>\n<p>\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0435\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 \u0441 GitHub:<\/p>\n<pre><code class=\"bash\">go install github.com\/easyp-tech\/easyp\/cmd\/easyp@latest<\/code><\/pre>\n<\/li>\n<li>\n<p>\u041d\u0435\u0434\u0430\u0432\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u043b\u0438 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 \u0447\u0435\u0440\u0435\u0437 <strong>brew<\/strong>:<\/p>\n<pre><code class=\"bash\">brew install easyp-tech\/tap\/easyp<\/code><\/pre>\n<\/li>\n<\/ul>\n<h3>\u041b\u0438\u043d\u0442\u0438\u043d\u0433<\/h3>\n<figure class=\"full-width\"><\/figure>\n<p>\u0425\u043e\u043b\u0438\u0432\u0430\u0440\u044b \u0432 <strong>PR<\/strong> \u043f\u043e \u043f\u043e\u0432\u043e\u0434\u0443 \u043e\u0442\u0441\u0442\u0443\u043f\u043e\u0432, \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0438 \u0442. \u043f., \u0432 \u0438\u0434\u0435\u0430\u043b\u0435, \u0440\u0435\u0448\u0430\u044e\u0442\u0441\u044f \u0441\u0442\u0438\u043b\u0435\u0432\u044b\u043c\u0438 \u0433\u0430\u0439\u0434\u0430\u043c\u0438. \u041d\u043e \u0435\u0441\u0442\u044c \u043b\u0438 \u043e\u043d\u0438 \u0443 \u0432\u0441\u0435\u0445 \u043a\u043e\u043c\u0430\u043d\u0434?<br \/> \u0423 \u043f\u0438\u0442\u043e\u043d\u0438\u0441\u0442\u043e\u0432 \u0435\u0441\u0442\u044c <strong>PEP<\/strong>, \u043d\u043e \u0434\u0430\u0436\u0435 \u043e\u043d \u043d\u0435 \u043f\u043e\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0432\u0441\u0435 \u0432\u043e\u043f\u0440\u043e\u0441\u044b.<br \/> \u0414\u0430 \u0438 \u0434\u0430\u0436\u0435 \u043f\u0440\u0438 \u043d\u0430\u043b\u0438\u0447\u0438\u0438 styleguide \u0433\u0434\u0435-\u0442\u043e \u043d\u0430 \u0432\u0438\u043a\u0438 \u0442\u0440\u0430\u0442\u0438\u0442\u044c \u0432\u0440\u0435\u043c\u044f \u043d\u0430 \u0430\u043d\u0430\u043b\u0438\u0437 \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0438\u044f \u043a\u043e\u0434\u0430 \u0432 <strong>PR<\/strong> \u2014 \u043d\u0435 \u043b\u0443\u0447\u0448\u0430\u044f \u0438\u0434\u0435\u044f.<\/p>\n<p>\u0423\u0436\u0435 \u0434\u0430\u0432\u043d\u043e \u0432\u0441\u0451 \u044d\u0442\u043e \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043e \u043b\u0438\u043d\u0442\u0435\u0440\u0430\u043c\u0438, \u043b\u0435\u0433\u043a\u043e \u0432\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u043c\u044b\u043c\u0438 \u0432 <strong>CI\/CD<\/strong>.<br \/> \u041d\u043e \u043f\u043e\u0447\u0435\u043c\u0443-\u0442\u043e \u044f \u0447\u0430\u0441\u0442\u043e \u0441\u0442\u0430\u043b\u043a\u0438\u0432\u0430\u044e\u0441\u044c \u0441 \u0443\u0434\u0438\u0432\u043b\u0435\u043d\u0438\u0435\u043c \u043d\u0430 \u0432\u043e\u043f\u0440\u043e\u0441: <em>\u00ab\u0410 \u043a\u0430\u043a\u043e\u0439 \u043b\u0438\u043d\u0442\u0435\u0440 \u0434\u043b\u044f Protobuf \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435?\u00bb<\/em>.<br \/> \u041f\u0440\u0438 \u044d\u0442\u043e\u043c \u0434\u043b\u044f \u041d\u0415 protobuf \u043b\u0438\u043d\u0442\u0435\u0440\u044b, \u0435\u0441\u0442\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043b\u0438, \u0430 \u0434\u043b\u044f protobuf \u2014 \u043f\u043e\u0447\u0435\u043c\u0443-\u0442\u043e \u043d\u0435\u0442.<br \/> \u0425\u043e\u0442\u044f \u043d\u0430\u0432\u0435\u0441\u0442\u0438 \u0431\u0435\u0441\u043f\u043e\u0440\u044f\u0434\u043e\u043a \u0432 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b\u0430\u0445 \u043d\u0438\u0447\u0443\u0442\u044c \u043d\u0435 \u0441\u043b\u043e\u0436\u043d\u0435\u0435.<\/p>\n<p>\u0414\u043e\u043f\u0443\u0441\u0442\u0438\u043c, \u0435\u0441\u0442\u044c \u043d\u0435\u043a\u0438\u0439 \u0441\u0435\u0440\u0432\u0438\u0441:<\/p>\n<pre><code>service ServiceAPI {   rpc example_one(google.protobuf.Empty) returns (google.protobuf.Empty); }<\/code><\/pre>\n<p>\u041f\u043e\u0442\u043e\u043c \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 \u0434\u0440\u0443\u0433\u043e\u0439 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u0438 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u0435\u0449\u0451 \u043e\u0434\u0438\u043d \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442:<\/p>\n<pre><code>service ServiceAPI {   rpc example_one(google.protobuf.Empty) returns (google.protobuf.Empty);   rpc ExampleTwo(google.protobuf.Empty) returns (google.protobuf.Empty); }<\/code><\/pre>\n<p>\u041a\u043e\u0434 \u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439, \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u043d\u0435 \u0432\u044b\u0434\u0430\u0441\u0442 \u043e\u0448\u0438\u0431\u043e\u043a, \u043d\u043e \u043e\u0431\u0449\u0430\u044f \u0441\u0442\u0438\u043b\u0438\u0441\u0442\u0438\u043a\u0430 \u0443\u0436\u0435 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0430.<\/p>\n<p>\u0418\u043b\u0438 \u0434\u0440\u0443\u0433\u043e\u0439, \u0431\u043e\u043b\u0435\u0435 \u043a\u0440\u0438\u0442\u0438\u0447\u043d\u044b\u0439 \u043f\u0440\u0438\u043c\u0435\u0440:<\/p>\n<pre><code>enum Example {   example_one = 0;   ExampleOne = 1; }<\/code><\/pre>\n<p>\u041a\u0440\u043e\u043c\u0435 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0438\u044f \u0441\u0442\u0438\u043b\u0438\u0441\u0442\u0438\u043a\u0438, \u043f\u043e\u043b\u0443\u0447\u0438\u043c \u043e\u0448\u0438\u0431\u043a\u0443 \u043f\u0440\u0438 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438:<\/p>\n<pre><code>Enum name ExampleOne has the same name as example_one if you ignore case and strip out the enum name prefix (if any). (If you are using allow_alias, please assign the same number to each enum value name.)<\/code><\/pre>\n<p>\u0425\u043e\u0442\u0435\u043b\u043e\u0441\u044c \u0431\u044b \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043f\u043e\u0438\u0441\u043a \u043f\u043e\u0434\u043e\u0431\u043d\u044b\u0445 \u043f\u0440\u043e\u0431\u043b\u0435\u043c \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0432 <strong>CI<\/strong> \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0434\u0441\u0432\u0435\u0447\u0438\u0432\u0430\u0442\u044c \u043e\u0448\u0438\u0431\u043a\u0438, \u044d\u043a\u043e\u043d\u043e\u043c\u044f \u0432\u0440\u0435\u043c\u044f \u043d\u0430 \u0440\u0435\u0432\u044c\u044e.<\/p>\n<p>\u0418 \u0442\u0443\u0442 \u043d\u0430 \u0441\u0446\u0435\u043d\u0443 \u0432\u044b\u0445\u043e\u0434\u0438\u0442 \u043b\u0438\u043d\u0442\u0435\u0440 <strong>EasyP<\/strong>.<\/p>\n<p>\u0414\u0430\u0432\u0430\u0439\u0442\u0435 \u0432\u0437\u0433\u043b\u044f\u043d\u0435\u043c \u043d\u0430 \u0435\u0433\u043e \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e.<\/p>\n<p><strong>YAML-\u043a\u043e\u043d\u0444\u0438\u0433<\/strong>:<\/p>\n<pre><code class=\"yaml\">lint:   use:     - MINIMAL<\/code><\/pre>\n<p>\u0417\u0434\u0435\u0441\u044c \u043c\u043e\u0436\u043d\u043e \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u043a\u0430\u043a \u043d\u0430\u0431\u043e\u0440 \u043f\u0440\u0430\u0432\u0438\u043b \u0441\u043f\u0438\u0441\u043a\u043e\u043c, \u0442\u0430\u043a \u0438 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u0433\u0440\u0443\u043f\u043f\u044b: <strong>MINIMAL<\/strong>, <strong>BASIC<\/strong>, <strong>DEFAULT<\/strong>, <strong>COMMENTS<\/strong> \u0438\u043b\u0438 <strong>UNARY_RPC<\/strong>.<br \/> \u0414\u043b\u044f \u043f\u0440\u043e\u0441\u0442\u043e\u0442\u044b \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u044f \u043f\u0440\u0430\u0432\u0438\u043b \u043c\u044b \u043f\u043e\u0437\u0430\u0438\u043c\u0441\u0442\u0432\u043e\u0432\u0430\u043b\u0438 \u0443 <strong>Buf<\/strong> \ud83d\ude42<\/p>\n<p>\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u043c <strong>EasyP<\/strong>:<\/p>\n<pre><code class=\"bash\">easyp lint --path .<\/code><\/pre>\n<p>\u0415\u0441\u043b\u0438 \u0435\u0441\u0442\u044c \u043e\u0448\u0438\u0431\u043a\u0438, \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c \u0432\u044b\u0432\u043e\u0434:<\/p>\n<pre><code>super_api\/v1\/services.proto:11:3:CORPUS_UNSPECIFIED enum zero value suffix is not valid (ENUM_ZERO_VALUE_SUFFIX)<\/code><\/pre>\n<p>\u0424\u043e\u0440\u043c\u0430\u0442 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0432\u043a\u043b\u044e\u0447\u0430\u0435\u0442 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u043e\u0431\u044a\u0435\u043a\u0442\u0430 \u0441 \u043e\u0448\u0438\u0431\u043a\u043e\u0439 \u0438 \u043f\u0440\u0430\u0432\u0438\u043b\u043e.<br \/> \u0421\u0435\u0439\u0447\u0430\u0441 \u0432 \u043f\u043b\u0430\u043d\u0430\u0445 \u2014 \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u0444\u043e\u0440\u043c\u0430\u0442\u0430 <strong>code-quality<\/strong>.<\/p>\n<p>\u041d\u043e \u0438\u043d\u043e\u0433\u0434\u0430 \u043d\u0443\u0436\u043d\u043e \u043e\u0442\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u0441\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u043d\u0438\u0435 \u043b\u0438\u043d\u0442\u0435\u0440\u0430 \u043d\u0430 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0451\u043d\u043d\u0443\u044e \u0441\u0442\u0440\u043e\u043a\u0443 (\u043f\u0440\u0438\u0447\u0438\u043d\u044b \u0432\u044b\u0445\u043e\u0434\u044f\u0442 \u0437\u0430 \u0440\u0430\u043c\u043a\u0438 \u0441\u0442\u0430\u0442\u044c\u0438). \u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u0435\u0441\u0442\u044c \u0434\u0432\u0430 \u043f\u0443\u0442\u0438:<\/p>\n<ol>\n<li>\n<p>\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c <code>buf:lint:ignore $\u0418\u041c\u042f_\u041f\u0420\u0410\u0412\u0418\u041b\u0410<\/code> (\u0434\u043b\u044f \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438 \u0441 <strong>Buf<\/strong>).<\/p>\n<\/li>\n<li>\n<p>\u0418\u043b\u0438 <code>nolint: $\u0418\u041c\u042f_\u041f\u0420\u0410\u0412\u0418\u041b\u0410<\/code>.<\/p>\n<\/li>\n<\/ol>\n<p>\u041d\u043e \u043a\u0440\u043e\u043c\u0435 \u043d\u0435\u0441\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f <strong>API<\/strong>, \u0435\u0441\u0442\u044c \u0434\u0440\u0443\u0433\u0430\u044f, \u0431\u043e\u043b\u0435\u0435 \u0441\u0435\u0440\u044c\u0451\u0437\u043d\u0430\u044f \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430&#8230;<\/p>\n<h3>\u041e\u0431\u0440\u0430\u0442\u043d\u0430\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c<\/h3>\n<p>\u0420\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0438\u043c \u0441\u0438\u0442\u0443\u0430\u0446\u0438\u044e: \u0435\u0441\u0442\u044c \u0441\u0435\u0440\u0432\u0438\u0441, \u0443\u0436\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0449\u0438\u0439 \u0432 \u043f\u0440\u043e\u0434\u0435.<br \/> \u041d\u043e \u0431\u0438\u0437\u043d\u0435\u0441 \u043d\u0435 \u0441\u0442\u043e\u0438\u0442 \u043d\u0430 \u043c\u0435\u0441\u0442\u0435, \u0438 \u0432 \u043e\u0434\u0438\u043d \u0434\u0435\u043d\u044c \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 <strong>PO<\/strong> \u0438 \u0433\u043e\u0432\u043e\u0440\u0438\u0442: <em>\u00ab\u041d\u0430\u043c \u043d\u0443\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043b\u043e\u0433\u0438\u043d \u043f\u043e \u043f\u043e\u0447\u0442\u0435\u00bb<\/em>.<\/p>\n<p>\u041e\u043a, \u0438\u0434\u0451\u043c \u0432 \u043d\u0430\u0448 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b:<\/p>\n<pre><code>message LoginRequest {   string username = 1;   string password = 2; }<\/code><\/pre>\n<p>\u0421\u0435\u0439\u0447\u0430\u0441 \u043c\u043e\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e <strong>username<\/strong>. \u0414\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c \u043f\u043e\u043b\u0435 \u0441 \u043f\u043e\u0447\u0442\u043e\u0439.<br \/> \u041b\u043e\u0433\u0438\u043a\u0430 \u0442\u0430\u043a\u0430\u044f: \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u043c\u043e\u0436\u0435\u0442 \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u043a\u0430\u043a <strong>username<\/strong>, \u0442\u0430\u043a \u0438 <strong>email<\/strong>, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0434\u0435\u043b\u0430\u0435\u043c \u0442\u0430\u043a, \u0447\u0442\u043e\u0431\u044b \u043e\u0434\u043d\u043e \u043f\u043e\u043b\u0435 \u043c\u043e\u0433\u043b\u043e \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0442\u044c \u0434\u0432\u0430 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f:<\/p>\n<pre><code>message LoginRequest {   oneof login {     string username = 1;     string email = 2;   }   string password = 2; }<\/code><\/pre>\n<p>\u041a\u043e\u043c\u043c\u0438\u0442\u0438\u043c, \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0435\u043c \u043d\u0430 \u0440\u0435\u0432\u044c\u044e, \u0434\u0435\u043f\u043b\u043e\u0438\u043c.<br \/> \u0418 \u0447\u0442\u043e \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c?<\/p>\n<figure class=\"full-width\"><\/figure>\n<p>\u041f\u0440\u0438\u0447\u0451\u043c \u044d\u0442\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u0441\u043b\u0443\u0447\u0430\u0439 \u043d\u0430 \u043e\u0434\u043d\u043e\u043c \u0438\u0437 \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432. \u041d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0447\u0435\u043b\u043e\u0432\u0435\u043a \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u043b\u0438 <strong>PR<\/strong> \u0441 \u044d\u0442\u0438\u043c \u043a\u043e\u0434\u043e\u043c \u0438 \u043f\u0440\u043e\u043f\u0443\u0441\u0442\u0438\u043b\u0438.<br \/> \u0412 \u043e\u0431\u0449\u0435\u043c, \u0447\u0435\u043b\u043e\u0432\u0435\u0447\u0435\u0441\u043a\u0438\u0439 \u0444\u0430\u043a\u0442\u043e\u0440 \u2014 \u0438 \u043d\u0438\u043a\u0443\u0434\u0430 \u043e\u0442 \u043d\u0435\u0433\u043e \u043d\u0435 \u0434\u0435\u0442\u044c\u0441\u044f.<\/p>\n<p>\u041d\u043e \u0443 \u043d\u0430\u0441 \u0436\u0435 \u0435\u0441\u0442\u044c \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0441\u0440\u0435\u0434\u0441\u0442\u0432\u0430 \u0434\u043b\u044f \u0430\u043d\u0430\u043b\u0438\u0437\u0430 \u0441\u0442\u0438\u043b\u044f, \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0438 \u0442. \u043f.<br \/> \u0427\u0442\u043e, \u0435\u0441\u043b\u0438 \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0443\u044e \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438 <strong>API<\/strong>, \u0447\u0442\u043e\u0431\u044b \u0438\u0441\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u0447\u0435\u043b\u043e\u0432\u0435\u0447\u0435\u0441\u043a\u0438\u0439 \u0444\u0430\u043a\u0442\u043e\u0440? \u041c\u0430\u0448\u0438\u043d\u0443 \u043d\u0435 \u043e\u0431\u043c\u0430\u043d\u0435\u0448\u044c, \u0438 \u0434\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u0431\u0443\u0434\u0435\u0442 <strong>false-positive<\/strong>, \u044d\u0442\u043e \u043b\u0438\u0448\u043d\u0438\u0439 \u043f\u043e\u0432\u043e\u0434 \u043f\u0435\u0440\u0435\u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c, \u0438 \u0448\u0430\u043d\u0441 \u043e\u0448\u0438\u0431\u043e\u043a \u0443\u043c\u0435\u043d\u044c\u0448\u0438\u0442\u0441\u044f.<\/p>\n<p>\u041a\u0430\u043a \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c? \u041a\u0430\u043a\u0438\u0435 \u044d\u0442\u0430\u043f\u044b \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438?<br \/> \u0412\u0441\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u043e\u0441\u043d\u043e\u0432\u043d\u0443\u044e \u0432\u0435\u0442\u043a\u0443 \u0434\u043e\u043b\u0436\u043d\u044b \u043f\u0440\u043e\u0445\u043e\u0434\u0438\u0442\u044c \u0447\u0435\u0440\u0435\u0437 <strong>Pull Request<\/strong>, \u043f\u043e\u0441\u043b\u0435 \u0443\u0441\u043f\u0435\u0448\u043d\u043e\u0433\u043e \u043f\u0440\u043e\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u044f \u0442\u0435\u0441\u0442\u043e\u0432, \u043b\u0438\u043d\u0442\u0435\u0440\u0430 \u0438 \u0440\u0435\u0432\u044c\u044e (\u0441\u043f\u0430\u0441\u0438\u0431\u043e, \u043a\u044d\u043f).<br \/> \u0414\u043e\u0431\u0430\u0432\u0438\u043c \u0441\u044e\u0434\u0430 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 \u043d\u0430 \u043e\u0431\u0440\u0430\u0442\u043d\u0443\u044e \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c: \u0435\u0441\u043b\u0438 \u0447\u0442\u043e-\u0442\u043e \u0441\u043b\u043e\u043c\u0430\u043b\u043e\u0441\u044c \u2014 \u043f\u0430\u0434\u0430\u0435\u043c, \u043d\u0435 \u0434\u0430\u0451\u043c \u0432\u043b\u0438\u0442\u044c <strong>PR<\/strong>.<br \/> \u041f\u0440\u0438 \u044d\u0442\u043e\u043c \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0435\u043c \u0442\u0435\u043a\u0443\u0449\u0438\u0439 \u043a\u043e\u0434 \u0441 \u043a\u043e\u0434\u043e\u043c \u0438\u0437 \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439 \u0432\u0435\u0442\u043a\u0438.<\/p>\n<pre><code class=\"bash\">easyp breaking<\/code><\/pre>\n<p>\u0412 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 <strong>EasyP<\/strong> \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0432\u0435\u0442\u043a\u0443 \u0434\u043b\u044f \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u044f:<\/p>\n<pre><code class=\"yaml\">breaking:   against_git_ref: master<\/code><\/pre>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u0440\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0438\u043c \u043d\u0430\u0448 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0439:<\/p>\n<ol>\n<li>\n<p>\u0418\u0441\u0445\u043e\u0434\u043d\u044b\u0439 <strong>message<\/strong>:<\/p>\n<pre><code>message LoginRequest {   string username = 1;   string password = 2; }<\/code><\/pre>\n<\/li>\n<li>\n<p>\u041d\u0430\u0448\u0438 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f:<\/p>\n<pre><code>message LoginRequest {   oneof login {     string username = 1;     string email = 2;   }   string password = 2; }<\/code><\/pre>\n<\/li>\n<li>\n<p>\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u043c <strong>EasyP<\/strong> \u0438 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c:<\/p>\n<pre><code>messages\/v1\/messages.proto:15:1: Previously present field \"1\" with name \"username\" on message \"LoginRequest\" was deleted. (BREAKING_CHECK)<\/code><\/pre>\n<\/li>\n<\/ol>\n<p>\u0412\u043e\u0442! <strong>EasyP<\/strong> \u00ab\u0434\u0430\u0451\u0442 \u043f\u043e \u0440\u0443\u043a\u0430\u043c\u00bb \u2014 <strong>PR<\/strong> \u0443\u0436\u0435 \u043d\u0435 \u0432\u043b\u0438\u0442\u044c, \u0430 \u0437\u043d\u0430\u0447\u0438\u0442, \u0438 \u043f\u0440\u043e\u0434 \u043d\u0435 \u0441\u043b\u043e\u043c\u0430\u0442\u044c.<br \/> \u041b\u0438\u0431\u043e \u0434\u0435\u043b\u0430\u0439 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0431\u0435\u0437 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0438\u044f \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438, \u043b\u0438\u0431\u043e \u0441\u043e\u0437\u0434\u0430\u0432\u0430\u0439 \u043d\u043e\u0432\u0443\u044e \u0432\u0435\u0440\u0441\u0438\u044e <strong>API<\/strong>.<\/p>\n<h4>\u041a\u0430\u043a \u044d\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043f\u043e\u0434 \u043a\u0430\u043f\u043e\u0442\u043e\u043c?<\/h4>\n<p><strong>EasyP<\/strong> \u0434\u0435\u043b\u0430\u0435\u0442 \u00ab\u0441\u043b\u0435\u043f\u043a\u0438\u00bb \u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u043e\u0432: \u043e\u0434\u0438\u043d \u0441\u043b\u0435\u043f\u043e\u043a \u2014 \u0442\u0435\u043a\u0443\u0449\u0438\u0439 \u043a\u043e\u0434, \u0432\u0442\u043e\u0440\u043e\u0439 \u2014 \u043a\u043e\u0434 \u0438\u0437 \u0432\u0435\u0442\u043a\u0438, \u0441 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0435\u043c.<br \/> \u0417\u0430\u0442\u0435\u043c \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442\u0441\u044f \u043f\u0440\u043e\u0446\u0435\u0441\u0441 \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u044f: <strong>EasyP<\/strong> \u0441\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u00ab\u043a\u0430\u0440\u0442\u0443\u00bb \u0432\u0441\u0435\u0445 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b\u043e\u0432 \u0441\u043e \u0432\u0441\u0435\u043c\u0438 \u0432\u043b\u043e\u0436\u0435\u043d\u0438\u044f\u043c\u0438: \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f\u043c\u0438, \u0441\u0435\u0440\u0432\u0438\u0441\u0430\u043c\u0438, enum\u2019\u0430\u043c\u0438 \u0438 \u0442. \u043f.<br \/> \u041f\u0440\u0438 \u044d\u0442\u043e\u043c \u0443\u0447\u0438\u0442\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043f\u0430\u043a\u0435\u0442, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u043e\u0431\u044a\u0435\u043a\u0442: \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c \u0434\u0432\u0430 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0441 \u043e\u0434\u0438\u043d\u0430\u043a\u043e\u0432\u044b\u043c \u0438\u043c\u0435\u043d\u0435\u043c, \u043d\u043e \u0432 \u0440\u0430\u0437\u043d\u044b\u0445 \u043f\u0430\u043a\u0435\u0442\u0430\u0445, <strong>EasyP<\/strong> \u044d\u0442\u043e \u043f\u043e\u0439\u043c\u0451\u0442 \u0438 \u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u0440\u0443\u0433\u0430\u0442\u044c\u0441\u044f.<\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0432\u0430\u0436\u043d\u043e, \u0447\u0442\u043e \u0432 \u0440\u0430\u043c\u043a\u0430\u0445 \u043e\u0434\u043d\u043e\u0433\u043e \u043f\u0430\u043a\u0435\u0442\u0430, \u0435\u0441\u043b\u0438 \u043c\u044b \u043f\u0435\u0440\u0435\u043c\u0435\u0441\u0442\u0438\u043b\u0438 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u0432 \u0434\u0440\u0443\u0433\u043e\u0439 \u0444\u0430\u0439\u043b (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043f\u0440\u0438 \u0440\u0435\u0444\u0430\u043a\u0442\u043e\u0440\u0438\u043d\u0433\u0435), \u043d\u043e \u043d\u0435 \u043c\u0435\u043d\u044f\u043b\u0438 \u0442\u0435\u0433\u0438 \u0438 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u044f \u043f\u043e\u043b\u0435\u0439 (\u0442\u043e \u0435\u0441\u0442\u044c \u043d\u0435 \u043d\u0430\u0440\u0443\u0448\u0438\u043b\u0438 \u043e\u0431\u0440\u0430\u0442\u043d\u0443\u044e \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c), <strong>EasyP<\/strong> \u044d\u0442\u043e \u043f\u043e\u0439\u043c\u0451\u0442 \u0438 \u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u0441\u0447\u0438\u0442\u0430\u0442\u044c \u044d\u0442\u043e \u043e\u0448\u0438\u0431\u043a\u043e\u0439.<br \/> \u041a \u0441\u043b\u043e\u0432\u0443, <strong>Buf<\/strong> \u043d\u0430 \u0442\u0430\u043a\u043e\u0435 \u0440\u0443\u0433\u0430\u0435\u0442\u0441\u044f \u0438 \u0433\u043e\u0432\u043e\u0440\u0438\u0442: <em>\u00ab\u041f\u0435\u0440\u0435\u0434\u0435\u043b\u044b\u0432\u0430\u0439\u00bb<\/em>, \u0447\u0442\u043e \u0441\u0442\u0440\u0430\u043d\u043d\u043e, \u0432\u0435\u0434\u044c \u043e\u0431\u0440\u0430\u0442\u043d\u0430\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u043d\u0435 \u043d\u0430\u0440\u0443\u0448\u0435\u043d\u0430.<\/p>\n<h3>\u041f\u0430\u043a\u0435\u0442\u043d\u044b\u0439 \u043c\u0435\u043d\u0435\u0434\u0436\u0435\u0440<\/h3>\n<p>\u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 \u0434\u0435\u0442\u0430\u043b\u0438 \u0440\u0430\u0431\u043e\u0442\u044b <strong>EasyP<\/strong> \u0443\u0436\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u044b \u0432 \u0441\u0442\u0430\u0442\u044c\u0435 \u042d\u0434\u0433\u0430\u0440\u0430. \u0417\u0434\u0435\u0441\u044c \u0436\u0435 \u043f\u043e\u0433\u043e\u0432\u043e\u0440\u0438\u043c \u043f\u0440\u043e \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e \u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435.<\/p>\n<p>\u0421\u043f\u0438\u0441\u043e\u043a \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u043c\u043e\u0436\u043d\u043e \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 \u0432 \u0441\u0435\u043a\u0446\u0438\u0438 <strong>deps<\/strong>:<\/p>\n<pre><code class=\"yaml\">deps:   - github.com\/googleapis\/googleapis   - github.com\/bufbuild\/protovalidate@v0.3.1   - github.com\/grpc-ecosystem\/grpc-gateway@v2.19.1<\/code><\/pre>\n<p>\u041f\u043e \u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0438 \u0441 <strong>go mod<\/strong>, \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0441\u0441\u044b\u043b\u043a\u0443 \u043d\u0430 <strong>Git<\/strong>-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0430 \u043f\u043e\u0441\u043b\u0435 <code>@<\/code> \u2014 \u0432\u0435\u0440\u0441\u0438\u044e (\u044d\u0442\u043e \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0442\u0435\u0433 \u0438\u043b\u0438 \u0445\u044d\u0448 \u043a\u043e\u043c\u043c\u0438\u0442\u0430).<br \/> \u0415\u0441\u043b\u0438 \u0432\u0435\u0440\u0441\u0438\u044f \u043d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d\u0430, <strong>EasyP<\/strong> \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0439 \u043a\u043e\u043c\u043c\u0438\u0442 \u0438\u0437 \u0434\u0435\u0444\u043e\u043b\u0442\u043d\u043e\u0439 \u0432\u0435\u0442\u043a\u0438.<\/p>\n<p><strong>EasyP<\/strong> \u0444\u0438\u043a\u0441\u0438\u0440\u0443\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0432 <strong>lock<\/strong>-\u0444\u0430\u0439\u043b\u0435.<\/p>\n<p>\u041a\u043e\u043c\u0430\u043d\u0434\u044b:<\/p>\n<ul>\n<li>\n<p><code>easyp download<\/code> \u2014 \u0441\u043a\u0430\u0447\u0438\u0432\u0430\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0438\u0437 <strong>lock<\/strong>-\u0444\u0430\u0439\u043b\u0430 (\u0435\u0441\u043b\u0438 \u0435\u0433\u043e \u043d\u0435\u0442 \u2014 \u0441\u0442\u0430\u0432\u0438\u0442 \u0432\u0435\u0440\u0441\u0438\u0438 \u0438\u0437 <strong>YAML<\/strong>).<\/p>\n<\/li>\n<li>\n<p><code>easyp update<\/code> \u2014 \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0435\u0442 lock \u0444\u0430\u0439\u043b, \u0441\u0442\u0430\u0432\u0438\u0442 \u0432\u0435\u0440\u0441\u0438\u0438 \u0438\u0437 <strong>YAML<\/strong> \u0438 \u043f\u0435\u0440\u0435\u0437\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 lock \u0444\u0430\u0439\u043b.<\/p>\n<\/li>\n<li>\n<p><code>easyp vendor<\/code> \u2014 \u043a\u043e\u043f\u0438\u0440\u0443\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0432 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u0443\u044e \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044e \u043f\u0440\u043e\u0435\u043a\u0442\u0430.<\/p>\n<\/li>\n<\/ul>\n<p>\u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u043a\u0435\u0448 \u0445\u0440\u0430\u043d\u0438\u0442\u0441\u044f \u0432 <code>~\/.easyp<\/code>, \u043d\u043e \u044d\u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0438\u0437\u043c\u0435\u043d\u0438\u0442\u044c \u0447\u0435\u0440\u0435\u0437 \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f <code>EASYPPATH<\/code>.<\/p>\n<p>\u041d\u043e \u0432\u0441\u0451 \u044d\u0442\u043e \u043d\u0435 \u0438\u043c\u0435\u043b\u043e \u0431\u044b \u0441\u043c\u044b\u0441\u043b\u0430 \u0431\u0435\u0437 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438 \u043a\u043e\u0434\u0430.<\/p>\n<h3>\u0413\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043a\u043e\u0434\u0430<\/h3>\n<p>\u0412\u0441\u044f \u043c\u043e\u0449\u044c <strong>Protobuf<\/strong> \u0440\u0430\u0441\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u044f \u043f\u043b\u0430\u0433\u0438\u043d\u0430\u043c.<br \/> \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u0440\u0430\u0437\u043d\u044b\u0445 \u044f\u0437\u044b\u043a\u043e\u0432, \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0438 \u0434\u0440\u0443\u0433\u0438\u0435 \u0445\u043e\u0442\u0435\u043b\u043a\u0438 \u043b\u0435\u0433\u043a\u043e \u0440\u0435\u0448\u0430\u044e\u0442\u0441\u044f \u0441 \u0438\u0445 \u043f\u043e\u043c\u043e\u0449\u044c\u044e.<\/p>\n<p>\u041f\u0440\u0438\u043c\u0435\u0440 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0441 <strong>protoc<\/strong>:<\/p>\n<pre><code class=\"bash\">protoc --go_out=. \\   --go_opt=paths=source_relative \\    --go-grpc_out=. \\   --go-grpc_opt=paths=source_relative \\    --java_out=gen\/proto\/java \\    --rust_out=gen\/proto\/rust \\    --swift_out=gen\/proto\/swift \\    helloworld\/helloworld.proto<\/code><\/pre>\n<p>\u0410 \u0432\u043e\u0442 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f <strong>EasyP<\/strong>:<\/p>\n<pre><code class=\"yaml\">generate:   plugins:     - name: go       out: .       opts:         paths: source_relative     - name: go-grpc       out: .       opts:         paths: source_relative         require_unimplemented_servers: false     - name: grpc-gateway       out: .       opts:         paths: source_relative     - name: openapiv2       out: .       opts:         simple_operation_ids: false         generate_unbound_methods: false     - name: validate-go       out: .       opts:         paths: source_relative<\/code><\/pre>\n<p>\u0423\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0438\u043c\u044f \u043f\u043b\u0430\u0433\u0438\u043d\u0430 \u0438 \u0435\u0433\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 (\u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u043e \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c \u0434\u043b\u044f <strong>protoc<\/strong>).<br \/> \u041f\u043e\u0434 \u043a\u0430\u043f\u043e\u0442\u043e\u043c, \u043a\u0441\u0442\u0430\u0442\u0438, \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0438\u043c\u0435\u043d\u043d\u043e <strong>protoc<\/strong>.<\/p>\n<p>\u041d\u043e \u0441 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 \u044d\u0442\u043e \u0435\u0449\u0451 \u043d\u0435 \u0432\u0441\u0451. <strong>EasyP<\/strong> \u0434\u043e\u043b\u0436\u0435\u043d \u0437\u043d\u0430\u0442\u044c, \u0433\u0434\u0435 \u043d\u0430\u0445\u043e\u0434\u044f\u0442\u0441\u044f \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u0435 <strong>proto<\/strong>-\u0444\u0430\u0439\u043b\u044b.<br \/> \u041e\u043d\u0438 \u043c\u043e\u0433\u0443\u0442 \u0431\u044b\u0442\u044c \u043a\u0430\u043a \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u043c\u0438, \u0442\u0430\u043a \u0438 \u0432 \u0443\u0434\u0430\u043b\u0451\u043d\u043d\u043e\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438:<\/p>\n<p><strong>\u0423\u0434\u0430\u043b\u0451\u043d\u043d\u044b\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439<\/strong>:<\/p>\n<pre><code class=\"yaml\">generate:   inputs:     - git_repo:         url: \"URL TO REMOTE REPO\"         sub_directory: \"DIR WITH PROTO FILES\"<\/code><\/pre>\n<p><strong>\u041b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u0435 \u0444\u0430\u0439\u043b\u044b<\/strong>:<\/p>\n<pre><code class=\"yaml\">generate:   inputs:     - directory: \"WHERE YOUR PROTO FILES ARE\"<\/code><\/pre>\n<h3>\u0410\u0432\u0442\u043e\u0434\u043e\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435<\/h3>\n<p>\u0427\u0442\u043e\u0431\u044b \u043d\u0435 \u0437\u0430\u043f\u043e\u043c\u0438\u043d\u0430\u0442\u044c \u0432\u0441\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b (\u0438\u0445 \u043f\u043e\u043a\u0430 \u043d\u0435 \u0442\u0430\u043a \u043c\u043d\u043e\u0433\u043e \ud83d\ude0a), \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0430\u0432\u0442\u043e\u0434\u043e\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435.<br \/> \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f <strong>bash<\/strong> \u0438 <strong>zsh<\/strong>.<\/p>\n<p><strong>\u0414\u043b\u044f zsh<\/strong>:<br \/> \u0414\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0432 <code>.zshrc<\/code>:<\/p>\n<pre><code class=\"bash\">source &lt;(easyp completion zsh)<\/code><\/pre>\n<p><strong>\u0414\u043b\u044f bash<\/strong>:<br \/> \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c <code>bash-completion<\/code>, \u0437\u0430\u0442\u0435\u043c \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0432 <code>.bashrc<\/code>:<\/p>\n<pre><code class=\"bash\">source &lt;(easyp completion bash)<\/code><\/pre>\n<p>\u0421\u0442\u0430\u0432\u044c\u0442\u0435 \u0437\u0432\u0451\u0437\u0434\u044b \u043d\u0430 <a href=\"https:\/\/github.com\/easyp-tech\/easyp\/\" rel=\"noopener noreferrer nofollow\">GitHub<\/a>!<br \/> \u0412\u0441\u0442\u0443\u043f\u0430\u0439\u0442\u0435 \u0432 \u043d\u0430\u0448\u0443 <a href=\"https:\/\/t.me\/+KDE8eR7hlhphYjMy\" rel=\"noopener noreferrer nofollow\">\u0433\u0440\u0443\u043f\u043f\u0443 \u0432 TG<\/a> \u2014 \u0441 \u0440\u0430\u0434\u043e\u0441\u0442\u044c\u044e \u043e\u0442\u0432\u0435\u0442\u0438\u043c \u043d\u0430 \u0432\u0441\u0435 \u0432\u043e\u043f\u0440\u043e\u0441\u044b!<\/p>\n<\/div>\n<\/div>\n<\/div>\n<p><!----><!----><\/div>\n<p><!----><!----><br \/> \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/913948\/\"> https:\/\/habr.com\/ru\/articles\/913948\/<\/a><br \/><\/br><\/br><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-461411","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/461411","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=461411"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/461411\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=461411"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=461411"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=461411"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}