suveren 2.2.2__tar.gz → 2.2.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (209) hide show
  1. {suveren-2.2.2 → suveren-2.2.3}/CHANGELOG.md +20 -0
  2. {suveren-2.2.2 → suveren-2.2.3}/PKG-INFO +32 -27
  3. {suveren-2.2.2 → suveren-2.2.3}/README.en.md +4 -0
  4. {suveren-2.2.2 → suveren-2.2.3}/README.md +31 -26
  5. {suveren-2.2.2 → suveren-2.2.3}/pyproject.toml +1 -1
  6. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/__init__.py +1 -1
  7. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cache.py +20 -5
  8. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/catalog.py +2 -1
  9. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cli.py +11 -1
  10. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/geoip.py +29 -7
  11. suveren-2.2.3/src/suveren/localsoft.py +101 -0
  12. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/net.py +30 -0
  13. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/render.py +3 -2
  14. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/scan.py +2 -1
  15. {suveren-2.2.2 → suveren-2.2.3}/tests/conftest.py +12 -0
  16. {suveren-2.2.2 → suveren-2.2.3}/tests/test_geoip.py +53 -0
  17. suveren-2.2.3/tests/test_localsoft.py +68 -0
  18. {suveren-2.2.2 → suveren-2.2.3}/tests/test_release_222.py +20 -0
  19. suveren-2.2.3/tools/mkdocs_hooks.py +20 -0
  20. {suveren-2.2.2 → suveren-2.2.3}/.gitignore +0 -0
  21. {suveren-2.2.2 → suveren-2.2.3}/COPYRIGHT +0 -0
  22. {suveren-2.2.2 → suveren-2.2.3}/LICENSE +0 -0
  23. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/__main__.py +0 -0
  24. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/admarking.py +0 -0
  25. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/advice.py +0 -0
  26. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/analyze.py +0 -0
  27. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/audit.py +0 -0
  28. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/blocklist.py +0 -0
  29. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/brand.py +0 -0
  30. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/checks.py +0 -0
  31. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/clirus.py +0 -0
  32. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cloud.py +0 -0
  33. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cms.py +0 -0
  34. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/collect.py +0 -0
  35. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/company.py +0 -0
  36. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/compliance.py +0 -0
  37. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/crawl.py +0 -0
  38. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cutoff.py +0 -0
  39. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/fonts/OFL.txt +0 -0
  40. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/fonts/suveren-mono.woff2 +0 -0
  41. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/fonts/suveren-sans.woff2 +0 -0
  42. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/laws.json +0 -0
  43. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/migration.json +0 -0
  44. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/public_suffix_list.dat +0 -0
  45. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/report.schema.json +0 -0
  46. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/retire.json +0 -0
  47. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/russian-trusted-ca.pem +0 -0
  48. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/services.json +0 -0
  49. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/takeover.json +0 -0
  50. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/dataflow.py +0 -0
  51. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/discover.py +0 -0
  52. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/dnsutil.py +0 -0
  53. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/dnszone.py +0 -0
  54. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/doctor.py +0 -0
  55. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/docx.py +0 -0
  56. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/drafts.py +0 -0
  57. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/egress.py +0 -0
  58. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/errors.py +0 -0
  59. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/fines.py +0 -0
  60. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/formleaks.py +0 -0
  61. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/history.py +0 -0
  62. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ignore.py +0 -0
  63. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/inn.py +0 -0
  64. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/laws.py +0 -0
  65. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/leaks.py +0 -0
  66. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/logins.py +0 -0
  67. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/mailsec.py +0 -0
  68. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/menu.py +0 -0
  69. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/metanote.py +0 -0
  70. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/migration.py +0 -0
  71. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/models.py +0 -0
  72. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ownership.py +0 -0
  73. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ownsite.py +0 -0
  74. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/page.py +0 -0
  75. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/pdpolicy.py +0 -0
  76. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/plan.py +0 -0
  77. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/plugins.py +0 -0
  78. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/psl.py +0 -0
  79. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/recommend.py +0 -0
  80. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/registries.py +0 -0
  81. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/report.py +0 -0
  82. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/research.py +0 -0
  83. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ruregistries.py +0 -0
  84. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/sanctions.py +0 -0
  85. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/sarif.py +0 -0
  86. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/scenarios.py +0 -0
  87. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/scriptgraph.py +0 -0
  88. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/services.py +0 -0
  89. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/subdomains.py +0 -0
  90. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/takeover_signatures.py +0 -0
  91. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/_logo.j2 +0 -0
  92. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/base.html.j2 +0 -0
  93. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/batch.html.j2 +0 -0
  94. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/company.html.j2 +0 -0
  95. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/report.html.j2 +0 -0
  96. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/summary.html.j2 +0 -0
  97. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/trace.py +0 -0
  98. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/unknown.py +0 -0
  99. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/utils.py +0 -0
  100. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/view.py +0 -0
  101. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/vulns.py +0 -0
  102. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/watch.py +0 -0
  103. {suveren-2.2.2 → suveren-2.2.3}/src/suveren/websec.py +0 -0
  104. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/eu_sample.csv +0 -0
  105. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/blog.html +0 -0
  106. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/extidp_forms.html +0 -0
  107. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/google_apple.html +0 -0
  108. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/gsi_only.html +0 -0
  109. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/home_with_login_link.html +0 -0
  110. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/own_routes.html +0 -0
  111. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/russian_only.html +0 -0
  112. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/sign_route.html +0 -0
  113. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/telegram_login.html +0 -0
  114. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/ulogin.html +0 -0
  115. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/policies/full.txt +0 -0
  116. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/policies/offer_with_consent.txt +0 -0
  117. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/policies/partial.txt +0 -0
  118. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/sdn_sample.xml +0 -0
  119. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/uk_sample.csv +0 -0
  120. {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/un_sample.xml +0 -0
  121. {suveren-2.2.2 → suveren-2.2.3}/tests/golden.py +0 -0
  122. {suveren-2.2.2 → suveren-2.2.3}/tests/lab.py +0 -0
  123. {suveren-2.2.2 → suveren-2.2.3}/tests/test_accuracy_tool.py +0 -0
  124. {suveren-2.2.2 → suveren-2.2.3}/tests/test_admarking.py +0 -0
  125. {suveren-2.2.2 → suveren-2.2.3}/tests/test_analyze.py +0 -0
  126. {suveren-2.2.2 → suveren-2.2.3}/tests/test_audit.py +0 -0
  127. {suveren-2.2.2 → suveren-2.2.3}/tests/test_brand.py +0 -0
  128. {suveren-2.2.2 → suveren-2.2.3}/tests/test_cache.py +0 -0
  129. {suveren-2.2.2 → suveren-2.2.3}/tests/test_catalog.py +0 -0
  130. {suveren-2.2.2 → suveren-2.2.3}/tests/test_check_services.py +0 -0
  131. {suveren-2.2.2 → suveren-2.2.3}/tests/test_cli.py +0 -0
  132. {suveren-2.2.2 → suveren-2.2.3}/tests/test_clirus.py +0 -0
  133. {suveren-2.2.2 → suveren-2.2.3}/tests/test_cloud.py +0 -0
  134. {suveren-2.2.2 → suveren-2.2.3}/tests/test_cms.py +0 -0
  135. {suveren-2.2.2 → suveren-2.2.3}/tests/test_collect.py +0 -0
  136. {suveren-2.2.2 → suveren-2.2.3}/tests/test_collect_offline.py +0 -0
  137. {suveren-2.2.2 → suveren-2.2.3}/tests/test_company.py +0 -0
  138. {suveren-2.2.2 → suveren-2.2.3}/tests/test_company_offline.py +0 -0
  139. {suveren-2.2.2 → suveren-2.2.3}/tests/test_compliance.py +0 -0
  140. {suveren-2.2.2 → suveren-2.2.3}/tests/test_control_chars.py +0 -0
  141. {suveren-2.2.2 → suveren-2.2.3}/tests/test_core.py +0 -0
  142. {suveren-2.2.2 → suveren-2.2.3}/tests/test_corpus.py +0 -0
  143. {suveren-2.2.2 → suveren-2.2.3}/tests/test_crawl.py +0 -0
  144. {suveren-2.2.2 → suveren-2.2.3}/tests/test_cutoff.py +0 -0
  145. {suveren-2.2.2 → suveren-2.2.3}/tests/test_dataflow.py +0 -0
  146. {suveren-2.2.2 → suveren-2.2.3}/tests/test_dnsutil.py +0 -0
  147. {suveren-2.2.2 → suveren-2.2.3}/tests/test_dnszone.py +0 -0
  148. {suveren-2.2.2 → suveren-2.2.3}/tests/test_doctor.py +0 -0
  149. {suveren-2.2.2 → suveren-2.2.3}/tests/test_docx.py +0 -0
  150. {suveren-2.2.2 → suveren-2.2.3}/tests/test_drafts.py +0 -0
  151. {suveren-2.2.2 → suveren-2.2.3}/tests/test_e2e.py +0 -0
  152. {suveren-2.2.2 → suveren-2.2.3}/tests/test_egress.py +0 -0
  153. {suveren-2.2.2 → suveren-2.2.3}/tests/test_errors.py +0 -0
  154. {suveren-2.2.2 → suveren-2.2.3}/tests/test_evidence.py +0 -0
  155. {suveren-2.2.2 → suveren-2.2.3}/tests/test_fines.py +0 -0
  156. {suveren-2.2.2 → suveren-2.2.3}/tests/test_formleaks.py +0 -0
  157. {suveren-2.2.2 → suveren-2.2.3}/tests/test_formleaks_browser.py +0 -0
  158. {suveren-2.2.2 → suveren-2.2.3}/tests/test_fuzz.py +0 -0
  159. {suveren-2.2.2 → suveren-2.2.3}/tests/test_ignore.py +0 -0
  160. {suveren-2.2.2 → suveren-2.2.3}/tests/test_inn.py +0 -0
  161. {suveren-2.2.2 → suveren-2.2.3}/tests/test_lab.py +0 -0
  162. {suveren-2.2.2 → suveren-2.2.3}/tests/test_laws.py +0 -0
  163. {suveren-2.2.2 → suveren-2.2.3}/tests/test_leaks.py +0 -0
  164. {suveren-2.2.2 → suveren-2.2.3}/tests/test_lock.py +0 -0
  165. {suveren-2.2.2 → suveren-2.2.3}/tests/test_logins.py +0 -0
  166. {suveren-2.2.2 → suveren-2.2.3}/tests/test_mailsec.py +0 -0
  167. {suveren-2.2.2 → suveren-2.2.3}/tests/test_menu.py +0 -0
  168. {suveren-2.2.2 → suveren-2.2.3}/tests/test_metanote.py +0 -0
  169. {suveren-2.2.2 → suveren-2.2.3}/tests/test_migration.py +0 -0
  170. {suveren-2.2.2 → suveren-2.2.3}/tests/test_net.py +0 -0
  171. {suveren-2.2.2 → suveren-2.2.3}/tests/test_nightly.py +0 -0
  172. {suveren-2.2.2 → suveren-2.2.3}/tests/test_offline_modules.py +0 -0
  173. {suveren-2.2.2 → suveren-2.2.3}/tests/test_ownsite.py +0 -0
  174. {suveren-2.2.2 → suveren-2.2.3}/tests/test_pdpolicy.py +0 -0
  175. {suveren-2.2.2 → suveren-2.2.3}/tests/test_plugins.py +0 -0
  176. {suveren-2.2.2 → suveren-2.2.3}/tests/test_psl.py +0 -0
  177. {suveren-2.2.2 → suveren-2.2.3}/tests/test_pypi_readme.py +0 -0
  178. {suveren-2.2.2 → suveren-2.2.3}/tests/test_recommend.py +0 -0
  179. {suveren-2.2.2 → suveren-2.2.3}/tests/test_registries_blocklist.py +0 -0
  180. {suveren-2.2.2 → suveren-2.2.3}/tests/test_release_221.py +0 -0
  181. {suveren-2.2.2 → suveren-2.2.3}/tests/test_render_launch.py +0 -0
  182. {suveren-2.2.2 → suveren-2.2.3}/tests/test_report_safety.py +0 -0
  183. {suveren-2.2.2 → suveren-2.2.3}/tests/test_research.py +0 -0
  184. {suveren-2.2.2 → suveren-2.2.3}/tests/test_ruregistries.py +0 -0
  185. {suveren-2.2.2 → suveren-2.2.3}/tests/test_rutls.py +0 -0
  186. {suveren-2.2.2 → suveren-2.2.3}/tests/test_sanctions.py +0 -0
  187. {suveren-2.2.2 → suveren-2.2.3}/tests/test_scenarios.py +0 -0
  188. {suveren-2.2.2 → suveren-2.2.3}/tests/test_schema.py +0 -0
  189. {suveren-2.2.2 → suveren-2.2.3}/tests/test_scriptgraph.py +0 -0
  190. {suveren-2.2.2 → suveren-2.2.3}/tests/test_services.py +0 -0
  191. {suveren-2.2.2 → suveren-2.2.3}/tests/test_subdomains.py +0 -0
  192. {suveren-2.2.2 → suveren-2.2.3}/tests/test_supply_chain.py +0 -0
  193. {suveren-2.2.2 → suveren-2.2.3}/tests/test_update_vulns.py +0 -0
  194. {suveren-2.2.2 → suveren-2.2.3}/tests/test_view.py +0 -0
  195. {suveren-2.2.2 → suveren-2.2.3}/tests/test_visual.py +0 -0
  196. {suveren-2.2.2 → suveren-2.2.3}/tests/test_vulns.py +0 -0
  197. {suveren-2.2.2 → suveren-2.2.3}/tests/test_watch.py +0 -0
  198. {suveren-2.2.2 → suveren-2.2.3}/tests/test_websec.py +0 -0
  199. {suveren-2.2.2 → suveren-2.2.3}/tools/accuracy.py +0 -0
  200. {suveren-2.2.2 → suveren-2.2.3}/tools/check_laws.py +0 -0
  201. {suveren-2.2.2 → suveren-2.2.3}/tools/check_services.py +0 -0
  202. {suveren-2.2.2 → suveren-2.2.3}/tools/ci.py +0 -0
  203. {suveren-2.2.2 → suveren-2.2.3}/tools/nightly-sites.txt +0 -0
  204. {suveren-2.2.2 → suveren-2.2.3}/tools/nightly.bat +0 -0
  205. {suveren-2.2.2 → suveren-2.2.3}/tools/nightly.py +0 -0
  206. {suveren-2.2.2 → suveren-2.2.3}/tools/pypi_readme.py +0 -0
  207. {suveren-2.2.2 → suveren-2.2.3}/tools/report_shots.py +0 -0
  208. {suveren-2.2.2 → suveren-2.2.3}/tools/update_psl.py +0 -0
  209. {suveren-2.2.2 → suveren-2.2.3}/tools/update_vulns.py +0 -0
@@ -1,5 +1,25 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.2.3 — 2026-11-10
4
+
5
+ - **Без прямого выхода в интернет проверка больше не висит.** Скачивание базы расположения
6
+ серверов DB-IP во время проверки ждёт соединения 5 секунд, ответа 10 секунд, и всё
7
+ скачивание не дольше 45 секунд. Если база не скачалась, проверка идёт дальше, а в отчёте
8
+ сказано, что страна сервера не проверена. Если сеть недоступна совсем («Network is
9
+ unreachable», как у WHOIS), остальные внешние загрузки не ждут своих таймаутов: берётся
10
+ старая копия, если она есть. `suveren update` по-прежнему ждёт долго. Нашёл читатель Хабра.
11
+ - **Скрипт антивируса больше не считается кодом сайта.** Касперский и AdGuard вставляют
12
+ свой скрипт в каждую страницу, и в режиме `--browser` он попадал в «Кто подключает
13
+ сторонний код» и в цепочки сторонних скриптов (SUV-WEB-011), как будто его подключил
14
+ сайт. Теперь такие скрипты (`kaspersky-labs.com`, `local.adguard.org`) убираются из
15
+ того, что увидел браузер, а в отчёте одна строка говорит, что на компьютере проверяющего
16
+ работает программа, которая меняет страницы. Нашёл читатель Хабра.
17
+ - **`--dkim-selector` у `batch`.** Свои селекторы DKIM теперь можно задать и для списка
18
+ сайтов: они проверяются у каждого сайта вместе с распространёнными.
19
+ - **Установка: нужен Python 3.11 и новее.** README и подсказка режима `--browser` советуют
20
+ `python3 -m pip install "suveren[browser]"` (на Windows `py -m pip`): голая команда `pip`
21
+ бывает от старого Python 2, и тогда pip не находит пакет.
22
+
3
23
  ## 2.2.2 — 2026-11-09
4
24
 
5
25
  - **`--verbose` (`-v`): видно, где зависает.** У `scan`, `company`, `batch`, `research` и
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: suveren
3
- Version: 2.2.2
3
+ Version: 2.2.3
4
4
  Summary: Аудит сайта и компании: иностранные сервисы, 152-ФЗ, блокировки РКН, ЕГРЮЛ и санкционные списки
5
5
  Project-URL: Homepage, https://github.com/marsilid/suveren
6
6
  Project-URL: Documentation, https://github.com/marsilid/suveren/blob/main/docs/guide.md
@@ -40,8 +40,8 @@ Description-Content-Type: text/markdown
40
40
  <div align="center">
41
41
 
42
42
  <picture>
43
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/logo-dark.png">
44
- <img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/logo-light.png" width="300">
43
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-dark.png">
44
+ <img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-light.png" width="300">
45
45
  </picture>
46
46
 
47
47
  **Проверка сайта и компании для работы в России**<br>
@@ -53,7 +53,7 @@ Description-Content-Type: text/markdown
53
53
  ![Python](https://img.shields.io/badge/python-3.11%E2%80%933.14-blue)
54
54
  ![License](https://img.shields.io/badge/license-AGPL--3.0-blue)
55
55
 
56
- [English version](https://github.com/marsilid/suveren/blob/v2.2.2/README.en.md)
56
+ [Сайт](https://marsilid.github.io/suveren/) · [English version](https://github.com/marsilid/suveren/blob/v2.2.3/README.en.md)
57
57
 
58
58
  </div>
59
59
 
@@ -62,7 +62,7 @@ Description-Content-Type: text/markdown
62
62
  письмо от имени компании и что исправить в первую очередь. Каждый вывод подкреплён
63
63
  доказательством: DNS-записью, заголовком ответа, цитатой из политики, адресом скрипта.
64
64
 
65
- ![Suveren в терминале](https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/demo.svg)
65
+ ![Suveren в терминале](https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/demo.svg)
66
66
 
67
67
  <sub>На картинках — выдуманные сайты в зарезервированной зоне `.test`: это данные настоящих
68
68
  проверок, в которых имена, адреса и IP заменены, чтобы не показывать чужие компании.</sub>
@@ -77,10 +77,15 @@ Description-Content-Type: text/markdown
77
77
  **Любая система** (Python 3.11+):
78
78
 
79
79
  ```bash
80
- pip install "suveren[browser]"
80
+ python3 -m pip install "suveren[browser]"
81
81
  suveren scan example.ru
82
82
  ```
83
83
 
84
+ На Windows вместо `python3` пишите `py`. Ставьте именно через `python3 -m pip`: голая команда
85
+ `pip` бывает от старого Python 2 или 3.8. Если pip отвечает `Could not find a version that
86
+ satisfies the requirement suveren` («from versions: none»), значит его Python старше 3.11:
87
+ проверьте `python3 --version` и обновите Python или скачайте готовый exe.
88
+
84
89
  <details>
85
90
  <summary>Другие способы: из исходного кода и Docker</summary>
86
91
 
@@ -92,7 +97,7 @@ docker build -t suveren https://github.com/marsilid/suveren.git
92
97
  docker run --rm -v "$PWD:/work" suveren scan example.ru
93
98
  ```
94
99
 
95
- ![Меню Suveren](https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/menu.svg)
100
+ ![Меню Suveren](https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/menu.svg)
96
101
 
97
102
  </details>
98
103
 
@@ -113,7 +118,7 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
113
118
  - **С кем мы имеем дело?** Компания в ЕГРЮЛ, санкционные списки США, ЕС, Великобритании и ООН,
114
119
  перечень Росфинмониторинга.
115
120
 
116
- Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.2/docs/checks.md)) и база из 300 с лишним сервисов.
121
+ Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md)) и база из 300 с лишним сервисов.
117
122
  Находки из разных разделов собираются в сценарии атак: «почту можно подделать» + «на сайте есть
118
123
  оплата» = фишинг от имени компании.
119
124
 
@@ -128,26 +133,26 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
128
133
  оформить отчёт под брендом своей студии.
129
134
 
130
135
  <picture>
131
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/report-dark.png">
132
- <img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/report-light.png">
136
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-dark.png">
137
+ <img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-light.png">
133
138
  </picture>
134
139
 
135
140
  <details>
136
141
  <summary>Раздел 152-ФЗ, проверка компании и сводка по списку сайтов</summary>
137
142
 
138
143
  <picture>
139
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/compliance-dark.png">
140
- <img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/compliance-light.png">
144
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-dark.png">
145
+ <img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-light.png">
141
146
  </picture>
142
147
 
143
148
  <picture>
144
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/company-dark.png">
145
- <img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/company-light.png">
149
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-dark.png">
150
+ <img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-light.png">
146
151
  </picture>
147
152
 
148
153
  <picture>
149
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/batch-dark.png">
150
- <img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/batch-light.png">
154
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-dark.png">
155
+ <img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-light.png">
151
156
  </picture>
152
157
 
153
158
  </details>
@@ -166,7 +171,7 @@ suveren scan сайт.ru -v # каждый сетевой шаг
166
171
  suveren scan сайт.ru --dkim-selector ew # проверить и ваш селектор DKIM, а не только типовые
167
172
  ```
168
173
 
169
- Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#все-команды), а также в
174
+ Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#все-команды), а также в
170
175
  `suveren --help` и `suveren scan --help`.
171
176
 
172
177
  ## Что Suveren делает с сайтом
@@ -186,9 +191,9 @@ Suveren в основном смотрит то же, что любой посе
186
191
  почтовые серверы, а с `--form-leaks` — утечки данных из форм. Запускается только после
187
192
  подтверждения владения (`suveren verify`).
188
193
 
189
- У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.2/docs/checks.md) указано, что она делает с сайтом и чем
194
+ У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md) указано, что она делает с сайтом и чем
190
195
  рискует тот, кто её запускает. Куда уходят данные при `--dns ru` — в
191
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#параметры-проверки), чем рискуют плагины — в [docs/plugins.md](https://github.com/marsilid/suveren/blob/v2.2.2/docs/plugins.md).
196
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#параметры-проверки), чем рискуют плагины — в [docs/plugins.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/plugins.md).
192
197
 
193
198
  ## Для CI
194
199
 
@@ -199,7 +204,7 @@ suveren scan example.ru --no-open --sarif suveren.sarif --fail-on fail
199
204
  SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку, которую решили пока не
200
205
  исправлять, можно принять в `.suveren-ignore` с причиной, автором и сроком: она остаётся в
201
206
  отчёте, но не валит сборку, а после срока снова считается. Подробнее — в
202
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#ci-и-другие-инструменты).
207
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ci-и-другие-инструменты).
203
208
 
204
209
  ## Источники данных и ограничения
205
210
 
@@ -212,21 +217,21 @@ SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку,
212
217
  Отчёт помогает расставить приоритеты и **не является юридическим заключением**: у каждой
213
218
  проверки 152-ФЗ указана статья закона со ссылкой на текст. Где проверить не удалось, Suveren
214
219
  пишет «не проверено», а не ложное «в порядке». Все ограничения — в
215
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#ограничения).
220
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ограничения).
216
221
 
217
222
  ## Участие
218
223
 
219
224
  Чтобы добавить сервис в базу, программировать не нужно: это файл
220
- [`services.json`](https://github.com/marsilid/suveren/blob/v2.2.2/src/suveren/data/services.json), как его заполнить — в
221
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#как-добавить-сервис-в-базу). Можно и просто открыть issue
222
- «Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.2/CONTRIBUTING.md),
223
- об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.2/SECURITY.md).
225
+ [`services.json`](https://github.com/marsilid/suveren/blob/v2.2.3/src/suveren/data/services.json), как его заполнить — в
226
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#как-добавить-сервис-в-базу). Можно и просто открыть issue
227
+ «Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.3/CONTRIBUTING.md),
228
+ об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.3/SECURITY.md).
224
229
 
