forked from Mirrors/doipjs
Initial commit
This commit is contained in:
commit
e996bc8023
1639 changed files with 322580 additions and 0 deletions
613
LICENSE
Normal file
613
LICENSE
Normal file
|
@ -0,0 +1,613 @@
|
||||||
|
GNU AFFERO GENERAL PUBLIC LICENSE
|
||||||
|
|
||||||
|
Version 3, 19 November 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 Affero General Public License is a free, copyleft license for software
|
||||||
|
and other kinds of works, specifically designed to ensure cooperation with
|
||||||
|
the community in the case of network server software.
|
||||||
|
|
||||||
|
The licenses for most software and other practical works are designed to take
|
||||||
|
away your freedom to share and change the works. By contrast, our General
|
||||||
|
Public Licenses are 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.
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
Developers that use our General Public Licenses protect your rights with two
|
||||||
|
steps: (1) assert copyright on the software, and (2) offer you this License
|
||||||
|
which gives you legal permission to copy, distribute and/or modify the software.
|
||||||
|
|
||||||
|
A secondary benefit of defending all users' freedom is that improvements made
|
||||||
|
in alternate versions of the program, if they receive widespread use, become
|
||||||
|
available for other developers to incorporate. Many developers of free software
|
||||||
|
are heartened and encouraged by the resulting cooperation. However, in the
|
||||||
|
case of software used on network servers, this result may fail to come about.
|
||||||
|
The GNU General Public License permits making a modified version and letting
|
||||||
|
the public access it on a server without ever releasing its source code to
|
||||||
|
the public.
|
||||||
|
|
||||||
|
The GNU Affero General Public License is designed specifically to ensure that,
|
||||||
|
in such cases, the modified source code becomes available to the community.
|
||||||
|
It requires the operator of a network server to provide the source code of
|
||||||
|
the modified version running there to the users of that server. Therefore,
|
||||||
|
public use of a modified version, on a publicly accessible server, gives the
|
||||||
|
public access to the source code of the modified version.
|
||||||
|
|
||||||
|
An older license, called the Affero General Public License and published by
|
||||||
|
Affero, was designed to accomplish similar goals. This is a different license,
|
||||||
|
not a version of the Affero GPL, but Affero has released a new version of
|
||||||
|
the Affero GPL which permits relicensing under this license.
|
||||||
|
|
||||||
|
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 Affero 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 s ue 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. Remote Network Interaction; Use with the GNU General Public License.
|
||||||
|
|
||||||
|
Notwithstanding any other provision of this License, if you modify the Program,
|
||||||
|
your modified version must prominently offer all users interacting with it
|
||||||
|
remotely through a computer network (if your version supports such interaction)
|
||||||
|
an opportunity to receive the Corresponding Source of your version by providing
|
||||||
|
access to the Corresponding Source from a network server at no charge, through
|
||||||
|
some standard or customary means of facilitating copying of software. This
|
||||||
|
Corresponding Source shall include the Corresponding Source for any work covered
|
||||||
|
by version 3 of the GNU General Public License that is incorporated pursuant
|
||||||
|
to the following paragraph.
|
||||||
|
|
||||||
|
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 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 work with which it is combined will remain
|
||||||
|
governed by version 3 of the GNU General Public License.
|
||||||
|
|
||||||
|
14. Revised Versions of this License.
|
||||||
|
|
||||||
|
The Free Software Foundation may publish revised and/or new versions of the
|
||||||
|
GNU Affero 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 Affero 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 Affero 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 Affero 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 Affero 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 Affero General Public License for more
|
||||||
|
details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU Affero 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 your software can interact with users remotely through a computer network,
|
||||||
|
you should also make sure that it provides a way for users to get its source.
|
||||||
|
For example, if your program is a web application, its interface could display
|
||||||
|
a "Source" link that leads users to an archive of the code. There are many
|
||||||
|
ways you could offer source, and different solutions will be better for different
|
||||||
|
programs; see section 13 for the specific requirements.
|
||||||
|
|
||||||
|
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 AGPL, see <https://www.gnu.org/licenses/>.
|
27
LICENSE.HEADER
Normal file
27
LICENSE.HEADER
Normal file
|
@ -0,0 +1,27 @@
|
||||||
|
Copyright (C) 2020 Yarmo Mackenbach
|
||||||
|
|
||||||
|
This program is free software: you can redistribute it and/or modify it under
|
||||||
|
the terms of the GNU Affero 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 Affero General Public License for more
|
||||||
|
details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU Affero 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 your software can interact with users remotely through a computer network,
|
||||||
|
you should also make sure that it provides a way for users to get its source.
|
||||||
|
For example, if your program is a web application, its interface could display
|
||||||
|
a "Source" link that leads users to an archive of the code. There are many
|
||||||
|
ways you could offer source, and different solutions will be better for different
|
||||||
|
programs; see section 13 for the specific requirements.
|
||||||
|
|
||||||
|
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 AGPL, see <https://www.gnu.org/licenses/>.
|
18
license-checker-config.json
Normal file
18
license-checker-config.json
Normal file
|
@ -0,0 +1,18 @@
|
||||||
|
{
|
||||||
|
"ignore": ".licenseignore",
|
||||||
|
"license": "LICENSE.HEADER",
|
||||||
|
"licenseFormats": {
|
||||||
|
"php": {
|
||||||
|
"prepend": "<?php",
|
||||||
|
"append": "?>",
|
||||||
|
"eachLine": {
|
||||||
|
"prepend": "// "
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"dotfile|licenseignore|gitignore|yml": {
|
||||||
|
"eachLine": {
|
||||||
|
"prepend": "# "
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
1
node_modules/.bin/_mocha
generated
vendored
Symbolic link
1
node_modules/.bin/_mocha
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../mocha/bin/_mocha
|
1
node_modules/.bin/esparse
generated
vendored
Symbolic link
1
node_modules/.bin/esparse
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../esprima/bin/esparse.js
|
1
node_modules/.bin/esvalidate
generated
vendored
Symbolic link
1
node_modules/.bin/esvalidate
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../esprima/bin/esvalidate.js
|
1
node_modules/.bin/flat
generated
vendored
Symbolic link
1
node_modules/.bin/flat
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../flat/cli.js
|
1
node_modules/.bin/he
generated
vendored
Symbolic link
1
node_modules/.bin/he
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../he/bin/he
|
1
node_modules/.bin/js-yaml
generated
vendored
Symbolic link
1
node_modules/.bin/js-yaml
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../js-yaml/bin/js-yaml.js
|
1
node_modules/.bin/license-check-and-add
generated
vendored
Symbolic link
1
node_modules/.bin/license-check-and-add
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../license-check-and-add/dist/src/cli.js
|
1
node_modules/.bin/mime
generated
vendored
Symbolic link
1
node_modules/.bin/mime
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../mime/cli.js
|
1
node_modules/.bin/mocha
generated
vendored
Symbolic link
1
node_modules/.bin/mocha
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../mocha/bin/mocha
|
1
node_modules/.bin/nanoid
generated
vendored
Symbolic link
1
node_modules/.bin/nanoid
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../nanoid/bin/nanoid.cjs
|
1
node_modules/.bin/node-which
generated
vendored
Symbolic link
1
node_modules/.bin/node-which
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../which/bin/node-which
|
1
node_modules/.bin/semver
generated
vendored
Symbolic link
1
node_modules/.bin/semver
generated
vendored
Symbolic link
|
@ -0,0 +1 @@
|
||||||
|
../semver/bin/semver.js
|
21
node_modules/@nodelib/fs.scandir/LICENSE
generated
vendored
Normal file
21
node_modules/@nodelib/fs.scandir/LICENSE
generated
vendored
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) Denis Malinochkin
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
171
node_modules/@nodelib/fs.scandir/README.md
generated
vendored
Normal file
171
node_modules/@nodelib/fs.scandir/README.md
generated
vendored
Normal file
|
@ -0,0 +1,171 @@
|
||||||
|
# @nodelib/fs.scandir
|
||||||
|
|
||||||
|
> List files and directories inside the specified directory.
|
||||||
|
|
||||||
|
## :bulb: Highlights
|
||||||
|
|
||||||
|
The package is aimed at obtaining information about entries in the directory.
|
||||||
|
|
||||||
|
* :moneybag: Returns useful information: `name`, `path`, `dirent` and `stats` (optional).
|
||||||
|
* :gear: On Node.js 10.10+ uses the mechanism without additional calls to determine the entry type. See [`old` and `modern` mode](#old-and-modern-mode).
|
||||||
|
* :link: Can safely work with broken symbolic links.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```console
|
||||||
|
npm install @nodelib/fs.scandir
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import * as fsScandir from '@nodelib/fs.scandir';
|
||||||
|
|
||||||
|
fsScandir.scandir('path', (error, stats) => { /* … */ });
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### .scandir(path, [optionsOrSettings], callback)
|
||||||
|
|
||||||
|
Returns an array of plain objects ([`Entry`](#entry)) with information about entry for provided path with standard callback-style.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
fsScandir.scandir('path', (error, entries) => { /* … */ });
|
||||||
|
fsScandir.scandir('path', {}, (error, entries) => { /* … */ });
|
||||||
|
fsScandir.scandir('path', new fsScandir.Settings(), (error, entries) => { /* … */ });
|
||||||
|
```
|
||||||
|
|
||||||
|
### .scandirSync(path, [optionsOrSettings])
|
||||||
|
|
||||||
|
Returns an array of plain objects ([`Entry`](#entry)) with information about entry for provided path.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const entries = fsScandir.scandirSync('path');
|
||||||
|
const entries = fsScandir.scandirSync('path', {});
|
||||||
|
const entries = fsScandir.scandirSync(('path', new fsScandir.Settings());
|
||||||
|
```
|
||||||
|
|
||||||
|
#### path
|
||||||
|
|
||||||
|
* Required: `true`
|
||||||
|
* Type: `string | Buffer | URL`
|
||||||
|
|
||||||
|
A path to a file. If a URL is provided, it must use the `file:` protocol.
|
||||||
|
|
||||||
|
#### optionsOrSettings
|
||||||
|
|
||||||
|
* Required: `false`
|
||||||
|
* Type: `Options | Settings`
|
||||||
|
* Default: An instance of `Settings` class
|
||||||
|
|
||||||
|
An [`Options`](#options) object or an instance of [`Settings`](#settingsoptions) class.
|
||||||
|
|
||||||
|
> :book: When you pass a plain object, an instance of the `Settings` class will be created automatically. If you plan to call the method frequently, use a pre-created instance of the `Settings` class.
|
||||||
|
|
||||||
|
### Settings([options])
|
||||||
|
|
||||||
|
A class of full settings of the package.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const settings = new fsScandir.Settings({ followSymbolicLinks: false });
|
||||||
|
|
||||||
|
const entries = fsScandir.scandirSync('path', settings);
|
||||||
|
```
|
||||||
|
|
||||||
|
## Entry
|
||||||
|
|
||||||
|
* `name` — The name of the entry (`unknown.txt`).
|
||||||
|
* `path` — The path of the entry relative to call directory (`root/unknown.txt`).
|
||||||
|
* `dirent` — An instance of [`fs.Dirent`](./src/types/index.ts) class. On Node.js below 10.10 will be emulated by [`DirentFromStats`](./src/utils/fs.ts) class.
|
||||||
|
* `stats` (optional) — An instance of `fs.Stats` class.
|
||||||
|
|
||||||
|
For example, the `scandir` call for `tools` directory with one directory inside:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
{
|
||||||
|
dirent: Dirent { name: 'typedoc', /* … */ },
|
||||||
|
name: 'typedoc',
|
||||||
|
path: 'tools/typedoc'
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### stats
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `false`
|
||||||
|
|
||||||
|
Adds an instance of `fs.Stats` class to the [`Entry`](#entry).
|
||||||
|
|
||||||
|
> :book: Always use `fs.readdir` without the `withFileTypes` option. ??TODO??
|
||||||
|
|
||||||
|
### followSymbolicLinks
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `false`
|
||||||
|
|
||||||
|
Follow symbolic links or not. Call `fs.stat` on symbolic link if `true`.
|
||||||
|
|
||||||
|
### `throwErrorOnBrokenSymbolicLink`
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `true`
|
||||||
|
|
||||||
|
Throw an error when symbolic link is broken if `true` or safely use `lstat` call if `false`.
|
||||||
|
|
||||||
|
### `pathSegmentSeparator`
|
||||||
|
|
||||||
|
* Type: `string`
|
||||||
|
* Default: `path.sep`
|
||||||
|
|
||||||
|
By default, this package uses the correct path separator for your OS (`\` on Windows, `/` on Unix-like systems). But you can set this option to any separator character(s) that you want to use instead.
|
||||||
|
|
||||||
|
### `fs`
|
||||||
|
|
||||||
|
* Type: [`FileSystemAdapter`](./src/adapters/fs.ts)
|
||||||
|
* Default: A default FS methods
|
||||||
|
|
||||||
|
By default, the built-in Node.js module (`fs`) is used to work with the file system. You can replace any method with your own.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
interface FileSystemAdapter {
|
||||||
|
lstat?: typeof fs.lstat;
|
||||||
|
stat?: typeof fs.stat;
|
||||||
|
lstatSync?: typeof fs.lstatSync;
|
||||||
|
statSync?: typeof fs.statSync;
|
||||||
|
readdir?: typeof fs.readdir;
|
||||||
|
readdirSync?: typeof fs.readdirSync;
|
||||||
|
}
|
||||||
|
|
||||||
|
const settings = new fsScandir.Settings({
|
||||||
|
fs: { lstat: fakeLstat }
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## `old` and `modern` mode
|
||||||
|
|
||||||
|
This package has two modes that are used depending on the environment and parameters of use.
|
||||||
|
|
||||||
|
### old
|
||||||
|
|
||||||
|
* Node.js below `10.10` or when the `stats` option is enabled
|
||||||
|
|
||||||
|
When working in the old mode, the directory is read first (`fs.readdir`), then the type of entries is determined (`fs.lstat` and/or `fs.stat` for symbolic links).
|
||||||
|
|
||||||
|
### modern
|
||||||
|
|
||||||
|
* Node.js 10.10+ and the `stats` option is disabled
|
||||||
|
|
||||||
|
In the modern mode, reading the directory (`fs.readdir` with the `withFileTypes` option) is combined with obtaining information about its entries. An additional call for symbolic links (`fs.stat`) is still present.
|
||||||
|
|
||||||
|
This mode makes fewer calls to the file system. It's faster.
|
||||||
|
|
||||||
|
## Changelog
|
||||||
|
|
||||||
|
See the [Releases section of our GitHub project](https://github.com/nodelib/nodelib/releases) for changelog for each release version.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This software is released under the terms of the MIT license.
|
13
node_modules/@nodelib/fs.scandir/out/adapters/fs.d.ts
generated
vendored
Normal file
13
node_modules/@nodelib/fs.scandir/out/adapters/fs.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import * as fs from 'fs';
|
||||||
|
export declare type FileSystemAdapter = {
|
||||||
|
lstat: typeof fs.lstat;
|
||||||
|
stat: typeof fs.stat;
|
||||||
|
lstatSync: typeof fs.lstatSync;
|
||||||
|
statSync: typeof fs.statSync;
|
||||||
|
readdir: typeof fs.readdir;
|
||||||
|
readdirSync: typeof fs.readdirSync;
|
||||||
|
};
|
||||||
|
export declare const FILE_SYSTEM_ADAPTER: FileSystemAdapter;
|
||||||
|
export declare function createFileSystemAdapter(fsMethods?: Partial<FileSystemAdapter>): FileSystemAdapter;
|
||||||
|
//# sourceMappingURL=fs.d.ts.map
|
18
node_modules/@nodelib/fs.scandir/out/adapters/fs.js
generated
vendored
Normal file
18
node_modules/@nodelib/fs.scandir/out/adapters/fs.js
generated
vendored
Normal file
|
@ -0,0 +1,18 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fs = require("fs");
|
||||||
|
exports.FILE_SYSTEM_ADAPTER = {
|
||||||
|
lstat: fs.lstat,
|
||||||
|
stat: fs.stat,
|
||||||
|
lstatSync: fs.lstatSync,
|
||||||
|
statSync: fs.statSync,
|
||||||
|
readdir: fs.readdir,
|
||||||
|
readdirSync: fs.readdirSync
|
||||||
|
};
|
||||||
|
function createFileSystemAdapter(fsMethods) {
|
||||||
|
if (fsMethods === undefined) {
|
||||||
|
return exports.FILE_SYSTEM_ADAPTER;
|
||||||
|
}
|
||||||
|
return Object.assign(Object.assign({}, exports.FILE_SYSTEM_ADAPTER), fsMethods);
|
||||||
|
}
|
||||||
|
exports.createFileSystemAdapter = createFileSystemAdapter;
|
5
node_modules/@nodelib/fs.scandir/out/constants.d.ts
generated
vendored
Normal file
5
node_modules/@nodelib/fs.scandir/out/constants.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
/**
|
||||||
|
* IS `true` for Node.js 10.10 and greater.
|
||||||
|
*/
|
||||||
|
export declare const IS_SUPPORT_READDIR_WITH_FILE_TYPES: boolean;
|
||||||
|
//# sourceMappingURL=constants.d.ts.map
|
13
node_modules/@nodelib/fs.scandir/out/constants.js
generated
vendored
Normal file
13
node_modules/@nodelib/fs.scandir/out/constants.js
generated
vendored
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const NODE_PROCESS_VERSION_PARTS = process.versions.node.split('.');
|
||||||
|
const MAJOR_VERSION = parseInt(NODE_PROCESS_VERSION_PARTS[0], 10);
|
||||||
|
const MINOR_VERSION = parseInt(NODE_PROCESS_VERSION_PARTS[1], 10);
|
||||||
|
const SUPPORTED_MAJOR_VERSION = 10;
|
||||||
|
const SUPPORTED_MINOR_VERSION = 10;
|
||||||
|
const IS_MATCHED_BY_MAJOR = MAJOR_VERSION > SUPPORTED_MAJOR_VERSION;
|
||||||
|
const IS_MATCHED_BY_MAJOR_AND_MINOR = MAJOR_VERSION === SUPPORTED_MAJOR_VERSION && MINOR_VERSION >= SUPPORTED_MINOR_VERSION;
|
||||||
|
/**
|
||||||
|
* IS `true` for Node.js 10.10 and greater.
|
||||||
|
*/
|
||||||
|
exports.IS_SUPPORT_READDIR_WITH_FILE_TYPES = IS_MATCHED_BY_MAJOR || IS_MATCHED_BY_MAJOR_AND_MINOR;
|
13
node_modules/@nodelib/fs.scandir/out/index.d.ts
generated
vendored
Normal file
13
node_modules/@nodelib/fs.scandir/out/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
import { FileSystemAdapter } from './adapters/fs';
|
||||||
|
import * as async from './providers/async';
|
||||||
|
import Settings, { Options } from './settings';
|
||||||
|
import { Dirent, Entry } from './types';
|
||||||
|
declare type AsyncCallback = async.AsyncCallback;
|
||||||
|
declare function scandir(path: string, callback: AsyncCallback): void;
|
||||||
|
declare function scandir(path: string, optionsOrSettings: Options | Settings, callback: AsyncCallback): void;
|
||||||
|
declare namespace scandir {
|
||||||
|
function __promisify__(path: string, optionsOrSettings?: Options | Settings): Promise<Entry[]>;
|
||||||
|
}
|
||||||
|
declare function scandirSync(path: string, optionsOrSettings?: Options | Settings): Entry[];
|
||||||
|
export { scandir, scandirSync, Settings, AsyncCallback, Dirent, Entry, FileSystemAdapter, Options };
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
24
node_modules/@nodelib/fs.scandir/out/index.js
generated
vendored
Normal file
24
node_modules/@nodelib/fs.scandir/out/index.js
generated
vendored
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const async = require("./providers/async");
|
||||||
|
const sync = require("./providers/sync");
|
||||||
|
const settings_1 = require("./settings");
|
||||||
|
exports.Settings = settings_1.default;
|
||||||
|
function scandir(path, optionsOrSettingsOrCallback, callback) {
|
||||||
|
if (typeof optionsOrSettingsOrCallback === 'function') {
|
||||||
|
return async.read(path, getSettings(), optionsOrSettingsOrCallback);
|
||||||
|
}
|
||||||
|
async.read(path, getSettings(optionsOrSettingsOrCallback), callback);
|
||||||
|
}
|
||||||
|
exports.scandir = scandir;
|
||||||
|
function scandirSync(path, optionsOrSettings) {
|
||||||
|
const settings = getSettings(optionsOrSettings);
|
||||||
|
return sync.read(path, settings);
|
||||||
|
}
|
||||||
|
exports.scandirSync = scandirSync;
|
||||||
|
function getSettings(settingsOrOptions = {}) {
|
||||||
|
if (settingsOrOptions instanceof settings_1.default) {
|
||||||
|
return settingsOrOptions;
|
||||||
|
}
|
||||||
|
return new settings_1.default(settingsOrOptions);
|
||||||
|
}
|
8
node_modules/@nodelib/fs.scandir/out/providers/async.d.ts
generated
vendored
Normal file
8
node_modules/@nodelib/fs.scandir/out/providers/async.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import Settings from '../settings';
|
||||||
|
import { Entry } from '../types';
|
||||||
|
export declare type AsyncCallback = (err: NodeJS.ErrnoException, entries: Entry[]) => void;
|
||||||
|
export declare function read(directory: string, settings: Settings, callback: AsyncCallback): void;
|
||||||
|
export declare function readdirWithFileTypes(directory: string, settings: Settings, callback: AsyncCallback): void;
|
||||||
|
export declare function readdir(directory: string, settings: Settings, callback: AsyncCallback): void;
|
||||||
|
//# sourceMappingURL=async.d.ts.map
|
90
node_modules/@nodelib/fs.scandir/out/providers/async.js
generated
vendored
Normal file
90
node_modules/@nodelib/fs.scandir/out/providers/async.js
generated
vendored
Normal file
|
@ -0,0 +1,90 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fsStat = require("@nodelib/fs.stat");
|
||||||
|
const rpl = require("run-parallel");
|
||||||
|
const constants_1 = require("../constants");
|
||||||
|
const utils = require("../utils");
|
||||||
|
function read(directory, settings, callback) {
|
||||||
|
if (!settings.stats && constants_1.IS_SUPPORT_READDIR_WITH_FILE_TYPES) {
|
||||||
|
return readdirWithFileTypes(directory, settings, callback);
|
||||||
|
}
|
||||||
|
return readdir(directory, settings, callback);
|
||||||
|
}
|
||||||
|
exports.read = read;
|
||||||
|
function readdirWithFileTypes(directory, settings, callback) {
|
||||||
|
settings.fs.readdir(directory, { withFileTypes: true }, (readdirError, dirents) => {
|
||||||
|
if (readdirError !== null) {
|
||||||
|
return callFailureCallback(callback, readdirError);
|
||||||
|
}
|
||||||
|
const entries = dirents.map((dirent) => ({
|
||||||
|
dirent,
|
||||||
|
name: dirent.name,
|
||||||
|
path: `${directory}${settings.pathSegmentSeparator}${dirent.name}`
|
||||||
|
}));
|
||||||
|
if (!settings.followSymbolicLinks) {
|
||||||
|
return callSuccessCallback(callback, entries);
|
||||||
|
}
|
||||||
|
const tasks = entries.map((entry) => makeRplTaskEntry(entry, settings));
|
||||||
|
rpl(tasks, (rplError, rplEntries) => {
|
||||||
|
if (rplError !== null) {
|
||||||
|
return callFailureCallback(callback, rplError);
|
||||||
|
}
|
||||||
|
callSuccessCallback(callback, rplEntries);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
}
|
||||||
|
exports.readdirWithFileTypes = readdirWithFileTypes;
|
||||||
|
function makeRplTaskEntry(entry, settings) {
|
||||||
|
return (done) => {
|
||||||
|
if (!entry.dirent.isSymbolicLink()) {
|
||||||
|
return done(null, entry);
|
||||||
|
}
|
||||||
|
settings.fs.stat(entry.path, (statError, stats) => {
|
||||||
|
if (statError !== null) {
|
||||||
|
if (settings.throwErrorOnBrokenSymbolicLink) {
|
||||||
|
return done(statError);
|
||||||
|
}
|
||||||
|
return done(null, entry);
|
||||||
|
}
|
||||||
|
entry.dirent = utils.fs.createDirentFromStats(entry.name, stats);
|
||||||
|
return done(null, entry);
|
||||||
|
});
|
||||||
|
};
|
||||||
|
}
|
||||||
|
function readdir(directory, settings, callback) {
|
||||||
|
settings.fs.readdir(directory, (readdirError, names) => {
|
||||||
|
if (readdirError !== null) {
|
||||||
|
return callFailureCallback(callback, readdirError);
|
||||||
|
}
|
||||||
|
const filepaths = names.map((name) => `${directory}${settings.pathSegmentSeparator}${name}`);
|
||||||
|
const tasks = filepaths.map((filepath) => {
|
||||||
|
return (done) => fsStat.stat(filepath, settings.fsStatSettings, done);
|
||||||
|
});
|
||||||
|
rpl(tasks, (rplError, results) => {
|
||||||
|
if (rplError !== null) {
|
||||||
|
return callFailureCallback(callback, rplError);
|
||||||
|
}
|
||||||
|
const entries = [];
|
||||||
|
names.forEach((name, index) => {
|
||||||
|
const stats = results[index];
|
||||||
|
const entry = {
|
||||||
|
name,
|
||||||
|
path: filepaths[index],
|
||||||
|
dirent: utils.fs.createDirentFromStats(name, stats)
|
||||||
|
};
|
||||||
|
if (settings.stats) {
|
||||||
|
entry.stats = stats;
|
||||||
|
}
|
||||||
|
entries.push(entry);
|
||||||
|
});
|
||||||
|
callSuccessCallback(callback, entries);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
}
|
||||||
|
exports.readdir = readdir;
|
||||||
|
function callFailureCallback(callback, error) {
|
||||||
|
callback(error);
|
||||||
|
}
|
||||||
|
function callSuccessCallback(callback, result) {
|
||||||
|
callback(null, result);
|
||||||
|
}
|
6
node_modules/@nodelib/fs.scandir/out/providers/sync.d.ts
generated
vendored
Normal file
6
node_modules/@nodelib/fs.scandir/out/providers/sync.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
import Settings from '../settings';
|
||||||
|
import { Entry } from '../types';
|
||||||
|
export declare function read(directory: string, settings: Settings): Entry[];
|
||||||
|
export declare function readdirWithFileTypes(directory: string, settings: Settings): Entry[];
|
||||||
|
export declare function readdir(directory: string, settings: Settings): Entry[];
|
||||||
|
//# sourceMappingURL=sync.d.ts.map
|
52
node_modules/@nodelib/fs.scandir/out/providers/sync.js
generated
vendored
Normal file
52
node_modules/@nodelib/fs.scandir/out/providers/sync.js
generated
vendored
Normal file
|
@ -0,0 +1,52 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fsStat = require("@nodelib/fs.stat");
|
||||||
|
const constants_1 = require("../constants");
|
||||||
|
const utils = require("../utils");
|
||||||
|
function read(directory, settings) {
|
||||||
|
if (!settings.stats && constants_1.IS_SUPPORT_READDIR_WITH_FILE_TYPES) {
|
||||||
|
return readdirWithFileTypes(directory, settings);
|
||||||
|
}
|
||||||
|
return readdir(directory, settings);
|
||||||
|
}
|
||||||
|
exports.read = read;
|
||||||
|
function readdirWithFileTypes(directory, settings) {
|
||||||
|
const dirents = settings.fs.readdirSync(directory, { withFileTypes: true });
|
||||||
|
return dirents.map((dirent) => {
|
||||||
|
const entry = {
|
||||||
|
dirent,
|
||||||
|
name: dirent.name,
|
||||||
|
path: `${directory}${settings.pathSegmentSeparator}${dirent.name}`
|
||||||
|
};
|
||||||
|
if (entry.dirent.isSymbolicLink() && settings.followSymbolicLinks) {
|
||||||
|
try {
|
||||||
|
const stats = settings.fs.statSync(entry.path);
|
||||||
|
entry.dirent = utils.fs.createDirentFromStats(entry.name, stats);
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
if (settings.throwErrorOnBrokenSymbolicLink) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return entry;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
exports.readdirWithFileTypes = readdirWithFileTypes;
|
||||||
|
function readdir(directory, settings) {
|
||||||
|
const names = settings.fs.readdirSync(directory);
|
||||||
|
return names.map((name) => {
|
||||||
|
const entryPath = `${directory}${settings.pathSegmentSeparator}${name}`;
|
||||||
|
const stats = fsStat.statSync(entryPath, settings.fsStatSettings);
|
||||||
|
const entry = {
|
||||||
|
name,
|
||||||
|
path: entryPath,
|
||||||
|
dirent: utils.fs.createDirentFromStats(name, stats)
|
||||||
|
};
|
||||||
|
if (settings.stats) {
|
||||||
|
entry.stats = stats;
|
||||||
|
}
|
||||||
|
return entry;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
exports.readdir = readdir;
|
21
node_modules/@nodelib/fs.scandir/out/settings.d.ts
generated
vendored
Normal file
21
node_modules/@nodelib/fs.scandir/out/settings.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
import * as fsStat from '@nodelib/fs.stat';
|
||||||
|
import * as fs from './adapters/fs';
|
||||||
|
export declare type Options = {
|
||||||
|
followSymbolicLinks?: boolean;
|
||||||
|
fs?: Partial<fs.FileSystemAdapter>;
|
||||||
|
pathSegmentSeparator?: string;
|
||||||
|
stats?: boolean;
|
||||||
|
throwErrorOnBrokenSymbolicLink?: boolean;
|
||||||
|
};
|
||||||
|
export default class Settings {
|
||||||
|
private readonly _options;
|
||||||
|
readonly followSymbolicLinks: boolean;
|
||||||
|
readonly fs: fs.FileSystemAdapter;
|
||||||
|
readonly pathSegmentSeparator: string;
|
||||||
|
readonly stats: boolean;
|
||||||
|
readonly throwErrorOnBrokenSymbolicLink: boolean;
|
||||||
|
readonly fsStatSettings: fsStat.Settings;
|
||||||
|
constructor(_options?: Options);
|
||||||
|
private _getValue;
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=settings.d.ts.map
|
24
node_modules/@nodelib/fs.scandir/out/settings.js
generated
vendored
Normal file
24
node_modules/@nodelib/fs.scandir/out/settings.js
generated
vendored
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const path = require("path");
|
||||||
|
const fsStat = require("@nodelib/fs.stat");
|
||||||
|
const fs = require("./adapters/fs");
|
||||||
|
class Settings {
|
||||||
|
constructor(_options = {}) {
|
||||||
|
this._options = _options;
|
||||||
|
this.followSymbolicLinks = this._getValue(this._options.followSymbolicLinks, false);
|
||||||
|
this.fs = fs.createFileSystemAdapter(this._options.fs);
|
||||||
|
this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path.sep);
|
||||||
|
this.stats = this._getValue(this._options.stats, false);
|
||||||
|
this.throwErrorOnBrokenSymbolicLink = this._getValue(this._options.throwErrorOnBrokenSymbolicLink, true);
|
||||||
|
this.fsStatSettings = new fsStat.Settings({
|
||||||
|
followSymbolicLink: this.followSymbolicLinks,
|
||||||
|
fs: this.fs,
|
||||||
|
throwErrorOnBrokenSymbolicLink: this.throwErrorOnBrokenSymbolicLink
|
||||||
|
});
|
||||||
|
}
|
||||||
|
_getValue(option, value) {
|
||||||
|
return option === undefined ? value : option;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = Settings;
|
20
node_modules/@nodelib/fs.scandir/out/types/index.d.ts
generated
vendored
Normal file
20
node_modules/@nodelib/fs.scandir/out/types/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,20 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import * as fs from 'fs';
|
||||||
|
export declare type Entry = {
|
||||||
|
dirent: Dirent;
|
||||||
|
name: string;
|
||||||
|
path: string;
|
||||||
|
stats?: Stats;
|
||||||
|
};
|
||||||
|
export declare type Stats = fs.Stats;
|
||||||
|
export declare type Dirent = {
|
||||||
|
isBlockDevice(): boolean;
|
||||||
|
isCharacterDevice(): boolean;
|
||||||
|
isDirectory(): boolean;
|
||||||
|
isFIFO(): boolean;
|
||||||
|
isFile(): boolean;
|
||||||
|
isSocket(): boolean;
|
||||||
|
isSymbolicLink(): boolean;
|
||||||
|
name: string;
|
||||||
|
};
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
2
node_modules/@nodelib/fs.scandir/out/types/index.js
generated
vendored
Normal file
2
node_modules/@nodelib/fs.scandir/out/types/index.js
generated
vendored
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
3
node_modules/@nodelib/fs.scandir/out/utils/fs.d.ts
generated
vendored
Normal file
3
node_modules/@nodelib/fs.scandir/out/utils/fs.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
import { Dirent, Stats } from '../types';
|
||||||
|
export declare function createDirentFromStats(name: string, stats: Stats): Dirent;
|
||||||
|
//# sourceMappingURL=fs.d.ts.map
|
18
node_modules/@nodelib/fs.scandir/out/utils/fs.js
generated
vendored
Normal file
18
node_modules/@nodelib/fs.scandir/out/utils/fs.js
generated
vendored
Normal file
|
@ -0,0 +1,18 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
class DirentFromStats {
|
||||||
|
constructor(name, stats) {
|
||||||
|
this.name = name;
|
||||||
|
this.isBlockDevice = stats.isBlockDevice.bind(stats);
|
||||||
|
this.isCharacterDevice = stats.isCharacterDevice.bind(stats);
|
||||||
|
this.isDirectory = stats.isDirectory.bind(stats);
|
||||||
|
this.isFIFO = stats.isFIFO.bind(stats);
|
||||||
|
this.isFile = stats.isFile.bind(stats);
|
||||||
|
this.isSocket = stats.isSocket.bind(stats);
|
||||||
|
this.isSymbolicLink = stats.isSymbolicLink.bind(stats);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function createDirentFromStats(name, stats) {
|
||||||
|
return new DirentFromStats(name, stats);
|
||||||
|
}
|
||||||
|
exports.createDirentFromStats = createDirentFromStats;
|
3
node_modules/@nodelib/fs.scandir/out/utils/index.d.ts
generated
vendored
Normal file
3
node_modules/@nodelib/fs.scandir/out/utils/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
import * as fs from './fs';
|
||||||
|
export { fs };
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
4
node_modules/@nodelib/fs.scandir/out/utils/index.js
generated
vendored
Normal file
4
node_modules/@nodelib/fs.scandir/out/utils/index.js
generated
vendored
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fs = require("./fs");
|
||||||
|
exports.fs = fs;
|
64
node_modules/@nodelib/fs.scandir/package.json
generated
vendored
Normal file
64
node_modules/@nodelib/fs.scandir/package.json
generated
vendored
Normal file
|
@ -0,0 +1,64 @@
|
||||||
|
{
|
||||||
|
"_from": "@nodelib/fs.scandir@2.1.3",
|
||||||
|
"_id": "@nodelib/fs.scandir@2.1.3",
|
||||||
|
"_inBundle": false,
|
||||||
|
"_integrity": "sha512-eGmwYQn3gxo4r7jdQnkrrN6bY478C3P+a/y72IJukF8LjB6ZHeB3c+Ehacj3sYeSmUXGlnA67/PmbM9CVwL7Dw==",
|
||||||
|
"_location": "/@nodelib/fs.scandir",
|
||||||
|
"_phantomChildren": {},
|
||||||
|
"_requested": {
|
||||||
|
"type": "version",
|
||||||
|
"registry": true,
|
||||||
|
"raw": "@nodelib/fs.scandir@2.1.3",
|
||||||
|
"name": "@nodelib/fs.scandir",
|
||||||
|
"escapedName": "@nodelib%2ffs.scandir",
|
||||||
|
"scope": "@nodelib",
|
||||||
|
"rawSpec": "2.1.3",
|
||||||
|
"saveSpec": null,
|
||||||
|
"fetchSpec": "2.1.3"
|
||||||
|
},
|
||||||
|
"_requiredBy": [
|
||||||
|
"/@nodelib/fs.walk"
|
||||||
|
],
|
||||||
|
"_resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.3.tgz",
|
||||||
|
"_shasum": "3a582bdb53804c6ba6d146579c46e52130cf4a3b",
|
||||||
|
"_spec": "@nodelib/fs.scandir@2.1.3",
|
||||||
|
"_where": "/home/yarmo/dev/keyoxide/doipjs/node_modules/@nodelib/fs.walk",
|
||||||
|
"bundleDependencies": false,
|
||||||
|
"dependencies": {
|
||||||
|
"@nodelib/fs.stat": "2.0.3",
|
||||||
|
"run-parallel": "^1.1.9"
|
||||||
|
},
|
||||||
|
"deprecated": false,
|
||||||
|
"description": "List files and directories inside the specified directory",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 8"
|
||||||
|
},
|
||||||
|
"gitHead": "3b1ef7554ad7c061b3580858101d483fba847abf",
|
||||||
|
"keywords": [
|
||||||
|
"NodeLib",
|
||||||
|
"fs",
|
||||||
|
"FileSystem",
|
||||||
|
"file system",
|
||||||
|
"scandir",
|
||||||
|
"readdir",
|
||||||
|
"dirent"
|
||||||
|
],
|
||||||
|
"license": "MIT",
|
||||||
|
"main": "out/index.js",
|
||||||
|
"name": "@nodelib/fs.scandir",
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "https://github.com/nodelib/nodelib/tree/master/packages/fs/fs.scandir"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"build": "npm run clean && npm run compile && npm run lint && npm test",
|
||||||
|
"clean": "rimraf {tsconfig.tsbuildinfo,out}",
|
||||||
|
"compile": "tsc -b .",
|
||||||
|
"compile:watch": "tsc -p . --watch --sourceMap",
|
||||||
|
"lint": "eslint \"src/**/*.ts\" --cache",
|
||||||
|
"test": "mocha \"out/**/*.spec.js\" -s 0",
|
||||||
|
"watch": "npm run clean && npm run compile:watch"
|
||||||
|
},
|
||||||
|
"typings": "out/index.d.ts",
|
||||||
|
"version": "2.1.3"
|
||||||
|
}
|
21
node_modules/@nodelib/fs.stat/LICENSE
generated
vendored
Normal file
21
node_modules/@nodelib/fs.stat/LICENSE
generated
vendored
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) Denis Malinochkin
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
126
node_modules/@nodelib/fs.stat/README.md
generated
vendored
Normal file
126
node_modules/@nodelib/fs.stat/README.md
generated
vendored
Normal file
|
@ -0,0 +1,126 @@
|
||||||
|
# @nodelib/fs.stat
|
||||||
|
|
||||||
|
> Get the status of a file with some features.
|
||||||
|
|
||||||
|
## :bulb: Highlights
|
||||||
|
|
||||||
|
Wrapper around standard method `fs.lstat` and `fs.stat` with some features.
|
||||||
|
|
||||||
|
* :beginner: Normally follows symbolic link.
|
||||||
|
* :gear: Can safely work with broken symbolic link.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```console
|
||||||
|
npm install @nodelib/fs.stat
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import * as fsStat from '@nodelib/fs.stat';
|
||||||
|
|
||||||
|
fsStat.stat('path', (error, stats) => { /* … */ });
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### .stat(path, [optionsOrSettings], callback)
|
||||||
|
|
||||||
|
Returns an instance of `fs.Stats` class for provided path with standard callback-style.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
fsStat.stat('path', (error, stats) => { /* … */ });
|
||||||
|
fsStat.stat('path', {}, (error, stats) => { /* … */ });
|
||||||
|
fsStat.stat('path', new fsStat.Settings(), (error, stats) => { /* … */ });
|
||||||
|
```
|
||||||
|
|
||||||
|
### .statSync(path, [optionsOrSettings])
|
||||||
|
|
||||||
|
Returns an instance of `fs.Stats` class for provided path.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const stats = fsStat.stat('path');
|
||||||
|
const stats = fsStat.stat('path', {});
|
||||||
|
const stats = fsStat.stat('path', new fsStat.Settings());
|
||||||
|
```
|
||||||
|
|
||||||
|
#### path
|
||||||
|
|
||||||
|
* Required: `true`
|
||||||
|
* Type: `string | Buffer | URL`
|
||||||
|
|
||||||
|
A path to a file. If a URL is provided, it must use the `file:` protocol.
|
||||||
|
|
||||||
|
#### optionsOrSettings
|
||||||
|
|
||||||
|
* Required: `false`
|
||||||
|
* Type: `Options | Settings`
|
||||||
|
* Default: An instance of `Settings` class
|
||||||
|
|
||||||
|
An [`Options`](#options) object or an instance of [`Settings`](#settings) class.
|
||||||
|
|
||||||
|
> :book: When you pass a plain object, an instance of the `Settings` class will be created automatically. If you plan to call the method frequently, use a pre-created instance of the `Settings` class.
|
||||||
|
|
||||||
|
### Settings([options])
|
||||||
|
|
||||||
|
A class of full settings of the package.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const settings = new fsStat.Settings({ followSymbolicLink: false });
|
||||||
|
|
||||||
|
const stats = fsStat.stat('path', settings);
|
||||||
|
```
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### `followSymbolicLink`
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `true`
|
||||||
|
|
||||||
|
Follow symbolic link or not. Call `fs.stat` on symbolic link if `true`.
|
||||||
|
|
||||||
|
### `markSymbolicLink`
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `false`
|
||||||
|
|
||||||
|
Mark symbolic link by setting the return value of `isSymbolicLink` function to always `true` (even after `fs.stat`).
|
||||||
|
|
||||||
|
> :book: Can be used if you want to know what is hidden behind a symbolic link, but still continue to know that it is a symbolic link.
|
||||||
|
|
||||||
|
### `throwErrorOnBrokenSymbolicLink`
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `true`
|
||||||
|
|
||||||
|
Throw an error when symbolic link is broken if `true` or safely return `lstat` call if `false`.
|
||||||
|
|
||||||
|
### `fs`
|
||||||
|
|
||||||
|
* Type: [`FileSystemAdapter`](./src/adapters/fs.ts)
|
||||||
|
* Default: A default FS methods
|
||||||
|
|
||||||
|
By default, the built-in Node.js module (`fs`) is used to work with the file system. You can replace any method with your own.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
interface FileSystemAdapter {
|
||||||
|
lstat?: typeof fs.lstat;
|
||||||
|
stat?: typeof fs.stat;
|
||||||
|
lstatSync?: typeof fs.lstatSync;
|
||||||
|
statSync?: typeof fs.statSync;
|
||||||
|
}
|
||||||
|
|
||||||
|
const settings = new fsStat.Settings({
|
||||||
|
fs: { lstat: fakeLstat }
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## Changelog
|
||||||
|
|
||||||
|
See the [Releases section of our GitHub project](https://github.com/nodelib/nodelib/releases) for changelog for each release version.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This software is released under the terms of the MIT license.
|
11
node_modules/@nodelib/fs.stat/out/adapters/fs.d.ts
generated
vendored
Normal file
11
node_modules/@nodelib/fs.stat/out/adapters/fs.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import * as fs from 'fs';
|
||||||
|
export declare type FileSystemAdapter = {
|
||||||
|
lstat: typeof fs.lstat;
|
||||||
|
stat: typeof fs.stat;
|
||||||
|
lstatSync: typeof fs.lstatSync;
|
||||||
|
statSync: typeof fs.statSync;
|
||||||
|
};
|
||||||
|
export declare const FILE_SYSTEM_ADAPTER: FileSystemAdapter;
|
||||||
|
export declare function createFileSystemAdapter(fsMethods?: Partial<FileSystemAdapter>): FileSystemAdapter;
|
||||||
|
//# sourceMappingURL=fs.d.ts.map
|
16
node_modules/@nodelib/fs.stat/out/adapters/fs.js
generated
vendored
Normal file
16
node_modules/@nodelib/fs.stat/out/adapters/fs.js
generated
vendored
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fs = require("fs");
|
||||||
|
exports.FILE_SYSTEM_ADAPTER = {
|
||||||
|
lstat: fs.lstat,
|
||||||
|
stat: fs.stat,
|
||||||
|
lstatSync: fs.lstatSync,
|
||||||
|
statSync: fs.statSync
|
||||||
|
};
|
||||||
|
function createFileSystemAdapter(fsMethods) {
|
||||||
|
if (fsMethods === undefined) {
|
||||||
|
return exports.FILE_SYSTEM_ADAPTER;
|
||||||
|
}
|
||||||
|
return Object.assign(Object.assign({}, exports.FILE_SYSTEM_ADAPTER), fsMethods);
|
||||||
|
}
|
||||||
|
exports.createFileSystemAdapter = createFileSystemAdapter;
|
13
node_modules/@nodelib/fs.stat/out/index.d.ts
generated
vendored
Normal file
13
node_modules/@nodelib/fs.stat/out/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
import { FileSystemAdapter } from './adapters/fs';
|
||||||
|
import * as async from './providers/async';
|
||||||
|
import Settings, { Options } from './settings';
|
||||||
|
import { Stats } from './types';
|
||||||
|
declare type AsyncCallback = async.AsyncCallback;
|
||||||
|
declare function stat(path: string, callback: AsyncCallback): void;
|
||||||
|
declare function stat(path: string, optionsOrSettings: Options | Settings, callback: AsyncCallback): void;
|
||||||
|
declare namespace stat {
|
||||||
|
function __promisify__(path: string, optionsOrSettings?: Options | Settings): Promise<Stats>;
|
||||||
|
}
|
||||||
|
declare function statSync(path: string, optionsOrSettings?: Options | Settings): Stats;
|
||||||
|
export { Settings, stat, statSync, AsyncCallback, FileSystemAdapter, Options, Stats };
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
24
node_modules/@nodelib/fs.stat/out/index.js
generated
vendored
Normal file
24
node_modules/@nodelib/fs.stat/out/index.js
generated
vendored
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const async = require("./providers/async");
|
||||||
|
const sync = require("./providers/sync");
|
||||||
|
const settings_1 = require("./settings");
|
||||||
|
exports.Settings = settings_1.default;
|
||||||
|
function stat(path, optionsOrSettingsOrCallback, callback) {
|
||||||
|
if (typeof optionsOrSettingsOrCallback === 'function') {
|
||||||
|
return async.read(path, getSettings(), optionsOrSettingsOrCallback);
|
||||||
|
}
|
||||||
|
async.read(path, getSettings(optionsOrSettingsOrCallback), callback);
|
||||||
|
}
|
||||||
|
exports.stat = stat;
|
||||||
|
function statSync(path, optionsOrSettings) {
|
||||||
|
const settings = getSettings(optionsOrSettings);
|
||||||
|
return sync.read(path, settings);
|
||||||
|
}
|
||||||
|
exports.statSync = statSync;
|
||||||
|
function getSettings(settingsOrOptions = {}) {
|
||||||
|
if (settingsOrOptions instanceof settings_1.default) {
|
||||||
|
return settingsOrOptions;
|
||||||
|
}
|
||||||
|
return new settings_1.default(settingsOrOptions);
|
||||||
|
}
|
5
node_modules/@nodelib/fs.stat/out/providers/async.d.ts
generated
vendored
Normal file
5
node_modules/@nodelib/fs.stat/out/providers/async.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
import Settings from '../settings';
|
||||||
|
import { ErrnoException, Stats } from '../types';
|
||||||
|
export declare type AsyncCallback = (err: ErrnoException, stats: Stats) => void;
|
||||||
|
export declare function read(path: string, settings: Settings, callback: AsyncCallback): void;
|
||||||
|
//# sourceMappingURL=async.d.ts.map
|
31
node_modules/@nodelib/fs.stat/out/providers/async.js
generated
vendored
Normal file
31
node_modules/@nodelib/fs.stat/out/providers/async.js
generated
vendored
Normal file
|
@ -0,0 +1,31 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
function read(path, settings, callback) {
|
||||||
|
settings.fs.lstat(path, (lstatError, lstat) => {
|
||||||
|
if (lstatError !== null) {
|
||||||
|
return callFailureCallback(callback, lstatError);
|
||||||
|
}
|
||||||
|
if (!lstat.isSymbolicLink() || !settings.followSymbolicLink) {
|
||||||
|
return callSuccessCallback(callback, lstat);
|
||||||
|
}
|
||||||
|
settings.fs.stat(path, (statError, stat) => {
|
||||||
|
if (statError !== null) {
|
||||||
|
if (settings.throwErrorOnBrokenSymbolicLink) {
|
||||||
|
return callFailureCallback(callback, statError);
|
||||||
|
}
|
||||||
|
return callSuccessCallback(callback, lstat);
|
||||||
|
}
|
||||||
|
if (settings.markSymbolicLink) {
|
||||||
|
stat.isSymbolicLink = () => true;
|
||||||
|
}
|
||||||
|
callSuccessCallback(callback, stat);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
}
|
||||||
|
exports.read = read;
|
||||||
|
function callFailureCallback(callback, error) {
|
||||||
|
callback(error);
|
||||||
|
}
|
||||||
|
function callSuccessCallback(callback, result) {
|
||||||
|
callback(null, result);
|
||||||
|
}
|
4
node_modules/@nodelib/fs.stat/out/providers/sync.d.ts
generated
vendored
Normal file
4
node_modules/@nodelib/fs.stat/out/providers/sync.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
import Settings from '../settings';
|
||||||
|
import { Stats } from '../types';
|
||||||
|
export declare function read(path: string, settings: Settings): Stats;
|
||||||
|
//# sourceMappingURL=sync.d.ts.map
|
22
node_modules/@nodelib/fs.stat/out/providers/sync.js
generated
vendored
Normal file
22
node_modules/@nodelib/fs.stat/out/providers/sync.js
generated
vendored
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
function read(path, settings) {
|
||||||
|
const lstat = settings.fs.lstatSync(path);
|
||||||
|
if (!lstat.isSymbolicLink() || !settings.followSymbolicLink) {
|
||||||
|
return lstat;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
const stat = settings.fs.statSync(path);
|
||||||
|
if (settings.markSymbolicLink) {
|
||||||
|
stat.isSymbolicLink = () => true;
|
||||||
|
}
|
||||||
|
return stat;
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
if (!settings.throwErrorOnBrokenSymbolicLink) {
|
||||||
|
return lstat;
|
||||||
|
}
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.read = read;
|
17
node_modules/@nodelib/fs.stat/out/settings.d.ts
generated
vendored
Normal file
17
node_modules/@nodelib/fs.stat/out/settings.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,17 @@
|
||||||
|
import * as fs from './adapters/fs';
|
||||||
|
export declare type Options = {
|
||||||
|
followSymbolicLink?: boolean;
|
||||||
|
fs?: Partial<fs.FileSystemAdapter>;
|
||||||
|
markSymbolicLink?: boolean;
|
||||||
|
throwErrorOnBrokenSymbolicLink?: boolean;
|
||||||
|
};
|
||||||
|
export default class Settings {
|
||||||
|
private readonly _options;
|
||||||
|
readonly followSymbolicLink: boolean;
|
||||||
|
readonly fs: fs.FileSystemAdapter;
|
||||||
|
readonly markSymbolicLink: boolean;
|
||||||
|
readonly throwErrorOnBrokenSymbolicLink: boolean;
|
||||||
|
constructor(_options?: Options);
|
||||||
|
private _getValue;
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=settings.d.ts.map
|
16
node_modules/@nodelib/fs.stat/out/settings.js
generated
vendored
Normal file
16
node_modules/@nodelib/fs.stat/out/settings.js
generated
vendored
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fs = require("./adapters/fs");
|
||||||
|
class Settings {
|
||||||
|
constructor(_options = {}) {
|
||||||
|
this._options = _options;
|
||||||
|
this.followSymbolicLink = this._getValue(this._options.followSymbolicLink, true);
|
||||||
|
this.fs = fs.createFileSystemAdapter(this._options.fs);
|
||||||
|
this.markSymbolicLink = this._getValue(this._options.markSymbolicLink, false);
|
||||||
|
this.throwErrorOnBrokenSymbolicLink = this._getValue(this._options.throwErrorOnBrokenSymbolicLink, true);
|
||||||
|
}
|
||||||
|
_getValue(option, value) {
|
||||||
|
return option === undefined ? value : option;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = Settings;
|
5
node_modules/@nodelib/fs.stat/out/types/index.d.ts
generated
vendored
Normal file
5
node_modules/@nodelib/fs.stat/out/types/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import * as fs from 'fs';
|
||||||
|
export declare type Stats = fs.Stats;
|
||||||
|
export declare type ErrnoException = NodeJS.ErrnoException;
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
2
node_modules/@nodelib/fs.stat/out/types/index.js
generated
vendored
Normal file
2
node_modules/@nodelib/fs.stat/out/types/index.js
generated
vendored
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
59
node_modules/@nodelib/fs.stat/package.json
generated
vendored
Normal file
59
node_modules/@nodelib/fs.stat/package.json
generated
vendored
Normal file
|
@ -0,0 +1,59 @@
|
||||||
|
{
|
||||||
|
"_from": "@nodelib/fs.stat@^2.0.2",
|
||||||
|
"_id": "@nodelib/fs.stat@2.0.3",
|
||||||
|
"_inBundle": false,
|
||||||
|
"_integrity": "sha512-bQBFruR2TAwoevBEd/NWMoAAtNGzTRgdrqnYCc7dhzfoNvqPzLyqlEQnzZ3kVnNrSp25iyxE00/3h2fqGAGArA==",
|
||||||
|
"_location": "/@nodelib/fs.stat",
|
||||||
|
"_phantomChildren": {},
|
||||||
|
"_requested": {
|
||||||
|
"type": "range",
|
||||||
|
"registry": true,
|
||||||
|
"raw": "@nodelib/fs.stat@^2.0.2",
|
||||||
|
"name": "@nodelib/fs.stat",
|
||||||
|
"escapedName": "@nodelib%2ffs.stat",
|
||||||
|
"scope": "@nodelib",
|
||||||
|
"rawSpec": "^2.0.2",
|
||||||
|
"saveSpec": null,
|
||||||
|
"fetchSpec": "^2.0.2"
|
||||||
|
},
|
||||||
|
"_requiredBy": [
|
||||||
|
"/@nodelib/fs.scandir",
|
||||||
|
"/fast-glob"
|
||||||
|
],
|
||||||
|
"_resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.3.tgz",
|
||||||
|
"_shasum": "34dc5f4cabbc720f4e60f75a747e7ecd6c175bd3",
|
||||||
|
"_spec": "@nodelib/fs.stat@^2.0.2",
|
||||||
|
"_where": "/home/yarmo/dev/keyoxide/doipjs/node_modules/fast-glob",
|
||||||
|
"bundleDependencies": false,
|
||||||
|
"deprecated": false,
|
||||||
|
"description": "Get the status of a file with some features",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 8"
|
||||||
|
},
|
||||||
|
"gitHead": "3b1ef7554ad7c061b3580858101d483fba847abf",
|
||||||
|
"keywords": [
|
||||||
|
"NodeLib",
|
||||||
|
"fs",
|
||||||
|
"FileSystem",
|
||||||
|
"file system",
|
||||||
|
"stat"
|
||||||
|
],
|
||||||
|
"license": "MIT",
|
||||||
|
"main": "out/index.js",
|
||||||
|
"name": "@nodelib/fs.stat",
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "https://github.com/nodelib/nodelib/tree/master/packages/fs/fs.stat"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"build": "npm run clean && npm run compile && npm run lint && npm test",
|
||||||
|
"clean": "rimraf {tsconfig.tsbuildinfo,out}",
|
||||||
|
"compile": "tsc -b .",
|
||||||
|
"compile:watch": "tsc -p . --watch --sourceMap",
|
||||||
|
"lint": "eslint \"src/**/*.ts\" --cache",
|
||||||
|
"test": "mocha \"out/**/*.spec.js\" -s 0",
|
||||||
|
"watch": "npm run clean && npm run compile:watch"
|
||||||
|
},
|
||||||
|
"typings": "out/index.d.ts",
|
||||||
|
"version": "2.0.3"
|
||||||
|
}
|
21
node_modules/@nodelib/fs.walk/LICENSE
generated
vendored
Normal file
21
node_modules/@nodelib/fs.walk/LICENSE
generated
vendored
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) Denis Malinochkin
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
215
node_modules/@nodelib/fs.walk/README.md
generated
vendored
Normal file
215
node_modules/@nodelib/fs.walk/README.md
generated
vendored
Normal file
|
@ -0,0 +1,215 @@
|
||||||
|
# @nodelib/fs.walk
|
||||||
|
|
||||||
|
> A library for efficiently walking a directory recursively.
|
||||||
|
|
||||||
|
## :bulb: Highlights
|
||||||
|
|
||||||
|
* :moneybag: Returns useful information: `name`, `path`, `dirent` and `stats` (optional).
|
||||||
|
* :rocket: On Node.js 10.10+ uses the mechanism without additional calls to determine the entry type for performance reasons. See [`old` and `modern` mode](https://github.com/nodelib/nodelib/blob/master/packages/fs/fs.scandir/README.md#old-and-modern-mode).
|
||||||
|
* :gear: Built-in directories/files and error filtering system.
|
||||||
|
* :link: Can safely work with broken symbolic links.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```console
|
||||||
|
npm install @nodelib/fs.walk
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import * as fsWalk from '@nodelib/fs.walk';
|
||||||
|
|
||||||
|
fsWalk.walk('path', (error, entries) => { /* … */ });
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### .walk(path, [optionsOrSettings], callback)
|
||||||
|
|
||||||
|
Reads the directory recursively and asynchronously. Requires a callback function.
|
||||||
|
|
||||||
|
> :book: If you want to use the Promise API, use `util.promisify`.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
fsWalk.walk('path', (error, entries) => { /* … */ });
|
||||||
|
fsWalk.walk('path', {}, (error, entries) => { /* … */ });
|
||||||
|
fsWalk.walk('path', new fsWalk.Settings(), (error, entries) => { /* … */ });
|
||||||
|
```
|
||||||
|
|
||||||
|
### .walkStream(path, [optionsOrSettings])
|
||||||
|
|
||||||
|
Reads the directory recursively and asynchronously. [Readable Stream](https://nodejs.org/dist/latest-v12.x/docs/api/stream.html#stream_readable_streams) is used as a provider.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const stream = fsWalk.walkStream('path');
|
||||||
|
const stream = fsWalk.walkStream('path', {});
|
||||||
|
const stream = fsWalk.walkStream('path', new fsWalk.Settings());
|
||||||
|
```
|
||||||
|
|
||||||
|
### .walkSync(path, [optionsOrSettings])
|
||||||
|
|
||||||
|
Reads the directory recursively and synchronously. Returns an array of entries.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const entries = fsWalk.walkSync('path');
|
||||||
|
const entries = fsWalk.walkSync('path', {});
|
||||||
|
const entries = fsWalk.walkSync('path', new fsWalk.Settings());
|
||||||
|
```
|
||||||
|
|
||||||
|
#### path
|
||||||
|
|
||||||
|
* Required: `true`
|
||||||
|
* Type: `string | Buffer | URL`
|
||||||
|
|
||||||
|
A path to a file. If a URL is provided, it must use the `file:` protocol.
|
||||||
|
|
||||||
|
#### optionsOrSettings
|
||||||
|
|
||||||
|
* Required: `false`
|
||||||
|
* Type: `Options | Settings`
|
||||||
|
* Default: An instance of `Settings` class
|
||||||
|
|
||||||
|
An [`Options`](#options) object or an instance of [`Settings`](#settings) class.
|
||||||
|
|
||||||
|
> :book: When you pass a plain object, an instance of the `Settings` class will be created automatically. If you plan to call the method frequently, use a pre-created instance of the `Settings` class.
|
||||||
|
|
||||||
|
### Settings([options])
|
||||||
|
|
||||||
|
A class of full settings of the package.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const settings = new fsWalk.Settings({ followSymbolicLinks: true });
|
||||||
|
|
||||||
|
const entries = fsWalk.walkSync('path', settings);
|
||||||
|
```
|
||||||
|
|
||||||
|
## Entry
|
||||||
|
|
||||||
|
* `name` — The name of the entry (`unknown.txt`).
|
||||||
|
* `path` — The path of the entry relative to call directory (`root/unknown.txt`).
|
||||||
|
* `dirent` — An instance of [`fs.Dirent`](./src/types/index.ts) class.
|
||||||
|
* [`stats`] — An instance of `fs.Stats` class.
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### basePath
|
||||||
|
|
||||||
|
* Type: `string`
|
||||||
|
* Default: `undefined`
|
||||||
|
|
||||||
|
By default, all paths are built relative to the root path. You can use this option to set custom root path.
|
||||||
|
|
||||||
|
In the example below we read the files from the `root` directory, but in the results the root path will be `custom`.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
fsWalk.walkSync('root'); // → ['root/file.txt']
|
||||||
|
fsWalk.walkSync('root', { basePath: 'custom' }); // → ['custom/file.txt']
|
||||||
|
```
|
||||||
|
|
||||||
|
### concurrency
|
||||||
|
|
||||||
|
* Type: `number`
|
||||||
|
* Default: `Infinity`
|
||||||
|
|
||||||
|
The maximum number of concurrent calls to `fs.readdir`.
|
||||||
|
|
||||||
|
> :book: The higher the number, the higher performance and the load on the File System. If you want to read in quiet mode, set the value to `4 * os.cpus().length` (4 is default size of [thread pool work scheduling](http://docs.libuv.org/en/v1.x/threadpool.html#thread-pool-work-scheduling)).
|
||||||
|
|
||||||
|
### deepFilter
|
||||||
|
|
||||||
|
* Type: [`DeepFilterFunction`](./src/settings.ts)
|
||||||
|
* Default: `undefined`
|
||||||
|
|
||||||
|
A function that indicates whether the directory will be read deep or not.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
// Skip all directories that starts with `node_modules`
|
||||||
|
const filter: DeepFilterFunction = (entry) => !entry.path.startsWith('node_modules');
|
||||||
|
```
|
||||||
|
|
||||||
|
### entryFilter
|
||||||
|
|
||||||
|
* Type: [`EntryFilterFunction`](./src/settings.ts)
|
||||||
|
* Default: `undefined`
|
||||||
|
|
||||||
|
A function that indicates whether the entry will be included to results or not.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
// Exclude all `.js` files from results
|
||||||
|
const filter: EntryFilterFunction = (entry) => !entry.name.endsWith('.js');
|
||||||
|
```
|
||||||
|
|
||||||
|
### errorFilter
|
||||||
|
|
||||||
|
* Type: [`ErrorFilterFunction`](./src/settings.ts)
|
||||||
|
* Default: `undefined`
|
||||||
|
|
||||||
|
A function that allows you to skip errors that occur when reading directories.
|
||||||
|
|
||||||
|
For example, you can skip `ENOENT` errors if required:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
// Skip all ENOENT errors
|
||||||
|
const filter: ErrorFilterFunction = (error) => error.code == 'ENOENT';
|
||||||
|
```
|
||||||
|
|
||||||
|
### stats
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `false`
|
||||||
|
|
||||||
|
Adds an instance of `fs.Stats` class to the [`Entry`](#entry).
|
||||||
|
|
||||||
|
> :book: Always use `fs.readdir` with additional `fs.lstat/fs.stat` calls to determine the entry type.
|
||||||
|
|
||||||
|
### followSymbolicLinks
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `false`
|
||||||
|
|
||||||
|
Follow symbolic links or not. Call `fs.stat` on symbolic link if `true`.
|
||||||
|
|
||||||
|
### `throwErrorOnBrokenSymbolicLink`
|
||||||
|
|
||||||
|
* Type: `boolean`
|
||||||
|
* Default: `true`
|
||||||
|
|
||||||
|
Throw an error when symbolic link is broken if `true` or safely return `lstat` call if `false`.
|
||||||
|
|
||||||
|
### `pathSegmentSeparator`
|
||||||
|
|
||||||
|
* Type: `string`
|
||||||
|
* Default: `path.sep`
|
||||||
|
|
||||||
|
By default, this package uses the correct path separator for your OS (`\` on Windows, `/` on Unix-like systems). But you can set this option to any separator character(s) that you want to use instead.
|
||||||
|
|
||||||
|
### `fs`
|
||||||
|
|
||||||
|
* Type: `FileSystemAdapter`
|
||||||
|
* Default: A default FS methods
|
||||||
|
|
||||||
|
By default, the built-in Node.js module (`fs`) is used to work with the file system. You can replace any method with your own.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
interface FileSystemAdapter {
|
||||||
|
lstat: typeof fs.lstat;
|
||||||
|
stat: typeof fs.stat;
|
||||||
|
lstatSync: typeof fs.lstatSync;
|
||||||
|
statSync: typeof fs.statSync;
|
||||||
|
readdir: typeof fs.readdir;
|
||||||
|
readdirSync: typeof fs.readdirSync;
|
||||||
|
}
|
||||||
|
|
||||||
|
const settings = new fsWalk.Settings({
|
||||||
|
fs: { lstat: fakeLstat }
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## Changelog
|
||||||
|
|
||||||
|
See the [Releases section of our GitHub project](https://github.com/nodelib/nodelib/releases) for changelog for each release version.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This software is released under the terms of the MIT license.
|
15
node_modules/@nodelib/fs.walk/out/index.d.ts
generated
vendored
Normal file
15
node_modules/@nodelib/fs.walk/out/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,15 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import { Readable } from 'stream';
|
||||||
|
import { Dirent, FileSystemAdapter } from '@nodelib/fs.scandir';
|
||||||
|
import { AsyncCallback } from './providers/async';
|
||||||
|
import Settings, { DeepFilterFunction, EntryFilterFunction, ErrorFilterFunction, Options } from './settings';
|
||||||
|
import { Entry } from './types';
|
||||||
|
declare function walk(directory: string, callback: AsyncCallback): void;
|
||||||
|
declare function walk(directory: string, optionsOrSettings: Options | Settings, callback: AsyncCallback): void;
|
||||||
|
declare namespace walk {
|
||||||
|
function __promisify__(directory: string, optionsOrSettings?: Options | Settings): Promise<Entry[]>;
|
||||||
|
}
|
||||||
|
declare function walkSync(directory: string, optionsOrSettings?: Options | Settings): Entry[];
|
||||||
|
declare function walkStream(directory: string, optionsOrSettings?: Options | Settings): Readable;
|
||||||
|
export { walk, walkSync, walkStream, Settings, AsyncCallback, Dirent, Entry, FileSystemAdapter, Options, DeepFilterFunction, EntryFilterFunction, ErrorFilterFunction };
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
32
node_modules/@nodelib/fs.walk/out/index.js
generated
vendored
Normal file
32
node_modules/@nodelib/fs.walk/out/index.js
generated
vendored
Normal file
|
@ -0,0 +1,32 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const async_1 = require("./providers/async");
|
||||||
|
const stream_1 = require("./providers/stream");
|
||||||
|
const sync_1 = require("./providers/sync");
|
||||||
|
const settings_1 = require("./settings");
|
||||||
|
exports.Settings = settings_1.default;
|
||||||
|
function walk(directory, optionsOrSettingsOrCallback, callback) {
|
||||||
|
if (typeof optionsOrSettingsOrCallback === 'function') {
|
||||||
|
return new async_1.default(directory, getSettings()).read(optionsOrSettingsOrCallback);
|
||||||
|
}
|
||||||
|
new async_1.default(directory, getSettings(optionsOrSettingsOrCallback)).read(callback);
|
||||||
|
}
|
||||||
|
exports.walk = walk;
|
||||||
|
function walkSync(directory, optionsOrSettings) {
|
||||||
|
const settings = getSettings(optionsOrSettings);
|
||||||
|
const provider = new sync_1.default(directory, settings);
|
||||||
|
return provider.read();
|
||||||
|
}
|
||||||
|
exports.walkSync = walkSync;
|
||||||
|
function walkStream(directory, optionsOrSettings) {
|
||||||
|
const settings = getSettings(optionsOrSettings);
|
||||||
|
const provider = new stream_1.default(directory, settings);
|
||||||
|
return provider.read();
|
||||||
|
}
|
||||||
|
exports.walkStream = walkStream;
|
||||||
|
function getSettings(settingsOrOptions = {}) {
|
||||||
|
if (settingsOrOptions instanceof settings_1.default) {
|
||||||
|
return settingsOrOptions;
|
||||||
|
}
|
||||||
|
return new settings_1.default(settingsOrOptions);
|
||||||
|
}
|
13
node_modules/@nodelib/fs.walk/out/providers/async.d.ts
generated
vendored
Normal file
13
node_modules/@nodelib/fs.walk/out/providers/async.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
import AsyncReader from '../readers/async';
|
||||||
|
import Settings from '../settings';
|
||||||
|
import { Entry, Errno } from '../types';
|
||||||
|
export declare type AsyncCallback = (err: Errno, entries: Entry[]) => void;
|
||||||
|
export default class AsyncProvider {
|
||||||
|
private readonly _root;
|
||||||
|
private readonly _settings;
|
||||||
|
protected readonly _reader: AsyncReader;
|
||||||
|
private readonly _storage;
|
||||||
|
constructor(_root: string, _settings: Settings);
|
||||||
|
read(callback: AsyncCallback): void;
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=async.d.ts.map
|
30
node_modules/@nodelib/fs.walk/out/providers/async.js
generated
vendored
Normal file
30
node_modules/@nodelib/fs.walk/out/providers/async.js
generated
vendored
Normal file
|
@ -0,0 +1,30 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const async_1 = require("../readers/async");
|
||||||
|
class AsyncProvider {
|
||||||
|
constructor(_root, _settings) {
|
||||||
|
this._root = _root;
|
||||||
|
this._settings = _settings;
|
||||||
|
this._reader = new async_1.default(this._root, this._settings);
|
||||||
|
this._storage = new Set();
|
||||||
|
}
|
||||||
|
read(callback) {
|
||||||
|
this._reader.onError((error) => {
|
||||||
|
callFailureCallback(callback, error);
|
||||||
|
});
|
||||||
|
this._reader.onEntry((entry) => {
|
||||||
|
this._storage.add(entry);
|
||||||
|
});
|
||||||
|
this._reader.onEnd(() => {
|
||||||
|
callSuccessCallback(callback, [...this._storage]);
|
||||||
|
});
|
||||||
|
this._reader.read();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = AsyncProvider;
|
||||||
|
function callFailureCallback(callback, error) {
|
||||||
|
callback(error);
|
||||||
|
}
|
||||||
|
function callSuccessCallback(callback, entries) {
|
||||||
|
callback(null, entries);
|
||||||
|
}
|
5
node_modules/@nodelib/fs.walk/out/providers/index.d.ts
generated
vendored
Normal file
5
node_modules/@nodelib/fs.walk/out/providers/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
import AsyncProvider from './async';
|
||||||
|
import StreamProvider from './stream';
|
||||||
|
import SyncProvider from './sync';
|
||||||
|
export { AsyncProvider, StreamProvider, SyncProvider };
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
8
node_modules/@nodelib/fs.walk/out/providers/index.js
generated
vendored
Normal file
8
node_modules/@nodelib/fs.walk/out/providers/index.js
generated
vendored
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const async_1 = require("./async");
|
||||||
|
exports.AsyncProvider = async_1.default;
|
||||||
|
const stream_1 = require("./stream");
|
||||||
|
exports.StreamProvider = stream_1.default;
|
||||||
|
const sync_1 = require("./sync");
|
||||||
|
exports.SyncProvider = sync_1.default;
|
13
node_modules/@nodelib/fs.walk/out/providers/stream.d.ts
generated
vendored
Normal file
13
node_modules/@nodelib/fs.walk/out/providers/stream.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import { Readable } from 'stream';
|
||||||
|
import AsyncReader from '../readers/async';
|
||||||
|
import Settings from '../settings';
|
||||||
|
export default class StreamProvider {
|
||||||
|
private readonly _root;
|
||||||
|
private readonly _settings;
|
||||||
|
protected readonly _reader: AsyncReader;
|
||||||
|
protected readonly _stream: Readable;
|
||||||
|
constructor(_root: string, _settings: Settings);
|
||||||
|
read(): Readable;
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=stream.d.ts.map
|
30
node_modules/@nodelib/fs.walk/out/providers/stream.js
generated
vendored
Normal file
30
node_modules/@nodelib/fs.walk/out/providers/stream.js
generated
vendored
Normal file
|
@ -0,0 +1,30 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const stream_1 = require("stream");
|
||||||
|
const async_1 = require("../readers/async");
|
||||||
|
class StreamProvider {
|
||||||
|
constructor(_root, _settings) {
|
||||||
|
this._root = _root;
|
||||||
|
this._settings = _settings;
|
||||||
|
this._reader = new async_1.default(this._root, this._settings);
|
||||||
|
this._stream = new stream_1.Readable({
|
||||||
|
objectMode: true,
|
||||||
|
read: () => { },
|
||||||
|
destroy: this._reader.destroy.bind(this._reader)
|
||||||
|
});
|
||||||
|
}
|
||||||
|
read() {
|
||||||
|
this._reader.onError((error) => {
|
||||||
|
this._stream.emit('error', error);
|
||||||
|
});
|
||||||
|
this._reader.onEntry((entry) => {
|
||||||
|
this._stream.push(entry);
|
||||||
|
});
|
||||||
|
this._reader.onEnd(() => {
|
||||||
|
this._stream.push(null);
|
||||||
|
});
|
||||||
|
this._reader.read();
|
||||||
|
return this._stream;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = StreamProvider;
|
11
node_modules/@nodelib/fs.walk/out/providers/sync.d.ts
generated
vendored
Normal file
11
node_modules/@nodelib/fs.walk/out/providers/sync.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
import SyncReader from '../readers/sync';
|
||||||
|
import Settings from '../settings';
|
||||||
|
import { Entry } from '../types';
|
||||||
|
export default class SyncProvider {
|
||||||
|
private readonly _root;
|
||||||
|
private readonly _settings;
|
||||||
|
protected readonly _reader: SyncReader;
|
||||||
|
constructor(_root: string, _settings: Settings);
|
||||||
|
read(): Entry[];
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=sync.d.ts.map
|
14
node_modules/@nodelib/fs.walk/out/providers/sync.js
generated
vendored
Normal file
14
node_modules/@nodelib/fs.walk/out/providers/sync.js
generated
vendored
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const sync_1 = require("../readers/sync");
|
||||||
|
class SyncProvider {
|
||||||
|
constructor(_root, _settings) {
|
||||||
|
this._root = _root;
|
||||||
|
this._settings = _settings;
|
||||||
|
this._reader = new sync_1.default(this._root, this._settings);
|
||||||
|
}
|
||||||
|
read() {
|
||||||
|
return this._reader.read();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = SyncProvider;
|
30
node_modules/@nodelib/fs.walk/out/readers/async.d.ts
generated
vendored
Normal file
30
node_modules/@nodelib/fs.walk/out/readers/async.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,30 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import { EventEmitter } from 'events';
|
||||||
|
import * as fsScandir from '@nodelib/fs.scandir';
|
||||||
|
import Settings from '../settings';
|
||||||
|
import { Entry, Errno } from '../types';
|
||||||
|
import Reader from './reader';
|
||||||
|
declare type EntryEventCallback = (entry: Entry) => void;
|
||||||
|
declare type ErrorEventCallback = (error: Errno) => void;
|
||||||
|
declare type EndEventCallback = () => void;
|
||||||
|
export default class AsyncReader extends Reader {
|
||||||
|
protected readonly _settings: Settings;
|
||||||
|
protected readonly _scandir: typeof fsScandir.scandir;
|
||||||
|
protected readonly _emitter: EventEmitter;
|
||||||
|
private readonly _queue;
|
||||||
|
private _isFatalError;
|
||||||
|
private _isDestroyed;
|
||||||
|
constructor(_root: string, _settings: Settings);
|
||||||
|
read(): EventEmitter;
|
||||||
|
destroy(): void;
|
||||||
|
onEntry(callback: EntryEventCallback): void;
|
||||||
|
onError(callback: ErrorEventCallback): void;
|
||||||
|
onEnd(callback: EndEventCallback): void;
|
||||||
|
private _pushToQueue;
|
||||||
|
private _worker;
|
||||||
|
private _handleError;
|
||||||
|
private _handleEntry;
|
||||||
|
private _emitEntry;
|
||||||
|
}
|
||||||
|
export {};
|
||||||
|
//# sourceMappingURL=async.d.ts.map
|
93
node_modules/@nodelib/fs.walk/out/readers/async.js
generated
vendored
Normal file
93
node_modules/@nodelib/fs.walk/out/readers/async.js
generated
vendored
Normal file
|
@ -0,0 +1,93 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const events_1 = require("events");
|
||||||
|
const fsScandir = require("@nodelib/fs.scandir");
|
||||||
|
const fastq = require("fastq");
|
||||||
|
const common = require("./common");
|
||||||
|
const reader_1 = require("./reader");
|
||||||
|
class AsyncReader extends reader_1.default {
|
||||||
|
constructor(_root, _settings) {
|
||||||
|
super(_root, _settings);
|
||||||
|
this._settings = _settings;
|
||||||
|
this._scandir = fsScandir.scandir;
|
||||||
|
this._emitter = new events_1.EventEmitter();
|
||||||
|
this._queue = fastq(this._worker.bind(this), this._settings.concurrency);
|
||||||
|
this._isFatalError = false;
|
||||||
|
this._isDestroyed = false;
|
||||||
|
this._queue.drain = () => {
|
||||||
|
if (!this._isFatalError) {
|
||||||
|
this._emitter.emit('end');
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
read() {
|
||||||
|
this._isFatalError = false;
|
||||||
|
this._isDestroyed = false;
|
||||||
|
setImmediate(() => {
|
||||||
|
this._pushToQueue(this._root, this._settings.basePath);
|
||||||
|
});
|
||||||
|
return this._emitter;
|
||||||
|
}
|
||||||
|
destroy() {
|
||||||
|
if (this._isDestroyed) {
|
||||||
|
throw new Error('The reader is already destroyed');
|
||||||
|
}
|
||||||
|
this._isDestroyed = true;
|
||||||
|
this._queue.killAndDrain();
|
||||||
|
}
|
||||||
|
onEntry(callback) {
|
||||||
|
this._emitter.on('entry', callback);
|
||||||
|
}
|
||||||
|
onError(callback) {
|
||||||
|
this._emitter.once('error', callback);
|
||||||
|
}
|
||||||
|
onEnd(callback) {
|
||||||
|
this._emitter.once('end', callback);
|
||||||
|
}
|
||||||
|
_pushToQueue(directory, base) {
|
||||||
|
const queueItem = { directory, base };
|
||||||
|
this._queue.push(queueItem, (error) => {
|
||||||
|
if (error !== null) {
|
||||||
|
this._handleError(error);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
_worker(item, done) {
|
||||||
|
this._scandir(item.directory, this._settings.fsScandirSettings, (error, entries) => {
|
||||||
|
if (error !== null) {
|
||||||
|
return done(error, undefined);
|
||||||
|
}
|
||||||
|
for (const entry of entries) {
|
||||||
|
this._handleEntry(entry, item.base);
|
||||||
|
}
|
||||||
|
done(null, undefined);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
_handleError(error) {
|
||||||
|
if (!common.isFatalError(this._settings, error)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
this._isFatalError = true;
|
||||||
|
this._isDestroyed = true;
|
||||||
|
this._emitter.emit('error', error);
|
||||||
|
}
|
||||||
|
_handleEntry(entry, base) {
|
||||||
|
if (this._isDestroyed || this._isFatalError) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const fullpath = entry.path;
|
||||||
|
if (base !== undefined) {
|
||||||
|
entry.path = common.joinPathSegments(base, entry.name, this._settings.pathSegmentSeparator);
|
||||||
|
}
|
||||||
|
if (common.isAppliedFilter(this._settings.entryFilter, entry)) {
|
||||||
|
this._emitEntry(entry);
|
||||||
|
}
|
||||||
|
if (entry.dirent.isDirectory() && common.isAppliedFilter(this._settings.deepFilter, entry)) {
|
||||||
|
this._pushToQueue(fullpath, entry.path);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_emitEntry(entry) {
|
||||||
|
this._emitter.emit('entry', entry);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = AsyncReader;
|
7
node_modules/@nodelib/fs.walk/out/readers/common.d.ts
generated
vendored
Normal file
7
node_modules/@nodelib/fs.walk/out/readers/common.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
import Settings, { FilterFunction } from '../settings';
|
||||||
|
import { Errno } from '../types';
|
||||||
|
export declare function isFatalError(settings: Settings, error: Errno): boolean;
|
||||||
|
export declare function isAppliedFilter<T>(filter: FilterFunction<T> | null, value: T): boolean;
|
||||||
|
export declare function replacePathSegmentSeparator(filepath: string, separator: string): string;
|
||||||
|
export declare function joinPathSegments(a: string, b: string, separator: string): string;
|
||||||
|
//# sourceMappingURL=common.d.ts.map
|
24
node_modules/@nodelib/fs.walk/out/readers/common.js
generated
vendored
Normal file
24
node_modules/@nodelib/fs.walk/out/readers/common.js
generated
vendored
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
function isFatalError(settings, error) {
|
||||||
|
if (settings.errorFilter === null) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return !settings.errorFilter(error);
|
||||||
|
}
|
||||||
|
exports.isFatalError = isFatalError;
|
||||||
|
function isAppliedFilter(filter, value) {
|
||||||
|
return filter === null || filter(value);
|
||||||
|
}
|
||||||
|
exports.isAppliedFilter = isAppliedFilter;
|
||||||
|
function replacePathSegmentSeparator(filepath, separator) {
|
||||||
|
return filepath.split(/[\\/]/).join(separator);
|
||||||
|
}
|
||||||
|
exports.replacePathSegmentSeparator = replacePathSegmentSeparator;
|
||||||
|
function joinPathSegments(a, b, separator) {
|
||||||
|
if (a === '') {
|
||||||
|
return b;
|
||||||
|
}
|
||||||
|
return a + separator + b;
|
||||||
|
}
|
||||||
|
exports.joinPathSegments = joinPathSegments;
|
7
node_modules/@nodelib/fs.walk/out/readers/reader.d.ts
generated
vendored
Normal file
7
node_modules/@nodelib/fs.walk/out/readers/reader.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
import Settings from '../settings';
|
||||||
|
export default class Reader {
|
||||||
|
protected readonly _root: string;
|
||||||
|
protected readonly _settings: Settings;
|
||||||
|
constructor(_root: string, _settings: Settings);
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=reader.d.ts.map
|
11
node_modules/@nodelib/fs.walk/out/readers/reader.js
generated
vendored
Normal file
11
node_modules/@nodelib/fs.walk/out/readers/reader.js
generated
vendored
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const common = require("./common");
|
||||||
|
class Reader {
|
||||||
|
constructor(_root, _settings) {
|
||||||
|
this._root = _root;
|
||||||
|
this._settings = _settings;
|
||||||
|
this._root = common.replacePathSegmentSeparator(_root, _settings.pathSegmentSeparator);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = Reader;
|
16
node_modules/@nodelib/fs.walk/out/readers/sync.d.ts
generated
vendored
Normal file
16
node_modules/@nodelib/fs.walk/out/readers/sync.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
import * as fsScandir from '@nodelib/fs.scandir';
|
||||||
|
import { Entry } from '../types';
|
||||||
|
import Reader from './reader';
|
||||||
|
export default class SyncReader extends Reader {
|
||||||
|
protected readonly _scandir: typeof fsScandir.scandirSync;
|
||||||
|
private readonly _storage;
|
||||||
|
private readonly _queue;
|
||||||
|
read(): Entry[];
|
||||||
|
private _pushToQueue;
|
||||||
|
private _handleQueue;
|
||||||
|
private _handleDirectory;
|
||||||
|
private _handleError;
|
||||||
|
private _handleEntry;
|
||||||
|
private _pushToStorage;
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=sync.d.ts.map
|
59
node_modules/@nodelib/fs.walk/out/readers/sync.js
generated
vendored
Normal file
59
node_modules/@nodelib/fs.walk/out/readers/sync.js
generated
vendored
Normal file
|
@ -0,0 +1,59 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fsScandir = require("@nodelib/fs.scandir");
|
||||||
|
const common = require("./common");
|
||||||
|
const reader_1 = require("./reader");
|
||||||
|
class SyncReader extends reader_1.default {
|
||||||
|
constructor() {
|
||||||
|
super(...arguments);
|
||||||
|
this._scandir = fsScandir.scandirSync;
|
||||||
|
this._storage = new Set();
|
||||||
|
this._queue = new Set();
|
||||||
|
}
|
||||||
|
read() {
|
||||||
|
this._pushToQueue(this._root, this._settings.basePath);
|
||||||
|
this._handleQueue();
|
||||||
|
return [...this._storage];
|
||||||
|
}
|
||||||
|
_pushToQueue(directory, base) {
|
||||||
|
this._queue.add({ directory, base });
|
||||||
|
}
|
||||||
|
_handleQueue() {
|
||||||
|
for (const item of this._queue.values()) {
|
||||||
|
this._handleDirectory(item.directory, item.base);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_handleDirectory(directory, base) {
|
||||||
|
try {
|
||||||
|
const entries = this._scandir(directory, this._settings.fsScandirSettings);
|
||||||
|
for (const entry of entries) {
|
||||||
|
this._handleEntry(entry, base);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
this._handleError(error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_handleError(error) {
|
||||||
|
if (!common.isFatalError(this._settings, error)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
_handleEntry(entry, base) {
|
||||||
|
const fullpath = entry.path;
|
||||||
|
if (base !== undefined) {
|
||||||
|
entry.path = common.joinPathSegments(base, entry.name, this._settings.pathSegmentSeparator);
|
||||||
|
}
|
||||||
|
if (common.isAppliedFilter(this._settings.entryFilter, entry)) {
|
||||||
|
this._pushToStorage(entry);
|
||||||
|
}
|
||||||
|
if (entry.dirent.isDirectory() && common.isAppliedFilter(this._settings.deepFilter, entry)) {
|
||||||
|
this._pushToQueue(fullpath, entry.path);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_pushToStorage(entry) {
|
||||||
|
this._storage.add(entry);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = SyncReader;
|
31
node_modules/@nodelib/fs.walk/out/settings.d.ts
generated
vendored
Normal file
31
node_modules/@nodelib/fs.walk/out/settings.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,31 @@
|
||||||
|
import * as fsScandir from '@nodelib/fs.scandir';
|
||||||
|
import { Entry, Errno } from './types';
|
||||||
|
export declare type FilterFunction<T> = (value: T) => boolean;
|
||||||
|
export declare type DeepFilterFunction = FilterFunction<Entry>;
|
||||||
|
export declare type EntryFilterFunction = FilterFunction<Entry>;
|
||||||
|
export declare type ErrorFilterFunction = FilterFunction<Errno>;
|
||||||
|
export declare type Options = {
|
||||||
|
basePath?: string;
|
||||||
|
concurrency?: number;
|
||||||
|
deepFilter?: DeepFilterFunction;
|
||||||
|
entryFilter?: EntryFilterFunction;
|
||||||
|
errorFilter?: ErrorFilterFunction;
|
||||||
|
followSymbolicLinks?: boolean;
|
||||||
|
fs?: Partial<fsScandir.FileSystemAdapter>;
|
||||||
|
pathSegmentSeparator?: string;
|
||||||
|
stats?: boolean;
|
||||||
|
throwErrorOnBrokenSymbolicLink?: boolean;
|
||||||
|
};
|
||||||
|
export default class Settings {
|
||||||
|
private readonly _options;
|
||||||
|
readonly basePath?: string;
|
||||||
|
readonly concurrency: number;
|
||||||
|
readonly deepFilter: DeepFilterFunction | null;
|
||||||
|
readonly entryFilter: EntryFilterFunction | null;
|
||||||
|
readonly errorFilter: ErrorFilterFunction | null;
|
||||||
|
readonly pathSegmentSeparator: string;
|
||||||
|
readonly fsScandirSettings: fsScandir.Settings;
|
||||||
|
constructor(_options?: Options);
|
||||||
|
private _getValue;
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=settings.d.ts.map
|
26
node_modules/@nodelib/fs.walk/out/settings.js
generated
vendored
Normal file
26
node_modules/@nodelib/fs.walk/out/settings.js
generated
vendored
Normal file
|
@ -0,0 +1,26 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const path = require("path");
|
||||||
|
const fsScandir = require("@nodelib/fs.scandir");
|
||||||
|
class Settings {
|
||||||
|
constructor(_options = {}) {
|
||||||
|
this._options = _options;
|
||||||
|
this.basePath = this._getValue(this._options.basePath, undefined);
|
||||||
|
this.concurrency = this._getValue(this._options.concurrency, Infinity);
|
||||||
|
this.deepFilter = this._getValue(this._options.deepFilter, null);
|
||||||
|
this.entryFilter = this._getValue(this._options.entryFilter, null);
|
||||||
|
this.errorFilter = this._getValue(this._options.errorFilter, null);
|
||||||
|
this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path.sep);
|
||||||
|
this.fsScandirSettings = new fsScandir.Settings({
|
||||||
|
followSymbolicLinks: this._options.followSymbolicLinks,
|
||||||
|
fs: this._options.fs,
|
||||||
|
pathSegmentSeparator: this._options.pathSegmentSeparator,
|
||||||
|
stats: this._options.stats,
|
||||||
|
throwErrorOnBrokenSymbolicLink: this._options.throwErrorOnBrokenSymbolicLink
|
||||||
|
});
|
||||||
|
}
|
||||||
|
_getValue(option, value) {
|
||||||
|
return option === undefined ? value : option;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.default = Settings;
|
9
node_modules/@nodelib/fs.walk/out/types/index.d.ts
generated
vendored
Normal file
9
node_modules/@nodelib/fs.walk/out/types/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
/// <reference types="node" />
|
||||||
|
import * as scandir from '@nodelib/fs.scandir';
|
||||||
|
export declare type Entry = scandir.Entry;
|
||||||
|
export declare type Errno = NodeJS.ErrnoException;
|
||||||
|
export declare type QueueItem = {
|
||||||
|
directory: string;
|
||||||
|
base?: string;
|
||||||
|
};
|
||||||
|
//# sourceMappingURL=index.d.ts.map
|
2
node_modules/@nodelib/fs.walk/out/types/index.js
generated
vendored
Normal file
2
node_modules/@nodelib/fs.walk/out/types/index.js
generated
vendored
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
64
node_modules/@nodelib/fs.walk/package.json
generated
vendored
Normal file
64
node_modules/@nodelib/fs.walk/package.json
generated
vendored
Normal file
|
@ -0,0 +1,64 @@
|
||||||
|
{
|
||||||
|
"_from": "@nodelib/fs.walk@^1.2.3",
|
||||||
|
"_id": "@nodelib/fs.walk@1.2.4",
|
||||||
|
"_inBundle": false,
|
||||||
|
"_integrity": "sha512-1V9XOY4rDW0rehzbrcqAmHnz8e7SKvX27gh8Gt2WgB0+pdzdiLV83p72kZPU+jvMbS1qU5mauP2iOvO8rhmurQ==",
|
||||||
|
"_location": "/@nodelib/fs.walk",
|
||||||
|
"_phantomChildren": {},
|
||||||
|
"_requested": {
|
||||||
|
"type": "range",
|
||||||
|
"registry": true,
|
||||||
|
"raw": "@nodelib/fs.walk@^1.2.3",
|
||||||
|
"name": "@nodelib/fs.walk",
|
||||||
|
"escapedName": "@nodelib%2ffs.walk",
|
||||||
|
"scope": "@nodelib",
|
||||||
|
"rawSpec": "^1.2.3",
|
||||||
|
"saveSpec": null,
|
||||||
|
"fetchSpec": "^1.2.3"
|
||||||
|
},
|
||||||
|
"_requiredBy": [
|
||||||
|
"/fast-glob"
|
||||||
|
],
|
||||||
|
"_resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.4.tgz",
|
||||||
|
"_shasum": "011b9202a70a6366e436ca5c065844528ab04976",
|
||||||
|
"_spec": "@nodelib/fs.walk@^1.2.3",
|
||||||
|
"_where": "/home/yarmo/dev/keyoxide/doipjs/node_modules/fast-glob",
|
||||||
|
"bundleDependencies": false,
|
||||||
|
"dependencies": {
|
||||||
|
"@nodelib/fs.scandir": "2.1.3",
|
||||||
|
"fastq": "^1.6.0"
|
||||||
|
},
|
||||||
|
"deprecated": false,
|
||||||
|
"description": "A library for efficiently walking a directory recursively",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 8"
|
||||||
|
},
|
||||||
|
"gitHead": "3b1ef7554ad7c061b3580858101d483fba847abf",
|
||||||
|
"keywords": [
|
||||||
|
"NodeLib",
|
||||||
|
"fs",
|
||||||
|
"FileSystem",
|
||||||
|
"file system",
|
||||||
|
"walk",
|
||||||
|
"scanner",
|
||||||
|
"crawler"
|
||||||
|
],
|
||||||
|
"license": "MIT",
|
||||||
|
"main": "out/index.js",
|
||||||
|
"name": "@nodelib/fs.walk",
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "https://github.com/nodelib/nodelib/tree/master/packages/fs/fs.walk"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"build": "npm run clean && npm run compile && npm run lint && npm test",
|
||||||
|
"clean": "rimraf {tsconfig.tsbuildinfo,out}",
|
||||||
|
"compile": "tsc -b .",
|
||||||
|
"compile:watch": "tsc -p . --watch --sourceMap",
|
||||||
|
"lint": "eslint \"src/**/*.ts\" --cache",
|
||||||
|
"test": "mocha \"out/**/*.spec.js\" -s 0",
|
||||||
|
"watch": "npm run clean && npm run compile:watch"
|
||||||
|
},
|
||||||
|
"typings": "out/index.d.ts",
|
||||||
|
"version": "1.2.4"
|
||||||
|
}
|
32
node_modules/@sinonjs/commons/CHANGES.md
generated
vendored
Normal file
32
node_modules/@sinonjs/commons/CHANGES.md
generated
vendored
Normal file
|
@ -0,0 +1,32 @@
|
||||||
|
# Changes
|
||||||
|
|
||||||
|
## 1.8.1
|
||||||
|
|
||||||
|
- [`07b9e7a`](https://github.com/sinonjs/commons/commit/07b9e7a1d784771273a9a58d74945bbc7319b5d4)
|
||||||
|
Optimize npm package size (Uladzimir Havenchyk)
|
||||||
|
|
||||||
|
_Released on 2020-07-17._
|
||||||
|
|
||||||
|
## 1.8.0
|
||||||
|
|
||||||
|
- [`4282205`](https://github.com/sinonjs/commons/commit/4282205343a4dcde2a35ccf2a8c2094300dad369)
|
||||||
|
Emit deprecationg warnings in node, and keep console info in browsers (mshaaban0)
|
||||||
|
|
||||||
|
_Released on 2020-05-20._
|
||||||
|
|
||||||
|
## 1.7.2
|
||||||
|
|
||||||
|
- [`76ad9c1`](https://github.com/sinonjs/commons/commit/76ad9c16bad29f72420ed55bdf45b65d076108c8)
|
||||||
|
Fix generators causing exceptions in function-name (Sebastian Mayr)
|
||||||
|
|
||||||
|
_Released on 2020-04-08._
|
||||||
|
|
||||||
|
## 1.7.1
|
||||||
|
|
||||||
|
- [`0486d25`](https://github.com/sinonjs/commons/commit/0486d250ecec9b5f9aa2210357767e413f4162d3)
|
||||||
|
Upgrade eslint-config-sinon, add eslint-plugin-jsdoc (Morgan Roderick)
|
||||||
|
>
|
||||||
|
> This adds linting of jsdoc
|
||||||
|
>
|
||||||
|
|
||||||
|
_Released on 2020-02-19._
|
29
node_modules/@sinonjs/commons/LICENSE
generated
vendored
Normal file
29
node_modules/@sinonjs/commons/LICENSE
generated
vendored
Normal file
|
@ -0,0 +1,29 @@
|
||||||
|
BSD 3-Clause License
|
||||||
|
|
||||||
|
Copyright (c) 2018, Sinon.JS
|
||||||
|
All rights reserved.
|
||||||
|
|
||||||
|
Redistribution and use in source and binary forms, with or without
|
||||||
|
modification, are permitted provided that the following conditions are met:
|
||||||
|
|
||||||
|
* Redistributions of source code must retain the above copyright notice, this
|
||||||
|
list of conditions and the following disclaimer.
|
||||||
|
|
||||||
|
* Redistributions in binary form must reproduce the above copyright notice,
|
||||||
|
this list of conditions and the following disclaimer in the documentation
|
||||||
|
and/or other materials provided with the distribution.
|
||||||
|
|
||||||
|
* Neither the name of the copyright holder nor the names of its
|
||||||
|
contributors may be used to endorse or promote products derived from
|
||||||
|
this software without specific prior written permission.
|
||||||
|
|
||||||
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||||
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||||
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
||||||
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||||
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||||||
|
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||||||
|
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||||||
|
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
16
node_modules/@sinonjs/commons/README.md
generated
vendored
Normal file
16
node_modules/@sinonjs/commons/README.md
generated
vendored
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
# commons
|
||||||
|
|
||||||
|
[![CircleCI](https://circleci.com/gh/sinonjs/commons.svg?style=svg)](https://circleci.com/gh/sinonjs/commons)
|
||||||
|
[![codecov](https://codecov.io/gh/sinonjs/commons/branch/master/graph/badge.svg)](https://codecov.io/gh/sinonjs/commons)
|
||||||
|
<a href="CODE_OF_CONDUCT.md"><img src="https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg" alt="Contributor Covenant" /></a>
|
||||||
|
|
||||||
|
Simple functions shared among the sinon end user libraries
|
||||||
|
|
||||||
|
## Rules
|
||||||
|
|
||||||
|
* Follows the [Sinon.JS compatibility](https://github.com/sinonjs/sinon/blob/master/CONTRIBUTING.md#compatibility)
|
||||||
|
* 100% test coverage
|
||||||
|
* Code formatted using [Prettier](https://prettier.io)
|
||||||
|
* No side effects welcome! (only pure functions)
|
||||||
|
* No platform specific functions
|
||||||
|
* One export per file (any bundler can do tree shaking)
|
57
node_modules/@sinonjs/commons/lib/called-in-order.js
generated
vendored
Normal file
57
node_modules/@sinonjs/commons/lib/called-in-order.js
generated
vendored
Normal file
|
@ -0,0 +1,57 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var every = require("./prototypes/array").every;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
function hasCallsLeft(callMap, spy) {
|
||||||
|
if (callMap[spy.id] === undefined) {
|
||||||
|
callMap[spy.id] = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
return callMap[spy.id] < spy.callCount;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
function checkAdjacentCalls(callMap, spy, index, spies) {
|
||||||
|
var calledBeforeNext = true;
|
||||||
|
|
||||||
|
if (index !== spies.length - 1) {
|
||||||
|
calledBeforeNext = spy.calledBefore(spies[index + 1]);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (hasCallsLeft(callMap, spy) && calledBeforeNext) {
|
||||||
|
callMap[spy.id] += 1;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A Sinon proxy object (fake, spy, stub)
|
||||||
|
*
|
||||||
|
* @typedef {object} SinonProxy
|
||||||
|
* @property {Function} calledBefore - A method that determines if this proxy was called before another one
|
||||||
|
* @property {string} id - Some id
|
||||||
|
* @property {number} callCount - Number of times this proxy has been called
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns true when the spies have been called in the order they were supplied in
|
||||||
|
*
|
||||||
|
* @param {SinonProxy[] | SinonProxy} spies An array of proxies, or several proxies as arguments
|
||||||
|
* @returns {boolean} true when spies are called in order, false otherwise
|
||||||
|
*/
|
||||||
|
function calledInOrder(spies) {
|
||||||
|
var callMap = {};
|
||||||
|
// eslint-disable-next-line no-underscore-dangle
|
||||||
|
var _spies = arguments.length > 1 ? arguments : spies;
|
||||||
|
|
||||||
|
return every(_spies, checkAdjacentCalls.bind(null, callMap));
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = calledInOrder;
|
121
node_modules/@sinonjs/commons/lib/called-in-order.test.js
generated
vendored
Normal file
121
node_modules/@sinonjs/commons/lib/called-in-order.test.js
generated
vendored
Normal file
|
@ -0,0 +1,121 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var assert = require("@sinonjs/referee-sinon").assert;
|
||||||
|
var calledInOrder = require("./called-in-order");
|
||||||
|
var sinon = require("@sinonjs/referee-sinon").sinon;
|
||||||
|
|
||||||
|
var testObject1 = {
|
||||||
|
someFunction: function() {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var testObject2 = {
|
||||||
|
otherFunction: function() {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var testObject3 = {
|
||||||
|
thirdFunction: function() {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
function testMethod() {
|
||||||
|
testObject1.someFunction();
|
||||||
|
testObject2.otherFunction();
|
||||||
|
testObject2.otherFunction();
|
||||||
|
testObject2.otherFunction();
|
||||||
|
testObject3.thirdFunction();
|
||||||
|
}
|
||||||
|
|
||||||
|
describe("calledInOrder", function() {
|
||||||
|
beforeEach(function() {
|
||||||
|
sinon.stub(testObject1, "someFunction");
|
||||||
|
sinon.stub(testObject2, "otherFunction");
|
||||||
|
sinon.stub(testObject3, "thirdFunction");
|
||||||
|
testMethod();
|
||||||
|
});
|
||||||
|
afterEach(function() {
|
||||||
|
testObject1.someFunction.restore();
|
||||||
|
testObject2.otherFunction.restore();
|
||||||
|
testObject3.thirdFunction.restore();
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("given single array argument", function() {
|
||||||
|
describe("when stubs were called in expected order", function() {
|
||||||
|
it("returns true", function() {
|
||||||
|
assert.isTrue(
|
||||||
|
calledInOrder([
|
||||||
|
testObject1.someFunction,
|
||||||
|
testObject2.otherFunction
|
||||||
|
])
|
||||||
|
);
|
||||||
|
assert.isTrue(
|
||||||
|
calledInOrder([
|
||||||
|
testObject1.someFunction,
|
||||||
|
testObject2.otherFunction,
|
||||||
|
testObject2.otherFunction,
|
||||||
|
testObject3.thirdFunction
|
||||||
|
])
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("when stubs were called in unexpected order", function() {
|
||||||
|
it("returns false", function() {
|
||||||
|
assert.isFalse(
|
||||||
|
calledInOrder([
|
||||||
|
testObject2.otherFunction,
|
||||||
|
testObject1.someFunction
|
||||||
|
])
|
||||||
|
);
|
||||||
|
assert.isFalse(
|
||||||
|
calledInOrder([
|
||||||
|
testObject2.otherFunction,
|
||||||
|
testObject1.someFunction,
|
||||||
|
testObject1.someFunction,
|
||||||
|
testObject3.thirdFunction
|
||||||
|
])
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("given multiple arguments", function() {
|
||||||
|
describe("when stubs were called in expected order", function() {
|
||||||
|
it("returns true", function() {
|
||||||
|
assert.isTrue(
|
||||||
|
calledInOrder(
|
||||||
|
testObject1.someFunction,
|
||||||
|
testObject2.otherFunction
|
||||||
|
)
|
||||||
|
);
|
||||||
|
assert.isTrue(
|
||||||
|
calledInOrder(
|
||||||
|
testObject1.someFunction,
|
||||||
|
testObject2.otherFunction,
|
||||||
|
testObject3.thirdFunction
|
||||||
|
)
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("when stubs were called in unexpected order", function() {
|
||||||
|
it("returns false", function() {
|
||||||
|
assert.isFalse(
|
||||||
|
calledInOrder(
|
||||||
|
testObject2.otherFunction,
|
||||||
|
testObject1.someFunction
|
||||||
|
)
|
||||||
|
);
|
||||||
|
assert.isFalse(
|
||||||
|
calledInOrder(
|
||||||
|
testObject2.otherFunction,
|
||||||
|
testObject1.someFunction,
|
||||||
|
testObject3.thirdFunction
|
||||||
|
)
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
27
node_modules/@sinonjs/commons/lib/class-name.js
generated
vendored
Normal file
27
node_modules/@sinonjs/commons/lib/class-name.js
generated
vendored
Normal file
|
@ -0,0 +1,27 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var functionName = require("./function-name");
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a display name for a value from a constructor
|
||||||
|
*
|
||||||
|
* @param {object} value A value to examine
|
||||||
|
* @returns {(string|null)} A string or null
|
||||||
|
*/
|
||||||
|
function className(value) {
|
||||||
|
return (
|
||||||
|
(value.constructor && value.constructor.name) ||
|
||||||
|
// The next branch is for IE11 support only:
|
||||||
|
// Because the name property is not set on the prototype
|
||||||
|
// of the Function object, we finally try to grab the
|
||||||
|
// name from its definition. This will never be reached
|
||||||
|
// in node, so we are not able to test this properly.
|
||||||
|
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/name
|
||||||
|
(typeof value.constructor === "function" &&
|
||||||
|
/* istanbul ignore next */
|
||||||
|
functionName(value.constructor)) ||
|
||||||
|
null
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = className;
|
37
node_modules/@sinonjs/commons/lib/class-name.test.js
generated
vendored
Normal file
37
node_modules/@sinonjs/commons/lib/class-name.test.js
generated
vendored
Normal file
|
@ -0,0 +1,37 @@
|
||||||
|
"use strict";
|
||||||
|
/* eslint-disable no-empty-function */
|
||||||
|
|
||||||
|
var assert = require("@sinonjs/referee").assert;
|
||||||
|
var className = require("./class-name");
|
||||||
|
|
||||||
|
describe("className", function() {
|
||||||
|
it("returns the class name of an instance", function() {
|
||||||
|
// Because eslint-config-sinon disables es6, we can't
|
||||||
|
// use a class definition here
|
||||||
|
// https://github.com/sinonjs/eslint-config-sinon/blob/master/index.js
|
||||||
|
// var instance = new (class TestClass {})();
|
||||||
|
var instance = new (function TestClass() {})();
|
||||||
|
var name = className(instance);
|
||||||
|
assert.equals(name, "TestClass");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns 'Object' for {}", function() {
|
||||||
|
var name = className({});
|
||||||
|
assert.equals(name, "Object");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns null for an object that has no prototype", function() {
|
||||||
|
var obj = Object.create(null);
|
||||||
|
var name = className(obj);
|
||||||
|
assert.equals(name, null);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns null for an object whose prototype was mangled", function() {
|
||||||
|
// This is what Node v6 and v7 do for objects returned by querystring.parse()
|
||||||
|
function MangledObject() {}
|
||||||
|
MangledObject.prototype = Object.create(null);
|
||||||
|
var obj = new MangledObject();
|
||||||
|
var name = className(obj);
|
||||||
|
assert.equals(name, null);
|
||||||
|
});
|
||||||
|
});
|
58
node_modules/@sinonjs/commons/lib/deprecated.js
generated
vendored
Normal file
58
node_modules/@sinonjs/commons/lib/deprecated.js
generated
vendored
Normal file
|
@ -0,0 +1,58 @@
|
||||||
|
/* eslint-disable no-console */
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a function that will invoke the supplied function and print a
|
||||||
|
* deprecation warning to the console each time it is called.
|
||||||
|
*
|
||||||
|
* @param {Function} func
|
||||||
|
* @param {string} msg
|
||||||
|
* @returns {Function}
|
||||||
|
*/
|
||||||
|
exports.wrap = function(func, msg) {
|
||||||
|
var wrapped = function() {
|
||||||
|
exports.printWarning(msg);
|
||||||
|
return func.apply(this, arguments);
|
||||||
|
};
|
||||||
|
if (func.prototype) {
|
||||||
|
wrapped.prototype = func.prototype;
|
||||||
|
}
|
||||||
|
return wrapped;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a string which can be supplied to `wrap()` to notify the user that a
|
||||||
|
* particular part of the sinon API has been deprecated.
|
||||||
|
*
|
||||||
|
* @param {string} packageName
|
||||||
|
* @param {string} funcName
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
exports.defaultMsg = function(packageName, funcName) {
|
||||||
|
return (
|
||||||
|
packageName +
|
||||||
|
"." +
|
||||||
|
funcName +
|
||||||
|
" is deprecated and will be removed from the public API in a future version of " +
|
||||||
|
packageName +
|
||||||
|
"."
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Prints a warning on the console, when it exists
|
||||||
|
*
|
||||||
|
* @param {string} msg
|
||||||
|
* @returns {undefined}
|
||||||
|
*/
|
||||||
|
exports.printWarning = function(msg) {
|
||||||
|
/* istanbul ignore next */
|
||||||
|
if (typeof process === "object" && process.emitWarning) {
|
||||||
|
// Emit Warnings in Node
|
||||||
|
process.emitWarning(msg);
|
||||||
|
} else if (console.info) {
|
||||||
|
console.info(msg);
|
||||||
|
} else {
|
||||||
|
console.log(msg);
|
||||||
|
}
|
||||||
|
};
|
100
node_modules/@sinonjs/commons/lib/deprecated.test.js
generated
vendored
Normal file
100
node_modules/@sinonjs/commons/lib/deprecated.test.js
generated
vendored
Normal file
|
@ -0,0 +1,100 @@
|
||||||
|
/* eslint-disable no-console */
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var assert = require("@sinonjs/referee-sinon").assert;
|
||||||
|
var sinon = require("@sinonjs/referee-sinon").sinon;
|
||||||
|
|
||||||
|
var deprecated = require("./deprecated");
|
||||||
|
|
||||||
|
var msg = "test";
|
||||||
|
|
||||||
|
describe("deprecated", function() {
|
||||||
|
describe("defaultMsg", function() {
|
||||||
|
it("should return a string", function() {
|
||||||
|
assert.equals(
|
||||||
|
deprecated.defaultMsg("sinon", "someFunc"),
|
||||||
|
"sinon.someFunc is deprecated and will be removed from the public API in a future version of sinon."
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("printWarning", function() {
|
||||||
|
beforeEach(function() {
|
||||||
|
sinon.replace(process, "emitWarning", sinon.fake());
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(sinon.restore);
|
||||||
|
|
||||||
|
describe("when `process.emitWarning` is defined", function() {
|
||||||
|
it("should call process.emitWarning with a msg", function() {
|
||||||
|
deprecated.printWarning(msg);
|
||||||
|
assert.calledOnceWith(process.emitWarning, msg);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("when `process.emitWarning` is undefined", function() {
|
||||||
|
beforeEach(function() {
|
||||||
|
sinon.replace(console, "info", sinon.fake());
|
||||||
|
sinon.replace(console, "log", sinon.fake());
|
||||||
|
process.emitWarning = undefined;
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(sinon.restore);
|
||||||
|
|
||||||
|
describe("when `console.info` is defined", function() {
|
||||||
|
it("should call `console.info` with a message", function() {
|
||||||
|
deprecated.printWarning(msg);
|
||||||
|
assert.calledOnceWith(console.info, msg);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("when `console.info` is undefined", function() {
|
||||||
|
it("should call `console.log` with a message", function() {
|
||||||
|
console.info = undefined;
|
||||||
|
deprecated.printWarning(msg);
|
||||||
|
assert.calledOnceWith(console.log, msg);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("wrap", function() {
|
||||||
|
var method = sinon.fake();
|
||||||
|
var wrapped;
|
||||||
|
|
||||||
|
beforeEach(function() {
|
||||||
|
wrapped = deprecated.wrap(method, msg);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should return a wrapper function", function() {
|
||||||
|
assert.match(wrapped, sinon.match.func);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should assign the prototype of the passed method", function() {
|
||||||
|
assert.equals(method.prototype, wrapped.prototype);
|
||||||
|
});
|
||||||
|
|
||||||
|
context("when the passed method has falsy prototype", function() {
|
||||||
|
it("should not be assigned to the wrapped method", function() {
|
||||||
|
method.prototype = null;
|
||||||
|
wrapped = deprecated.wrap(method, msg);
|
||||||
|
assert.match(wrapped.prototype, sinon.match.object);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
context("when invoking the wrapped function", function() {
|
||||||
|
before(function() {
|
||||||
|
sinon.replace(deprecated, "printWarning", sinon.fake());
|
||||||
|
wrapped({});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should call `printWarning` before invoking", function() {
|
||||||
|
assert.calledOnceWith(deprecated.printWarning, msg);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should invoke the passed method with the given arguments", function() {
|
||||||
|
assert.calledOnceWith(method, {});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
27
node_modules/@sinonjs/commons/lib/every.js
generated
vendored
Normal file
27
node_modules/@sinonjs/commons/lib/every.js
generated
vendored
Normal file
|
@ -0,0 +1,27 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns true when fn returns true for all members of obj.
|
||||||
|
* This is an every implementation that works for all iterables
|
||||||
|
*
|
||||||
|
* @param {object} obj
|
||||||
|
* @param {Function} fn
|
||||||
|
* @returns {boolean}
|
||||||
|
*/
|
||||||
|
module.exports = function every(obj, fn) {
|
||||||
|
var pass = true;
|
||||||
|
|
||||||
|
try {
|
||||||
|
/* eslint-disable-next-line local-rules/no-prototype-methods */
|
||||||
|
obj.forEach(function() {
|
||||||
|
if (!fn.apply(this, arguments)) {
|
||||||
|
// Throwing an error is the only way to break `forEach`
|
||||||
|
throw new Error();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
} catch (e) {
|
||||||
|
pass = false;
|
||||||
|
}
|
||||||
|
|
||||||
|
return pass;
|
||||||
|
};
|
41
node_modules/@sinonjs/commons/lib/every.test.js
generated
vendored
Normal file
41
node_modules/@sinonjs/commons/lib/every.test.js
generated
vendored
Normal file
|
@ -0,0 +1,41 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var assert = require("@sinonjs/referee-sinon").assert;
|
||||||
|
var sinon = require("@sinonjs/referee-sinon").sinon;
|
||||||
|
var every = require("./every");
|
||||||
|
|
||||||
|
describe("util/core/every", function() {
|
||||||
|
it("returns true when the callback function returns true for every element in an iterable", function() {
|
||||||
|
var obj = [true, true, true, true];
|
||||||
|
var allTrue = every(obj, function(val) {
|
||||||
|
return val;
|
||||||
|
});
|
||||||
|
|
||||||
|
assert(allTrue);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns false when the callback function returns false for any element in an iterable", function() {
|
||||||
|
var obj = [true, true, true, false];
|
||||||
|
var result = every(obj, function(val) {
|
||||||
|
return val;
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.isFalse(result);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("calls the given callback once for each item in an iterable until it returns false", function() {
|
||||||
|
var iterableOne = [true, true, true, true];
|
||||||
|
var iterableTwo = [true, true, false, true];
|
||||||
|
var callback = sinon.spy(function(val) {
|
||||||
|
return val;
|
||||||
|
});
|
||||||
|
|
||||||
|
every(iterableOne, callback);
|
||||||
|
assert.equals(callback.callCount, 4);
|
||||||
|
|
||||||
|
callback.resetHistory();
|
||||||
|
|
||||||
|
every(iterableTwo, callback);
|
||||||
|
assert.equals(callback.callCount, 3);
|
||||||
|
});
|
||||||
|
});
|
29
node_modules/@sinonjs/commons/lib/function-name.js
generated
vendored
Normal file
29
node_modules/@sinonjs/commons/lib/function-name.js
generated
vendored
Normal file
|
@ -0,0 +1,29 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a display name for a function
|
||||||
|
*
|
||||||
|
* @param {Function} func
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
module.exports = function functionName(func) {
|
||||||
|
if (!func) {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
return (
|
||||||
|
func.displayName ||
|
||||||
|
func.name ||
|
||||||
|
// Use function decomposition as a last resort to get function
|
||||||
|
// name. Does not rely on function decomposition to work - if it
|
||||||
|
// doesn't debugging will be slightly less informative
|
||||||
|
// (i.e. toString will say 'spy' rather than 'myFunc').
|
||||||
|
(String(func).match(/function ([^\s(]+)/) || [])[1]
|
||||||
|
);
|
||||||
|
} catch (e) {
|
||||||
|
// Stringify may fail and we might get an exception, as a last-last
|
||||||
|
// resort fall back to empty string.
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
};
|
76
node_modules/@sinonjs/commons/lib/function-name.test.js
generated
vendored
Normal file
76
node_modules/@sinonjs/commons/lib/function-name.test.js
generated
vendored
Normal file
|
@ -0,0 +1,76 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var jsc = require("jsverify");
|
||||||
|
var refute = require("@sinonjs/referee-sinon").refute;
|
||||||
|
|
||||||
|
var functionName = require("./function-name");
|
||||||
|
|
||||||
|
describe("function-name", function() {
|
||||||
|
it("should return empty string if func is falsy", function() {
|
||||||
|
jsc.assertForall("falsy", function(fn) {
|
||||||
|
return functionName(fn) === "";
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should use displayName by default", function() {
|
||||||
|
jsc.assertForall("nestring", function(displayName) {
|
||||||
|
var fn = { displayName: displayName };
|
||||||
|
|
||||||
|
return functionName(fn) === fn.displayName;
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should use name if displayName is not available", function() {
|
||||||
|
jsc.assertForall("nestring", function(name) {
|
||||||
|
var fn = { name: name };
|
||||||
|
|
||||||
|
return functionName(fn) === fn.name;
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should fallback to string parsing", function() {
|
||||||
|
jsc.assertForall("nat", function(naturalNumber) {
|
||||||
|
var name = "fn" + naturalNumber;
|
||||||
|
var fn = {
|
||||||
|
toString: function() {
|
||||||
|
return "\nfunction " + name;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
return functionName(fn) === name;
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should not fail when a name cannot be found", function() {
|
||||||
|
refute.exception(function() {
|
||||||
|
var fn = {
|
||||||
|
toString: function() {
|
||||||
|
return "\nfunction (";
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
functionName(fn);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should not fail when toString is undefined", function() {
|
||||||
|
refute.exception(function() {
|
||||||
|
functionName(Object.create(null));
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("should not fail when toString throws", function() {
|
||||||
|
refute.exception(function() {
|
||||||
|
var fn;
|
||||||
|
try {
|
||||||
|
// eslint-disable-next-line no-eval
|
||||||
|
fn = eval("(function*() {})")().constructor;
|
||||||
|
} catch (e) {
|
||||||
|
// env doesn't support generators
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
functionName(fn);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
22
node_modules/@sinonjs/commons/lib/global.js
generated
vendored
Normal file
22
node_modules/@sinonjs/commons/lib/global.js
generated
vendored
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A reference to the global object
|
||||||
|
*
|
||||||
|
* @type {object} globalObject
|
||||||
|
*/
|
||||||
|
var globalObject;
|
||||||
|
|
||||||
|
/* istanbul ignore else */
|
||||||
|
if (typeof global !== "undefined") {
|
||||||
|
// Node
|
||||||
|
globalObject = global;
|
||||||
|
} else if (typeof window !== "undefined") {
|
||||||
|
// Browser
|
||||||
|
globalObject = window;
|
||||||
|
} else {
|
||||||
|
// WebWorker
|
||||||
|
globalObject = self;
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = globalObject;
|
16
node_modules/@sinonjs/commons/lib/global.test.js
generated
vendored
Normal file
16
node_modules/@sinonjs/commons/lib/global.test.js
generated
vendored
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var assert = require("@sinonjs/referee-sinon").assert;
|
||||||
|
var globalObject = require("./global");
|
||||||
|
|
||||||
|
describe("global", function() {
|
||||||
|
before(function() {
|
||||||
|
if (typeof global === "undefined") {
|
||||||
|
this.skip();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("is same as global", function() {
|
||||||
|
assert.same(globalObject, global);
|
||||||
|
});
|
||||||
|
});
|
14
node_modules/@sinonjs/commons/lib/index.js
generated
vendored
Normal file
14
node_modules/@sinonjs/commons/lib/index.js
generated
vendored
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
global: require("./global"),
|
||||||
|
calledInOrder: require("./called-in-order"),
|
||||||
|
className: require("./class-name"),
|
||||||
|
deprecated: require("./deprecated"),
|
||||||
|
every: require("./every"),
|
||||||
|
functionName: require("./function-name"),
|
||||||
|
orderByFirstCall: require("./order-by-first-call"),
|
||||||
|
prototypes: require("./prototypes"),
|
||||||
|
typeOf: require("./type-of"),
|
||||||
|
valueToString: require("./value-to-string")
|
||||||
|
};
|
29
node_modules/@sinonjs/commons/lib/index.test.js
generated
vendored
Normal file
29
node_modules/@sinonjs/commons/lib/index.test.js
generated
vendored
Normal file
|
@ -0,0 +1,29 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var assert = require("@sinonjs/referee-sinon").assert;
|
||||||
|
var index = require("./index");
|
||||||
|
|
||||||
|
var expectedMethods = [
|
||||||
|
"calledInOrder",
|
||||||
|
"className",
|
||||||
|
"every",
|
||||||
|
"functionName",
|
||||||
|
"orderByFirstCall",
|
||||||
|
"typeOf",
|
||||||
|
"valueToString"
|
||||||
|
];
|
||||||
|
var expectedObjectProperties = ["deprecated", "prototypes"];
|
||||||
|
|
||||||
|
describe("package", function() {
|
||||||
|
expectedMethods.forEach(function(name) {
|
||||||
|
it("should export a method named " + name, function() {
|
||||||
|
assert.isFunction(index[name]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
expectedObjectProperties.forEach(function(name) {
|
||||||
|
it("should export an object property named " + name, function() {
|
||||||
|
assert.isObject(index[name]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
36
node_modules/@sinonjs/commons/lib/order-by-first-call.js
generated
vendored
Normal file
36
node_modules/@sinonjs/commons/lib/order-by-first-call.js
generated
vendored
Normal file
|
@ -0,0 +1,36 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var sort = require("./prototypes/array").sort;
|
||||||
|
var slice = require("./prototypes/array").slice;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
function comparator(a, b) {
|
||||||
|
// uuid, won't ever be equal
|
||||||
|
var aCall = a.getCall(0);
|
||||||
|
var bCall = b.getCall(0);
|
||||||
|
var aId = (aCall && aCall.callId) || -1;
|
||||||
|
var bId = (bCall && bCall.callId) || -1;
|
||||||
|
|
||||||
|
return aId < bId ? -1 : 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A Sinon proxy object (fake, spy, stub)
|
||||||
|
*
|
||||||
|
* @typedef {object} SinonProxy
|
||||||
|
* @property {Function} getCall - A method that can return the first call
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sorts an array of SinonProxy instances (fake, spy, stub) by their first call
|
||||||
|
*
|
||||||
|
* @param {SinonProxy[] | SinonProxy} spies
|
||||||
|
* @returns {SinonProxy[]}
|
||||||
|
*/
|
||||||
|
function orderByFirstCall(spies) {
|
||||||
|
return sort(slice(spies), comparator);
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = orderByFirstCall;
|
52
node_modules/@sinonjs/commons/lib/order-by-first-call.test.js
generated
vendored
Normal file
52
node_modules/@sinonjs/commons/lib/order-by-first-call.test.js
generated
vendored
Normal file
|
@ -0,0 +1,52 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var assert = require("@sinonjs/referee-sinon").assert;
|
||||||
|
var knuthShuffle = require("knuth-shuffle").knuthShuffle;
|
||||||
|
var sinon = require("@sinonjs/referee-sinon").sinon;
|
||||||
|
var orderByFirstCall = require("./order-by-first-call");
|
||||||
|
|
||||||
|
describe("orderByFirstCall", function() {
|
||||||
|
it("should order an Array of spies by the callId of the first call, ascending", function() {
|
||||||
|
// create an array of spies
|
||||||
|
var spies = [
|
||||||
|
sinon.spy(),
|
||||||
|
sinon.spy(),
|
||||||
|
sinon.spy(),
|
||||||
|
sinon.spy(),
|
||||||
|
sinon.spy(),
|
||||||
|
sinon.spy()
|
||||||
|
];
|
||||||
|
|
||||||
|
// call all the spies
|
||||||
|
spies.forEach(function(spy) {
|
||||||
|
spy();
|
||||||
|
});
|
||||||
|
|
||||||
|
// add a few uncalled spies
|
||||||
|
spies.push(sinon.spy());
|
||||||
|
spies.push(sinon.spy());
|
||||||
|
|
||||||
|
// randomise the order of the spies
|
||||||
|
knuthShuffle(spies);
|
||||||
|
|
||||||
|
var sortedSpies = orderByFirstCall(spies);
|
||||||
|
|
||||||
|
assert.equals(sortedSpies.length, spies.length);
|
||||||
|
|
||||||
|
var orderedByFirstCall = sortedSpies.every(function(spy, index) {
|
||||||
|
if (index + 1 === sortedSpies.length) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
var nextSpy = sortedSpies[index + 1];
|
||||||
|
|
||||||
|
// uncalled spies should be ordered first
|
||||||
|
if (!spy.called) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
return spy.calledImmediatelyBefore(nextSpy);
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.isTrue(orderedByFirstCall);
|
||||||
|
});
|
||||||
|
});
|
44
node_modules/@sinonjs/commons/lib/prototypes/README.md
generated
vendored
Normal file
44
node_modules/@sinonjs/commons/lib/prototypes/README.md
generated
vendored
Normal file
|
@ -0,0 +1,44 @@
|
||||||
|
# Prototypes
|
||||||
|
|
||||||
|
The functions in this folder are to be use for keeping cached references to the built-in prototypes, so that people can't inadvertently break the library by making mistakes in userland.
|
||||||
|
|
||||||
|
See https://github.com/sinonjs/sinon/pull/1523
|
||||||
|
|
||||||
|
## Without cached references
|
||||||
|
|
||||||
|
```js
|
||||||
|
// in userland, the library user needs to replace the filter method on
|
||||||
|
// Array.prototype
|
||||||
|
var array = [1, 2, 3];
|
||||||
|
sinon.replace(array, "filter", sinon.fake.returns(2));
|
||||||
|
|
||||||
|
// in a sinon module, the library author needs to use the filter method
|
||||||
|
var someArray = ["a", "b", 42, "c"];
|
||||||
|
var answer = filter(someArray, function(v) {
|
||||||
|
return v === 42;
|
||||||
|
});
|
||||||
|
|
||||||
|
console.log(answer);
|
||||||
|
// => 2
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## With cached references
|
||||||
|
|
||||||
|
```js
|
||||||
|
// in userland, the library user needs to replace the filter method on
|
||||||
|
// Array.prototype
|
||||||
|
var array = [1, 2, 3];
|
||||||
|
sinon.replace(array, "filter", sinon.fake.returns(2));
|
||||||
|
|
||||||
|
// in a sinon module, the library author needs to use the filter method
|
||||||
|
// get a reference to the original Array.prototype.filter
|
||||||
|
var filter = require("@sinonjs/commons").prototypes.array.filter;
|
||||||
|
var someArray = ["a", "b", 42, "c"];
|
||||||
|
var answer = filter(someArray, function(v) {
|
||||||
|
return v === 42;
|
||||||
|
});
|
||||||
|
|
||||||
|
console.log(answer);
|
||||||
|
// => 42
|
||||||
|
```
|
5
node_modules/@sinonjs/commons/lib/prototypes/array.js
generated
vendored
Normal file
5
node_modules/@sinonjs/commons/lib/prototypes/array.js
generated
vendored
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var copyPrototype = require("./copy-prototype");
|
||||||
|
|
||||||
|
module.exports = copyPrototype(Array.prototype);
|
21
node_modules/@sinonjs/commons/lib/prototypes/copy-prototype.js
generated
vendored
Normal file
21
node_modules/@sinonjs/commons/lib/prototypes/copy-prototype.js
generated
vendored
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var call = Function.call;
|
||||||
|
|
||||||
|
module.exports = function copyPrototypeMethods(prototype) {
|
||||||
|
/* eslint-disable local-rules/no-prototype-methods */
|
||||||
|
return Object.getOwnPropertyNames(prototype).reduce(function(result, name) {
|
||||||
|
// ignore size because it throws from Map
|
||||||
|
if (
|
||||||
|
name !== "size" &&
|
||||||
|
name !== "caller" &&
|
||||||
|
name !== "callee" &&
|
||||||
|
name !== "arguments" &&
|
||||||
|
typeof prototype[name] === "function"
|
||||||
|
) {
|
||||||
|
result[name] = call.bind(prototype[name]);
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
}, Object.create(null));
|
||||||
|
};
|
5
node_modules/@sinonjs/commons/lib/prototypes/function.js
generated
vendored
Normal file
5
node_modules/@sinonjs/commons/lib/prototypes/function.js
generated
vendored
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
var copyPrototype = require("./copy-prototype");
|
||||||
|
|
||||||
|
module.exports = copyPrototype(Function.prototype);
|
10
node_modules/@sinonjs/commons/lib/prototypes/index.js
generated
vendored
Normal file
10
node_modules/@sinonjs/commons/lib/prototypes/index.js
generated
vendored
Normal file
|
@ -0,0 +1,10 @@
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
array: require("./array"),
|
||||||
|
function: require("./function"),
|
||||||
|
map: require("./map"),
|
||||||
|
object: require("./object"),
|
||||||
|
set: require("./set"),
|
||||||
|
string: require("./string")
|
||||||
|
};
|
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue