funora 0.0.1.dev2__tar.gz

funora-0.0.1.dev2/.gitattributes

@@ -0,0 +1,3 @@
+# Тесты сравнивают строки побайтово, включая канареечные значения и подписи
+# скелета. Перевод строки обязан быть одинаковым на всех машинах.
+* text=auto eol=lf

funora-0.0.1.dev2/.github/dependabot.yml

@@ -0,0 +1,13 @@
+# Actions in release workflows are pinned by commit SHA. Pins do not age well on
+# their own - Dependabot is what keeps them current without giving up the pinning.
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    commit-message:
+      prefix: "ci"
+    labels:
+      - "type:refactor"
+    open-pull-requests-limit: 3

funora-0.0.1.dev2/.github/workflows/ci.yml

@@ -0,0 +1,204 @@
+# Проверки Python SDK.
+#
+# Сторонние actions закреплены по хэшу коммита, а не по тегу: тег в GitHub можно
+# переставить на другой коммит, хэш нельзя.
+
+name: ci
+
+on:
+  workflow_call:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Тесты и проверки
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.11', '3.12']
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      # Спецификация нужна, чтобы сверить обещанные ею селекторы с настоящими
+      # снимками страниц. Проверить это можно только здесь: снимки лежат в этом
+      # репозитории, а перечень селекторов - в том.
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          repository: Funora-Develop/Funora-spec
+          ref: fa83fa17d548524815d42be74d24dc6100af9e66 # контракт 0.64.0
+          path: .funora-spec
+          persist-credentials: false
+
+      # Зелёная сборка без этого шага доказывает «совпадает со спецификацией,
+      # какой она была в момент сборки», а не «совпадает с версией X». При шести
+      # SDK и независимом версионировании спецификации это и есть тот вопрос,
+      # ради которого заведён spec/version.yaml.
+      - name: Против какой спецификации собрано
+        run: |
+          rev=$(git -C .funora-spec rev-parse HEAD)
+          ver=$(grep -m1 '^spec_version:' .funora-spec/spec/version.yaml | cut -d'"' -f2)
+          status=$(grep -m1 '^status:' .funora-spec/spec/version.yaml | awk '{print $2}')
+          echo "спецификация: версия $ver, статус $status, ревизия $rev"
+          {
+            echo "### Спецификация"
+            echo ""
+            echo "| поле | значение |"
+            echo "| --- | --- |"
+            echo "| версия | \`$ver\` |"
+            echo "| статус | \`$status\` |"
+            echo "| ревизия | \`$rev\` |"
+          } >> "$GITHUB_STEP_SUMMARY"
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # Раннер набора соответствия живёт в репозитории спецификации и написан на
+      # JavaScript: принадлежать одной реализации из шести ему нельзя. Без его
+      # зависимостей набор падал бы на «Cannot find module», и это выглядело бы
+      # поломкой реализации, а не недостачей сборки.
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: '22'
+
+      - name: Зависимости раннера
+        run: npm ci
+        working-directory: .funora-spec
+
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[dev,docs]"
+
+      - name: Нижняя граница версии сборщика
+        if: matrix.python-version == '3.11'
+        run: python -m pip install hatchling==1.27.0
+
+      - name: Линтер
+        run: ruff check src tests tools
+
+      - name: Форматирование
+        run: ruff format --check src tests tools
+
+      - name: Проверка типов
+        run: mypy
+
+      - name: Тесты
+        run: pytest -q --cov=funora --cov-report=xml --cov-fail-under=100
+        env:
+          FUNORA_SPEC_DIR: ${{ github.workspace }}/.funora-spec
+
+      # Набор соответствия - тот самый, ради которого заведены векторы.
+      #
+      # До сих пор он в сборку НЕ ВХОДИЛ, и гоняли его, когда вспомнят. Набор,
+      # который гоняют по памяти, - это тот же объявленный и молчащий механизм,
+      # только с лишним шагом: расхождение реализации с контрактом дожидалось
+      # бы того, кто решит его запустить.
+      #
+      # Раннер живёт в репозитории спецификации: принадлежать одной реализации
+      # из шести ему нельзя.
+      - name: Соответствие контракту
+        run: node scripts/conformance.js "python -m funora.conformance"
+        working-directory: .funora-spec
+        env:
+          FUNORA_SPEC_DIR: ${{ github.workspace }}/.funora-spec
+
+      # Руководство собирается той же сборкой, что и код.
+      #
+      # Документация, которую никто не собирает, ломается тише кода: битая
+      # разметка, глава, выпавшая из оглавления, ссылка в никуда - всё это видно
+      # только тому, кто откроет страницу, то есть первому пришедшему человеку.
+      #
+      # Строго: предупреждение сборщика здесь - отказ. Проверку самих ссылок
+      # делает pytest по настоящему дереву репозитория, и она сильнее.
+      - name: Руководство собирается
+        run: mkdocs build --strict
+
+      # Порождённые модули обязаны совпадать со спецификацией посимвольно.
+      # Шаг отдельный и без права на пропуск: расхождение здесь означает, что
+      # спецификацию изменили, а сборку не перезапустили, и шесть реализаций
+      # разъедутся молча.
+      - name: Порождённые модули не отстали
+        run: python tools/codegen.py --check
+        env:
+          FUNORA_SPEC_DIR: ${{ github.workspace }}/.funora-spec
+
+      - name: Матрица функций не отстала
+        run: python tools/completeness.py --check
+        env:
+          FUNORA_SPEC_DIR: ${{ github.workspace }}/.funora-spec
+
+      - name: Сборка и установка wheel и sdist
+        run: |
+          python -m pip install build twine
+          python -m build --no-isolation
+          python -m twine check dist/*
+          python tools/check_distribution.py dist
+
+      # Отдельным шагом, потому что молчаливый пропуск здесь недопустим. Наборы
+      # сверки пропускают себя, если спецификация недоступна, и без этой
+      # проверки отсутствие сверки выглядело бы как зелёная сборка.
+      - name: Сверка со спецификацией выполнена, а не пропущена
+        run: |
+          out=$(pytest tests/test_spec_selectors.py tests/test_generated.py tests/test_revision_source.py tests/test_fixtures.py tests/test_money.py -q -rs)
+          echo "$out"
+          # Ловится недоступность спецификации, а не всякий пропуск. Пропуски
+          # бывают законные: счётчик, объявленный в области строки, по документу
+          # не сверяется - его проверяет разбор, а не подсчёт узлов.
+          #
+          # Признак недоступности точный: модуль пропускается целиком с этой
+          # причиной, и тогда не проходит ни одна проверка.
+          if echo "$out" | grep -q "FUNORA_SPEC_DIR"; then
+            echo "сверка со спецификацией пропущена: она недоступна"
+            exit 1
+          fi
+          if ! echo "$out" | grep -qE '[0-9]+ passed'; then
+            echo "сверка со спецификацией не выполнилась ни разу"
+            exit 1
+          fi
+        env:
+          FUNORA_SPEC_DIR: ${{ github.workspace }}/.funora-spec
+
+  windows-storage:
+    name: Очереди и журналы на Windows
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: '3.12'
+      - run: python -m pip install -e ".[dev]"
+      - name: Блокировки, восстановление и общий бюджет
+        run: >-
+          python -m pytest -q tests/test_state.py tests/test_spool.py
+          tests/test_persistence_failures.py tests/test_runtime_failures.py
+          tests/test_bot.py tests/test_budget_concurrency.py
+          tests/test_http_transport_contract.py
+          tests/test_watch_outbox.py
+          tests/test_monitoring.py
+          tests/test_monitoring_timing.py
+          tests/test_monitoring_history.py
+          tests/test_distribution_gate.py
+          tests/test_lot_revision.py
+          tests/test_lot_form_preservation.py
+          tests/test_outbound_restore.py
+          tests/test_durable_recovery.py
+          tests/test_price_audit_restore.py
+          tests/test_state_paths.py
+          tests/test_absence_semantics.py
+          tests/test_client_boundaries.py
+          tests/test_core_boundaries.py
+          tests/test_engine_boundaries.py
+          tests/test_observe_boundaries.py
+          tests/test_parser_boundaries.py
+          tests/test_parser_failures.py
+          tests/test_recovery_boundaries.py
+          tests/test_service_reads.py

funora-0.0.1.dev2/.github/workflows/release.yml

@@ -0,0 +1,75 @@
+# Publishes funora to PyPI via Trusted Publishing (OIDC).
+# No API token is stored anywhere: PyPI trusts this repository, this workflow
+# file name and the "pypi" environment. Third-party actions are pinned by
+# commit SHA, as required for release and security workflows.
+
+name: release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    name: Проверки перед выпуском
+    uses: ./.github/workflows/ci.yml
+
+  build:
+    name: Build distributions
+    needs: verify
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: '3.12'
+
+      - name: Тег соответствует версии пакета
+        run: python tools/check_release.py
+        env:
+          FUNORA_RELEASE_TAG: ${{ github.ref_name }}
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Установка wheel и sdist в чистые окружения
+        run: python tools/check_distribution.py dist
+
+      - name: Validate package metadata
+        run: |
+          python -m pip install --upgrade twine
+          python -m twine check dist/*
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    # Тег v<версия> обозначает намеренный выпуск, включая pre-alpha.
+    # Обычные коммиты и PR этот workflow не запускают.
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/funora
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

funora-0.0.1.dev2/.gitignore

@@ -0,0 +1,189 @@
+# ---------------------------------------------------------------------------
+# Funora
+#
+# Credentials come first on purpose. A FunPay session key is not a scoped token:
+# it is the whole account. Anything that could carry one must never be committed,
+# because git history cannot be cleaned out of forks and caches after the fact.
+# ---------------------------------------------------------------------------
+
+# --- Credentials and session material -------------------------------------
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+secrets.*
+credentials.*
+golden_key*
+*golden*key*
+cookies.txt
+cookies.json
+*.cookies
+session.json
+session_*.json
+.session/
+auth.json
+*.netrc
+.npmrc
+.pypirc
+
+# --- Captured protocol material -------------------------------------------
+# Raw pages from a signed-in account contain buyer names and message text.
+# Only redacted, structurally skeletonized fixtures belong in the repository.
+captures/
+raw-captures/
+*.raw.html
+*.raw.json
+snapshots/raw/
+debug-dump/
+diagnostics-*.json
+
+# --- Local working notes ---------------------------------------------------
+# Assistant and maintainer scratch space. Never committed.
+.notes/
+
+# --- AI assistants and coding agents ---------------------------------------
+.claude/
+.claude.json
+CLAUDE.md
+.anthropic/
+.cursor/
+.cursorrules
+.cursorignore
+.cursorindexingignore
+.aider*
+.continue/
+.windsurf/
+.windsurfrules
+.codeium/
+.codeiumignore
+.tabnine/
+.cody/
+.sourcegraph/
+.gemini/
+GEMINI.md
+.agent/
+.agents/
+AGENTS.md
+AGENT.md
+.copilot/
+copilot-instructions.md
+.cline*
+.clinerules
+.roo/
+.roomodes
+.roorules
+.specstory/
+.junie/
+.devin/
+.opencode/
+.crush/
+.qodo/
+.pearai/
+.trae/
+.kiro/
+.amazonq/
+.augment/
+.augmentignore
+.mcp.json
+.mcp/
+.llm/
+.ai/
+llm-notes/
+prompts.local.*
+
+# --- Editors and IDEs ------------------------------------------------------
+.idea/
+.vscode/
+!.vscode/extensions.json
+.vs/
+.fleet/
+.zed/
+*.swp
+*.swo
+*~
+.project
+.classpath
+.settings/
+*.sublime-workspace
+*.sublime-project
+
+# --- Operating system ------------------------------------------------------
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+desktop.ini
+$RECYCLE.BIN/
+
+# --- Logs and temporary files ----------------------------------------------
+*.log
+logs/
+tmp/
+temp/
+.tmp/
+*.tmp
+*.bak
+*.orig
+*.rej
+
+# --- Python ----------------------------------------------------------------
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.venv/
+venv/
+env/
+ENV/
+.python-version
+.pytest_cache/
+.mypy_cache/
+.dmypy.json
+.pyre/
+.ruff_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+
+# Рабочая копия спецификации, которую CI клонирует для сверки селекторов.
+.funora-spec/
+
+# Каталог, куда пишет инструмент наблюдений (funora.observe, ключ --out).
+#
+# Закрыт намеренно и наглухо. Инструмент ходит на площадку под живой сессией и
+# кладёт сюда скелет страницы вместе с описанием происхождения. Скелет текстов
+# не несёт, но каталог - рабочий: рядом с ним оказывается всё, что автор снял
+# по дороге, включая сырую разметку, если он сохранил её руками для разбора.
+#
+# Правило проекта: сырая разметка авторизованных страниц в репозиторий не
+# попадает никогда. Снимки, которые вправду нужны, кладутся в
+# tests/fixtures/pages осознанно и поимённо, а не потому, что каталог не был
+# закрыт.
+observations/
+
+# Собранный сайт руководства. Строится из docs/ и в репозиторий не кладётся.
+site/

funora-0.0.1.dev2/DISCLAIMER.md

@@ -0,0 +1,157 @@
+# Disclaimer
+
+*The English text is authoritative. Русская версия - ниже.*
+
+## Not affiliated with FunPay
+
+Funora is an independent, community-built project. It is **not affiliated with, endorsed by,
+sponsored by, or connected to FunPay** or any of its operators. The name "FunPay" is used
+only to describe what this software interoperates with.
+
+## It works against an interface that is not meant for it
+
+There is no public, documented FunPay API. Funora talks to a private web interface: HTML
+pages, form fields and internal JSON payloads that can change at any time, without notice
+and without a version number. A change on the site can break Funora in ways that are not
+always loud - a page may still load and simply return nothing.
+
+Funora is built to detect that and fail visibly rather than quietly, but no such mechanism is
+perfect.
+
+## The risk is yours
+
+Automating a marketplace you do not own carries real consequences:
+
+- your account may be suspended, temporarily or permanently;
+- funds and pending payouts may be frozen while that is resolved;
+- a parsing failure at the wrong moment can mean an order not delivered, a message not
+  answered, or a price set incorrectly.
+
+The account is yours. The money is yours. **No disclaimer moves that risk anywhere else**,
+and this software is provided without any warranty - see the [LICENSE](LICENSE).
+
+## What the published rules say, and what they do not
+
+We quote FunPay's own rules so you can check every claim rather than trust ours.
+
+Source: **[funpay.com/trade/info](https://funpay.com/trade/info)** (RU) ·
+**[funpay.com/en/trade/info](https://funpay.com/en/trade/info)** (EN)
+
+- **1.9** - *"Advertising, spamming, mass mailing to users."* Sanction: temporary or
+  permanent suspension of the account. This is why Funora has no broadcast or mass-messaging
+  feature and will not accept one.
+- **2.2.9** - *"Продажа товаров и услуг, связанных со спамом и массовой рассылкой сообщений."*
+  (Selling goods and services related to spam and mass messaging.)
+- **2.1.8** - *"The 'Automatic delivery' function must not be used for products that require
+  communication or additional services."* If you build automatic delivery on Funora,
+  respecting this is your responsibility: the framework cannot know what your product needs.
+- **3.4.3** - *"Account suspension due to poor-quality services (for example, due to the
+  seller using bots or other software prohibited by the game publisher)."* Note the actual
+  subject of this clause: software prohibited **by the game publisher**, not automation of
+  FunPay itself.
+
+**We did not find any published clause that either permits or forbids automating FunPay
+itself.** We will not claim otherwise in either direction. Part of FunPay's documentation is
+reachable only by signed-in users and we have not reviewed it. Read the rules and the
+agreement that apply to your own account, and decide for yourself.
+
+## What Funora will not do
+
+These are permanent non-goals, not features postponed to a later release:
+
+- CAPTCHA solving or bypass;
+- anti-detection or browser fingerprint spoofing;
+- proxy rotation intended to evade rate limits or bans;
+- mass messaging, broadcast helpers, or anything that makes spam convenient;
+- automatic generation of reviews or ratings.
+
+Pull requests implementing any of the above will be closed.
+
+## Your credentials and other people's data
+
+A FunPay session key is not a scoped token - it is your entire account. Funora is designed to
+keep it out of logs, exception text and diagnostics, but the guarantee ends at the edges of
+this project: a third-party HTTP client with debug logging enabled, an APM agent, or an
+in-process plugin can all read it. See
+[SECURITY.md](https://github.com/Funora-Develop/.github/blob/main/SECURITY.md).
+
+This software also processes data belonging to people who never installed it - your buyers'
+messages, names and order details. Handle it accordingly.
+
+---
+
+# Отказ от ответственности
+
+*Английский текст является основным; русский приведён для удобства.*
+
+## Проект не аффилирован с FunPay
+
+Funora - независимый проект, разрабатываемый сообществом. Он **не аффилирован с FunPay, не
+одобрен ею, не спонсируется и никак с ней не связан**. Название «FunPay» используется только
+для описания того, с чем это ПО взаимодействует.
+
+## Он работает с интерфейсом, который для этого не предназначен
+
+Публичного документированного API у FunPay нет. Funora обращается к приватному
+веб-интерфейсу: HTML-страницам, полям форм и внутренним JSON-ответам, которые могут
+измениться в любой момент, без предупреждения и без номера версии. Изменение на сайте может
+сломать Funora негромко - страница загрузится и просто вернёт пустоту.
+
+Framework спроектирован так, чтобы обнаруживать это и падать заметно, а не молчать. Но
+идеальных механизмов такого рода не бывает.
+
+## Риск несёте вы
+
+У автоматизации чужой площадки есть реальные последствия:
+
+- аккаунт могут заблокировать, временно или навсегда;
+- средства и незавершённые выплаты могут быть заморожены на время разбирательства;
+- сбой парсинга в неудачный момент означает невыданный заказ, неотвеченное сообщение или
+  неверно выставленную цену.
+
+Аккаунт ваш. Деньги ваши. **Никакой отказ от ответственности не переносит этот риск на
+кого-то другого**, и программа предоставляется без каких-либо гарантий - см. [LICENSE](LICENSE).
+
+## Что говорят опубликованные правила, а что - нет
+
+Цитируем правила FunPay, чтобы вы могли проверить каждое утверждение, а не верить нам на слово.
+
+Источник: **[funpay.com/trade/info](https://funpay.com/trade/info)**
+
+- **1.9** - «Реклама, спам, массовая рассылка пользователям.» Санкция: временная или
+  постоянная блокировка аккаунта. Поэтому в Funora нет массовых рассылок и не будет.
+- **2.2.9** - «Продажа товаров и услуг, связанных со спамом и массовой рассылкой сообщений.»
+- **2.1.8** - «Функцию "Автоматическая выдача" запрещается использовать для товаров, при
+  продаже которых требуется общение или предоставление дополнительных услуг.» Если строите
+  автовыдачу на Funora, соблюдение этого - на вас: framework не знает, что требует ваш товар.
+- **3.4.3** - «Блокировка аккаунта из-за некачественно оказываемой услуги (например, из-за
+  использования продавцом бота или другого запрещённого издателем игры ПО).» Обратите
+  внимание, о чём пункт: о ПО, запрещённом **издателем игры**, а не об автоматизации FunPay.
+
+**Пункта, который прямо разрешал или прямо запрещал бы автоматизацию самой FunPay, в
+опубликованных правилах мы не нашли.** Утверждать обратное - ни в ту, ни в другую сторону -
+не будем. Часть документации площадки доступна только авторизованным пользователям, и мы её
+не просматривали. Прочитайте правила и соглашение, применимые к вашему аккаунту, и решите сами.
+
+## Чего Funora делать не будет
+
+Это постоянные не-цели, а не отложенные функции:
+
+- решение или обход CAPTCHA;
+- антидетект и подмена отпечатка браузера;
+- ротация прокси для обхода ограничений или блокировок;
+- массовые рассылки и всё, что делает спам удобным;
+- автоматическая генерация отзывов и оценок.
+
+Pull request с любым из перечисленного будет закрыт.
+
+## Ваши учётные данные и чужие данные
+
+Сессионный ключ FunPay - это не токен с ограниченными правами, это доступ ко всему аккаунту.
+Funora проектируется так, чтобы он не попадал в логи, текст исключений и диагностику, но
+гарантия заканчивается на границе проекта: сторонний HTTP-клиент с включённым отладочным
+логированием, APM-агент или плагин внутри процесса прочитают его. См.
+[SECURITY.md](https://github.com/Funora-Develop/.github/blob/main/SECURITY.md).
+
+Эта программа также обрабатывает данные людей, которые её не устанавливали, - сообщения,
+имена и детали заказов ваших покупателей. Обращайтесь с ними соответственно.