225
230
  ## Лицензия
226
231
 
227
- [GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.2/LICENSE) или более поздняя, начиная с версии 1.1: код открыт, и любая изменённая
232
+ [GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.3/LICENSE) или более поздняя, начиная с версии 1.1: код открыт, и любая изменённая
228
233
  версия, в том числе работающая как сервис, тоже должна быть открыта. Для закрытых продуктов и
229
- SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.2/COPYRIGHT). Версии до 1.0.x остаются
234
+ SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.3/COPYRIGHT). Версии до 1.0.x остаются
230
235
  под MIT.
231
236
 
232
237
  Связанный проект: [ReconLens](https://github.com/marsilid/reconlens) — пассивная OSINT-разведка
@@ -44,6 +44,10 @@ pip install "suveren[browser]"
44
44
  suveren scan example.ru
45
45
  ```
46
46
 
47
+ If pip says `Could not find a version that satisfies the requirement suveren`
48
+ ("from versions: none"), your Python is older than 3.11: check `python --version` and upgrade
49
+ it, or download the ready exe.
50
+
47
51
  <details>
48
52
  <summary>Other ways: from source and Docker</summary>
49
53
 
@@ -1,8 +1,8 @@
1
1
  <div align="center">
2
2
 
3
3
  <picture>
4
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/logo-dark.png">
5
- <img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/logo-light.png" width="300">
4
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-dark.png">
5
+ <img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-light.png" width="300">
6
6
  </picture>
7
7
 
8
8
  **Проверка сайта и компании для работы в России**<br>
@@ -14,7 +14,7 @@
14
14
  ![Python](https://img.shields.io/badge/python-3.11%E2%80%933.14-blue)
15
15
  ![License](https://img.shields.io/badge/license-AGPL--3.0-blue)
16
16
 
17
- [English version](https://github.com/marsilid/suveren/blob/v2.2.2/README.en.md)
17
+ [Сайт](https://marsilid.github.io/suveren/) · [English version](https://github.com/marsilid/suveren/blob/v2.2.3/README.en.md)
18
18
 
19
19
  </div>
20
20
 
@@ -23,7 +23,7 @@
23
23
  письмо от имени компании и что исправить в первую очередь. Каждый вывод подкреплён
24
24
  доказательством: DNS-записью, заголовком ответа, цитатой из политики, адресом скрипта.
25
25
 
26
- ![Suveren в терминале](https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/demo.svg)
26
+ ![Suveren в терминале](https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/demo.svg)
27
27
 
28
28
  <sub>На картинках — выдуманные сайты в зарезервированной зоне `.test`: это данные настоящих
29
29
  проверок, в которых имена, адреса и IP заменены, чтобы не показывать чужие компании.</sub>
@@ -38,10 +38,15 @@
38
38
  **Любая система** (Python 3.11+):
39
39
 
40
40
  ```bash
41
- pip install "suveren[browser]"
41
+ python3 -m pip install "suveren[browser]"
42
42
  suveren scan example.ru
43
43
  ```
44
44
 
45
+ На Windows вместо `python3` пишите `py`. Ставьте именно через `python3 -m pip`: голая команда
46
+ `pip` бывает от старого Python 2 или 3.8. Если pip отвечает `Could not find a version that
47
+ satisfies the requirement suveren` («from versions: none»), значит его Python старше 3.11:
48
+ проверьте `python3 --version` и обновите Python или скачайте готовый exe.
49
+
45
50
  <details>
46
51
  <summary>Другие способы: из исходного кода и Docker</summary>
47
52
 
@@ -53,7 +58,7 @@ docker build -t suveren https://github.com/marsilid/suveren.git
53
58
  docker run --rm -v "$PWD:/work" suveren scan example.ru
54
59
  ```
55
60
 
56
- ![Меню Suveren](https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/menu.svg)
61
+ ![Меню Suveren](https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/menu.svg)
57
62
 
58
63
  </details>
59
64
 
@@ -74,7 +79,7 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
74
79
  - **С кем мы имеем дело?** Компания в ЕГРЮЛ, санкционные списки США, ЕС, Великобритании и ООН,
75
80
  перечень Росфинмониторинга.
76
81
 
77
- Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.2/docs/checks.md)) и база из 300 с лишним сервисов.
82
+ Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md)) и база из 300 с лишним сервисов.
78
83
  Находки из разных разделов собираются в сценарии атак: «почту можно подделать» + «на сайте есть
