Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 45e798f2bf | |||
| a4b7629d6a |
@@ -5,6 +5,33 @@
|
||||
Формат: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
||||
Версионирование: [Semantic Versioning](https://semver.org/lang/ru/).
|
||||
|
||||
## [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 crm3-26 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
|
||||
@@ -40,5 +67,6 @@
|
||||
- `query_1c.py`: `search`, `show`, `refs`, `modules`, `module`.
|
||||
- Инкремент по `mtime`+`size` файлов; индекс модулей `**/*.bsl`.
|
||||
|
||||
[0.3.0]: https://git.p7net.ru/1c/index/-/tags/v0.3.0
|
||||
[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,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.1**) · [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).
|
||||
|
||||
@@ -28,6 +30,7 @@ python tools/index/query_1c.py --version
|
||||
| Найти объект по имени/синониму | `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` |
|
||||
|
||||
@@ -84,8 +87,9 @@ python tools/index/query_1c.py --version
|
||||
|
||||
### Что индексируется
|
||||
|
||||
- **Метаданные** `src/<Тип>/*.xml`: имя, синоним, комментарий, реквизиты / измерения / ресурсы / ТЧ, типы (в т.ч. `TypeSet`), ссылки, `FillChecking`.
|
||||
- **Метаданные** `src/<Тип>/*.xml`: имя, синоним, комментарий, реквизиты / измерения / ресурсы / ТЧ, типы (в т.ч. `TypeSet`), ссылки, `FillChecking`, `RegisterRecords` (документ → регистры движений).
|
||||
- **Модули** `**/*.bsl`: путь, owner (`Document.X`), вид модуля, имена процедур/функций, тело (до 200 КБ в FTS).
|
||||
- **Связи движений** — таблица `register_records` (обратный индекс регистраторов).
|
||||
|
||||
По умолчанию пропускаются: `CommonPicture`, `StyleItem`, `XDTOPackage`, `CommonTemplate`, `Language`, `Bot`.
|
||||
|
||||
@@ -119,6 +123,7 @@ python tools/index/index_1c.py list
|
||||
| `object` | имя/синоним объекта **или** реквизита | дерево структуры | `-b`, `--type`, `--clear`, `--limit` |
|
||||
| `show` | имя объекта | полная карточка JSON | `-b` |
|
||||
| `refs` | `Catalog.Партнеры` / `ЗаказКлиента` | обратные ссылки полей | `-b`, `--limit` (на каждую baseconf) |
|
||||
| `movements` | документ или регистр | регистратор ↔ регистры движений | `-b`, `--type`, `--limit` |
|
||||
| `modules` | строка | поиск по BSL | `-b`, `-n` / `--names-only`, `--limit` |
|
||||
| `module` | путь или owner | символы модуля, строки | `-b` |
|
||||
|
||||
@@ -159,6 +164,21 @@ python tools/index/query_1c.py refs Document.ЗаказКлиента -b source
|
||||
Без `-b` — все конфигурации в индексе; `--limit` действует **на каждую**.
|
||||
Составной тип поля: `→ DocumentRef.ЗаказКлиента (среди прочего: DocumentRef.…)`.
|
||||
|
||||
### `movements` — регистратор ↔ регистры движений
|
||||
|
||||
```bash
|
||||
# документ → регистры, в которых он регистратор
|
||||
python tools/index/query_1c.py movements ЗаказКлиента -b target
|
||||
python tools/index/query_1c.py movements Document.РеализацияТоваровУслуг -b target
|
||||
|
||||
# регистр → документы-регистраторы
|
||||
python tools/index/query_1c.py movements AccumulationRegister.ТоварыНаСкладах -b target
|
||||
python tools/index/query_1c.py movements ТоварыНаСкладах -b target --type AccumulationRegister
|
||||
```
|
||||
|
||||
Данные из свойства метаданных `RegisterRecords` (таблица `register_records` в индексе).
|
||||
При первом запуске утилиты v0.3+ схема индекса мигрирует 2→3 автоматически (без полного `reindex`).
|
||||
|
||||
### `modules` / `module`
|
||||
|
||||
```bash
|
||||
@@ -220,3 +240,36 @@ cache/1c_meta/ # в корне проекта CRM3-26 (gitignore)
|
||||
```
|
||||
|
||||
Per-config `search.sqlite` устарели и не используются.
|
||||
|
||||
---
|
||||
|
||||
## Автор и обратная связь
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Автор** | Michael BAG |
|
||||
| **E-mail** | [mk@p7net.ru](mailto:mk@p7net.ru) |
|
||||
| **Предложения, вопросы, ошибки** | пишите на **mk@p7net.ru** |
|
||||
|
||||
Репозиторий: <https://git.p7net.ru/1c/index.git>
|
||||
|
||||
---
|
||||
|
||||
## Лицензирование
|
||||
|
||||
Программа **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.
|
||||
|
||||
+4
-1
@@ -2,8 +2,11 @@
|
||||
|
||||
from pathlib import Path
|
||||
|
||||
__version__ = "0.2.0"
|
||||
__version__ = "0.3.1"
|
||||
__status__ = "in development"
|
||||
__author__ = "Michael BAG"
|
||||
__email__ = "mk@p7net.ru"
|
||||
__license__ = "GPL-3.0-or-later"
|
||||
|
||||
|
||||
def read_version_file() -> str:
|
||||
|
||||
+64
-3
@@ -62,8 +62,16 @@ def add_tool_args(parser: argparse.ArgumentParser) -> None:
|
||||
)
|
||||
|
||||
|
||||
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 = "Без параметра — индексировать все выгрузки с src/ в репозитории."
|
||||
else:
|
||||
default_hint = "Без параметра — поиск по всем проиндексированным."
|
||||
parser.add_argument(
|
||||
"--baseconf",
|
||||
"-b",
|
||||
@@ -72,12 +80,65 @@ def add_baseconf_args(parser: argparse.ArgumentParser) -> None:
|
||||
dest="baseconf",
|
||||
help=(
|
||||
"Конфигурация 1С в репозитории (папка <name>/src/). "
|
||||
"Можно несколько раз. Алиасы: target→crm3-26, source→crm3-dev. "
|
||||
"Без параметра — поиск по всем проиндексированным."
|
||||
"Можно несколько раз или через запятую: -b target,source. "
|
||||
"Алиасы: target→crm3-26, source→crm3-dev. "
|
||||
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:
|
||||
|
||||
+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}). "
|
||||
"Обновите tools/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
|
||||
|
||||
|
||||
|
||||
@@ -25,9 +25,238 @@ def open_index(project_root: Path, *, readonly: bool = True) -> sqlite3.Connecti
|
||||
raise FileNotFoundError(
|
||||
f"Индекс не найден: {path}. Запустите: python tools/index/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,
|
||||
|
||||
+25
-5
@@ -31,10 +31,10 @@ 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,
|
||||
)
|
||||
@@ -168,6 +168,9 @@ 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,
|
||||
@@ -184,8 +187,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 +213,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/ в репозитории и что уже в index.sqlite.",
|
||||
)
|
||||
lc.set_defaults(func=cmd_list_configs)
|
||||
|
||||
return p
|
||||
|
||||
+131
-12
@@ -13,6 +13,8 @@
|
||||
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 movements ЗаказКлиента -b target
|
||||
python tools/index/query_1c.py movements AccumulationRegister.ТоварыНаСкладах -b target
|
||||
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Документы
|
||||
@@ -33,16 +35,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,
|
||||
@@ -182,6 +188,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)
|
||||
@@ -290,11 +352,14 @@ 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"
|
||||
"Можно указать до или после подкоманды; несколько раз или через запятую.\n"
|
||||
"Файл настроек утилиты — --config (-c): см. tools/index/config.example.json"
|
||||
),
|
||||
)
|
||||
@@ -304,18 +369,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 +401,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 +417,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 +470,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