Compare commits
5 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 91521e6604 | |||
| 06e13395f8 | |||
| 404659a545 | |||
| 45e798f2bf | |||
| a4b7629d6a |
@@ -8,3 +8,5 @@ __pycache__/
|
||||
*.egg-info/
|
||||
.pytest_cache/
|
||||
config.local.json
|
||||
config.local.yml
|
||||
config.local.yaml
|
||||
|
||||
+70
-4
@@ -1,10 +1,73 @@
|
||||
# Changelog
|
||||
|
||||
Все значимые изменения **tools/index** (индекс метаданных и модулей 1С) фиксируются в этом файле.
|
||||
Все значимые изменения утилиты **index** (индекс метаданных и модулей 1С) фиксируются в этом файле.
|
||||
|
||||
Формат: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
||||
Версионирование: [Semantic Versioning](https://semver.org/lang/ru/).
|
||||
|
||||
## [0.3.4] - 2026-07-21
|
||||
|
||||
### Added
|
||||
|
||||
- Поддержка внешних обработок как virtual `--baseconf`: можно указать папку (например `my-transfer.ext`), и `reindex` автоматически развернёт её в `my-transfer.ext.<ИмяОбработки>` для каждой найденной пары `<Имя>.xml + <Имя>/`.
|
||||
|
||||
### Changed
|
||||
|
||||
- Проверка `--baseconf` и автоскан `list/reindex` теперь учитывают не только `<name>/src/`, но и внешние обработки.
|
||||
- Индексация metadata/modules для virtual external baseconf:
|
||||
- metadata: `<root>/<ExternalDataProcessor>.xml`,
|
||||
- модули: `*.bsl` только внутри `<root>/<ExternalDataProcessor>/`.
|
||||
- Определение owner для модулей внешней обработки:
|
||||
- `ExternalDataProcessor.<ИмяОбработки>` для `Ext/ObjectModule.bsl`,
|
||||
- `ExternalDataProcessor.<ИмяОбработки>.Form.<ИмяФормы>` для модулей форм.
|
||||
|
||||
## [0.3.3] - 2026-07-17
|
||||
|
||||
### Changed
|
||||
|
||||
- **`query_1c.py search`**: если объект найден по реквизиту (колонка `fields_text` в FTS), в выдаче показывается только совпавший реквизит с типом значения — в том же формате дерева, что и `object --clear`.
|
||||
|
||||
## [0.3.2] - 2026-07-17
|
||||
|
||||
### Added
|
||||
|
||||
- `--config` в формате **YAML** (`.yml`/`.yaml`) с поддержкой комментариев; пример `config.example.yml`.
|
||||
- Блок **`default_baseconfs`** в конфиге: `reindex` без `-b` индексирует только этот список; без блока — автосканирование `<name>/src/`.
|
||||
- **Автопоиск** локального конфига без `--config`: `config.local.yml` / `config.local.yaml` / `config.local.json`.
|
||||
|
||||
### Changed
|
||||
|
||||
- Документация и тексты `--help`: обобщённые примеры вместо локальных имён выгрузок и проектов.
|
||||
- Алиасы `--baseconf` — через `baseconf_aliases` в YAML-конфиге (не в коде).
|
||||
- Список конфигураций для `reindex` без `-b`: автообнаружение или `default_baseconfs` из конфига.
|
||||
|
||||
## [0.3.1] - 2026-07-17
|
||||
|
||||
### Changed
|
||||
|
||||
- **`--help` подкоманд** `query_1c.py` и `index_1c.py`: общие опции (`--baseconf`, `--config`, `--root`) отображаются в справке каждой подкоманды, а не только на верхнем уровне.
|
||||
- Текст подсказки `--baseconf` для `index_1c.py reindex`: «индексировать все выгрузки», не «поиск».
|
||||
- **Автор и лицензия:** Michael BAG (mk@p7net.ru); GNU GPL v3 — [`LICENSE`](LICENSE), справочный перевод [`LICENSE.ru`](LICENSE.ru); раздел в README.
|
||||
|
||||
### Fixed
|
||||
|
||||
- `query_1c.py`: `-b` / `--baseconf` до подкоманды (`query_1c.py -b my-config search …`) корректно применяется к запросу.
|
||||
|
||||
## [0.3.0] - 2026-07-16
|
||||
|
||||
### Added
|
||||
|
||||
- Таблица **`register_records`** (документ → регистры движений из `RegisterRecords`).
|
||||
- Команда **`query_1c.py movements`**:
|
||||
- документ → список регистров движений;
|
||||
- регистр → список документов-регистраторов;
|
||||
- `--type`, `--limit`, `-b` как у остальных команд.
|
||||
- Мягкая миграция схемы **2→3** при открытии индекса (без `reindex --full`): backfill из JSON объектов.
|
||||
|
||||
### Changed
|
||||
|
||||
- `SCHEMA_VERSION` = 3; инкрементальный `reindex` пишет связи в `register_records`.
|
||||
|
||||
## [0.2.0] - 2026-07-16
|
||||
|
||||
### Added
|
||||
@@ -21,7 +84,7 @@
|
||||
|
||||
### Changed
|
||||
|
||||
- Параметр конфигурации 1С: **`--baseconf` / `-b`** (алиасы `target`→`crm3-26`, `source`→`crm3-dev`).
|
||||
- Параметр конфигурации 1С: **`--baseconf` / `-b`**; алиасы через `baseconf_aliases` в `--config`.
|
||||
- **`--config` / `-c`** — только файл настроек утилиты (JSON), не выгрузка 1С.
|
||||
- Информативные ошибки: нет индекса / нет папки `src/` / baseconf не проиндексирован / объект не найден (с подсказками).
|
||||
- Расширена документация `README.md` (примеры, режимы, применение в Cursor).
|
||||
@@ -40,5 +103,8 @@
|
||||
- `query_1c.py`: `search`, `show`, `refs`, `modules`, `module`.
|
||||
- Инкремент по `mtime`+`size` файлов; индекс модулей `**/*.bsl`.
|
||||
|
||||
[0.2.0]: https://git.p7net.ru/1c/index/-/tags/v0.2.0
|
||||
[0.1.0]: https://git.p7net.ru/1c/index/-/tags/v0.1.0
|
||||
[0.3.2]: v0.3.2
|
||||
[0.3.1]: v0.3.1
|
||||
[0.3.0]: v0.3.0
|
||||
[0.2.0]: v0.2.0
|
||||
[0.1.0]: v0.1.0
|
||||
|
||||
@@ -0,0 +1,674 @@
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
<one line to give the program's name and a brief idea of what it does.>
|
||||
Copyright (C) <year> <name of author>
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
<program> Copyright (C) <year> <name of author>
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<https://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
||||
+744
@@ -0,0 +1,744 @@
|
||||
This is an unofficial translation of the GNU General Public License
|
||||
into Russian. It was not published by the Free Software Foundation, and
|
||||
does not legally state the distribution terms for software that uses the
|
||||
GNU GPL - only the original English text of the GNU GPL does that.
|
||||
However, we hope that this translation will help Russian speakers
|
||||
to understand the GNU GPL better.
|
||||
|
||||
Настоящий перевод Стандартной Общественной Лицензии GNU на русский язык
|
||||
не является официальным. Он не опубликован Фондом Свободного Программного
|
||||
Обеспечения и не устанавливает имеющих юридическую силу условий для
|
||||
распространения программного обеспечения, которое распространяется на
|
||||
условиях Стандартной Общественной Лицензии GNU. Условия, имеющие
|
||||
юридическую силу, закреплены исключительно в аутентичном тексте
|
||||
Стандартной Общественной Лицензии GNU на английском языке. Мы надеемся,
|
||||
что настоящий перевод поможет русскоязычным пользователям лучше понять
|
||||
содержание Стандартной Общественной Лицензии GNU.
|
||||
|
||||
|
||||
СТАНДАРТНАЯ ОБЩЕСТВЕННАЯ ЛИЦЕНЗИЯ GNU
|
||||
Версия 3, от 29 июня 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Каждый имеет право распространять точные копии этой лицензии,
|
||||
но без внесения изменений.
|
||||
|
||||
ПРЕАМБУЛА
|
||||
|
||||
Стандартная Общественная Лицензия GNU (GNU General Public License, GNU
|
||||
GPL) - это свободная copyleft лицензия на программное обеспечение (ПО) и
|
||||
другие виды произведений.
|
||||
|
||||
Большинство лицензий на программное обеспечение и другие произведения
|
||||
спроектированы так, чтобы лишить вас свободы делиться ими и изменять их.
|
||||
Стандартная Общественная Лицензия GNU, напротив, разработана с целью
|
||||
гарантировать Ваше право распространять и вносить изменения во все версии
|
||||
программного обеспечения, с уверенностью, что ПО останется свободным
|
||||
для всех пользователей. Мы, Фонд Свободного Программного Обеспечения
|
||||
(Free Software Foundation), используем GNU GPL для большей части нашего
|
||||
программного обеспечения; эта лицензия применяется также к любым другим
|
||||
произведениям, чьи авторы используют её. Вы можете использовать эту
|
||||
лицензию и для своего ПО.
|
||||
|
||||
Когда мы говорим о свободном ПО, мы говорим о свободе, а не цене.
|
||||
Наши лицензии спроектированы так, чтобы удостовериться в Вашем праве
|
||||
распространять копии свободного ПО (и за плату, если вы того пожелаете),
|
||||
чтобы Вы получали исходный текст или могли получить его при желании,
|
||||
чтобы Вы могли изменять ПО или использовать его части в новых свободных
|
||||
программах, и чтобы Вы знали что Вы можете это сделать.
|
||||
|
||||
Для защиты Ваших прав, нам необходимо ограничивать других в возможности
|
||||
отказать Вам в Ваших правах или просить Вас отказаться от них. Поэтому
|
||||
если Вы распространяете копии свободного ПО или модифицируете его, то на
|
||||
Вас ложатся некоторые обязанности: обязанности уважать свободу других.
|
||||
|
||||
Например, если Вы распространяете копии свободного ПО, бесплатно или
|
||||
по определённой цене, Вы должны предоставлять получателям те же свободы,
|
||||
которые получили сами. Вы должны быть уверены, что они, также как и Вы,
|
||||
получили или могут получить исходный текст. И Вы должны донести до них
|
||||
эти условия, чтобы они знали свои права.
|
||||
|
||||
Разработчики, использующие GNU GPL, защищают Ваши права с помощью
|
||||
следующих двух шагов: (1) заявляют авторские права на ПО, и (2)
|
||||
предоставляют Вам эту лицензию, дающую Вам законное право копировать,
|
||||
распространять и/или модифицировать его.
|
||||
|
||||
Для защиты разработчиков и авторов GPL чётко объясняет, что нет никакой
|
||||
гарантии, распространяемой на свободное ПО. Для удобства пользователей и
|
||||
авторов, GPL требует, чтобы модифицированные версии обозначались как
|
||||
"изменённые", таким образом проблемы и ошибки изменённых версий не будут
|
||||
ошибочно приписаны авторам оригинала.
|
||||
|
||||
Некоторые устройства спроектированы так, чтобы воспрепятствовать
|
||||
доступу пользователя к установке или запуску модифицированных версий ПО,
|
||||
хотя производитель может это делать. Это абсолютно несовместимо с нашей
|
||||
целью - защитой пользовательских прав на измененение ПО. Подобные
|
||||
злоупотребления систематически происходят в сфере продуктов
|
||||
индивидуального использования, в которой это особенно неприемлемо. Именно
|
||||
поэтому мы разработали данную версию GPL чтобы запретить подобную
|
||||
практику на этом рынке. Если подобные проблемы возникнут в других
|
||||
областях, мы, ради защиты свободы пользователей, готовы расширить
|
||||
действие лицензии на эти новые области в будущих версиях GPL.
|
||||
|
||||
Наконец, каждой программе постоянно угрожают софтверные патенты.
|
||||
Государства не должны допускать ограничение патентами разработки и
|
||||
использования ПО на компьютерах общего назначения, но т.к. это всё ещё
|
||||
делается, мы хотим избежать опасности наложения патентов на свободные
|
||||
программы, что сделает их, фактически, частной собственностью. Для
|
||||
предотвращения этого, GPL гарантирует, что патенты не могут быть
|
||||
использованы с целью сделать программу несвободной.
|
||||
|
||||
Ниже следуют точные условия копирования, распространения и модификации.
|
||||
|
||||
УСЛОВИЯ
|
||||
|
||||
0. Определения
|
||||
|
||||
"Данная Лицензия" подразумевает третью версию Стандартной Общественной
|
||||
Лицензии GNU.
|
||||
|
||||
"Авторское право" подразумевает также законы, схожие с законами об
|
||||
авторском праве, применимые к другим видам разработок, например,
|
||||
в области интегральных микросхем.
|
||||
|
||||
"Программа" подразумевает любое охраноспособное произведение,
|
||||
лицензированное Данной Лицензией. К каждому владельцу лицензии
|
||||
(лицензиату) обращаются как "Вы". "Владельцы лицензии" и "получатели"
|
||||
могут быть как физическими, так и юридическими лицами.
|
||||
|
||||
"Модификация" произведения означает копирование или адаптация всего или
|
||||
части произведения в форме, требующей разрешения правообладателя и
|
||||
отличающееся от точного копирования. Результат называется
|
||||
"модифицированной версией" предыдущего произведения или произведением,
|
||||
"основанным" на предыдущем произведении.
|
||||
|
||||
"Лицензированное произведение" подразумевает немодифицированную
|
||||
Программу, либо произведение, основанное на Программе.
|
||||
|
||||
"Тиражировать" произведение означает делать что-либо с ним, что, без
|
||||
разрешения, сделает вас непосредственно либо косвенно ответственным за
|
||||
нарушение авторского права в соответствии с применимым законом, за
|
||||
исключением запуска на компьютере или модификации личной копии.
|
||||
Тиражирование включает в себя копирование, распространение (с или без
|
||||
модификаций), публикацию, и, в некоторых странах, другие действия.
|
||||
|
||||
"Передача" произведения означает любой вид тиражирования, который
|
||||
позволяет третьим лицам создавать или получать копии. Простое
|
||||
взаимодействие с пользователем через компьютерную сеть, без получения
|
||||
копии, передачей не является.
|
||||
|
||||
Пользовательский интерфейс отображает "Соответствующие правовые
|
||||
уведомления", в том смысле, что он включает удобные и заметные элементы:
|
||||
(1) отображение соответствующих уведомлений об авторском праве и (2)
|
||||
объяснение пользователю, что нет никакой гарантии на это произведение
|
||||
(кроме тех случаев, когда гарантии явно предоставлены), что лицензиаты
|
||||
могут передавать произведение согласно Данной Лицензии, и каким образом
|
||||
можно ознакомиться с Данной Лицензией. Если интерфейс предоставляет набор
|
||||
пользовательских команд или меню, то соответствующий заметный пункт
|
||||
удовлетворяет данным условиям.
|
||||
|
||||
1. Исходный текст
|
||||
|
||||
"Исходный текст" произведения подразумевает предпочитаемую форму
|
||||
произведения для создания его модификаций. "Объектный код" подразумевает
|
||||
любую другую форму произведения.
|
||||
|
||||
"Стандартный интерфейс" означает интерфейс, который либо является
|
||||
официальным стандартом, установленным признанным органом по
|
||||
стандартизации, либо, в случае интерфейсов, специфичных для конкретного
|
||||
языка программирования, тот, что широко распространён среди разработчиков
|
||||
на данном языке.
|
||||
|
||||
"Системные библиотеки" исполнимых произведений включают в себя всё
|
||||
отличное от произведения как целого, (а) включающееся в стандартную
|
||||
поставку Главного компонента, но не являющееся его частью, и (б) служащее
|
||||
только для использования других произведений с Главным Компонентом, либо
|
||||
для предоставления Стандартного Интерфейса, доступного общественности в
|
||||
форме исходного текста. "Главный Компонент" в этом контексте означает
|
||||
главный существенный компонент (ядро, оконная система и т.д.) конкретной
|
||||
операционной системы (если присутствует) на которой выполняется
|
||||
произведение, либо компилятор, использованный для создания произведения,
|
||||
либо интерпретатор объектного кода, использованный для запуска
|
||||
произведения.
|
||||
|
||||
"Соответствующий Исходный Текст" произведения в форме объектного кода
|
||||
подразумевает весь исходный текст, необходимый для генерации, установки,
|
||||
выполнения (для выполнимых произведений) объектного кода и модификации
|
||||
произведения, включая скрипты, контролирующие эти действия. Однако, он не
|
||||
содержит Системные Библиотеки произведения, утилиты общего назначения или
|
||||
свободно доступные программы, которые использовались в немодифицированном
|
||||
виде для осуществления деятельности, но не являются частью произведения.
|
||||
Например, Соответствующий Исходный Текст включает файлы определения
|
||||
интерфейса, связанные с файлами исходного текста произведения, и исходный
|
||||
текст общих библиотек и динамически связанных подпрограмм, которые
|
||||
необходимы по идее автора произведения, таких как прямая передача данных
|
||||
или поток управления между этими подпрограммами и другими частями
|
||||
произведения.
|
||||
|
||||
Соответствующий Исходный Текст не обязан включать в себя что-либо, что
|
||||
пользователь может автоматически сгенерировать из остальных частей
|
||||
Соответствующего Исходного Текста.
|
||||
|
||||
Соответствующий Исходный Текст произведения в форме исходного текста -
|
||||
то же самое произведение.
|
||||
|
||||
2. Основные свободы
|
||||
|
||||
Все права, предоставленные Данной Лицензией, предоставляются на срок
|
||||
действия авторских прав на Программу и не могут быть отозваны, в случае
|
||||
соблюдения Вами всех формальных требований. Данная Лицензия однозначно
|
||||
подтверждает Ваши неограниченные права на запуск немодифицированной
|
||||
Программы. Действие Данной Лицензии на вывод произведения, защищённого
|
||||
Данной Лицензией, распространяется только в том случае, если вывод
|
||||
представляет собой лицензированное произведение. Данная Лицензия признаёт
|
||||
Ваши права на свободное использование или его эквивалент в соответствии с
|
||||
законом об авторском праве.
|
||||
|
||||
Вы можете создавать, запускать и тиражировать лицензированные
|
||||
произведения, которые Вы не передаёте, без условий, до тех пор, пока
|
||||
лицензия остаётся в силе. Вы можете передать лицензированное произведение
|
||||
третьим лицам с единственной целью - модификацией произведения
|
||||
исключительно для Вас, либо для предоставления Вам возможности запуска
|
||||
этих произведений, при условии что Вы выполняете условия Данной Лицензии
|
||||
при передаче материалов, на которые не обладаете авторским правом. Третьи
|
||||
лица, создающие или запускающие лицензированные произведения должны
|
||||
делать это исключительно от Вашего имени, под Вашим контролем, на
|
||||
условиях запрета создания копий материалов, защищённых авторским правом,
|
||||
без Вашего разрешения.
|
||||
|
||||
Передача при любых других обстоятельствах разрешена исключительно на
|
||||
условиях, установленных ниже. Сублицензирование запрещено; секция 10
|
||||
исключает необходимость в этом.
|
||||
|
||||
3. Защита законных прав пользователей от противотехнических законов
|
||||
|
||||
Ни одно из лицензированных произведений не должно считаться частью
|
||||
технического средства защиты согласно любому применимому закону,
|
||||
выполняющему обязательства, наложенные статьёй 11 соглашения авторского
|
||||
права Всемирной Организации Интеллектуальной Собственности (WIPO),
|
||||
принятой 20 декабря 1996 года, или схожим законам, запрещающим или
|
||||
ограничивающим обход таких средств.
|
||||
|
||||
При передаче Вами лицензированного произведения, Вы отказываетесь от
|
||||
каких-либо юридических полномочий запрещать обход технических средств,
|
||||
пока такой обход находится в рамках осуществления прав, выданных Данной
|
||||
Лицензии, в знак уважения к лицензированному произведению, и Вы
|
||||
отказываетесь от любых намерений ограничить работу или модификацию
|
||||
произведения, как средств давления, направленных на пользователей
|
||||
произведения, Ваши законные права и права третьих лиц запретить обход
|
||||
технологических средств защиты.
|
||||
|
||||
4. Передача точных копий
|
||||
|
||||
Вы можете передавать точные копии исходного текста Программы так же,
|
||||
как и получили, на любом носителе, при условии что в заметной и
|
||||
соответствующей форме публикуете уведомление об авторском праве на каждом
|
||||
экземпляре; сохраняете нетронутыми все уведомления, устанавливающие что
|
||||
Данная Лицензия и любые неразрешающие условия, добавленные в соответствии
|
||||
с главой 7, применимы к тексту программы; сохраняете нетронутыми все
|
||||
уведомления об отсутствии гарантий; предоставляете всем получателям копию
|
||||
Данной Лицензии вместе с Программой.
|
||||
|
||||
Вы можете взимать любую плату за каждую копию, передаваемую Вами, либо
|
||||
делать это бесплатно. Вы можете также предлагать поддержку или гарантии
|
||||
за определённую плату.
|
||||
|
||||
5. Передача версий модифицированного исходного текста
|
||||
|
||||
Вы можете передавать произведения, основанные на Программе, или
|
||||
модификации программы в форме исходного текста на условиях главы 4, также
|
||||
выполняя следующие условия:
|
||||
|
||||
a) Произведение должно содержать заметные уведомления, утверждающие
|
||||
что Вы модифицировали его, и содержащие действительную дату
|
||||
изменений.
|
||||
|
||||
б) Произведение должно содержать заметные уведомления, утверждающие
|
||||
что оно выпущена в соответствии с Данной Лицензией и любыми
|
||||
дополнительными условиями, установленными в соответствии с главой 7.
|
||||
Данное требование изменяет требование секции 4 "оставлять нетронутыми
|
||||
все уведомления".
|
||||
|
||||
в) Вы должны выдать лицензии на произведение, как единое целое, в
|
||||
соответствии с Данной Лицензией, всем, кто захочет получить копию.
|
||||
Данная Лицензия распространяться со всеми применимыми условиями главы
|
||||
7, на всё произведение и каждую его часть, безотносительно того, как
|
||||
они поставляются. Данная Лицензия не допускает выдачи лицензий на
|
||||
произведение другими способами, но не запрещает этого, если Вы
|
||||
получили разрешение на выдачу лицензий отдельно.
|
||||
|
||||
г) Если в произведении присутствуют пользовательские интерфейсы,
|
||||
каждый должен отображать "Соответствующие Правовые Уведомления";
|
||||
однако, если Программа имеет пользовательские интерфейсы, которые не
|
||||
отображают "Соответствующие Правовые Уведомления", Ваше произведение
|
||||
не обязано изменять это поведение.
|
||||
|
||||
Компиляция лицензированного произведения с другими отдельными и
|
||||
независимыми произведениями, которые по своей природе не являются
|
||||
расширениями лицензированного произведения и не соединены с ним с целью
|
||||
сформировать бОльшую программу, на носителе, используемом для хранения
|
||||
или распространения, называется "агрегацией", если компиляция и её
|
||||
суммарные авторские права не ограничивают доступ и юридические права
|
||||
пользователя компиляции относительно исходного произведения. Включение
|
||||
лицензированного произведения в агрегацию не распространяет действие
|
||||
Данной Лицензии на остальные части агрегации.
|
||||
|
||||
6. Передача форм, отличных от исходной
|
||||
|
||||
Вы можете передавать лицензированные произведения в форме объектного
|
||||
кода на условиях глав 4 и 5, в том случае, когда Вы также передаёте
|
||||
машиночитаемый Соответствующий Исходный Текст на условиях Данной
|
||||
Лицензии, одним из следующих путей:
|
||||
|
||||
а) Передаёте объектный код в (или встроенным в) физическом продукте
|
||||
(включая физический дистрибутивный носитель) вместе с Соответствующим
|
||||
Исходным Текстом, расположенным на физическом носителе, широко
|
||||
используемом для обмена ПО.
|
||||
|
||||
б) Передаёте объектный код в (или встроенным в) физическом продукте
|
||||
(включая физический дистрибутивный носитель) вместе с письменным
|
||||
обещанием, действительным по меньшей мере в течение трёх лет и до тех
|
||||
пор, пока Вы предоставляете запасные части или поддержку для данной
|
||||
модели продукта, предоставить любому обладателю объектного кода либо
|
||||
(1) копию Соответствующего Исходного Текста для всего ПО продукта,
|
||||
лицензированного Данной Лицензией, на физическом носителе, широко
|
||||
используемом для обмена ПО, по цене, не превышающей физические
|
||||
затраты на передачу исходного теста, либо (2) возможность скопировать
|
||||
Соответствующий Исходный Текст с сетевого сервера без взимания платы.
|
||||
|
||||
в) Передаёте отдельные экземпляры объектного кода с копией
|
||||
письменного обещания предоставить Соответствующий Исходный Текст.
|
||||
Данный способ разрешён только в редких случаях и на некоммерческой
|
||||
основе, только если Вы получили объектный код в такой форме, в
|
||||
соответствии с пунктом 6б.
|
||||
|
||||
г) Передаёте объектный код, предоставляя доступ из обозначенного
|
||||
места (бесплатно, либо за определённую плату) и предоставляете
|
||||
аналогичный доступ к Соответствующему Исходному Тексту тем же путём,
|
||||
из того же места, без последующей оплаты. Нет необходимости
|
||||
предоставлять Соответствующий Исходный Текст в комплекте с объектным
|
||||
кодом. Если местом доступа является сетевой сервер, Соответствующий
|
||||
Исходный Текст может находиться на другом сервере (обслуживаемом
|
||||
Вами, либо третьими лицами), предоставляющем аналогичные возможности
|
||||
копирования; объектный код должен сопровождаться ясными указаниями
|
||||
местоположения Соответствующего Исходного Текста. Независимо от того,
|
||||
на каком сервере расположен Соответствующий Исходный Текст, Вы
|
||||
обязаны убедиться в том, что он доступен столько, сколько необходимо
|
||||
для соответствия данным требованиям.
|
||||
|
||||
д) Передаёте объектный код, используя передачу от пользователя к
|
||||
пользователю (peer-to-peer), сообщая пользователям где объектный код
|
||||
и Соответствующий Исходный Текст общедоступен без взимания платы
|
||||
согласно пункту 6г.
|
||||
|
||||
Нет необходимости включать в передачу произведения в форме объектного
|
||||
кода отделимые части объектного кода, чей исходный код исключён из
|
||||
Соответствующего Исходного Текста как Системная Библиотека.
|
||||
|
||||
"Пользовательский Продукт" это либо (1) "потребительский товар",
|
||||
подразумевающий любые формы материального личного имущества, которые
|
||||
используются для личных, семейных или домовладельческих целей, либо
|
||||
(2) что-либо спроектированное или продающееся для установки дома. При
|
||||
определении является ли продукт потребительским товаром, случаи,
|
||||
вызывающие сомнения, будут решены в пользу лицензирования. Для
|
||||
конкретного продукта, полученного конкретным пользователем, "обычное
|
||||
использование" подразумевает типичное или распространённое использование
|
||||
такого типа продуктов, безотносительно статуса конкретного пользователя
|
||||
или того, как конкретный пользователь использует, или рассчитывает, или
|
||||
будет использовать продукт. Продукт является потребительским товаром
|
||||
безотносительно того, имеет ли он существенные коммерческие, промышленные
|
||||
или непотребительские применения до тех пор, пока такие применения не
|
||||
являются единственными существенными применениями продукта.
|
||||
|
||||
"Установочная Информация" Пользовательского Продукта подразумевает
|
||||
методы, процедуры, ключи доступа и другую информацию, необходимую для
|
||||
установки и запуска модифицированных версий лицензированного произведения
|
||||
в Пользовательском Продукте из модифицированной версий Соответствующего
|
||||
Исходного Текста. Информация должна быть полной, для гарантирования того,
|
||||
что ничто не препятствует или создаёт помехи продолжению нормального
|
||||
функционирования изменённого объектного кода только потому, что были
|
||||
произведены изменения.
|
||||
|
||||
Если Вы передаёте объектный код согласно данной главе б, или в, или
|
||||
исключительно для использования в Пользовательском Продукте, и передача
|
||||
происходит как часть сделки, в которой права владения и использования
|
||||
Пользовательского Продукта переходят получателю пожизненно либо на
|
||||
определённый срок (безотносительно того, как характеризована сделка),
|
||||
Соответствующий Исходный Текст, передаваемый согласно данной главе должен
|
||||
быть сопровождён Установочной Информацией. Данное требование не действует
|
||||
если ни Вы, ни третьи лица не имеете возможности установить
|
||||
модифицированный объектный код на Пользовательский Продукт (например,
|
||||
произведение установлено в ROM).
|
||||
|
||||
Требование предоставления Установочной Информации не включает
|
||||
требование предоставления поддержки, гарантии или обновлений на
|
||||
произведение, которое было модифицировано либо установлено получателем,
|
||||
или для Пользовательского Продукта, в котором произведение модифицировано
|
||||
или установлено. Доступ к сети может быть запрещён, если сама модификация
|
||||
существенно и негативно действует на работу сети, либо нарушает правила и
|
||||
протоколы передачи данных в сети.
|
||||
|
||||
Предоставленные Соответствующий Исходный Текст и Установочная
|
||||
Информация в соответствии с данной главой должны быть в
|
||||
открыто-документированном формате (имеющем реализацию, доступную в форме
|
||||
исходного текста), и не должны запрашивать пароля либо ключа для
|
||||
распаковки, чтения или копирования.
|
||||
|
||||
7. Дополнительные условия
|
||||
|
||||
"Дополнительные свободы" - это условия, которые дополняют Данную
|
||||
Лицензию путём создания исключений из одного или нескольких условий.
|
||||
Дополнительные свободы, применимые ко всей Программе, должны быть
|
||||
расценены как если бы они были включены в Данную Лицензию, в случае если
|
||||
они действительны согласно применимому закону. Если дополнительные
|
||||
свободы применяются только к части Программы, эта часть может быть
|
||||
использована отдельно на этих условиях, но вся Программа остаётся под
|
||||
действием Данной лицензии без учёта дополнительных свобод.
|
||||
|
||||
Когда Вы передаёте копию лицензированного произведения, Вы имеете право
|
||||
убрать, на своё усмотрение, любые дополнительные свободы на эту копию,
|
||||
либо любую её часть. (Дополнительные свободы могут быть прямо дополнены
|
||||
требованием удалить самих себя в определённых случаях изменения
|
||||
произведения.) Вы можете добавить дополнительные свободы к материалам,
|
||||
добавленным Вами в лицензированное произведение и на которые Вы имеете
|
||||
или можете предоставить разрешение правообладателя.
|
||||
|
||||
Несмотря на любые другие положения Данной Лицензии, на материал,
|
||||
добавленный Вами к лицензированному произведению, Вы можете (если
|
||||
разрешено держателями авторских прав на материал) дополнить условия
|
||||
Данной Лицензии следующими условиями:
|
||||
|
||||
а) Отказ от гарантий или ограничения ответственности иначе, чем
|
||||
установлено в главах 15 и 16 данной лицензии; либо
|
||||
|
||||
б) Требование сохранения определённых разумных юридических
|
||||
уведомлений или указания авторства в материале, или в Соответствующих
|
||||
Правовых Уведомлениях, отображаемых произведением, их содержащим;
|
||||
либо
|
||||
|
||||
в) Запрет на введение в заблуждение относительно происхождения этого
|
||||
материала, либо требование к модифицированным версиям такого
|
||||
материала содержать пометку в надлежащей форме о том, что материал
|
||||
отличается от оригинальной версии; либо
|
||||
|
||||
г) Ограничение на использование, в целях рекламы, имён лицензиаров
|
||||
либо авторов материала; либо
|
||||
|
||||
д) Отказ предоставлять, согласно закону о торговых марках, права на
|
||||
использование некоторых торговых имён, торговых марок, сервисных
|
||||
марок; либо
|
||||
|
||||
е) Требование освобождения от ответственности лицензиаров и авторов
|
||||
материала (или модифицированных версий материала) с договорным
|
||||
принятием ответственности получателем, для любой ответственности,
|
||||
которую данное договорное принятие непосредственно налагает на
|
||||
правообладателей и авторов.
|
||||
|
||||
Все остальные неразрешающие дополнительные условия считаются
|
||||
"дополнительными запретами", что попадает под действие главы 10. Если
|
||||
Программа в том виде, в котором Вы её получили, либо её часть, содержит
|
||||
уведомление, устанавливающее, что она защищена Данной Лицензией и при
|
||||
этом содержит дополнительные запреты, Вы можете удалить эти запреты.
|
||||
Если документ лицензии содержит дополнительные запреты, но допускает
|
||||
релицензирование или передачу на условиях Данной Лицензии, Вы можете
|
||||
добавить к лицензированному произведению материал, защищённый условиями
|
||||
того лицензионного документа, при условии что дополнительный запрет не
|
||||
сохраняется при таком релицензировании или передаче.
|
||||
|
||||
Если Вы добавляете условия в лицензированное произведение в
|
||||
соответствии с данной главой, Вы должны добавить в затронутые исходные
|
||||
файлы, утверждение о том, что дополнительные условия применяются к этим
|
||||
файлам, а также уведомление о том где искать данные условия.
|
||||
|
||||
Дополнительные условия, разрешающие либо неразрешающие, могут быть
|
||||
установлены в форме отдельной лицензии, либо установлены как исключения;
|
||||
требования, перечисленные Выше применяются в любом случае.
|
||||
|
||||
8. Окончание действия
|
||||
|
||||
Вы не можете тиражировать или модифицировать лицензированное
|
||||
произведение кроме как на условиях, явно изложенных в Данной Лицензии.
|
||||
Любая попытка тиражирования или модификации произведения на иных условиях
|
||||
недействительна и автоматически лишает Вас всех прав, выданных Данной
|
||||
Лицензией (включая любые патентые лицензии, предоставленные согласно
|
||||
третьему параграфу главы 11).
|
||||
|
||||
Однако, в том случае, когда Вы прекращаете нарушение Данной Лицензии,
|
||||
лицензия от конкретного правообладателя восстанавливается (а) временно,
|
||||
до тех пор пока правообладатель явно и окончательно не окончит действие
|
||||
Вашей лицензии, и (б) на постоянной основе, если правообладатель не
|
||||
уведомит Вас о нарушении с помощью надлежащих средств в срок 60 дней с
|
||||
момента прекращения нарушений.
|
||||
|
||||
Кроме того, Ваша лицензия от конкретного правообладателя
|
||||
восстанавливается на постоянной основе в случае если правообладатель
|
||||
уведомляет Вас о нарушении с помощью надлежащих средств, но Вы впервые
|
||||
получаете уведомление о нарушении Данной Лицензии (для любого
|
||||
произведения) от этого правообладателя и устраняете нарушение в течение
|
||||
30 дней после получения уведомления.
|
||||
|
||||
Лишение Вас прав согласно данной секции не лишает прав людей, которые
|
||||
получили от Вас копии или права согласно Данной Лицензией. Если Ваши
|
||||
права приостановлены и не восстановлены на постоянной основе, Вы не
|
||||
можете получить новую лицензию на тот же материал согласно главе 10.
|
||||
|
||||
9. Соглашение не требуется для копирования
|
||||
|
||||
Вы не обязаны принимать Данную Лицензию чтобы получить или запустить
|
||||
экземпляр Программы. В дополнении, тиражирование лицензированного
|
||||
произведения, происходящее исключительно как совокупность передач от
|
||||
пользователя к пользователю, требуемых для получения копии также не
|
||||
требует соглашения. Однако, только Данная Лицензия даёт Вам права
|
||||
тиражирования или модификации любых лицензированных произведений. Такие
|
||||
действия нарушают авторское право, если Вы не приняли Данную Лицензию.
|
||||
Поэтому модифицируя или тиражируя лицензированное произведение, Вы
|
||||
подтверждаете своё согласие с Данной Лицензией.
|
||||
|
||||
10. Автоматическое лицензирование последующих получателей
|
||||
|
||||
Каждый раз, когда Вы передаёте лицензированное произведение, получатель
|
||||
автоматически получает лицензию от первоначального лицензиара на запуск,
|
||||
модификацию и тиражирование произведения, подчинённого Данной Лицензии.
|
||||
Вы не ответственны за соблюдение Данной Лицензии третьими лицами.
|
||||
|
||||
"Юридическая сделка" - сделка передающая контроль организации, или
|
||||
практически все активы таковой, или разделение организации, или слияние
|
||||
организаций. Если тиражирование лицензированного произведения является
|
||||
результатом юридической сделки, каждая сторона сделки, получающая копию
|
||||
произведения также получает все лицензии на произведение, которые
|
||||
предшественник стороны имел или мог выдать согласно предыдущему
|
||||
параграфу, плюс право владения Соответствующим Исходным Текстом
|
||||
произведения от предшественника, если он обладал Соответствующим Исходным
|
||||
Текстом, либо мог получить его при соответствующем запросе.
|
||||
|
||||
Вы не можете налагать никакие дополнительные запреты на осуществление
|
||||
прав предоставленных или подтверждённых Данной Лицензией. Например, Вы
|
||||
не можете налагать лицензионные сборы, авторский гонорар, или другие виды
|
||||
выплат за осуществление прав, выданных согласно Данной Лицензии, и Вы не
|
||||
можете инициировать судебный процесс (включая встречный иск), заявляя что
|
||||
любое патентное требование нарушено путём создания, использования,
|
||||
продажи, предложения продажи или импортирования Программы либо любой её
|
||||
части.
|
||||
|
||||
11. Патенты
|
||||
|
||||
"Участник" – правообладатель, разрешающий использование Программы либо
|
||||
произведения, на котором основана Программа, согласно Данной Лицензии.
|
||||
Произведение, лицензированное таким образом, называется "версией
|
||||
участника".
|
||||
|
||||
"Основные патентные требования" участника - все патентные требования
|
||||
которые имеет или контролирует участник, либо уже приобретённые, либо
|
||||
намеченные для приобретения, которые будут нарушены тем или иным образом,
|
||||
допускающимся Данной Лицензией, включая создание, использование или
|
||||
продажа версии участника, но исключая требования, которые будут нарушены
|
||||
только в форме совокупности будущих модификаций версии участника. В
|
||||
рамках данного определения, "контроль" включает в себя право выдавать
|
||||
патентные сублицензии в форме, следующей требованиям Данной Лицензии.
|
||||
|
||||
Каждый участник выдаёт Вам неэксклюзивные, международные, свободные от
|
||||
отчислений патентные лицензии, согласно основным патентным требованиям
|
||||
участника, на использование, продажу, предложение продажи, импортирование
|
||||
и запуск, модификацию и тиражирование содержимого версии участника.
|
||||
|
||||
В следующих трёх параграфах, "патентная лицензия" это любое взаимное
|
||||
соглашение или обязательство, как бы оно не называлось, не применять
|
||||
патент (например, выдача прав на использование подпадающего под патент
|
||||
произведения или обязательство не подавать исков за нарушение патента).
|
||||
"Выдать" такую патентную лицензию противоположной стороне означает
|
||||
заключить такое соглашение или обязательство не применять против неё
|
||||
данный патент.
|
||||
|
||||
Если Вы передаёте лицензированное произведение, сознательно основываясь
|
||||
на патентной лицензии и при этом Соответствующий Исходный Текст
|
||||
произведения не доступен никому для копирования бесплатно и в
|
||||
соответствии с условиями Данной Лицензии через общедоступный сервер или
|
||||
другими легкодоступными методами, Вы должны либо (1) сделать так чтобы
|
||||
Соответствующий Исходный Текст был доступен, либо (2) лишить себя
|
||||
патентной лицензии на данное конкретное произведение, либо (3) оговорить,
|
||||
соответствующим Данной Лицензии образом, расширение патентной лицензии
|
||||
для последующих получателей. "Сознательно основываясь" означает что Вы
|
||||
знаете условия патентной лицензии, но передача лицензированного
|
||||
произведения в стране, либо использование лицензированного произведения
|
||||
получателями в стране, нарушит один или более патент, который можно
|
||||
идентифицировать, в этой стране и который Вы имеете основания считать
|
||||
действительным.
|
||||
|
||||
Если в соответствии с или в связи с конкретной сделкой или соглашением
|
||||
Вы передаёте, тиражируете, путём наладки передачи, лицензированное
|
||||
произведение и предоставляете одной из сторон патентную лицензию после
|
||||
получения лицензированного произведения, давая им право использовать,
|
||||
тиражировать, модифицировать или передавать конкретный экземпляр
|
||||
лицензионного произведения, то патентная лицензия, которую Вы
|
||||
предоставляете автоматически расширяет своё действие на всех получателей
|
||||
лицензированного произведения основанного на ней.
|
||||
|
||||
Патентная лицензия является "дискриминационной", если она не описывает
|
||||
свою сферу применения, запрещает осуществление или обусловлена
|
||||
неосуществлением одного или более прав, которые явно выдаются согласно
|
||||
Данной Лицензии. Вы не можете передавать лицензированное произведение,
|
||||
если Вы - одна из сторон соглашения с третьей стороной, которая
|
||||
занимается дистрибуцией ПО, согласно которому Вы производите выплату
|
||||
третьему лицу в зависимости от объёма осуществляемых передач, и согласно
|
||||
которому третье лицо выдаёт, любой стороне, получающей лицензированное
|
||||
произведение от Вас, дискриминационную патентную лицензию (а) вместе с
|
||||
экземплярами лицензированного произведения, переданными Вами (или
|
||||
копиями, сделанными с этих экземпляров), или (б) вместе с конкретными
|
||||
продуктами или сборками, содержащими лицензированное произведение, в
|
||||
случае, если Вы не вступили в соглашение или патентная лицензия не
|
||||
предоставлена до 28 марта 2007г.
|
||||
|
||||
Ничто в Данной Лицензии не должно быть рассмотрено как исключение или
|
||||
ограничение любой подразумеваемой лицензии или других способов
|
||||
противодействия нарушению, которые в других случаях могут быть доступны
|
||||
для Вас согласно применимому патентному закону.
|
||||
|
||||
12. Не отказывать свободе других
|
||||
|
||||
Условия, наложенные на Вас (судебным приказом, соглашением или как-либо
|
||||
ещё), которые противоречат условиям Данной лицензии, не освобождают Вас
|
||||
от условий, наложенных Данной Лицензией. Если Вы не можете передавать
|
||||
лицензированное произведение так, чтобы удовлетворять одновременно Вашим
|
||||
обязательствам согласно Данной Лицензии и любым другим релевантным
|
||||
обязательствам, то Вы не должны распространять её вовсе. Например, если
|
||||
Вы согласны с условиями, обязывающими Вас собирать авторские отчисления с
|
||||
тех, кому Вы передаёте Программу, за право последующей передачи,
|
||||
единственный способ удовлетворить этим условиям и Данной Лицензии будет
|
||||
полное воздержание от передачи Программы.
|
||||
|
||||
13. Использование со Стандартной Общественной Лицензией редакции Афферо
|
||||
|
||||
Несмотря на любые другие положения настоящей Лицензии, Вы имеете
|
||||
разрешение подключать или совмещать любое лицензированное произведение с
|
||||
произведением, лицензированным согласно версии 3 Стандартной Общественной
|
||||
Лицензии редакции Афферо (Affero) в единое комбинированное произведение и
|
||||
передавать его. Условия Данной Лицензии продолжат применяться к той части
|
||||
произведения, которая изначально находилась под ней, но специальные
|
||||
требования главы 13 редакции Афферо, касающиеся взаимодействия через
|
||||
компьютерную сеть, будут применяться ко всему объединённому произведению.
|
||||
|
||||
14. Пересмотренные версии данной лицензии
|
||||
|
||||
Фонд Свободного Программного Обеспечения может публиковать
|
||||
пересмотренные и/или новые версии Стандартной Общественной Лицензии GNU
|
||||
время от времени. Такие пересмотренные версии будут схожи по духу
|
||||
нынешней версии, но могут отличаться в деталях, чтобы соответствовать
|
||||
новым проблемам.
|
||||
|
||||
Каждой версии выдаётся отличительный номер. Если Программа
|
||||
устанавливает, что конкретный номер версии GNU GPL "или любая более
|
||||
поздняя версия" применима к ней, Вы можете следовать условиям либо версии
|
||||
указанного номера, либо более поздних версий, опубликованных Фондом
|
||||
Свободного Программного Обеспечения. Если программа не указывает номер
|
||||
версии GNU GPL, Вы можете выбрать любую версию, когда либо опубликованную
|
||||
Фондом.
|
||||
|
||||
Если программа уточняет, что уполномоченный представитель может решать
|
||||
какая из будущих версий GNU GPL может быть использована, публичное
|
||||
заявление этого представителя о принятии версии на постоянной основе даёт
|
||||
Вам право выбрать эту версию для Программы.
|
||||
|
||||
Следующие версии лицензии могут давать Вам дополнительные или другие
|
||||
разрешения. Однако, никакие дополнительные обязательства не возлагаются
|
||||
на автора или правообладателя как результат Вашего выбора следующих
|
||||
версий.
|
||||
|
||||
15. Отказ от гарантий
|
||||
|
||||
НА ПРОГРАММУ НЕ РАСПРОСТРАНЯЮТСЯ НИКАКИЕ ГАРАНТИИ ДО РАМОК, ДОПУСТИМЫХ
|
||||
ПРИМЕНИМЫМ ЗАКОНОМ. ЕСЛИ ИНОЕ НЕ УСТАНОВЛЕНО В ПИСЬМЕННОЙ ФОРМЕ,
|
||||
ПРАВООБЛАДАТЕЛЬ И/ИЛИ ДРУГИЕ СТОРОНЫ ПРЕДОСТАВЛЯЮТ ПРОГРАММУ «КАК ЕСТЬ»,
|
||||
БЕЗ КАКИХ ЛИБО ГАРАНТИЙ (ЗАЯВЛЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ), ВКЛЮЧАЯ, НО НЕ
|
||||
ОГРАНИЧИВАЯСЬ, ПОДРАЗУМЕВАЕМЫМИ ГАРАНТИЯМИ ТОВАРНОГО СОСТОЯНИЯ ПРИ
|
||||
ПРОДАЖЕ И ГОДНОСТИ ДЛЯ ОПРЕДЕЛЁННОГО ПРИМЕНЕНИЯ. ВЕСЬ РИСК КАК В
|
||||
ОТНОШЕНИИ КАЧЕСТВА, ТАК И ПРОИЗВОДИТЕЛЬНОСТИ ПРОГРАММЫ ВЫ БЕРЁТЕ НА СЕБЯ.
|
||||
ЕСЛИ В ПРОГРАММЕ ОБНАРУЖЕН ДЕФЕКТ, ВЫ БЕРЁТЕ НА СЕБЯ СТОИМОСТЬ
|
||||
НЕОБХОДИМОГО ОБСЛУЖИВАНИЯ, ПОЧИНКИ ИЛИ ИСПРАВЛЕНИЯ.
|
||||
|
||||
16. Ограничение ответственности
|
||||
|
||||
НИ В КОЕМ СЛУЧАЕ, ЕСЛИ НЕ ТРЕБУЕТСЯ ПРИМЕНИМЫМ ЗАКОНОМ ИЛИ ПИСЬМЕННЫМ
|
||||
СОГЛАШЕНИЕМ, НИ ОДИН ИЗ ПРАВООБЛАДАТЕЛЕЙ ИЛИ СТОРОН, МОДИФИЦИРОВАВШИХ
|
||||
И/ИЛИ ПЕРЕДАВАВШИХ ПРОГРАММУ, КАК БЫЛО РАЗРЕШЕНО ВЫШЕ, НЕ ОТВЕТСТВЕНЕН ЗА
|
||||
УЩЕРБ, ВКЛЮЧАЯ ОБЩИЙ, КОНКРЕТНЫЙ, СЛУЧАЙНЫЙ ИЛИ ПОСЛЕДОВАВШИЙ УЩЕРБ,
|
||||
ВЫТЕКАЮЩИЙ ИЗ ИСПОЛЬЗОВАНИЯ ИЛИ НЕВОЗМОЖНОСТИ ИСПОЛЬЗОВАНИЯ ПРОГРАММЫ
|
||||
(ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ ПОТЕРЕЙ ДАННЫХ ИЛИ НЕВЕРНОЙ ОБРАБОТКОЙ
|
||||
ДАННЫХ, ИЛИ ПОТЕРИ, УСТАНОВЛЕННЫЕ ВАМИ ИЛИ ТРЕТЬИМИ ЛИЦАМИ, ИЛИ
|
||||
НЕВОЗМОЖНОСТЬ ПРОГРАММЫ РАБОТАТЬ С ДРУГИМИ ПРОГРАММАМИ), ДАЖЕ В СЛУЧАЕ
|
||||
ЕСЛИ ПРАВООБЛАДАТЕЛЬ ЛИБО ДРУГАЯ СТОРОНА БЫЛА ИЗВЕЩЕНА О ВОЗМОЖНОСТИ
|
||||
ТАКОГО УЩЕРБА.
|
||||
|
||||
17. Интерпретация глав 15 и 16
|
||||
|
||||
Если отказ от гарантии или ограничение ответственности представленные
|
||||
выше не могут быть исполнены согласно их условиям, рассматривающие суды
|
||||
должны применить местный закон, который наиболее приближен к абсолютному
|
||||
отказу от всей гражданской ответственности в связи с Программой, исключая
|
||||
случаи когда гарантия или принятие ответственности сопровождают копию
|
||||
Программы за плату.
|
||||
|
||||
КОНЕЦ УСЛОВИЙ
|
||||
|
||||
Как применить данные условия к Вашим новым программам
|
||||
|
||||
Если Вы разрабатываете новую программу и хотите чтобы она была
|
||||
максимально полезна общественности, лучший способ добиться желаемого -
|
||||
сделать программу свободным ПО, которое каждый сможет распространять и
|
||||
изменять согласно данным условиям.
|
||||
|
||||
Для этого укомплектуйте программу нижеследующими уведомлениями.
|
||||
Рекоммендуется присоединить их к началу каждого файла исходного кода для
|
||||
наиболее эффективного указания отсутствия гарантий. Каждый файл должен
|
||||
также содержать, по крайней мере, строку авторских прав и указатель на
|
||||
нахождение полного списка уведомлений.
|
||||
|
||||
<название программы и краткое описание того, что она делает>
|
||||
Copyright (C) <год> <имя автора>
|
||||
|
||||
Данная программа является свободным программным обеспечением: Вы
|
||||
можете распространять и/или модифицировать её согласно условиям
|
||||
Стандартной Общественной Лицензии GNU, опубликованной Фондом
|
||||
Свободного Программного Обеспечения, версии 3 или, по Вашему
|
||||
усмотрению, любой более поздней версии.
|
||||
|
||||
Эта программа распространяется в надежде, что она будет полезной, но
|
||||
БЕЗ ВСЯКИХ ГАРАНТИЙ, в том числе подразумеваемых гарантий ТОВАРНОГО
|
||||
СОСТОЯНИЯ ПРИ ПРОДАЖЕ и ГОДНОСТИ ДЛЯ ОПРЕДЕЛЁННОГО ПРИМЕНЕНИЯ.
|
||||
Смотрите Стандартную Общественную Лицензию GNU для получения
|
||||
дополнительной информации.
|
||||
|
||||
Вы должны были получить копию Стандартной Общественной Лицензии GNU
|
||||
вместе с программой. В случае её отсутствия, посмотрите
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
Также добавьте информацию о том, как можно связаться с вами по
|
||||
электронной и обычной почте.
|
||||
|
||||
Если программа взаимодействует с пользователем при помощи терминала,
|
||||
сделайте так, чтобы она выводила краткое сообщение наподобие
|
||||
нижеследующего при запуске в интерактивном режиме:
|
||||
|
||||
<название программы> Copyright (C) <год> <имя автора>
|
||||
Данная программа распространяется БЕЗ ВСЯКИХ ГАРАНТИЙ; для получения
|
||||
дополнительной информации наберите 'show warranty'.
|
||||
Это свободное программное обеспечение: распространяйте его свободно в
|
||||
соответствии с определёнными условиями; для получения дополнительной
|
||||
информации наберите 'show copying'.
|
||||
|
||||
Гипотетические команды 'show warranty', 'show copying' могут показывать
|
||||
соответствующие части Стандартной Общественной Лицензии. Конечно, команды
|
||||
Вашей программы могут быть другими; в случае графического интерфейса
|
||||
пользователя, Вы можете использовать диалоговое окно "О программе".
|
||||
|
||||
Также, в случае необходимости, Вам следует получить от Вашего
|
||||
работодателя (если Вы работаете программистом) или учебного заведения
|
||||
(если учитесь) письменный отказ от авторских прав на программу. Для
|
||||
дополнительной информации об этом, а также о применении и исполнении
|
||||
условий GNU GPL, смотрите <http://www.gnu.org/licenses/>.
|
||||
|
||||
Стандартная Общественная Лицензия GNU не разрешает включение Вашей
|
||||
программы в собственническое ПО. Если Вы хотите этого, используйте Малую
|
||||
Стандартную Общественную Лицензию GNU (GNU Lesser General Public License,
|
||||
GNU LGPL) вместо этой лицензии, но, пожалуйста, прочитайте сначала
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
# Индекс метаданных и модулей конфигураций 1С
|
||||
|
||||
**Версия:** см. [`VERSION`](VERSION) (текущая: **0.2.0**) · [CHANGELOG](CHANGELOG.md)
|
||||
**Версия:** см. [`VERSION`](VERSION) (текущая: **0.3.4**) · [CHANGELOG](CHANGELOG.md)
|
||||
**Автор:** Michael BAG · [mk@p7net.ru](mailto:mk@p7net.ru)
|
||||
**Лицензия:** [GNU GPL v3](LICENSE) · [русский перевод (справочно)](LICENSE.ru)
|
||||
|
||||
Единый кэш проекта: **`cache/1c_meta/index.sqlite`** — все выгрузки 1С в одной БД (SQLite FTS5).
|
||||
|
||||
@@ -9,29 +11,27 @@
|
||||
| [`index_1c.py`](index_1c.py) | построение и обновление индекса |
|
||||
| [`query_1c.py`](query_1c.py) | поиск и просмотр по готовому индексу |
|
||||
|
||||
Репозиторий утилиты: <https://git.p7net.ru/1c/index.git>
|
||||
Правило для Cursor (в корне CRM3-26): `.cursor/rules/1c-meta-index.mdc`
|
||||
|
||||
```bash
|
||||
python tools/index/index_1c.py --version
|
||||
python tools/index/query_1c.py --version
|
||||
python index_1c.py --version
|
||||
python query_1c.py --version
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Зачем это нужно
|
||||
|
||||
Обход десятков тысяч XML/BSL в `crm3-26/src` и соседних выгрузках через Grep в Cursor медленный. Индекс один раз разбирает метаданные и модули и даёт:
|
||||
Обход десятков тысяч XML/BSL в `<выгрузка>/src` через Grep в IDE медленный. Индекс один раз разбирает метаданные и модули и даёт:
|
||||
|
||||
| Задача | Команда |
|
||||
|--------|---------|
|
||||
| Найти объект по имени/синониму | `query_1c.py search` / `object` |
|
||||
| Структура реквизитов, обязательность, типы | `query_1c.py object` |
|
||||
| Кто ссылается на справочник/документ | `query_1c.py refs` |
|
||||
| Документ ↔ регистры движений | `query_1c.py movements` |
|
||||
| Найти процедуру/фрагмент в BSL | `query_1c.py modules` |
|
||||
| Сравнить целевую и исходную конфигурацию | `-b target` / `-b source` |
|
||||
| Сравнить несколько выгрузок в одном репозитории | `-b cfg1 -b cfg2` |
|
||||
|
||||
**Типичный workflow агента:**
|
||||
**Типичный workflow:**
|
||||
`reindex` (после выгрузки) → `object` / `search` → `refs` / `modules` → открыть конкретный `.xml` / `.bsl`.
|
||||
|
||||
---
|
||||
@@ -40,22 +40,33 @@ python tools/index/query_1c.py --version
|
||||
|
||||
| Параметр | Короткий | Назначение |
|
||||
|----------|----------|------------|
|
||||
| `--config` | `-c` | Файл **настроек утилиты** (JSON). **Не** конфигурация 1С. См. [`config.example.json`](config.example.json). |
|
||||
| `--root` | `-r` | Корень проекта CRM3-26 (если запуск не из дерева проекта). |
|
||||
| `--baseconf` | `-b` | Выгрузка конфигурации 1С: папка `<name>/src/` в репозитории. Можно несколько раз. |
|
||||
| `--config` | `-c` | Файл **настроек утилиты** (YAML). **Не** конфигурация 1С. См. [`config.example.yml`](config.example.yml). |
|
||||
| `--root` | `-r` | Корень проекта с выгрузками 1С (если запуск не из дерева проекта). |
|
||||
| `--baseconf` | `-b` | Источник индексации: `<name>/src/` или virtual внешняя обработка `<dir>.<ИмяОбработки>`. Можно несколько раз. |
|
||||
| `--version` | | Версия утилиты. |
|
||||
|
||||
Приоритет корня проекта: `--root` > `project_root` в `--config` > авто из расположения `tools/index/`.
|
||||
Приоритет корня проекта: `--root` > `project_root` в `--config` > авто (каталог с `index_1c.py` и `VERSION`).
|
||||
Если `--config` не указан, утилита пытается автоматически найти
|
||||
`config.local.yml`, `config.local.yaml` или `config.local.json`.
|
||||
|
||||
### Алиасы `--baseconf`
|
||||
|
||||
| Алиас | Папка |
|
||||
|-------|-------|
|
||||
| `target`, `crm3_26` | `crm3-26` |
|
||||
| `source`, `crm3_old`, `crm3-old`, `crm3_dev` | `crm3-dev` |
|
||||
Краткие имена задаются в файле `--config`, поле **`baseconf_aliases`**:
|
||||
|
||||
Другие выгрузки без алиаса: `crm3-26.rhana`, `crm3-dev.rhana`, `ws-rhana`, `bu-corp`, …
|
||||
Полный список: `python tools/index/index_1c.py list`
|
||||
```yaml
|
||||
project_root: "/path/to/project"
|
||||
baseconf_aliases:
|
||||
main: "my-config"
|
||||
ext: "my-config.ext"
|
||||
```
|
||||
|
||||
После этого `-b main` эквивалентно `-b my-config`.
|
||||
|
||||
Если в YAML задан блок `default_baseconfs`, то `reindex` без `-b` использует этот список.
|
||||
Если блока нет — `reindex` без `-b` индексирует **все** каталоги с `src/` и найденные внешние обработки.
|
||||
`query_1c.py` без `-b` ищет по **всем** конфигурациям в индексе.
|
||||
|
||||
Список выгрузок: `python index_1c.py list`
|
||||
|
||||
---
|
||||
|
||||
@@ -67,7 +78,7 @@ python tools/index/query_1c.py --version
|
||||
|---------|----------|
|
||||
| `reindex` | обновить индекс |
|
||||
| `status` | размер БД, meta, список проиндексированных baseconf |
|
||||
| `list` | выгрузки с `src/` в репозитории + что уже в индексе |
|
||||
| `list` | источники индексации в репозитории + что уже в индексе |
|
||||
|
||||
### Режимы `reindex`
|
||||
|
||||
@@ -75,34 +86,39 @@ python tools/index/query_1c.py --version
|
||||
|-------|-----------|
|
||||
| `reindex -j 12` | инкремент: только файлы с изменившимися `mtime`/`size` |
|
||||
| `reindex --full -j 12` | удалить всю БД и собрать заново все известные выгрузки |
|
||||
| `reindex --full -b crm3-26` | пересобрать только указанную конфигурацию |
|
||||
| `reindex -b target -t Documents,Catalogs` | только выбранные типы объектов |
|
||||
| `reindex -b ws-rhana --no-modules` | метаданные без BSL |
|
||||
| `reindex --full -b my-config` | пересобрать только указанную конфигурацию |
|
||||
| `reindex -b main -t Documents,Catalogs` | только выбранные типы объектов |
|
||||
| `reindex -b my-config --no-modules` | метаданные без BSL |
|
||||
| `reindex --md` | дополнительно Markdown в `cache/1c_meta/md/<baseconf>/` |
|
||||
|
||||
`-j` / `--workers` — число потоков (по умолчанию 4–16).
|
||||
|
||||
### Что индексируется
|
||||
|
||||
- **Метаданные** `src/<Тип>/*.xml`: имя, синоним, комментарий, реквизиты / измерения / ресурсы / ТЧ, типы (в т.ч. `TypeSet`), ссылки, `FillChecking`.
|
||||
- **Метаданные конфигураций/расширений** `src/<Тип>/*.xml`: имя, синоним, комментарий, реквизиты / измерения / ресурсы / ТЧ, типы (в т.ч. `TypeSet`), ссылки, `FillChecking`, `RegisterRecords` (документ → регистры движений).
|
||||
- **Метаданные внешних обработок**: `<dir>/<ИмяОбработки>.xml` (как `ExternalDataProcessor`).
|
||||
- **Модули** `**/*.bsl`: путь, owner (`Document.X`), вид модуля, имена процедур/функций, тело (до 200 КБ в FTS).
|
||||
- **Связи движений** — таблица `register_records` (обратный индекс регистраторов).
|
||||
|
||||
По умолчанию пропускаются: `CommonPicture`, `StyleItem`, `XDTOPackage`, `CommonTemplate`, `Language`, `Bot`.
|
||||
|
||||
### Примеры переиндексации
|
||||
|
||||
```bash
|
||||
# после обновления выгрузки целевой конфигурации
|
||||
python tools/index/index_1c.py reindex -b target -j 12
|
||||
# после обновления одной выгрузки
|
||||
python index_1c.py reindex -b my-config -j 12
|
||||
|
||||
# полная пересборка всего проекта
|
||||
python tools/index/index_1c.py reindex --full -j 12
|
||||
python index_1c.py reindex --full -j 12
|
||||
|
||||
# только документы и справочники исходной + расширения
|
||||
python tools/index/index_1c.py reindex -b source -b crm3-dev.rhana -t Documents,Catalogs -j 8
|
||||
# основная конфигурация + расширение, только документы и справочники
|
||||
python index_1c.py reindex -b main -b ext -t Documents,Catalogs -j 8
|
||||
|
||||
python tools/index/index_1c.py status
|
||||
python tools/index/index_1c.py list
|
||||
# внешние обработки: развернуть папку в virtual baseconf
|
||||
python index_1c.py reindex -b my-transfer.ext -j 8
|
||||
|
||||
python index_1c.py status
|
||||
python index_1c.py list
|
||||
```
|
||||
|
||||
---
|
||||
@@ -115,10 +131,11 @@ python tools/index/index_1c.py list
|
||||
|
||||
| Команда | Аргумент | Результат | Полезные опции |
|
||||
|---------|----------|-----------|----------------|
|
||||
| `search` | строка | объекты метаданных (FTS) | `-b`, `--type`, `--limit` |
|
||||
| `search` | строка | объекты метаданных (FTS); при совпадении по реквизиту — дерево найденного поля | `-b`, `--type`, `--limit` |
|
||||
| `object` | имя/синоним объекта **или** реквизита | дерево структуры | `-b`, `--type`, `--clear`, `--limit` |
|
||||
| `show` | имя объекта | полная карточка JSON | `-b` |
|
||||
| `refs` | `Catalog.Партнеры` / `ЗаказКлиента` | обратные ссылки полей | `-b`, `--limit` (на каждую baseconf) |
|
||||
| `refs` | `Catalog.Customers` / `Contract` | обратные ссылки полей | `-b`, `--limit` (на каждую baseconf) |
|
||||
| `movements` | документ или регистр | регистратор ↔ регистры движений | `-b`, `--type`, `--limit` |
|
||||
| `modules` | строка | поиск по BSL | `-b`, `-n` / `--names-only`, `--limit` |
|
||||
| `module` | путь или owner | символы модуля, строки | `-b` |
|
||||
|
||||
@@ -126,22 +143,22 @@ python tools/index/index_1c.py list
|
||||
|
||||
```bash
|
||||
# полная структура документа
|
||||
python tools/index/query_1c.py object ЗаказКлиента -b target
|
||||
python query_1c.py object Contract -b my-config
|
||||
|
||||
# только реквизиты с именем/синонимом «Партнер» в документах
|
||||
python tools/index/query_1c.py object Партнер -b target --type Document --clear
|
||||
# только реквизиты с именем/синонимом «Partner» в документах
|
||||
python query_1c.py object Partner -b my-config --type Document --clear
|
||||
|
||||
# совпал сам объект → --clear печатает только заголовок
|
||||
python tools/index/query_1c.py object ЗаказКлиента -b target --clear
|
||||
python query_1c.py object Contract -b my-config --clear
|
||||
```
|
||||
|
||||
Формат строки реквизита:
|
||||
|
||||
```text
|
||||
├── `Attribute.Партнер` — Клиент [обяз.] : CatalogRef.Партнеры
|
||||
├── `Attribute.СуммаДокумента` — … [необяз.] : DefinedType.ДенежнаяСуммаЛюбогоЗнака
|
||||
├── `TabularSection.Товары` — Товары
|
||||
│ └── `Column.Номенклатура` — … [обяз.] : CatalogRef.Номенклатура
|
||||
├── `Attribute.Partner` — Клиент [обяз.] : CatalogRef.Customers
|
||||
├── `Attribute.Amount` — … [необяз.] : DefinedType.MoneyAmount
|
||||
├── `TabularSection.Lines` — Строки
|
||||
│ └── `Column.Item` — … [обяз.] : CatalogRef.Items
|
||||
```
|
||||
|
||||
- **[обяз.]** — `FillChecking=ShowError`; **[необяз.]** — `DontCheck`
|
||||
@@ -151,29 +168,44 @@ python tools/index/query_1c.py object ЗаказКлиента -b target --clear
|
||||
### `refs` — кто ссылается
|
||||
|
||||
```bash
|
||||
python tools/index/query_1c.py refs "ЗаказКлиента"
|
||||
python tools/index/query_1c.py refs Catalog.Партнеры -b target --limit 50
|
||||
python tools/index/query_1c.py refs Document.ЗаказКлиента -b source
|
||||
python query_1c.py refs "Contract"
|
||||
python query_1c.py refs Catalog.Customers -b my-config --limit 50
|
||||
python query_1c.py refs Document.Contract -b main
|
||||
```
|
||||
|
||||
Без `-b` — все конфигурации в индексе; `--limit` действует **на каждую**.
|
||||
Составной тип поля: `→ DocumentRef.ЗаказКлиента (среди прочего: DocumentRef.…)`.
|
||||
Составной тип поля: `→ DocumentRef.Contract (среди прочего: DocumentRef.…)`.
|
||||
|
||||
### `movements` — регистратор ↔ регистры движений
|
||||
|
||||
```bash
|
||||
# документ → регистры, в которых он регистратор
|
||||
python query_1c.py movements Contract -b my-config
|
||||
python query_1c.py movements Document.Sales -b my-config
|
||||
|
||||
# регистр → документы-регистраторы
|
||||
python query_1c.py movements AccumulationRegister.Stock -b my-config
|
||||
python query_1c.py movements Stock -b my-config --type AccumulationRegister
|
||||
```
|
||||
|
||||
Данные из свойства метаданных `RegisterRecords` (таблица `register_records` в индексе).
|
||||
При первом запуске утилиты v0.3+ схема индекса мигрирует 2→3 автоматически (без полного `reindex`).
|
||||
|
||||
### `modules` / `module`
|
||||
|
||||
```bash
|
||||
python tools/index/query_1c.py modules "ОбработатьHealth" -b ws-rhana
|
||||
python tools/index/query_1c.py modules "РВС_Transfer" -b ws-rhana -n
|
||||
python tools/index/query_1c.py module CommonModules/РВС_TransferAPIДокументы -b ws-rhana
|
||||
python query_1c.py modules "ProcessData" -b my-config
|
||||
python query_1c.py modules "MyModule" -b my-config.ext -n
|
||||
python query_1c.py module CommonModules/MyModule -b my-config
|
||||
```
|
||||
|
||||
### Прочие примеры
|
||||
|
||||
```bash
|
||||
python tools/index/query_1c.py search "ЗаказКлиента"
|
||||
python tools/index/query_1c.py search "Партнер" --type Document -b crm3-26
|
||||
python tools/index/query_1c.py show Document.ЗаказКлиента -b target
|
||||
python tools/index/query_1c.py search "Партнер" -b source -b crm3-dev.rhana
|
||||
python query_1c.py search "Contract"
|
||||
python query_1c.py search "Partner" --type Document -b my-config
|
||||
python query_1c.py show Document.Contract -b main
|
||||
python query_1c.py search "Partner" -b main -b ext
|
||||
```
|
||||
|
||||
### Ошибки и подсказки
|
||||
@@ -181,7 +213,7 @@ python tools/index/query_1c.py search "Партнер" -b source -b crm3-dev.rha
|
||||
| Ситуация | Поведение |
|
||||
|----------|-----------|
|
||||
| Нет `index.sqlite` | подсказка `index_1c.py reindex --full` |
|
||||
| `-b` без папки `src/` | список доступных выгрузок + алиасы |
|
||||
| `-b` без папки `src/` | список доступных выгрузок |
|
||||
| `-b` есть в репо, нет в индексе | список проиндексированных + команда `reindex -b …` |
|
||||
| `show` / `object` не нашли | похожие имена из индекса |
|
||||
|
||||
@@ -190,29 +222,29 @@ python tools/index/query_1c.py search "Партнер" -b source -b crm3-dev.rha
|
||||
## Файл настроек утилиты (`--config`)
|
||||
|
||||
```bash
|
||||
cp tools/index/config.example.json tools/index/config.local.json
|
||||
# project_root: "/path/to/crm3-26"
|
||||
python tools/index/query_1c.py --config tools/index/config.local.json search "Заказ"
|
||||
cp config.example.yml config.local.yml
|
||||
# project_root: "/path/to/project"
|
||||
python query_1c.py --config config.local.yml search "Contract"
|
||||
```
|
||||
|
||||
`config.local.json` в `.gitignore` (локальные пути).
|
||||
`config.local.yml` в `.gitignore` (локальные пути и алиасы).
|
||||
Legacy-вариант `config.local.json` тоже поддерживается и подхватывается авто-поиском.
|
||||
|
||||
---
|
||||
|
||||
## Применение в Cursor
|
||||
## Применение в Cursor / IDE
|
||||
|
||||
1. После выгрузки из EDT/конфигуратора: `python tools/index/index_1c.py reindex -j 12` (или `-b target`).
|
||||
1. После выгрузки из EDT/конфигуратора: `python index_1c.py reindex -j 12` (или `-b my-config`).
|
||||
2. Метаданные и связи — через `query_1c.py`, не Grep по всему `src/`.
|
||||
3. Разделять контекст: `-b target` vs `-b source`.
|
||||
3. При нескольких выгрузках — ограничивать `-b` нужной baseconf.
|
||||
4. Код: `modules` → открыть `rel_path`; структура документа: `object`.
|
||||
5. Правило агента: `.cursor/rules/1c-meta-index.mdc`.
|
||||
|
||||
---
|
||||
|
||||
## Артефакты кэша
|
||||
|
||||
```text
|
||||
cache/1c_meta/ # в корне проекта CRM3-26 (gitignore)
|
||||
cache/1c_meta/ # в корне проекта (обычно в .gitignore)
|
||||
index.sqlite # единая БД
|
||||
INDEX.md
|
||||
manifest.json
|
||||
@@ -220,3 +252,34 @@ cache/1c_meta/ # в корне проекта CRM3-26 (gitignore)
|
||||
```
|
||||
|
||||
Per-config `search.sqlite` устарели и не используются.
|
||||
|
||||
---
|
||||
|
||||
## Автор и обратная связь
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Автор** | Michael BAG |
|
||||
| **E-mail** | [mk@p7net.ru](mailto:mk@p7net.ru) |
|
||||
| **Предложения, вопросы, ошибки** | пишите на **mk@p7net.ru** |
|
||||
|
||||
---
|
||||
|
||||
## Лицензирование
|
||||
|
||||
Программа **index_1c.py**, **query_1c.py** и пакет **index1c/** распространяются на условиях
|
||||
**GNU General Public License версии 3** (или более поздней).
|
||||
|
||||
| Файл | Язык | Статус |
|
||||
|------|------|--------|
|
||||
| [`LICENSE`](LICENSE) | английский | **юридически значимый** текст лицензии (FSF) |
|
||||
| [`LICENSE.ru`](LICENSE.ru) | русский | **неофициальный перевод** для ознакомления |
|
||||
|
||||
Юридическую силу имеет только английский текст [`LICENSE`](LICENSE).
|
||||
Русский перевод [`LICENSE.ru`](LICENSE.ru) не опубликован FSF и не заменяет оригинал;
|
||||
он помогает русскоязычным пользователям понять условия GPL v3.
|
||||
|
||||
**Copyright © 2025–2026 Michael BAG** \<mk@p7net.ru\>
|
||||
|
||||
При распространении или модификации сохраняйте уведомление об авторских правах и текст лицензии.
|
||||
Производные работы должны распространяться на тех же условиях GPL v3.
|
||||
|
||||
@@ -1,4 +0,0 @@
|
||||
{
|
||||
"project_root": "/path/to/crm3-26",
|
||||
"comment": "Файл настроек утилиты tools/index (НЕ конфигурация 1С). Копируйте в config.local.json и укажите --config config.local.json"
|
||||
}
|
||||
@@ -0,0 +1,24 @@
|
||||
# Пример локальной конфигурации tools/index.
|
||||
# Скопируйте в config.local.yml и передавайте:
|
||||
# python index_1c.py --config config.local.yml reindex
|
||||
# python query_1c.py --config config.local.yml search "..."
|
||||
#
|
||||
# ВАЖНО:
|
||||
# - Это файл настроек утилиты, НЕ конфигурация 1С.
|
||||
# - Файл обычно не коммитят (локальные пути/алиасы).
|
||||
|
||||
# Корень проекта, в котором лежат выгрузки (<name>/src/).
|
||||
project_root: "/path/to/project"
|
||||
|
||||
# Короткие алиасы для --baseconf.
|
||||
# Пример: -b main эквивалентно -b my-config
|
||||
baseconf_aliases:
|
||||
main: "my-config"
|
||||
ext: "my-config.ext"
|
||||
|
||||
# Необязательный whitelist baseconf для reindex без -b.
|
||||
# Если блок задан, то reindex (без -b) возьмет ТОЛЬКО эти конфигурации.
|
||||
# Если блока нет — работает автосканирование всех <name>/src/ в project_root.
|
||||
default_baseconfs:
|
||||
- main
|
||||
- ext
|
||||
+4
-1
@@ -2,8 +2,11 @@
|
||||
|
||||
from pathlib import Path
|
||||
|
||||
__version__ = "0.2.0"
|
||||
__version__ = "0.3.2"
|
||||
__status__ = "in development"
|
||||
__author__ = "Michael BAG"
|
||||
__email__ = "mk@p7net.ru"
|
||||
__license__ = "GPL-3.0-or-later"
|
||||
|
||||
|
||||
def read_version_file() -> str:
|
||||
|
||||
+13
-2
@@ -172,7 +172,13 @@ def _index_one_config(
|
||||
existing = dbmod.get_file_index(conn, cfg.name) if not full else {}
|
||||
seen_paths: set[str] = set()
|
||||
|
||||
meta_files = iter_object_xml_files(cfg.src, types=types, skip_types=skip_types)
|
||||
meta_files = iter_object_xml_files(
|
||||
cfg.src,
|
||||
types=types,
|
||||
skip_types=skip_types,
|
||||
source_kind=cfg.source_kind,
|
||||
external_name=cfg.external_name,
|
||||
)
|
||||
meta_jobs: list[tuple[str, str, str]] = []
|
||||
meta_skipped = 0
|
||||
for otype, path in meta_files:
|
||||
@@ -222,7 +228,12 @@ def _index_one_config(
|
||||
mod_skipped = 0
|
||||
if index_modules:
|
||||
mod_jobs: list[tuple[str, str, str]] = []
|
||||
for path in iter_bsl_files(cfg.src):
|
||||
bsl_paths = (
|
||||
sorted((cfg.src / cfg.external_name).rglob("*.bsl"))
|
||||
if cfg.source_kind == "external_processor" and cfg.external_name
|
||||
else iter_bsl_files(cfg.src)
|
||||
)
|
||||
for path in bsl_paths:
|
||||
rel = path.relative_to(cfg.src).as_posix()
|
||||
seen_paths.add(rel)
|
||||
mtime_ns, size = _file_stamp(path)
|
||||
|
||||
+157
-23
@@ -3,7 +3,6 @@
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import sys
|
||||
from pathlib import Path
|
||||
from typing import Any
|
||||
@@ -21,25 +20,89 @@ class BaseconfError(Exception):
|
||||
|
||||
|
||||
def load_tool_config(path: Path) -> dict[str, Any]:
|
||||
"""Файл настроек утилиты index (JSON). Не путать с конфигурацией 1С."""
|
||||
"""Файл настроек утилиты index (YAML; legacy JSON поддерживается)."""
|
||||
ext = path.suffix.lower()
|
||||
try:
|
||||
data = json.loads(path.read_text(encoding="utf-8"))
|
||||
raw = path.read_text(encoding="utf-8")
|
||||
except OSError as e:
|
||||
raise BaseconfError(f"Не удалось прочитать --config {path}: {e}", exit_code=1) from e
|
||||
except json.JSONDecodeError as e:
|
||||
raise BaseconfError(f"Некорректный JSON в --config {path}: {e}", exit_code=1) from e
|
||||
|
||||
if ext == ".json":
|
||||
try:
|
||||
import json
|
||||
|
||||
data = json.loads(raw)
|
||||
except Exception as e:
|
||||
raise BaseconfError(f"Некорректный JSON в --config {path}: {e}", exit_code=1) from e
|
||||
if not isinstance(data, dict):
|
||||
raise BaseconfError(f"--config {path}: ожидается JSON-объект", exit_code=1)
|
||||
return data
|
||||
|
||||
try:
|
||||
import yaml # type: ignore
|
||||
except Exception as e:
|
||||
raise BaseconfError(
|
||||
"Для чтения --config в формате YAML нужен пакет pyyaml: pip install pyyaml",
|
||||
exit_code=1,
|
||||
) from e
|
||||
try:
|
||||
data = yaml.safe_load(raw)
|
||||
except Exception as e:
|
||||
raise BaseconfError(f"Некорректный YAML в --config {path}: {e}", exit_code=1) from e
|
||||
if not isinstance(data, dict):
|
||||
raise BaseconfError(f"--config {path}: ожидается JSON-объект", exit_code=1)
|
||||
raise BaseconfError(f"--config {path}: ожидается YAML-объект", exit_code=1)
|
||||
return data
|
||||
|
||||
|
||||
def discover_local_tool_config() -> Path | None:
|
||||
"""Автопоиск локального конфига без --config."""
|
||||
candidates = ("config.local.yml", "config.local.yaml", "config.local.json")
|
||||
roots = [Path.cwd(), project_root_from_here()]
|
||||
seen: set[Path] = set()
|
||||
for root in roots:
|
||||
for rel in (Path("tools/index"), Path(".")):
|
||||
base = (root / rel).resolve()
|
||||
if base in seen or not base.is_dir():
|
||||
continue
|
||||
seen.add(base)
|
||||
for name in candidates:
|
||||
p = base / name
|
||||
if p.is_file():
|
||||
return p
|
||||
return None
|
||||
|
||||
|
||||
def apply_tool_config(data: dict[str, Any]) -> None:
|
||||
"""Применить настройки из YAML (--config): алиасы и дефолтные baseconf."""
|
||||
from .config import set_config_aliases, set_default_baseconfs
|
||||
|
||||
aliases = data.get("baseconf_aliases")
|
||||
if aliases is not None:
|
||||
if not isinstance(aliases, dict):
|
||||
raise BaseconfError("--config: baseconf_aliases должен быть объектом YAML")
|
||||
set_config_aliases({str(k): str(v) for k, v in aliases.items()})
|
||||
default_baseconfs = data.get("default_baseconfs")
|
||||
if default_baseconfs is not None:
|
||||
if not isinstance(default_baseconfs, list):
|
||||
raise BaseconfError("--config: default_baseconfs должен быть YAML-списком")
|
||||
set_default_baseconfs([str(x) for x in default_baseconfs])
|
||||
else:
|
||||
set_default_baseconfs([])
|
||||
|
||||
|
||||
def resolve_project_root(args: argparse.Namespace) -> Path:
|
||||
"""Корень проекта: --root → project_root из --config → авто."""
|
||||
"""Корень проекта: --root → --config/auto-config → авто."""
|
||||
if getattr(args, "root", None):
|
||||
return Path(args.root).resolve()
|
||||
cfg_path = getattr(args, "config", None)
|
||||
if not cfg_path:
|
||||
auto = discover_local_tool_config()
|
||||
if auto is not None:
|
||||
cfg_path = str(auto)
|
||||
setattr(args, "config", cfg_path)
|
||||
if cfg_path:
|
||||
data = load_tool_config(Path(cfg_path))
|
||||
apply_tool_config(data)
|
||||
pr = data.get("project_root")
|
||||
if pr:
|
||||
return Path(pr).resolve()
|
||||
@@ -52,18 +115,32 @@ def add_tool_args(parser: argparse.ArgumentParser) -> None:
|
||||
"--config",
|
||||
"-c",
|
||||
metavar="FILE",
|
||||
help="JSON с настройками утилиты (project_root и др.), см. config.example.json",
|
||||
help=(
|
||||
"YAML с настройками утилиты (project_root и др.), см. config.example.yml. "
|
||||
"Без параметра: автопоиск config.local.yml/.yaml/.json"
|
||||
),
|
||||
)
|
||||
parser.add_argument(
|
||||
"--root",
|
||||
"-r",
|
||||
metavar="DIR",
|
||||
help="Корень проекта CRM3-26 (перекрывает project_root из --config)",
|
||||
help="Корень проекта с выгрузками 1С (перекрывает project_root из --config)",
|
||||
)
|
||||
|
||||
|
||||
def add_baseconf_args(parser: argparse.ArgumentParser) -> None:
|
||||
def add_baseconf_args(
|
||||
parser: argparse.ArgumentParser,
|
||||
*,
|
||||
mode: str = "query",
|
||||
) -> None:
|
||||
"""Фильтр по выгрузке конфигурации 1С в репозитории."""
|
||||
if mode == "index":
|
||||
default_hint = (
|
||||
"Без параметра — default_baseconfs из --config; "
|
||||
"если блок не задан, индексировать все выгрузки с src/ и внешние обработки."
|
||||
)
|
||||
else:
|
||||
default_hint = "Без параметра — поиск по всем проиндексированным."
|
||||
parser.add_argument(
|
||||
"--baseconf",
|
||||
"-b",
|
||||
@@ -71,13 +148,66 @@ def add_baseconf_args(parser: argparse.ArgumentParser) -> None:
|
||||
metavar="NAME",
|
||||
dest="baseconf",
|
||||
help=(
|
||||
"Конфигурация 1С в репозитории (папка <name>/src/). "
|
||||
"Можно несколько раз. Алиасы: target→crm3-26, source→crm3-dev. "
|
||||
"Без параметра — поиск по всем проиндексированным."
|
||||
"Источник индексации 1С: <name>/src/ или virtual <dir>.<Обработка>. "
|
||||
"Можно несколько раз или через запятую: -b cfg1,cfg2. "
|
||||
"Краткие имена (алиасы) — в baseconf_aliases файла --config. "
|
||||
f"{default_hint}"
|
||||
),
|
||||
)
|
||||
|
||||
|
||||
def make_parent_parser(*, include_baseconf: bool = True, baseconf_mode: str = "query") -> argparse.ArgumentParser:
|
||||
"""Общие опции для подкоманд (--config, --root, опционально --baseconf)."""
|
||||
p = argparse.ArgumentParser(add_help=False)
|
||||
add_tool_args(p)
|
||||
if include_baseconf:
|
||||
add_baseconf_args(p, mode=baseconf_mode)
|
||||
return p
|
||||
|
||||
|
||||
def extract_baseconf_argv(argv: list[str]) -> tuple[list[str], list[str]]:
|
||||
"""
|
||||
Извлечь все -b / --baseconf из argv (до или после подкоманды).
|
||||
Возвращает (значения baseconf, argv без этих аргументов).
|
||||
"""
|
||||
baseconfs: list[str] = []
|
||||
rest: list[str] = []
|
||||
i = 0
|
||||
while i < len(argv):
|
||||
tok = argv[i]
|
||||
if tok in ("-b", "--baseconf"):
|
||||
if i + 1 >= len(argv):
|
||||
rest.append(tok)
|
||||
break
|
||||
baseconfs.append(argv[i + 1])
|
||||
i += 2
|
||||
continue
|
||||
if tok.startswith("--baseconf="):
|
||||
baseconfs.append(tok.split("=", 1)[1])
|
||||
i += 1
|
||||
continue
|
||||
if tok.startswith("-b") and len(tok) > 2:
|
||||
baseconfs.append(tok[2:])
|
||||
i += 1
|
||||
continue
|
||||
rest.append(tok)
|
||||
i += 1
|
||||
return baseconfs, rest
|
||||
|
||||
|
||||
def merge_baseconf_args(args: argparse.Namespace, extra: list[str] | None) -> None:
|
||||
"""Объединить baseconf из argv и argparse (in-place)."""
|
||||
if not extra:
|
||||
return
|
||||
current = list(getattr(args, "baseconf", None) or [])
|
||||
seen = set(current)
|
||||
for item in extra:
|
||||
if item not in seen:
|
||||
seen.add(item)
|
||||
current.append(item)
|
||||
args.baseconf = current or None
|
||||
|
||||
|
||||
def resolve_baseconf_names(raw: list[str] | None) -> list[str]:
|
||||
"""Разрешить алиасы имён конфигураций 1С (без проверки индекса)."""
|
||||
if not raw:
|
||||
@@ -104,34 +234,38 @@ def validate_baseconfs(
|
||||
require_indexed: bool = True,
|
||||
) -> list[str]:
|
||||
"""
|
||||
Проверить --baseconf: папка src/, наличие в индексе.
|
||||
Проверить --baseconf: src-выгрузка или virtual внешняя обработка, наличие в индексе.
|
||||
Возвращает канонические имена. Иначе BaseconfError с подсказками.
|
||||
"""
|
||||
if not names:
|
||||
return []
|
||||
|
||||
resolved = resolve_baseconf_names(names)
|
||||
available = {c.name for c in discover_configs(project_root, None)}
|
||||
missing_src: list[str] = []
|
||||
for name in resolved:
|
||||
if not (project_root / name / "src").is_dir():
|
||||
if discover_configs(project_root, [name]):
|
||||
continue
|
||||
if name not in available:
|
||||
missing_src.append(name)
|
||||
|
||||
if missing_src:
|
||||
available = [c.name for c in discover_configs(project_root, None)]
|
||||
available_list = sorted(available)
|
||||
lines = [
|
||||
"Конфигурация 1С не найдена в репозитории (нет каталога <name>/src/):",
|
||||
"Источник индексации 1С не найден в репозитории "
|
||||
"(нет <name>/src/ или внешней обработки <dir>/<name>.xml + <dir>/<name>/):",
|
||||
*(f" - {n}" for n in missing_src),
|
||||
"",
|
||||
"Доступные выгрузки в проекте:",
|
||||
]
|
||||
if available:
|
||||
lines.extend(f" - {n}" for n in available)
|
||||
if available_list:
|
||||
lines.extend(f" - {n}" for n in available_list)
|
||||
else:
|
||||
lines.append(" (нет)")
|
||||
lines.extend(
|
||||
[
|
||||
"",
|
||||
"Алиасы: target→crm3-26, source→crm3-dev, crm3_old→crm3-dev",
|
||||
"Краткие имена (алиасы) для -b задаются в baseconf_aliases файла --config.",
|
||||
]
|
||||
)
|
||||
raise BaseconfError("\n".join(lines))
|
||||
@@ -155,7 +289,7 @@ def validate_baseconfs(
|
||||
lines.extend(
|
||||
[
|
||||
"",
|
||||
f"Переиндексация: python tools/index/index_1c.py reindex --full -b {not_indexed[0]}",
|
||||
f"Переиндексация: python index_1c.py reindex --full -b {not_indexed[0]}",
|
||||
]
|
||||
)
|
||||
raise BaseconfError("\n".join(lines))
|
||||
@@ -236,7 +370,7 @@ def index_db_missing_message(project_root: Path) -> str:
|
||||
return (
|
||||
f"Индекс не найден: {path}\n"
|
||||
"Сначала выполните:\n"
|
||||
" python tools/index/index_1c.py reindex --full -j 12\n"
|
||||
" python index_1c.py reindex --full -j 12\n"
|
||||
"или для одной конфигурации:\n"
|
||||
" python tools/index/index_1c.py reindex --full -b crm3-26"
|
||||
" python index_1c.py reindex --full -b <имя-выгрузки>"
|
||||
)
|
||||
|
||||
+162
-27
@@ -2,31 +2,14 @@
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
from dataclasses import dataclass
|
||||
from pathlib import Path
|
||||
|
||||
# Папки выгрузок относительно корня проекта (есть src/).
|
||||
DEFAULT_CONFIGS: tuple[str, ...] = (
|
||||
"crm3-26",
|
||||
"crm3-26.rhana",
|
||||
"crm3-dev",
|
||||
"crm3-dev.rhana",
|
||||
"crm3-dev.docs",
|
||||
"ws-rhana",
|
||||
"bu-corp",
|
||||
"bu-corp.rhana",
|
||||
"diadoc.ext.rhana",
|
||||
)
|
||||
|
||||
# Алиасы имён конфигураций 1С для CLI (--baseconf / -b).
|
||||
CONFIG_ALIASES: dict[str, str] = {
|
||||
"crm3_26": "crm3-26",
|
||||
"crm3_old": "crm3-dev",
|
||||
"crm3-old": "crm3-dev",
|
||||
"crm3_dev": "crm3-dev",
|
||||
"target": "crm3-26",
|
||||
"source": "crm3-dev",
|
||||
}
|
||||
# Алиасы имён конфигураций 1С для CLI (--baseconf / -b), задаются через --config
|
||||
# (поле baseconf_aliases в YAML). См. config.example.yml.
|
||||
_RUNTIME_ALIASES: dict[str, str] = {}
|
||||
_RUNTIME_DEFAULT_BASECONFS: list[str] = []
|
||||
|
||||
# Папка EDT → канонический тип (английский идентификатор выгрузки).
|
||||
OBJECT_TYPE_FOLDERS: dict[str, str] = {
|
||||
@@ -71,6 +54,7 @@ OBJECT_TYPE_FOLDERS: dict[str, str] = {
|
||||
"XDTOPackages": "XDTOPackage",
|
||||
"Bots": "Bot",
|
||||
"ExternalDataSources": "ExternalDataSource",
|
||||
"ExternalDataProcessors": "ExternalDataProcessor",
|
||||
"Languages": "Language",
|
||||
}
|
||||
|
||||
@@ -110,6 +94,10 @@ TYPE_ALIASES: dict[str, str] = {
|
||||
"dataprocessors": "DataProcessor",
|
||||
"обработка": "DataProcessor",
|
||||
"обработки": "DataProcessor",
|
||||
"externaldataprocessor": "ExternalDataProcessor",
|
||||
"externaldataprocessors": "ExternalDataProcessor",
|
||||
"внешняяобработка": "ExternalDataProcessor",
|
||||
"внешниеобработки": "ExternalDataProcessor",
|
||||
"report": "Report",
|
||||
"reports": "Report",
|
||||
"отчет": "Report",
|
||||
@@ -189,16 +177,105 @@ class ConfigPaths:
|
||||
name: str
|
||||
root: Path
|
||||
src: Path
|
||||
source_kind: str = "src" # src | external_processor
|
||||
external_name: str = ""
|
||||
|
||||
|
||||
def project_root_from_here() -> Path:
|
||||
"""tools/index/index1c → корень проекта."""
|
||||
return Path(__file__).resolve().parents[3]
|
||||
"""Корень проекта: каталог с index_1c.py и VERSION."""
|
||||
here = Path(__file__).resolve().parent
|
||||
for candidate in (here.parent, here.parent.parent, here.parent.parent.parent):
|
||||
if (candidate / "index_1c.py").is_file() and (candidate / "VERSION").is_file():
|
||||
return candidate
|
||||
return here.parent
|
||||
|
||||
|
||||
def set_config_aliases(aliases: dict[str, str] | None) -> None:
|
||||
"""Задать алиасы baseconf из файла --config (baseconf_aliases)."""
|
||||
global _RUNTIME_ALIASES
|
||||
_RUNTIME_ALIASES = {str(k): str(v) for k, v in (aliases or {}).items()}
|
||||
|
||||
|
||||
def get_config_aliases() -> dict[str, str]:
|
||||
return dict(_RUNTIME_ALIASES)
|
||||
|
||||
|
||||
def set_default_baseconfs(names: list[str] | None) -> None:
|
||||
"""Задать default_baseconfs из файла --config (YAML)."""
|
||||
global _RUNTIME_DEFAULT_BASECONFS
|
||||
_RUNTIME_DEFAULT_BASECONFS = [str(x) for x in (names or []) if str(x).strip()]
|
||||
|
||||
|
||||
def get_default_baseconfs() -> list[str]:
|
||||
"""Список baseconf по умолчанию для reindex без -b."""
|
||||
return list(_RUNTIME_DEFAULT_BASECONFS)
|
||||
|
||||
|
||||
def resolve_config_name(name: str) -> str:
|
||||
key = name.strip()
|
||||
return CONFIG_ALIASES.get(key, CONFIG_ALIASES.get(key.lower(), key))
|
||||
aliases = get_config_aliases()
|
||||
return aliases.get(key, aliases.get(key.lower(), key))
|
||||
|
||||
|
||||
def list_config_dirs(project_root: Path) -> list[str]:
|
||||
"""Все источники индексации в корне проекта.
|
||||
|
||||
Возвращает:
|
||||
- обычные конфигурации/расширения: <name> (если есть <name>/src/)
|
||||
- внешние обработки: <dir>.<Обработка> для каталогов вида <dir>/*.xml + <dir>/<Обработка>/
|
||||
"""
|
||||
if not project_root.is_dir():
|
||||
return []
|
||||
found: list[str] = []
|
||||
for child in sorted(project_root.iterdir()):
|
||||
if not child.is_dir() or child.name.startswith("."):
|
||||
continue
|
||||
if (child / "src").is_dir():
|
||||
found.append(child.name)
|
||||
continue
|
||||
if child.name.endswith(".ext"):
|
||||
found.extend(_discover_external_processors(child))
|
||||
return found
|
||||
|
||||
|
||||
_SAFE_NAME_RE = re.compile(r"^[A-Za-zА-Яа-яЁё0-9_]+$")
|
||||
|
||||
|
||||
def _looks_like_external_processor_xml(path: Path) -> bool:
|
||||
try:
|
||||
text = path.read_text(encoding="utf-8", errors="ignore")
|
||||
except OSError:
|
||||
return False
|
||||
probe = text[:8000]
|
||||
return "<ExternalDataProcessor" in probe and "<MetaDataObject" in probe
|
||||
|
||||
|
||||
def _discover_external_processor_entries(root: Path) -> list[tuple[str, str, Path]]:
|
||||
"""Найти внешние обработки под root (включая вложенные папки).
|
||||
|
||||
Возвращает кортежи: (virtual_name, processor_name, processor_root_dir).
|
||||
"""
|
||||
out: list[tuple[str, str, Path]] = []
|
||||
try:
|
||||
xml_files = sorted(root.rglob("*.xml"))
|
||||
except OSError:
|
||||
return out
|
||||
for xml in xml_files:
|
||||
parent = xml.parent
|
||||
name = xml.stem.strip()
|
||||
if not name or not _SAFE_NAME_RE.match(name):
|
||||
continue
|
||||
obj_dir = parent / name
|
||||
if not obj_dir.is_dir():
|
||||
continue
|
||||
if not _looks_like_external_processor_xml(xml):
|
||||
continue
|
||||
out.append((f"{root.name}.{name}", name, parent))
|
||||
return out
|
||||
|
||||
|
||||
def _discover_external_processors(root: Path) -> list[str]:
|
||||
return [name for name, _proc, _parent in _discover_external_processor_entries(root)]
|
||||
|
||||
|
||||
def resolve_object_type(name: str) -> str:
|
||||
@@ -217,13 +294,71 @@ def resolve_object_type(name: str) -> str:
|
||||
|
||||
|
||||
def discover_configs(project_root: Path, names: list[str] | None = None) -> list[ConfigPaths]:
|
||||
wanted = [resolve_config_name(n) for n in names] if names else list(DEFAULT_CONFIGS)
|
||||
wanted = [resolve_config_name(n) for n in names] if names else list_config_dirs(project_root)
|
||||
found: list[ConfigPaths] = []
|
||||
seen: set[str] = set()
|
||||
|
||||
def _append(cfg: ConfigPaths) -> None:
|
||||
if cfg.name in seen:
|
||||
return
|
||||
seen.add(cfg.name)
|
||||
found.append(cfg)
|
||||
|
||||
for name in wanted:
|
||||
root = project_root / name
|
||||
src = root / "src"
|
||||
if src.is_dir():
|
||||
found.append(ConfigPaths(name=name, root=root, src=src))
|
||||
_append(ConfigPaths(name=name, root=root, src=src))
|
||||
continue
|
||||
# virtual baseconf для внешних обработок:
|
||||
# <dir>.<processor> → ищем <...>/<processor>.xml + <...>/<processor>/
|
||||
if "." in name:
|
||||
base, ext_name = name.rsplit(".", 1)
|
||||
ext_root = project_root / base
|
||||
if ext_root.is_dir():
|
||||
entries = _discover_external_processor_entries(ext_root)
|
||||
for _virtual_name, proc_name, proc_root in entries:
|
||||
if proc_name != ext_name:
|
||||
continue
|
||||
_append(
|
||||
ConfigPaths(
|
||||
name=name,
|
||||
root=proc_root,
|
||||
src=proc_root,
|
||||
source_kind="external_processor",
|
||||
external_name=proc_name,
|
||||
)
|
||||
)
|
||||
break
|
||||
else:
|
||||
# имя может уже быть каноническим virtual name
|
||||
for virtual_name, proc_name, proc_root in entries:
|
||||
if virtual_name != name:
|
||||
continue
|
||||
_append(
|
||||
ConfigPaths(
|
||||
name=virtual_name,
|
||||
root=proc_root,
|
||||
src=proc_root,
|
||||
source_kind="external_processor",
|
||||
external_name=proc_name,
|
||||
)
|
||||
)
|
||||
break
|
||||
if name in seen:
|
||||
continue
|
||||
# если передали только папку (например my-transfer.ext), развернуть все обработки
|
||||
if root.is_dir():
|
||||
for virtual_name, proc_name, proc_root in _discover_external_processor_entries(root):
|
||||
_append(
|
||||
ConfigPaths(
|
||||
name=virtual_name,
|
||||
root=proc_root,
|
||||
src=proc_root,
|
||||
source_kind="external_processor",
|
||||
external_name=proc_name,
|
||||
)
|
||||
)
|
||||
return found
|
||||
|
||||
|
||||
|
||||
+116
-6
@@ -8,7 +8,7 @@ from datetime import datetime, timezone
|
||||
from pathlib import Path
|
||||
from typing import Any, Iterable
|
||||
|
||||
SCHEMA_VERSION = 2
|
||||
SCHEMA_VERSION = 3
|
||||
|
||||
DDL = """
|
||||
PRAGMA journal_mode=WAL;
|
||||
@@ -82,6 +82,13 @@ CREATE TABLE IF NOT EXISTS refs (
|
||||
to_name TEXT NOT NULL
|
||||
);
|
||||
|
||||
CREATE TABLE IF NOT EXISTS register_records (
|
||||
id INTEGER PRIMARY KEY,
|
||||
config TEXT NOT NULL,
|
||||
document_full_name TEXT NOT NULL,
|
||||
register_full_name TEXT NOT NULL
|
||||
);
|
||||
|
||||
CREATE TABLE IF NOT EXISTS modules (
|
||||
id INTEGER PRIMARY KEY,
|
||||
config TEXT NOT NULL,
|
||||
@@ -123,12 +130,84 @@ CREATE INDEX IF NOT EXISTS idx_fields_object ON fields(object_id);
|
||||
CREATE INDEX IF NOT EXISTS idx_refs_to ON refs(to_kind, to_name);
|
||||
CREATE INDEX IF NOT EXISTS idx_refs_from ON refs(from_full_name);
|
||||
CREATE INDEX IF NOT EXISTS idx_refs_config ON refs(config);
|
||||
CREATE INDEX IF NOT EXISTS idx_regrec_register ON register_records(register_full_name);
|
||||
CREATE INDEX IF NOT EXISTS idx_regrec_document ON register_records(document_full_name);
|
||||
CREATE INDEX IF NOT EXISTS idx_regrec_config ON register_records(config);
|
||||
CREATE INDEX IF NOT EXISTS idx_modules_config ON modules(config);
|
||||
CREATE INDEX IF NOT EXISTS idx_modules_owner ON modules(owner);
|
||||
CREATE INDEX IF NOT EXISTS idx_files_config ON files(config);
|
||||
"""
|
||||
|
||||
|
||||
def _table_exists(conn: sqlite3.Connection, name: str) -> bool:
|
||||
row = conn.execute(
|
||||
"SELECT 1 FROM sqlite_master WHERE type='table' AND name=?",
|
||||
(name,),
|
||||
).fetchone()
|
||||
return row is not None
|
||||
|
||||
|
||||
def backfill_register_records(conn: sqlite3.Connection) -> int:
|
||||
"""Заполнить register_records из JSON объектов (документы → RegisterRecords)."""
|
||||
conn.execute("DELETE FROM register_records")
|
||||
n = 0
|
||||
rows = conn.execute(
|
||||
"SELECT config, full_name, json FROM objects WHERE object_type='Document'"
|
||||
).fetchall()
|
||||
batch: list[tuple[str, str, str]] = []
|
||||
for r in rows:
|
||||
try:
|
||||
data = json.loads(r["json"])
|
||||
except json.JSONDecodeError:
|
||||
continue
|
||||
for reg in data.get("register_records") or []:
|
||||
if not reg or not isinstance(reg, str):
|
||||
continue
|
||||
batch.append((r["config"], r["full_name"], reg))
|
||||
n += 1
|
||||
if len(batch) >= 500:
|
||||
conn.executemany(
|
||||
"""
|
||||
INSERT INTO register_records(config, document_full_name, register_full_name)
|
||||
VALUES(?,?,?)
|
||||
""",
|
||||
batch,
|
||||
)
|
||||
batch.clear()
|
||||
if batch:
|
||||
conn.executemany(
|
||||
"""
|
||||
INSERT INTO register_records(config, document_full_name, register_full_name)
|
||||
VALUES(?,?,?)
|
||||
""",
|
||||
batch,
|
||||
)
|
||||
return n
|
||||
|
||||
|
||||
def migrate_schema(conn: sqlite3.Connection, from_version: int) -> None:
|
||||
"""Мягкая миграция без wipe БД."""
|
||||
if from_version < 3:
|
||||
conn.executescript(
|
||||
"""
|
||||
CREATE TABLE IF NOT EXISTS register_records (
|
||||
id INTEGER PRIMARY KEY,
|
||||
config TEXT NOT NULL,
|
||||
document_full_name TEXT NOT NULL,
|
||||
register_full_name TEXT NOT NULL
|
||||
);
|
||||
CREATE INDEX IF NOT EXISTS idx_regrec_register ON register_records(register_full_name);
|
||||
CREATE INDEX IF NOT EXISTS idx_regrec_document ON register_records(document_full_name);
|
||||
CREATE INDEX IF NOT EXISTS idx_regrec_config ON register_records(config);
|
||||
"""
|
||||
)
|
||||
backfill_register_records(conn)
|
||||
conn.execute(
|
||||
"INSERT OR REPLACE INTO meta(key, value) VALUES('schema_version', ?)",
|
||||
(str(SCHEMA_VERSION),),
|
||||
)
|
||||
|
||||
|
||||
def utcnow() -> str:
|
||||
return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
|
||||
|
||||
@@ -161,11 +240,18 @@ def init_db(conn: sqlite3.Connection) -> None:
|
||||
"INSERT OR REPLACE INTO meta(key, value) VALUES('created_at', ?)",
|
||||
(utcnow(),),
|
||||
)
|
||||
elif int(row["value"]) != SCHEMA_VERSION:
|
||||
raise RuntimeError(
|
||||
f"Несовместимая схема индекса (есть {row['value']}, нужна {SCHEMA_VERSION}). "
|
||||
"Запустите: python tools/index/index_1c.py reindex --full"
|
||||
)
|
||||
else:
|
||||
ver = int(row["value"])
|
||||
if ver > SCHEMA_VERSION:
|
||||
raise RuntimeError(
|
||||
f"Индекс новее утилиты (схема {ver}, утилита {SCHEMA_VERSION}). "
|
||||
"Обновите утилиту index до более новой версии."
|
||||
)
|
||||
if ver < SCHEMA_VERSION:
|
||||
migrate_schema(conn, ver)
|
||||
elif not _table_exists(conn, "register_records"):
|
||||
# schema_version=3, но таблица потеряна — восстановить
|
||||
migrate_schema(conn, 2)
|
||||
conn.commit()
|
||||
|
||||
|
||||
@@ -231,6 +317,11 @@ def delete_file_cascade(conn: sqlite3.Connection, file_id: int) -> None:
|
||||
"DELETE FROM refs WHERE config=? AND from_full_name=?",
|
||||
(row["config"], row["full_name"]),
|
||||
)
|
||||
if _table_exists(conn, "register_records"):
|
||||
conn.execute(
|
||||
"DELETE FROM register_records WHERE config=? AND document_full_name=?",
|
||||
(row["config"], row["full_name"]),
|
||||
)
|
||||
conn.execute("DELETE FROM objects WHERE id=?", (oid,))
|
||||
|
||||
mod = conn.execute(
|
||||
@@ -259,6 +350,8 @@ def delete_config(conn: sqlite3.Connection, config: str) -> None:
|
||||
conn.execute("DELETE FROM modules_fts WHERE module_id=?", (mid,))
|
||||
conn.execute("DELETE FROM fields WHERE config=?", (config,))
|
||||
conn.execute("DELETE FROM refs WHERE config=?", (config,))
|
||||
if _table_exists(conn, "register_records"):
|
||||
conn.execute("DELETE FROM register_records WHERE config=?", (config,))
|
||||
conn.execute("DELETE FROM objects WHERE config=?", (config,))
|
||||
conn.execute("DELETE FROM modules WHERE config=?", (config,))
|
||||
conn.execute("DELETE FROM files WHERE config=?", (config,))
|
||||
@@ -318,6 +411,11 @@ def upsert_object(
|
||||
"DELETE FROM refs WHERE config=? AND from_full_name=?",
|
||||
(config, full_name),
|
||||
)
|
||||
if _table_exists(conn, "register_records"):
|
||||
conn.execute(
|
||||
"DELETE FROM register_records WHERE config=? AND document_full_name=?",
|
||||
(config, full_name),
|
||||
)
|
||||
conn.execute(
|
||||
"""
|
||||
UPDATE objects SET object_type=?, name=?, synonym=?, comment=?, tooltip=?,
|
||||
@@ -411,6 +509,18 @@ def upsert_object(
|
||||
r.get("name"),
|
||||
),
|
||||
)
|
||||
|
||||
if _table_exists(conn, "register_records"):
|
||||
for reg in obj.get("register_records") or []:
|
||||
if not reg or not isinstance(reg, str):
|
||||
continue
|
||||
conn.execute(
|
||||
"""
|
||||
INSERT INTO register_records(config, document_full_name, register_full_name)
|
||||
VALUES(?,?,?)
|
||||
""",
|
||||
(config, full_name, reg),
|
||||
)
|
||||
return oid
|
||||
|
||||
|
||||
|
||||
+205
-24
@@ -3,12 +3,15 @@
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import re
|
||||
import sqlite3
|
||||
from pathlib import Path
|
||||
from typing import Any
|
||||
|
||||
from .parse_meta import FieldRec, ObjectRec, parse_metadata_xml
|
||||
|
||||
_QUERY_TOKEN_RE = re.compile(r"[\wА-Яа-яЁё]+", flags=re.UNICODE)
|
||||
|
||||
|
||||
FILL_LABEL = {
|
||||
"ShowError": "обяз.",
|
||||
@@ -43,6 +46,174 @@ def _field_matches(f: dict[str, Any], q: str, qn: str) -> bool:
|
||||
return name_cf == qn or syn_cf == qn or qn in syn_parts
|
||||
|
||||
|
||||
def _query_tokens(query: str) -> list[str]:
|
||||
return _QUERY_TOKEN_RE.findall(query or "")
|
||||
|
||||
|
||||
def _words_cf(text: str) -> list[str]:
|
||||
return [w.casefold() for w in _QUERY_TOKEN_RE.findall(text or "")]
|
||||
|
||||
|
||||
def _tokens_match_text(tokens: list[str], text: str) -> bool:
|
||||
"""Как FTS search: каждый токен — префикс какого-либо слова в тексте."""
|
||||
if not tokens:
|
||||
return False
|
||||
words = _words_cf(text)
|
||||
if not words:
|
||||
return False
|
||||
for tok in tokens:
|
||||
t = tok.casefold()
|
||||
if not any(w.startswith(t) for w in words):
|
||||
return False
|
||||
return True
|
||||
|
||||
|
||||
def object_header_matches_search(row: dict[str, Any], query: str) -> bool:
|
||||
"""Совпадение по имени/синониму/комментарию объекта (не по реквизитам)."""
|
||||
tokens = _query_tokens(query)
|
||||
if not tokens:
|
||||
return False
|
||||
for part in (
|
||||
row.get("name") or "",
|
||||
row.get("full_name") or "",
|
||||
row.get("synonym") or "",
|
||||
row.get("comment") or "",
|
||||
):
|
||||
if _tokens_match_text(tokens, part):
|
||||
return True
|
||||
return False
|
||||
|
||||
|
||||
def field_matches_search_query(f: dict[str, Any], query: str) -> bool:
|
||||
"""Совпадение реквизита с поисковым запросом (префикс по словам, как FTS)."""
|
||||
tokens = _query_tokens(query)
|
||||
if not tokens:
|
||||
return False
|
||||
text = " ".join(
|
||||
filter(
|
||||
None,
|
||||
[
|
||||
f.get("kind") or "",
|
||||
f.get("name") or "",
|
||||
f.get("synonym") or "",
|
||||
f.get("comment") or "",
|
||||
f.get("tabular_section") or "",
|
||||
" ".join(f.get("types") or []),
|
||||
],
|
||||
)
|
||||
)
|
||||
return _tokens_match_text(tokens, text)
|
||||
|
||||
|
||||
def _field_dict_from_db_row(row: sqlite3.Row) -> dict[str, Any]:
|
||||
return {
|
||||
"kind": row["kind"],
|
||||
"name": row["name"],
|
||||
"synonym": row["synonym"] or "",
|
||||
"comment": row["comment"] or "" if "comment" in row.keys() else "",
|
||||
"types": [t.strip() for t in (row["types"] or "").split(",") if t.strip()],
|
||||
"tabular_section": row["tabular_section"] or "",
|
||||
"refs": json.loads(row["refs_json"] or "[]"),
|
||||
"fill_checking": "",
|
||||
}
|
||||
|
||||
|
||||
def find_fields_for_search_query(
|
||||
conn: sqlite3.Connection,
|
||||
object_id: int,
|
||||
query: str,
|
||||
) -> list[dict[str, Any]]:
|
||||
"""Реквизиты объекта, совпавшие с FTS-запросом search."""
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT kind, name, synonym, comment, types, tabular_section, refs_json
|
||||
FROM fields
|
||||
WHERE object_id = ?
|
||||
ORDER BY tabular_section, kind, name
|
||||
""",
|
||||
(object_id,),
|
||||
)
|
||||
matched: list[dict[str, Any]] = []
|
||||
seen: set[tuple[str, str, str]] = set()
|
||||
for row in rows:
|
||||
fdict = _field_dict_from_db_row(row)
|
||||
if not field_matches_search_query(fdict, query):
|
||||
continue
|
||||
sig = (fdict["tabular_section"], fdict["name"], fdict["kind"])
|
||||
if sig in seen:
|
||||
continue
|
||||
seen.add(sig)
|
||||
matched.append(fdict)
|
||||
return matched
|
||||
|
||||
|
||||
def enrich_matched_fields(obj: dict[str, Any], matched: list[dict[str, Any]]) -> None:
|
||||
"""Подтянуть FillChecking и типы из актуальной структуры объекта."""
|
||||
if not matched or not obj.get("fields"):
|
||||
return
|
||||
by_f = {
|
||||
(f.get("tabular_section") or "", f.get("name") or "", f.get("kind") or ""): f
|
||||
for f in obj["fields"]
|
||||
}
|
||||
for mf in matched:
|
||||
key = (mf.get("tabular_section") or "", mf.get("name") or "", mf.get("kind") or "")
|
||||
src = by_f.get(key)
|
||||
if not src:
|
||||
continue
|
||||
mf["fill_checking"] = src.get("fill_checking") or ""
|
||||
mf["types"] = src.get("types") or mf.get("types")
|
||||
mf["synonym"] = src.get("synonym") or mf.get("synonym")
|
||||
mf["refs"] = src.get("refs") or mf.get("refs")
|
||||
|
||||
|
||||
def load_object_structure_for_row(
|
||||
conn: sqlite3.Connection,
|
||||
row: dict[str, Any],
|
||||
) -> dict[str, Any]:
|
||||
match = {
|
||||
"config": row["config"],
|
||||
"full_name": row["full_name"],
|
||||
"path": row.get("path"),
|
||||
"object_type": row.get("object_type"),
|
||||
}
|
||||
if row.get("json"):
|
||||
match["json"] = row["json"]
|
||||
elif row.get("object_id"):
|
||||
jrow = conn.execute(
|
||||
"SELECT json FROM objects WHERE id=?", (row["object_id"],)
|
||||
).fetchone()
|
||||
match["json"] = jrow["json"] if jrow else "{}"
|
||||
else:
|
||||
jrow = conn.execute(
|
||||
"SELECT json FROM objects WHERE config=? AND full_name=?",
|
||||
(row["config"], row["full_name"]),
|
||||
).fetchone()
|
||||
match["json"] = jrow["json"] if jrow else "{}"
|
||||
return load_object_structure(match)
|
||||
|
||||
|
||||
def annotate_search_hits(
|
||||
conn: sqlite3.Connection,
|
||||
rows: list[dict[str, Any]],
|
||||
query: str,
|
||||
) -> list[dict[str, Any]]:
|
||||
"""Уточнить search: object — по шапке; field — по реквизитам в fields_text."""
|
||||
for row in rows:
|
||||
if object_header_matches_search(row, query):
|
||||
row["match_kind"] = "object"
|
||||
row["matched_fields"] = []
|
||||
continue
|
||||
oid = row.get("object_id")
|
||||
matched = find_fields_for_search_query(conn, int(oid), query) if oid else []
|
||||
if matched:
|
||||
row["match_kind"] = "field"
|
||||
row["matched_fields"] = matched
|
||||
else:
|
||||
row["match_kind"] = "object"
|
||||
row["matched_fields"] = []
|
||||
return rows
|
||||
|
||||
|
||||
def find_structure_matches(
|
||||
conn: sqlite3.Connection,
|
||||
query: str,
|
||||
@@ -239,12 +410,43 @@ def format_field_line(
|
||||
return f"{indent}{branch}`{kind}.{name}`{syn_s} [{fill}] : {types_s}"
|
||||
|
||||
|
||||
def _select_matched_field_nodes(
|
||||
fields: list[dict[str, Any]],
|
||||
matched_fields: list[dict[str, Any]],
|
||||
) -> tuple[list[dict[str, Any]], set[tuple[str, str, str]], set[str]]:
|
||||
want: set[tuple[str, str, str]] = set()
|
||||
need_ts: set[str] = set()
|
||||
for mf in matched_fields:
|
||||
want.add(
|
||||
(
|
||||
mf.get("kind") or "",
|
||||
mf.get("tabular_section") or "",
|
||||
mf.get("name") or "",
|
||||
)
|
||||
)
|
||||
if mf.get("tabular_section") and mf.get("kind") == "Column":
|
||||
need_ts.add(mf["tabular_section"])
|
||||
selected: list[dict[str, Any]] = []
|
||||
for f in fields:
|
||||
key = (
|
||||
f.get("kind") or "",
|
||||
f.get("tabular_section") or "",
|
||||
f.get("name") or "",
|
||||
)
|
||||
if key in want:
|
||||
selected.append(f)
|
||||
elif f.get("kind") == "TabularSection" and f.get("name") in need_ts:
|
||||
selected.append(f)
|
||||
return selected, want, need_ts
|
||||
|
||||
|
||||
def format_object_tree(
|
||||
obj: dict[str, Any],
|
||||
*,
|
||||
clear: bool = False,
|
||||
matched_fields: list[dict[str, Any]] | None = None,
|
||||
match_kind: str = "object",
|
||||
omit_header: bool = False,
|
||||
) -> str:
|
||||
"""Дерево реквизитов объекта. clear — только совпадения."""
|
||||
lines: list[str] = []
|
||||
@@ -254,35 +456,14 @@ def format_object_tree(
|
||||
header = f"`{obj.get('full_name') or obj.get('object_type') + '.' + obj.get('name')}`{syn_s}"
|
||||
if cfg:
|
||||
header = f"[{cfg}] {header}"
|
||||
lines.append(header)
|
||||
if not omit_header:
|
||||
lines.append(header)
|
||||
|
||||
fields: list[dict[str, Any]] = list(obj.get("fields") or [])
|
||||
|
||||
if clear:
|
||||
if match_kind == "field" and matched_fields:
|
||||
want: set[tuple[str, str, str]] = set()
|
||||
need_ts: set[str] = set()
|
||||
for mf in matched_fields:
|
||||
want.add(
|
||||
(
|
||||
mf.get("kind") or "",
|
||||
mf.get("tabular_section") or "",
|
||||
mf.get("name") or "",
|
||||
)
|
||||
)
|
||||
if mf.get("tabular_section") and mf.get("kind") == "Column":
|
||||
need_ts.add(mf["tabular_section"])
|
||||
selected: list[dict[str, Any]] = []
|
||||
for f in fields:
|
||||
key = (
|
||||
f.get("kind") or "",
|
||||
f.get("tabular_section") or "",
|
||||
f.get("name") or "",
|
||||
)
|
||||
if key in want:
|
||||
selected.append(f)
|
||||
elif f.get("kind") == "TabularSection" and f.get("name") in need_ts:
|
||||
selected.append(f)
|
||||
selected, want, need_ts = _select_matched_field_nodes(fields, matched_fields)
|
||||
if not selected:
|
||||
lines.append(" (совпавшие реквизиты не найдены в структуре)")
|
||||
return "\n".join(lines)
|
||||
|
||||
+16
-1
@@ -336,12 +336,27 @@ def iter_object_xml_files(
|
||||
src: Path,
|
||||
types: set[str] | None = None,
|
||||
skip_types: set[str] | None = None,
|
||||
*,
|
||||
source_kind: str = "src",
|
||||
external_name: str = "",
|
||||
) -> list[tuple[str, Path]]:
|
||||
"""Список (object_type, xml_path) только верхний уровень src/<Folder>/*.xml."""
|
||||
"""Список (object_type, xml_path) для обычной выгрузки или external processing."""
|
||||
skip = skip_types or set()
|
||||
out: list[tuple[str, Path]] = []
|
||||
if not src.is_dir():
|
||||
return out
|
||||
if source_kind == "external_processor":
|
||||
otype = "ExternalDataProcessor"
|
||||
if otype in skip:
|
||||
return out
|
||||
if types is not None and otype not in types:
|
||||
return out
|
||||
if not external_name:
|
||||
return out
|
||||
xml = src / f"{external_name}.xml"
|
||||
if xml.is_file():
|
||||
out.append((otype, xml))
|
||||
return out
|
||||
for folder in sorted(src.iterdir()):
|
||||
if not folder.is_dir():
|
||||
continue
|
||||
|
||||
@@ -53,6 +53,12 @@ def _owner_from_rel(rel: Path) -> str:
|
||||
parts = rel.parts
|
||||
if not parts:
|
||||
return ""
|
||||
# Внешняя обработка: <Обработка>/Ext/ObjectModule.bsl
|
||||
if len(parts) >= 3 and parts[1] == "Ext":
|
||||
return f"ExternalDataProcessor.{parts[0]}"
|
||||
# Форма внешней обработки: <Обработка>/Forms/<Форма>/Ext/Form/Module.bsl
|
||||
if len(parts) >= 6 and parts[1] == "Forms":
|
||||
return f"ExternalDataProcessor.{parts[0]}.Form.{parts[2]}"
|
||||
folder = parts[0]
|
||||
otype = OBJECT_TYPE_FOLDERS.get(folder)
|
||||
if otype and len(parts) >= 2:
|
||||
|
||||
+238
-5
@@ -10,6 +10,7 @@ from typing import Any
|
||||
|
||||
from . import db as dbmod
|
||||
from .config import cache_dir
|
||||
from .object_view import annotate_search_hits
|
||||
|
||||
|
||||
def _fts_query(raw: str) -> str:
|
||||
@@ -23,11 +24,240 @@ def open_index(project_root: Path, *, readonly: bool = True) -> sqlite3.Connecti
|
||||
path = dbmod.global_db_path(cache_dir(project_root))
|
||||
if not path.is_file():
|
||||
raise FileNotFoundError(
|
||||
f"Индекс не найден: {path}. Запустите: python tools/index/index_1c.py reindex --full"
|
||||
f"Индекс не найден: {path}. Запустите: python index_1c.py reindex --full"
|
||||
)
|
||||
# мягкая миграция схемы (например 2→3: таблица register_records)
|
||||
probe = dbmod.connect(path, readonly=True)
|
||||
need_migrate = False
|
||||
try:
|
||||
row = probe.execute(
|
||||
"SELECT value FROM meta WHERE key='schema_version'"
|
||||
).fetchone()
|
||||
ver = int(row["value"]) if row else 0
|
||||
if ver < dbmod.SCHEMA_VERSION:
|
||||
need_migrate = True
|
||||
elif ver == dbmod.SCHEMA_VERSION:
|
||||
t = probe.execute(
|
||||
"SELECT 1 FROM sqlite_master WHERE type='table' AND name='register_records'"
|
||||
).fetchone()
|
||||
if t is None:
|
||||
need_migrate = True
|
||||
finally:
|
||||
probe.close()
|
||||
|
||||
if need_migrate:
|
||||
wconn = dbmod.connect(path, readonly=False)
|
||||
try:
|
||||
dbmod.init_db(wconn)
|
||||
finally:
|
||||
wconn.close()
|
||||
|
||||
return dbmod.connect(path, readonly=readonly)
|
||||
|
||||
|
||||
REGISTER_OBJECT_TYPES = frozenset(
|
||||
{
|
||||
"AccumulationRegister",
|
||||
"InformationRegister",
|
||||
"AccountingRegister",
|
||||
"CalculationRegister",
|
||||
}
|
||||
)
|
||||
|
||||
|
||||
def _resolve_movement_targets(
|
||||
conn: sqlite3.Connection,
|
||||
target: str,
|
||||
*,
|
||||
configs: list[str] | None = None,
|
||||
object_type: str | None = None,
|
||||
) -> list[dict[str, Any]]:
|
||||
"""Найти объект(ы) для movements: документ или регистр."""
|
||||
sql = """
|
||||
SELECT config, full_name, object_type, name, synonym
|
||||
FROM objects
|
||||
WHERE (full_name = ? OR name = ?)
|
||||
"""
|
||||
params: list[Any] = [target, target]
|
||||
if configs:
|
||||
sql += f" AND config IN ({','.join('?' * len(configs))})"
|
||||
params.extend(configs)
|
||||
if object_type:
|
||||
sql += " AND object_type = ?"
|
||||
params.append(object_type)
|
||||
sql += " ORDER BY config, full_name"
|
||||
rows = [dict(r) for r in conn.execute(sql, params)]
|
||||
if rows:
|
||||
return rows
|
||||
|
||||
# Document.X / AccumulationRegister.X без точного совпадения типа
|
||||
if "." in target:
|
||||
kind, name = target.split(".", 1)
|
||||
sql = """
|
||||
SELECT config, full_name, object_type, name, synonym
|
||||
FROM objects
|
||||
WHERE object_type = ? AND name = ?
|
||||
"""
|
||||
params = [kind, name]
|
||||
if configs:
|
||||
sql += f" AND config IN ({','.join('?' * len(configs))})"
|
||||
params.extend(configs)
|
||||
sql += " ORDER BY config, full_name"
|
||||
rows = [dict(r) for r in conn.execute(sql, params)]
|
||||
if rows:
|
||||
return rows
|
||||
|
||||
sql = """
|
||||
SELECT config, full_name, object_type, name, synonym
|
||||
FROM objects
|
||||
WHERE full_name LIKE ?
|
||||
"""
|
||||
params = [f"%.{target}"]
|
||||
if configs:
|
||||
sql += f" AND config IN ({','.join('?' * len(configs))})"
|
||||
params.extend(configs)
|
||||
if object_type:
|
||||
sql += " AND object_type = ?"
|
||||
params.append(object_type)
|
||||
sql += " ORDER BY config, full_name LIMIT 20"
|
||||
return [dict(r) for r in conn.execute(sql, params)]
|
||||
|
||||
|
||||
def find_movements(
|
||||
conn: sqlite3.Connection,
|
||||
target: str,
|
||||
*,
|
||||
configs: list[str] | None = None,
|
||||
object_type: str | None = None,
|
||||
limit: int = 200,
|
||||
) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
|
||||
"""Связи регистратор ↔ регистры движений (RegisterRecords).
|
||||
|
||||
Возвращает ``(resolved_objects, rows)``, где каждая строка:
|
||||
- direction: ``document_to_registers`` | ``register_to_documents``
|
||||
- config, from_full_name, to_full_name
|
||||
- from_synonym / to_synonym (если есть в индексе)
|
||||
|
||||
``limit`` — максимум связей **на каждый** найденный объект×конфигурацию.
|
||||
"""
|
||||
resolved = _resolve_movement_targets(
|
||||
conn, target, configs=configs, object_type=object_type
|
||||
)
|
||||
# оставить документы и регистры
|
||||
resolved = [
|
||||
r
|
||||
for r in resolved
|
||||
if r["object_type"] == "Document" or r["object_type"] in REGISTER_OBJECT_TYPES
|
||||
]
|
||||
if not resolved:
|
||||
return [], []
|
||||
|
||||
has_table = (
|
||||
conn.execute(
|
||||
"SELECT 1 FROM sqlite_master WHERE type='table' AND name='register_records'"
|
||||
).fetchone()
|
||||
is not None
|
||||
)
|
||||
|
||||
# кэш синонимов
|
||||
def _synonyms(full_names: set[str], cfg: str) -> dict[str, str]:
|
||||
if not full_names:
|
||||
return {}
|
||||
names = sorted(full_names)
|
||||
ph = ",".join("?" * len(names))
|
||||
return {
|
||||
r["full_name"]: r["synonym"] or ""
|
||||
for r in conn.execute(
|
||||
f"SELECT full_name, synonym FROM objects WHERE config=? AND full_name IN ({ph})",
|
||||
[cfg, *names],
|
||||
)
|
||||
}
|
||||
|
||||
out: list[dict[str, Any]] = []
|
||||
for obj in resolved:
|
||||
cfg = obj["config"]
|
||||
full = obj["full_name"]
|
||||
if obj["object_type"] == "Document":
|
||||
if has_table:
|
||||
links = [
|
||||
r["register_full_name"]
|
||||
for r in conn.execute(
|
||||
"""
|
||||
SELECT register_full_name FROM register_records
|
||||
WHERE config=? AND document_full_name=?
|
||||
ORDER BY register_full_name
|
||||
LIMIT ?
|
||||
""",
|
||||
(cfg, full, limit),
|
||||
)
|
||||
]
|
||||
else:
|
||||
row = conn.execute(
|
||||
"SELECT json FROM objects WHERE config=? AND full_name=?",
|
||||
(cfg, full),
|
||||
).fetchone()
|
||||
links = []
|
||||
if row:
|
||||
try:
|
||||
links = list(json.loads(row["json"]).get("register_records") or [])
|
||||
except json.JSONDecodeError:
|
||||
links = []
|
||||
links = sorted(links)[:limit]
|
||||
syns = _synonyms(set(links), cfg)
|
||||
for reg in links:
|
||||
out.append(
|
||||
{
|
||||
"direction": "document_to_registers",
|
||||
"config": cfg,
|
||||
"from_full_name": full,
|
||||
"from_synonym": obj.get("synonym") or "",
|
||||
"to_full_name": reg,
|
||||
"to_synonym": syns.get(reg, ""),
|
||||
}
|
||||
)
|
||||
else:
|
||||
# регистр → документы-регистраторы
|
||||
if has_table:
|
||||
docs = [
|
||||
r["document_full_name"]
|
||||
for r in conn.execute(
|
||||
"""
|
||||
SELECT document_full_name FROM register_records
|
||||
WHERE config=? AND register_full_name=?
|
||||
ORDER BY document_full_name
|
||||
LIMIT ?
|
||||
""",
|
||||
(cfg, full, limit),
|
||||
)
|
||||
]
|
||||
else:
|
||||
docs = []
|
||||
for r in conn.execute(
|
||||
"SELECT full_name, json FROM objects WHERE config=? AND object_type='Document'",
|
||||
(cfg,),
|
||||
):
|
||||
try:
|
||||
regs = json.loads(r["json"]).get("register_records") or []
|
||||
except json.JSONDecodeError:
|
||||
continue
|
||||
if full in regs:
|
||||
docs.append(r["full_name"])
|
||||
docs = sorted(docs)[:limit]
|
||||
syns = _synonyms(set(docs), cfg)
|
||||
for doc in docs:
|
||||
out.append(
|
||||
{
|
||||
"direction": "register_to_documents",
|
||||
"config": cfg,
|
||||
"from_full_name": full,
|
||||
"from_synonym": obj.get("synonym") or "",
|
||||
"to_full_name": doc,
|
||||
"to_synonym": syns.get(doc, ""),
|
||||
}
|
||||
)
|
||||
return resolved, out
|
||||
|
||||
|
||||
def search_objects(
|
||||
conn: sqlite3.Connection,
|
||||
query: str,
|
||||
@@ -37,7 +267,8 @@ def search_objects(
|
||||
limit: int = 30,
|
||||
) -> list[dict[str, Any]]:
|
||||
exact_sql = """
|
||||
SELECT config, full_name, object_type, name, synonym, comment, path, '' AS snip, -100.0 AS score
|
||||
SELECT config, full_name, object_type, name, synonym, comment, path,
|
||||
id AS object_id, '' AS snip, -100.0 AS score
|
||||
FROM objects
|
||||
WHERE (name = ? OR full_name = ? OR full_name LIKE ?)
|
||||
"""
|
||||
@@ -57,6 +288,7 @@ def search_objects(
|
||||
fetch_n = max(limit * 5, 50)
|
||||
sql = """
|
||||
SELECT o.config, o.full_name, o.object_type, o.name, o.synonym, o.comment, o.path,
|
||||
o.id AS object_id,
|
||||
snippet(objects_fts, 0, '[', ']', '…', 12) AS snip,
|
||||
bm25(objects_fts, 10.0, 5.0, 2.0, 1.0) AS score
|
||||
FROM objects_fts
|
||||
@@ -78,7 +310,8 @@ def search_objects(
|
||||
except sqlite3.OperationalError:
|
||||
like = f"%{query}%"
|
||||
sql2 = """
|
||||
SELECT config, full_name, object_type, name, synonym, comment, path, '' AS snip, 0 AS score
|
||||
SELECT config, full_name, object_type, name, synonym, comment, path,
|
||||
id AS object_id, '' AS snip, 0 AS score
|
||||
FROM objects
|
||||
WHERE full_name LIKE ? OR synonym LIKE ? OR comment LIKE ? OR name LIKE ?
|
||||
"""
|
||||
@@ -114,7 +347,7 @@ def search_objects(
|
||||
merged.sort(
|
||||
key=lambda x: (x.get("_boost", 9), x.get("score") if x.get("score") is not None else 0)
|
||||
)
|
||||
return merged[:limit]
|
||||
return annotate_search_hits(conn, merged[:limit], query)
|
||||
|
||||
|
||||
def search_modules(
|
||||
@@ -174,7 +407,7 @@ def find_refs_to(
|
||||
|
||||
Возвращает (строки, totals_by_config).
|
||||
При поиске по нескольким конфигурациям ``limit`` — максимум **на каждую**
|
||||
конфигурацию (чтобы crm3-26 не вытеснял crm3-dev из-за ORDER BY + LIMIT).
|
||||
конфигурацию (чтобы одна baseconf не вытесняла другую из-за ORDER BY + LIMIT).
|
||||
"""
|
||||
kind = ""
|
||||
name = target
|
||||
|
||||
+2
-2
@@ -272,8 +272,8 @@ def write_global_index_md(cache_root: Path, summary: dict[str, Any]) -> Path:
|
||||
f"Режим: `{summary.get('mode', '?')}`, БД: `cache/1c_meta/index.sqlite`.",
|
||||
f"Потоки: {summary.get('workers', '?')}, время: {summary.get('elapsed_sec', '?')} с.",
|
||||
"",
|
||||
"Поиск: `python tools/index/query_1c.py search \"…\"`",
|
||||
"Переиндексация: `python tools/index/index_1c.py reindex` (инкремент) / `--full`.",
|
||||
"Поиск: `python query_1c.py search \"…\"`",
|
||||
"Переиндексация: `python index_1c.py reindex` (инкремент) / `--full`.",
|
||||
"",
|
||||
"## Конфигурации",
|
||||
"",
|
||||
|
||||
+53
-21
@@ -1,20 +1,20 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Переиндексация метаданных и модулей конфигураций 1С → cache/1c_meta/index.sqlite.
|
||||
"""Переиндексация метаданных и модулей 1С (конфигурации + внешние обработки) → cache/1c_meta/index.sqlite.
|
||||
|
||||
Параметры:
|
||||
--config, -c файл настроек утилиты (JSON)
|
||||
--baseconf, -b какие выгрузки 1С индексировать (crm3-26, target, …)
|
||||
--config, -c файл настроек утилиты (YAML)
|
||||
--baseconf, -b какие источники 1С индексировать (каталог с src/ или virtual external)
|
||||
|
||||
Примеры:
|
||||
|
||||
python tools/index/index_1c.py reindex -j 12
|
||||
python tools/index/index_1c.py reindex --full -j 12
|
||||
python tools/index/index_1c.py reindex --full -b crm3-26 -j 12
|
||||
python tools/index/index_1c.py reindex -b target -b ws-rhana -t Documents,Catalogs
|
||||
python tools/index/index_1c.py status
|
||||
python tools/index/index_1c.py list
|
||||
python index_1c.py reindex -j 12
|
||||
python index_1c.py reindex --full -j 12
|
||||
python index_1c.py reindex --full -b my-config -j 12
|
||||
python index_1c.py reindex -b main -b my-config.ext -t Documents,Catalogs
|
||||
python index_1c.py status
|
||||
python index_1c.py list
|
||||
|
||||
Поиск: python tools/index/query_1c.py …
|
||||
Поиск: python query_1c.py …
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
@@ -31,18 +31,19 @@ from index1c.build import build_project_index, default_workers # noqa: E402
|
||||
from index1c import read_version_file # noqa: E402
|
||||
from index1c.cli import ( # noqa: E402
|
||||
BaseconfError,
|
||||
add_baseconf_args,
|
||||
add_tool_args,
|
||||
handle_baseconf_error,
|
||||
index_db_missing_message,
|
||||
make_parent_parser,
|
||||
resolve_project_root,
|
||||
validate_baseconfs,
|
||||
)
|
||||
from index1c.config import ( # noqa: E402
|
||||
CONFIG_ALIASES,
|
||||
DEFAULT_SKIP_TYPES,
|
||||
cache_dir,
|
||||
discover_configs,
|
||||
get_default_baseconfs,
|
||||
get_config_aliases,
|
||||
resolve_object_type,
|
||||
)
|
||||
from index1c import db as dbmod # noqa: E402
|
||||
@@ -70,7 +71,17 @@ def _select_configs_for_reindex(args: argparse.Namespace, root: Path) -> list:
|
||||
sys.exit(e.exit_code)
|
||||
return discover_configs(root, names)
|
||||
|
||||
# без -b: все известные с src/
|
||||
# без -b: default_baseconfs из --config или автосканирование.
|
||||
defaults = get_default_baseconfs()
|
||||
if defaults:
|
||||
try:
|
||||
names = validate_baseconfs(root, defaults, require_indexed=False)
|
||||
except BaseconfError as e:
|
||||
print(str(e), file=sys.stderr)
|
||||
sys.exit(e.exit_code)
|
||||
return discover_configs(root, names)
|
||||
|
||||
# fallback: все каталоги с src/ в корне проекта
|
||||
return discover_configs(root, None)
|
||||
|
||||
|
||||
@@ -79,8 +90,9 @@ def cmd_reindex(args: argparse.Namespace) -> int:
|
||||
configs = _select_configs_for_reindex(args, root)
|
||||
if not configs:
|
||||
print(
|
||||
"Нет конфигураций для индексации (нужна папка <name>/src/).\n"
|
||||
"Укажите -b crm3-26 или проверьте: python tools/index/index_1c.py list",
|
||||
"Нет источников для индексации (нужна папка <name>/src/ "
|
||||
"или внешняя обработка <dir>/<name>.xml + <dir>/<name>/).\n"
|
||||
"Укажите -b <имя-выгрузки> или проверьте: python index_1c.py list",
|
||||
file=sys.stderr,
|
||||
)
|
||||
return 1
|
||||
@@ -150,7 +162,7 @@ def cmd_list_configs(args: argparse.Namespace) -> int:
|
||||
found = discover_configs(root, None)
|
||||
print("Выгрузки 1С в репозитории (для --baseconf / -b):")
|
||||
for c in found:
|
||||
aliases = [k for k, v in CONFIG_ALIASES.items() if v == c.name]
|
||||
aliases = [k for k, v in get_config_aliases().items() if v == c.name]
|
||||
alias_s = f" алиасы: {', '.join(aliases)}" if aliases else ""
|
||||
print(f"- {c.name}{alias_s}")
|
||||
db_path = dbmod.global_db_path(cache_dir(root))
|
||||
@@ -168,12 +180,15 @@ def cmd_list_configs(args: argparse.Namespace) -> int:
|
||||
|
||||
|
||||
def build_parser() -> argparse.ArgumentParser:
|
||||
tool_parent = make_parent_parser(include_baseconf=False)
|
||||
reindex_parent = make_parent_parser(include_baseconf=True, baseconf_mode="index")
|
||||
|
||||
p = argparse.ArgumentParser(
|
||||
description="Построение единого SQLite-индекса метаданных и BSL-модулей 1С.",
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
epilog=(
|
||||
"Конфигурация 1С: --baseconf (-b). Файл настроек утилиты: --config (-c).\n"
|
||||
"Алиасы baseconf: target→crm3-26, source→crm3-dev"
|
||||
"Алиасы/default для baseconf — в YAML (--config), см. config.example.yml"
|
||||
),
|
||||
)
|
||||
p.add_argument(
|
||||
@@ -184,8 +199,13 @@ def build_parser() -> argparse.ArgumentParser:
|
||||
add_tool_args(p)
|
||||
sub = p.add_subparsers(dest="cmd", required=True)
|
||||
|
||||
r = sub.add_parser("reindex", help="Построить / обновить index.sqlite")
|
||||
add_baseconf_args(r)
|
||||
r = sub.add_parser(
|
||||
"reindex",
|
||||
help="Построить / обновить index.sqlite",
|
||||
parents=[reindex_parent],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Построение или инкрементальное обновление index.sqlite.",
|
||||
)
|
||||
r.add_argument("--types", "-t", help="Только типы: Documents,Catalogs,рс,рн,…")
|
||||
r.add_argument("--skip-types", help="Дополнительно пропустить типы")
|
||||
r.add_argument("--include-skipped", action="store_true")
|
||||
@@ -205,10 +225,22 @@ def build_parser() -> argparse.ArgumentParser:
|
||||
r.add_argument("--md", action="store_true", help="Markdown в cache/1c_meta/md/")
|
||||
r.set_defaults(func=cmd_reindex)
|
||||
|
||||
st = sub.add_parser("status", help="Состояние index.sqlite")
|
||||
st = sub.add_parser(
|
||||
"status",
|
||||
help="Состояние index.sqlite",
|
||||
parents=[tool_parent],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Размер БД, meta и список проиндексированных конфигураций.",
|
||||
)
|
||||
st.set_defaults(func=cmd_status)
|
||||
|
||||
lc = sub.add_parser("list", help="Выгрузки в репозитории и в индексе")
|
||||
lc = sub.add_parser(
|
||||
"list",
|
||||
help="Источники в репозитории и в индексе",
|
||||
parents=[tool_parent],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Источники 1С в репозитории (src/ и external) и что уже в index.sqlite.",
|
||||
)
|
||||
lc.set_defaults(func=cmd_list_configs)
|
||||
|
||||
return p
|
||||
|
||||
+158
-47
@@ -2,20 +2,19 @@
|
||||
"""Запросы к единому индексу конфигураций 1С (cache/1c_meta/index.sqlite).
|
||||
|
||||
Параметры:
|
||||
--config, -c файл настроек утилиты (JSON), не конфигурация 1С
|
||||
--baseconf, -b выгрузка конфигурации 1С в репозитории (crm3-26, target, …)
|
||||
--config, -c файл настроек утилиты (YAML), не конфигурация 1С
|
||||
--baseconf, -b выгрузка конфигурации 1С в репозитории (имя каталога с src/)
|
||||
|
||||
Примеры:
|
||||
|
||||
python tools/index/query_1c.py search \"ЗаказКлиента\"
|
||||
python tools/index/query_1c.py search \"Партнер\" --type Document -b crm3-26
|
||||
python tools/index/query_1c.py show ЗаказКлиента -b target
|
||||
python tools/index/query_1c.py show Document.ЗаказКлиента -b crm3-26
|
||||
python tools/index/query_1c.py modules \"РВС_Transfer\" -b ws-rhana
|
||||
python tools/index/query_1c.py refs Catalog.Партнеры -b source
|
||||
python tools/index/query_1c.py object ЗаказКлиента -b target
|
||||
python tools/index/query_1c.py object Партнер -b crm3-26 --clear
|
||||
python tools/index/query_1c.py module CommonModules/РВС_TransferAPIДокументы
|
||||
python query_1c.py search \"Contract\"
|
||||
python query_1c.py search \"Partner\" --type Document -b my-config
|
||||
python query_1c.py show Document.Contract -b main
|
||||
python query_1c.py modules \"ProcessData\" -b my-config.ext
|
||||
python query_1c.py refs Catalog.Customers -b main
|
||||
python query_1c.py movements Document.Contract -b my-config
|
||||
python query_1c.py object Contract -b my-config --clear
|
||||
python query_1c.py module CommonModules/MyModule
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
@@ -33,16 +32,20 @@ from index1c.cli import ( # noqa: E402
|
||||
BaseconfError,
|
||||
add_baseconf_args,
|
||||
add_tool_args,
|
||||
extract_baseconf_argv,
|
||||
format_not_found_modules,
|
||||
format_not_found_object,
|
||||
get_baseconfs_for_query,
|
||||
handle_baseconf_error,
|
||||
index_db_missing_message,
|
||||
make_parent_parser,
|
||||
merge_baseconf_args,
|
||||
resolve_project_root,
|
||||
)
|
||||
from index1c.config import resolve_object_type # noqa: E402
|
||||
from index1c import read_version_file # noqa: E402
|
||||
from index1c.search import ( # noqa: E402
|
||||
find_movements,
|
||||
find_refs_to,
|
||||
get_module,
|
||||
get_object,
|
||||
@@ -51,9 +54,11 @@ from index1c.search import ( # noqa: E402
|
||||
search_objects,
|
||||
)
|
||||
from index1c.object_view import ( # noqa: E402
|
||||
enrich_matched_fields,
|
||||
find_structure_matches,
|
||||
format_object_tree,
|
||||
load_object_structure,
|
||||
load_object_structure_for_row,
|
||||
)
|
||||
|
||||
|
||||
@@ -88,7 +93,21 @@ def cmd_search(args: argparse.Namespace) -> int:
|
||||
for r in rows:
|
||||
syn = f" — {r['synonym']}" if r.get("synonym") else ""
|
||||
print(f"- [{r['config']}] `{r['full_name']}`{syn}")
|
||||
if r.get("snip"):
|
||||
matched = list(r.get("matched_fields") or [])
|
||||
if r.get("match_kind") == "field" and matched:
|
||||
obj = load_object_structure_for_row(conn, r)
|
||||
enrich_matched_fields(obj, matched)
|
||||
block = format_object_tree(
|
||||
obj,
|
||||
clear=True,
|
||||
matched_fields=matched,
|
||||
match_kind="field",
|
||||
omit_header=True,
|
||||
)
|
||||
for line in block.splitlines():
|
||||
if line:
|
||||
print(f" {line}")
|
||||
elif r.get("snip"):
|
||||
print(f" {r['snip']}")
|
||||
return 0
|
||||
finally:
|
||||
@@ -182,6 +201,62 @@ def cmd_refs(args: argparse.Namespace) -> int:
|
||||
conn.close()
|
||||
|
||||
|
||||
def cmd_movements(args: argparse.Namespace) -> int:
|
||||
root = resolve_project_root(args)
|
||||
conn = _open_or_exit(root)
|
||||
try:
|
||||
try:
|
||||
baseconfs = get_baseconfs_for_query(args, conn, root)
|
||||
except BaseconfError as e:
|
||||
return handle_baseconf_error(e)
|
||||
otype = resolve_object_type(args.type) if args.type else None
|
||||
resolved, rows = find_movements(
|
||||
conn,
|
||||
args.target,
|
||||
configs=baseconfs,
|
||||
object_type=otype,
|
||||
limit=args.limit,
|
||||
)
|
||||
if not resolved:
|
||||
print(
|
||||
format_not_found_object(args.target, baseconfs=baseconfs, conn=conn),
|
||||
file=sys.stderr,
|
||||
)
|
||||
return 2
|
||||
if not rows:
|
||||
names = ", ".join(f"`{r['full_name']}`" for r in resolved)
|
||||
print(f"Связей регистратор↔регистр для {names} не найдено.")
|
||||
return 2
|
||||
|
||||
# группировка: config → from_full_name → links
|
||||
current_cfg = None
|
||||
current_from = None
|
||||
for r in rows:
|
||||
if r["config"] != current_cfg:
|
||||
current_cfg = r["config"]
|
||||
current_from = None
|
||||
print(f"## [{current_cfg}]")
|
||||
if r["from_full_name"] != current_from:
|
||||
current_from = r["from_full_name"]
|
||||
syn = f" — {r['from_synonym']}" if r.get("from_synonym") else ""
|
||||
if r["direction"] == "document_to_registers":
|
||||
print(f"### Документ `{current_from}`{syn} → регистры движений")
|
||||
else:
|
||||
print(f"### Регистр `{current_from}`{syn} → регистраторы")
|
||||
to_syn = f" — {r['to_synonym']}" if r.get("to_synonym") else ""
|
||||
print(f"- `{r['to_full_name']}`{to_syn}")
|
||||
|
||||
if len(resolved) > 1:
|
||||
print()
|
||||
print(
|
||||
f"Найдено объектов: {len(resolved)}. "
|
||||
"Уточните полное имя (Document.… / AccumulationRegister.…) или --type."
|
||||
)
|
||||
return 0
|
||||
finally:
|
||||
conn.close()
|
||||
|
||||
|
||||
def cmd_show(args: argparse.Namespace) -> int:
|
||||
root = resolve_project_root(args)
|
||||
conn = _open_or_exit(root)
|
||||
@@ -224,29 +299,8 @@ def cmd_object(args: argparse.Namespace) -> int:
|
||||
if i:
|
||||
print()
|
||||
obj = load_object_structure(m)
|
||||
# подтянуть FillChecking/типы из свежего XML в matched_fields
|
||||
matched = list(m.get("matched_fields") or [])
|
||||
if matched and obj.get("fields"):
|
||||
by_f = {
|
||||
(
|
||||
f.get("tabular_section") or "",
|
||||
f.get("name") or "",
|
||||
f.get("kind") or "",
|
||||
): f
|
||||
for f in obj["fields"]
|
||||
}
|
||||
for mf in matched:
|
||||
key = (
|
||||
mf.get("tabular_section") or "",
|
||||
mf.get("name") or "",
|
||||
mf.get("kind") or "",
|
||||
)
|
||||
src = by_f.get(key)
|
||||
if src:
|
||||
mf["fill_checking"] = src.get("fill_checking") or ""
|
||||
mf["types"] = src.get("types") or mf.get("types")
|
||||
mf["synonym"] = src.get("synonym") or mf.get("synonym")
|
||||
mf["refs"] = src.get("refs") or mf.get("refs")
|
||||
enrich_matched_fields(obj, matched)
|
||||
# точное совпадение объекта (score 0) → clear без дерева;
|
||||
# иначе при найденных реквизитах — clear только по ним
|
||||
kind = m.get("match_kind") or "object"
|
||||
@@ -290,12 +344,15 @@ def cmd_module(args: argparse.Namespace) -> int:
|
||||
|
||||
|
||||
def build_parser() -> argparse.ArgumentParser:
|
||||
common = make_parent_parser(include_baseconf=True, baseconf_mode="query")
|
||||
|
||||
p = argparse.ArgumentParser(
|
||||
description="Поиск по cache/1c_meta/index.sqlite (метаданные и BSL-модули).",
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
epilog=(
|
||||
"Конфигурация 1С — параметр --baseconf (-b): папка выгрузки в репозитории.\n"
|
||||
"Файл настроек утилиты — --config (-c): см. tools/index/config.example.json"
|
||||
"Можно указать до или после подкоманды; несколько раз или через запятую.\n"
|
||||
"Файл настроек утилиты — --config (-c): см. config.example.yml"
|
||||
),
|
||||
)
|
||||
p.add_argument(
|
||||
@@ -304,18 +361,29 @@ def build_parser() -> argparse.ArgumentParser:
|
||||
version=f"%(prog)s {read_version_file()}",
|
||||
)
|
||||
add_tool_args(p)
|
||||
add_baseconf_args(p, mode="query")
|
||||
sub = p.add_subparsers(dest="cmd", required=True)
|
||||
|
||||
s = sub.add_parser("search", help="Полнотекстовый поиск объектов метаданных")
|
||||
s = sub.add_parser(
|
||||
"search",
|
||||
help="Полнотекстовый поиск объектов метаданных",
|
||||
parents=[common],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Поиск объектов по имени, синониму или фрагменту поля.",
|
||||
)
|
||||
s.add_argument("query", help="Имя, синоним, фрагмент поля")
|
||||
add_baseconf_args(s)
|
||||
s.add_argument("--type", help="Тип объекта: Document, Catalog, рс, …")
|
||||
s.add_argument("--limit", type=int, default=30)
|
||||
s.set_defaults(func=cmd_search)
|
||||
|
||||
m = sub.add_parser("modules", help="Поиск по BSL: процедуры, тело модуля, путь")
|
||||
m = sub.add_parser(
|
||||
"modules",
|
||||
help="Поиск по BSL: процедуры, тело модуля, путь",
|
||||
parents=[common],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Поиск по BSL-модулям: процедуры, фрагменты кода, путь файла.",
|
||||
)
|
||||
m.add_argument("query")
|
||||
add_baseconf_args(m)
|
||||
m.add_argument("--limit", type=int, default=30)
|
||||
m.add_argument(
|
||||
"--names-only",
|
||||
@@ -325,9 +393,14 @@ def build_parser() -> argparse.ArgumentParser:
|
||||
)
|
||||
m.set_defaults(func=cmd_modules)
|
||||
|
||||
ref = sub.add_parser("refs", help="Обратный индекс: кто ссылается на объект")
|
||||
ref = sub.add_parser(
|
||||
"refs",
|
||||
help="Обратный индекс: кто ссылается на объект",
|
||||
parents=[common],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Обратный индекс: какие реквизиты ссылаются на указанный объект.",
|
||||
)
|
||||
ref.add_argument("target", help="Catalog.Партнеры | CatalogRef.Партнеры | Партнеры")
|
||||
add_baseconf_args(ref)
|
||||
ref.add_argument(
|
||||
"--limit",
|
||||
type=int,
|
||||
@@ -336,17 +409,47 @@ def build_parser() -> argparse.ArgumentParser:
|
||||
)
|
||||
ref.set_defaults(func=cmd_refs)
|
||||
|
||||
sh = sub.add_parser("show", help="Карточка объекта (JSON: поля, типы, ссылки)")
|
||||
mov = sub.add_parser(
|
||||
"movements",
|
||||
help="Регистратор ↔ регистры движений (RegisterRecords)",
|
||||
parents=[common],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Связи документ ↔ регистры движений (RegisterRecords).",
|
||||
)
|
||||
mov.add_argument(
|
||||
"target",
|
||||
help="Document.ЗаказКлиента | AccumulationRegister.ТоварыНаСкладах | имя",
|
||||
)
|
||||
mov.add_argument(
|
||||
"--type",
|
||||
help="Уточнить тип: Document, AccumulationRegister, InformationRegister, …",
|
||||
)
|
||||
mov.add_argument(
|
||||
"--limit",
|
||||
type=int,
|
||||
default=200,
|
||||
help="Макс. связей на каждый найденный объект (по умолчанию 200)",
|
||||
)
|
||||
mov.set_defaults(func=cmd_movements)
|
||||
|
||||
sh = sub.add_parser(
|
||||
"show",
|
||||
help="Карточка объекта (JSON: поля, типы, ссылки)",
|
||||
parents=[common],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Полная карточка объекта в JSON (поля, типы, ссылки).",
|
||||
)
|
||||
sh.add_argument("name", help="ЗаказКлиента | Document.ЗаказКлиента")
|
||||
add_baseconf_args(sh)
|
||||
sh.set_defaults(func=cmd_show)
|
||||
|
||||
ob = sub.add_parser(
|
||||
"object",
|
||||
help="Структура объекта: дерево реквизитов, обязательность, типы",
|
||||
parents=[common],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Дерево структуры объекта: реквизиты, обязательность, типы.",
|
||||
)
|
||||
ob.add_argument("query", help="Имя/синоним объекта или реквизита")
|
||||
add_baseconf_args(ob)
|
||||
ob.add_argument("--type", help="Ограничить типом: Document, Catalog, …")
|
||||
ob.add_argument("--limit", type=int, default=10, help="Макс. число объектов")
|
||||
ob.add_argument(
|
||||
@@ -359,17 +462,25 @@ def build_parser() -> argparse.ArgumentParser:
|
||||
)
|
||||
ob.set_defaults(func=cmd_object)
|
||||
|
||||
md = sub.add_parser("module", help="Метаданные модуля по пути или owner")
|
||||
md = sub.add_parser(
|
||||
"module",
|
||||
help="Метаданные модуля по пути или owner",
|
||||
parents=[common],
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
description="Метаданные одного BSL-модуля по пути или имени owner.",
|
||||
)
|
||||
md.add_argument("path", help="CommonModules/… или CommonModule.Имя")
|
||||
add_baseconf_args(md)
|
||||
md.set_defaults(func=cmd_module)
|
||||
|
||||
return p
|
||||
|
||||
|
||||
def main(argv: list[str] | None = None) -> int:
|
||||
raw = list(argv if argv is not None else sys.argv[1:])
|
||||
early_baseconf, raw = extract_baseconf_argv(raw)
|
||||
parser = build_parser()
|
||||
args = parser.parse_args(argv)
|
||||
args = parser.parse_args(raw)
|
||||
merge_baseconf_args(args, early_baseconf)
|
||||
return int(args.func(args))
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user