79
84
  оплата» = фишинг от имени компании.
80
85
 
@@ -89,26 +94,26 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
89
94
  оформить отчёт под брендом своей студии.
90
95
 
91
96
  <picture>
92
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/report-dark.png">
93
- <img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/report-light.png">
97
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-dark.png">
98
+ <img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-light.png">
94
99
  </picture>
95
100
 
96
101
  <details>
97
102
  <summary>Раздел 152-ФЗ, проверка компании и сводка по списку сайтов</summary>
98
103
 
99
104
  <picture>
100
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/compliance-dark.png">
101
- <img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/compliance-light.png">
105
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-dark.png">
106
+ <img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-light.png">
102
107
  </picture>
103
108
 
104
109
  <picture>
105
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/company-dark.png">
106
- <img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/company-light.png">
110
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-dark.png">
111
+ <img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-light.png">
107
112
  </picture>
108
113
 
109
114
  <picture>
110
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/batch-dark.png">
111
- <img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.2/docs/batch-light.png">
115
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-dark.png">
116
+ <img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-light.png">
112
117
  </picture>
113
118
 
114
119
  </details>
@@ -127,7 +132,7 @@ suveren scan сайт.ru -v # каждый сетевой шаг
127
132
  suveren scan сайт.ru --dkim-selector ew # проверить и ваш селектор DKIM, а не только типовые
128
133
  ```
129
134
 
130
- Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#все-команды), а также в
135
+ Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#все-команды), а также в
131
136
  `suveren --help` и `suveren scan --help`.
132
137
 
133
138
  ## Что Suveren делает с сайтом
@@ -147,9 +152,9 @@ Suveren в основном смотрит то же, что любой посе
147
152
  почтовые серверы, а с `--form-leaks` — утечки данных из форм. Запускается только после
148
153
  подтверждения владения (`suveren verify`).
149
154
 
150
- У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.2/docs/checks.md) указано, что она делает с сайтом и чем
155
+ У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md) указано, что она делает с сайтом и чем
151
156
  рискует тот, кто её запускает. Куда уходят данные при `--dns ru` — в
152
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#параметры-проверки), чем рискуют плагины — в [docs/plugins.md](https://github.com/marsilid/suveren/blob/v2.2.2/docs/plugins.md).
157
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#параметры-проверки), чем рискуют плагины — в [docs/plugins.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/plugins.md).
153
158
 
154
159
  ## Для CI
155
160
 
@@ -160,7 +165,7 @@ suveren scan example.ru --no-open --sarif suveren.sarif --fail-on fail
160
165
  SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку, которую решили пока не
161
166
  исправлять, можно принять в `.suveren-ignore` с причиной, автором и сроком: она остаётся в
162
167
  отчёте, но не валит сборку, а после срока снова считается. Подробнее — в
163
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#ci-и-другие-инструменты).
168
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ci-и-другие-инструменты).
164
169
 
165
170
  ## Источники данных и ограничения
166
171
 
@@ -173,21 +178,21 @@ SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку,
173
178
  Отчёт помогает расставить приоритеты и **не является юридическим заключением**: у каждой
174
179
  проверки 152-ФЗ указана статья закона со ссылкой на текст. Где проверить не удалось, Suveren
175
180
  пишет «не проверено», а не ложное «в порядке». Все ограничения — в
176
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#ограничения).
181
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ограничения).
177
182
 
178
183
  ## Участие
179
184
 
180
185
  Чтобы добавить сервис в базу, программировать не нужно: это файл
181
- [`services.json`](https://github.com/marsilid/suveren/blob/v2.2.2/src/suveren/data/services.json), как его заполнить — в
182
- [руководстве](https://github.com/marsilid/suveren/blob/v2.2.2/docs/guide.md#как-добавить-сервис-в-базу). Можно и просто открыть issue
183
- «Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.2/CONTRIBUTING.md),
184
- об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.2/SECURITY.md).
186
+ [`services.json`](https://github.com/marsilid/suveren/blob/v2.2.3/src/suveren/data/services.json), как его заполнить — в
187
+ [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#как-добавить-сервис-в-базу). Можно и просто открыть issue
188
+ «Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.3/CONTRIBUTING.md),
189
+ об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.3/SECURITY.md).
185
190
 
186
191
  ## Лицензия
187
192
 
188
- [GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.2/LICENSE) или более поздняя, начиная с версии 1.1: код открыт, и любая изменённая
193
+ [GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.3/LICENSE) или более поздняя, начиная с версии 1.1: код открыт, и любая изменённая
189
194
  версия, в том числе работающая как сервис, тоже должна быть открыта. Для закрытых продуктов и
190
- SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.2/COPYRIGHT). Версии до 1.0.x остаются
195
+ SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.3/COPYRIGHT). Версии до 1.0.x остаются
191
196
  под MIT.
192
197
 
193
198
  Связанный проект: [ReconLens](https://github.com/marsilid/reconlens) — пассивная OSINT-разведка
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "suveren"
7
- version = "2.2.2"
7
+ version = "2.2.3"
8
8
  description = "Аудит сайта и компании: иностранные сервисы, 152-ФЗ, блокировки РКН, ЕГРЮЛ и санкционные списки"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -4,4 +4,4 @@ Copyright (C) 2026 marsilid. Licensed under the GNU AGPL-3.0-or-later; see COPYR
4
4
  LICENSE. Versions up to 1.0.x were published under MIT.
5
5
  """
6
6
 
7
- __version__ = "2.2.2"
7
+ __version__ = "2.2.3"
@@ -12,7 +12,7 @@ from pathlib import Path
12
12
  import httpx
13
13
 
14
14
  from suveren.errors import ModuleError, describe
15
- from suveren.net import MAX_BODY_KEY
15
+ from suveren.net import MAX_BODY_KEY, note_unreachable, offline
16
16
 
17
17
  DEFAULT_TTL = 24 * 3600
18
18
  # Sanctions lists change weekly and the block register daily: a "not found" against an
@@ -69,23 +69,37 @@ async def fetch_cached(
69
69
  ttl: float = DEFAULT_TTL,
70
70
  refresh: bool = False,
71
71
  html: bool = False,
72
+ timeout: httpx.Timeout | None = None,
72
73
  ) -> tuple[Path, str | None]:
73
74
  """Return the cached file, downloading it when missing or stale.
74
75
 
75
76
  If the download fails but an old copy exists, the old copy is returned with
76
- a note. Without any copy a :class:`ModuleError` is raised.
77
+ a note. Without any copy a :class:`ModuleError` is raised. Once the network is
78
+ known to be unreachable (``net.offline``), nothing is downloaded: it would only
79
+ wait for its timeout.
77
80
  """
78
81
  path = cache_dir() / name
79
82
  if not refresh and is_fresh(path, ttl):
80
83
  return path, None
84
+ down = offline()
85
+ if down:
86
+ if path.exists():
87
+ return path, f"сеть недоступна, использована копия {name} от {age_text(path)}"
88
+ raise ModuleError(f"не удалось скачать {url} (сеть недоступна: {down})")
81
89
  async with _lock(name):
82
90
  if not refresh and is_fresh(path, ttl): # another caller has just fetched it
83
91
  return path, None
84
- return await _download(client, url, name, path, html=html)
92
+ return await _download(client, url, name, path, html=html, timeout=timeout)
85
93
 
86
94
 
87
95
  async def _download(
88
- client: httpx.AsyncClient, url: str, name: str, path: Path, *, html: bool
96
+ client: httpx.AsyncClient,
97
+ url: str,
98
+ name: str,
99
+ path: Path,
100
+ *,
101
+ html: bool,
102
+ timeout: httpx.Timeout | None = None,
89
103
  ) -> tuple[Path, str | None]:
90
104
  path.parent.mkdir(parents=True, exist_ok=True)
91
105
  # A name of its own, so another process downloading the same list does not collide.
@@ -93,7 +107,7 @@ async def _download(
93
107
  try:
94
108
  # Sanctions lists and the block list are far bigger than a page.
95
109
  big = {MAX_BODY_KEY: 1 << 30}
96
- timeout = httpx.Timeout(30.0, read=120.0)
110
+ timeout = timeout or httpx.Timeout(30.0, read=120.0)
97
111
  async with client.stream("GET", url, timeout=timeout, extensions=big) as resp:
98
112
  resp.raise_for_status()
99
113
  with tmp.open("wb") as fh:
@@ -106,6 +120,7 @@ async def _download(
106
120
  tmp.replace(path)
107
121
  return path, None
108
122
  except (httpx.HTTPError, OSError, _NotData) as exc:
123
+ note_unreachable(exc)
109
124
  tmp.unlink(missing_ok=True)
110
125
  why = "вместо списка пришла пустая страница или HTML" if isinstance(exc, _NotData) else ""
111
126
  if path.exists():
@@ -170,7 +170,8 @@ CATALOG: tuple[CheckSpec, ...] = (
170
170
  "retire.js."),
171
171
  _spec("SUV-WEB-011", WEB, "Цепочки сторонних скриптов", "security",
172
172
  "web scripts supply-chain browser",
173
- "Код, который подключил не сайт, а чужие скрипты (только в режиме --browser)."),
173
+ "Код, который подключил не сайт, а чужие скрипты (только в режиме --browser). "
174
+ "Скрипты антивируса на компьютере проверяющего (Kaspersky, AdGuard) не учитываются."),
174
175
  _spec("SUV-WEB-012", WEB, "Ограничение центров сертификации (CAA)", "security",
175
176
  "web tls dns", "Запись CAA: какие центры сертификации могут выпускать сертификаты "
176
177
  "сайта (RFC 8659)."),
@@ -965,15 +965,24 @@ def batch(
965
965
  brand_logo: BrandLogo = None,
966
966
  brand_url: BrandUrl = None,
967
967
  ignore_file: IgnorePath = None,
968
+ dkim_selector: Annotated[
969
+ list[str] | None,
970
+ typer.Option(
971
+ "--dkim-selector",
972
+ help="Свой селектор DKIM, можно несколько раз: проверяется у каждого сайта "
973
+ "списка вместе с распространёнными.",
974
+ ),
975
+ ] = None,
968
976
  verbose: VerboseOpt = False,
969
977
  ) -> None:
970
978
  """Проверить список сайтов: сводная таблица, CSV и отчёт по каждому сайту."""
971
979
  _trace(verbose)
972
980
  brand = _brand(brand_name, brand_logo, brand_url)
973
981
  try:
982
+ selectors = dkim_selectors(dkim_selector or [])
974
983
  threshold = _validate_grade(fail_under)
975
984
  accepted = load_ignore(ignore_file)
976
- except SuverenError as exc:
985
+ except (SuverenError, ValueError) as exc:
977
986
  raise _fail(str(exc)) from exc
978
987
  try:
979
988
  hosts, skipped = read_targets(file)
@@ -1026,6 +1035,7 @@ def batch(
1026
1035
  host,
1027
1036
  timeout=timeout,
1028
1037
  dns_mode=dns_mode.value,
1038
+ dkim_selectors=selectors,
1029
1039
  **plan.kwargs(), # type: ignore[arg-type]
1030
1040
  ),
1031
1041
  max_time,
@@ -36,6 +36,11 @@ URL = "https://download.db-ip.com/free/dbip-country-lite-{month}.csv.gz"
36
36
  TTL = 31 * 24 * 3600 # a new file comes out on the 1st of each month
37
37
  # Two missed months: addresses move between countries, an old answer is not used.
38
38
  STALE_DAYS = 70
39
+ # During a scan the file is a nicety: without it the server's country is "не определена".
40
+ # A network that drops packets left the download hanging for minutes (redfox0, 2.2.2),
41
+ # so a scan waits briefly; `suveren update` keeps the long default.
42
+ SCAN_TIMEOUT = httpx.Timeout(5.0, read=10.0)
43
+ SCAN_BUDGET = 45.0 # the whole download, a slow trickle included
39
44
 
40
45
 
41
46
  def month_urls(today: date | None = None) -> list[str]:
@@ -122,15 +127,32 @@ def read(path: Path) -> GeoDb:
122
127
  return db
123
128
 
124
129
 
125
- async def load(client: httpx.AsyncClient, *, refresh: bool = False) -> GeoDb:
126
- """The database, or an empty one whose ``problem`` says why; a scan never fails on it."""
127
- path: Path | None = None
130
+ async def _fetch(client: httpx.AsyncClient, refresh: bool) -> Path | None:
131
+ timeout = None if refresh else SCAN_TIMEOUT
128
132
  for url in month_urls():
129
133
  try:
130
- path, _ = await fetch_cached(client, url, FILENAME, ttl=TTL, refresh=refresh)
131
- break
132
- except ModuleError:
133
- continue
134
+ path, _ = await fetch_cached(
135
+ client, url, FILENAME, ttl=TTL, refresh=refresh, timeout=timeout
136
+ )
137
+ return path
138
+ except ModuleError as exc:
139
+ # Last month's file is worth asking for only when the server answered
140
+ # (404 before the 1st's file is out); a dead connection stays dead.
141
+ if not isinstance(exc.__cause__, httpx.HTTPStatusError):
142
+ return None
143
+ return None
144
+
145
+
146
+ async def load(client: httpx.AsyncClient, *, refresh: bool = False) -> GeoDb:
147
+ """The database, or an empty one whose ``problem`` says why; a scan never fails on it."""
148
+ try:
149
+ if refresh:
150
+ path = await _fetch(client, refresh)
151
+ else:
152
+ async with asyncio.timeout(SCAN_BUDGET):
153
+ path = await _fetch(client, refresh)
154
+ except TimeoutError:
155
+ path = None
134
156
  if path is None:
135
157
  return GeoDb(problem=f"база {NAME} не скачалась")
136
158
  age = (time.time() - path.stat().st_mtime) / 86400