Compare commits
No commits in common. "main" and "sh" have entirely different histories.
60 changed files with 116 additions and 2752 deletions
|
|
@ -1,18 +0,0 @@
|
||||||
on: [push]
|
|
||||||
jobs:
|
|
||||||
job:
|
|
||||||
container:
|
|
||||||
image: ${{vars.DOCKER}}debian:bookworm
|
|
||||||
steps:
|
|
||||||
- name: spcd
|
|
||||||
env:
|
|
||||||
SPCD: ${{vars.SPCD}}
|
|
||||||
SPCD_SSH_HOSTS: ${{vars.SPCD_SSH_HOSTS}}
|
|
||||||
SPCD_SSH_KEY: ${{secrets.SPCD_SSH_KEY}}
|
|
||||||
SPCD_TXT_LOCALE: ${{vars.SPCD_TXT_LOCALE}}
|
|
||||||
run: ${{vars.SPCD}}
|
|
||||||
|
|
||||||
#- run: spcd-check-project
|
|
||||||
- run: spcd-build-project
|
|
||||||
- run: spcd-browse-workspace
|
|
||||||
- run: spcd-synchronize
|
|
||||||
5
.gitignore
vendored
5
.gitignore
vendored
|
|
@ -1,5 +0,0 @@
|
||||||
__pycache__
|
|
||||||
/tmp
|
|
||||||
/.venv
|
|
||||||
/.vscode
|
|
||||||
/dist
|
|
||||||
11
build.py
11
build.py
|
|
@ -1,11 +0,0 @@
|
||||||
#! /usr/bin/env python3
|
|
||||||
"""Dummy build."""
|
|
||||||
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from rwx.fs import make_directory, write
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
out = Path(__file__).parent / "out" / "web"
|
|
||||||
make_directory(out)
|
|
||||||
write(out / "index.html", "rwx.rwx.work")
|
|
||||||
660
license.md
660
license.md
|
|
@ -1,660 +0,0 @@
|
||||||
# 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
|
|
||||||
sue for patent infringement). To "grant" such a patent license to a
|
|
||||||
party means to make such an agreement or commitment not to enforce a
|
|
||||||
patent against the party.
|
|
||||||
|
|
||||||
If you convey a covered work, knowingly relying on a patent license,
|
|
||||||
and the Corresponding Source of the work is not available for anyone
|
|
||||||
to copy, free of charge and under the terms of this License, through a
|
|
||||||
publicly available network server or other readily accessible means,
|
|
||||||
then you must either (1) cause the Corresponding Source to be so
|
|
||||||
available, or (2) arrange to deprive yourself of the benefit of the
|
|
||||||
patent license for this particular work, or (3) arrange, in a manner
|
|
||||||
consistent with the requirements of this License, to extend the patent
|
|
||||||
license to downstream recipients. "Knowingly relying" means you have
|
|
||||||
actual knowledge that, but for the patent license, your conveying the
|
|
||||||
covered work in a country, or your recipient's use of the covered work
|
|
||||||
in a country, would infringe one or more identifiable patents in that
|
|
||||||
country that you have reason to believe are valid.
|
|
||||||
|
|
||||||
If, pursuant to or in connection with a single transaction or
|
|
||||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
|
||||||
covered work, and grant a patent license to some of the parties
|
|
||||||
receiving the covered work authorizing them to use, propagate, modify
|
|
||||||
or convey a specific copy of the covered work, then the patent license
|
|
||||||
you grant is automatically extended to all recipients of the covered
|
|
||||||
work and works based on it.
|
|
||||||
|
|
||||||
A patent license is "discriminatory" if it does not include within the
|
|
||||||
scope of its coverage, prohibits the exercise of, or is conditioned on
|
|
||||||
the non-exercise of one or more of the rights that are specifically
|
|
||||||
granted under this License. You may not convey a covered work if you
|
|
||||||
are a party to an arrangement with a third party that is in the
|
|
||||||
business of distributing software, under which you make payment to the
|
|
||||||
third party based on the extent of your activity of conveying the
|
|
||||||
work, and under which the third party grants, to any of the parties
|
|
||||||
who would receive the covered work from you, a discriminatory patent
|
|
||||||
license (a) in connection with copies of the covered work conveyed by
|
|
||||||
you (or copies made from those copies), or (b) primarily for and in
|
|
||||||
connection with specific products or compilations that contain the
|
|
||||||
covered work, unless you entered into that arrangement, or that patent
|
|
||||||
license was granted, prior to 28 March 2007.
|
|
||||||
|
|
||||||
Nothing in this License shall be construed as excluding or limiting
|
|
||||||
any implied license or other defenses to infringement that may
|
|
||||||
otherwise be available to you under applicable patent law.
|
|
||||||
|
|
||||||
### 12. No Surrender of Others' Freedom.
|
|
||||||
|
|
||||||
If conditions are imposed on you (whether by court order, agreement or
|
|
||||||
otherwise) that contradict the conditions of this License, they do not
|
|
||||||
excuse you from the conditions of this License. If you cannot convey a
|
|
||||||
covered work so as to satisfy simultaneously your obligations under
|
|
||||||
this License and any other pertinent obligations, then as a
|
|
||||||
consequence you may not convey it at all. For example, if you agree to
|
|
||||||
terms that obligate you to collect a royalty for further conveying
|
|
||||||
from those to whom you convey the Program, the only way you could
|
|
||||||
satisfy both those terms and this License would be to refrain entirely
|
|
||||||
from conveying the Program.
|
|
||||||
|
|
||||||
### 13. 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/>.
|
|
||||||
|
|
@ -1,32 +0,0 @@
|
||||||
[build-system]
|
|
||||||
requires = ["hatchling"]
|
|
||||||
build-backend = "hatchling.build"
|
|
||||||
|
|
||||||
[project]
|
|
||||||
authors = [
|
|
||||||
{ name = "Marc Beninca", email = "git@marc.beninca.link" },
|
|
||||||
]
|
|
||||||
maintainers = [
|
|
||||||
{ name = "Marc Beninca", email = "git@marc.beninca.link" },
|
|
||||||
]
|
|
||||||
classifiers = [
|
|
||||||
"Programming Language :: Python :: 3",
|
|
||||||
"License :: OSI Approved :: GNU Affero General Public License v3",
|
|
||||||
"Operating System :: OS Independent",
|
|
||||||
]
|
|
||||||
dependencies = []
|
|
||||||
description = "Read Write eXecute"
|
|
||||||
dynamic = ["version"]
|
|
||||||
keywords = []
|
|
||||||
license-files = ["license.md"]
|
|
||||||
name = "rwx"
|
|
||||||
readme = "readme.md"
|
|
||||||
requires-python = ">= 3.11"
|
|
||||||
|
|
||||||
[project.scripts]
|
|
||||||
# command = "package.module:function"
|
|
||||||
|
|
||||||
[project.urls]
|
|
||||||
|
|
||||||
[tool.hatch.version]
|
|
||||||
path = "rwx/__init__.py"
|
|
||||||
74
readme.md
74
readme.md
|
|
@ -1,74 +0,0 @@
|
||||||
# Read Write eXecute
|
|
||||||
|
|
||||||
A tiny framework to read, write & execute things.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Why
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## How
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## What
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Who
|
|
||||||
|
|
||||||
### By
|
|
||||||
|
|
||||||
* [Marc Beninca](https://marc.beninca.link)
|
|
||||||
|
|
||||||
### For
|
|
||||||
|
|
||||||
* myself
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Where
|
|
||||||
|
|
||||||
### Chat
|
|
||||||
|
|
||||||
* [Discord](https://discord.com/channels/983145051985154108/1255894474895134761)
|
|
||||||
* [IRC](ircs://irc.libera.chat/##rwx)
|
|
||||||
|
|
||||||
### Forge
|
|
||||||
|
|
||||||
* [Repository](https://forge.rwx.work/rwx.work/rwx)
|
|
||||||
* [RSS](https://forge.rwx.work/rwx.work/rwx.rss)
|
|
||||||
* [Workflows](https://forge.rwx.work/rwx.work/rwx/actions)
|
|
||||||
|
|
||||||
### Deployment
|
|
||||||
|
|
||||||
* [Site](https://rwx.rwx.work)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## When
|
|
||||||
|
|
||||||
### Task stack
|
|
||||||
|
|
||||||
#### Python
|
|
||||||
|
|
||||||
* character constants for box drawing
|
|
||||||
* common __str__ function
|
|
||||||
* parse pyproject.toml to write commands
|
|
||||||
* write classes for
|
|
||||||
* steps bars to log
|
|
||||||
* system commands to run
|
|
||||||
* with single call of subprocess.run
|
|
||||||
* or alternate subprocess method?
|
|
||||||
|
|
||||||
#### Shell
|
|
||||||
|
|
||||||
* git switch signing commits & tags
|
|
||||||
* shellcheck & shfmt
|
|
||||||
* python tools
|
|
||||||
* log
|
|
||||||
* hetzner
|
|
||||||
* apt
|
|
||||||
* apt-file search | grep
|
|
||||||
* ffmpeg
|
|
||||||
|
|
@ -1,33 +0,0 @@
|
||||||
"""Read Write eXecute."""
|
|
||||||
|
|
||||||
__version__ = "0.0.1"
|
|
||||||
|
|
||||||
from os import linesep
|
|
||||||
|
|
||||||
|
|
||||||
class Object:
|
|
||||||
"""Root object."""
|
|
||||||
|
|
||||||
def __repr__(self) -> str:
|
|
||||||
"""Return machine-readable state.
|
|
||||||
|
|
||||||
:return: state
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
name = self.__class__.__name__
|
|
||||||
attributes = [
|
|
||||||
f"{k}={v!r}" for k, v in vars(self).items() if not k.startswith("_")
|
|
||||||
]
|
|
||||||
arguments = ", ".join(attributes)
|
|
||||||
return f"{name}({arguments})"
|
|
||||||
|
|
||||||
def __str__(self) -> str:
|
|
||||||
"""Return human-readable state.
|
|
||||||
|
|
||||||
:return: state
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
attributes = [
|
|
||||||
f"{k} = {v}" for k, v in vars(self).items() if not k.startswith("_")
|
|
||||||
]
|
|
||||||
return linesep.join(attributes)
|
|
||||||
|
|
@ -1,19 +0,0 @@
|
||||||
#! /usr/bin/env python3
|
|
||||||
|
|
||||||
"""Entry point."""
|
|
||||||
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from rwx import fs
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
file_path: Path = Path(__file__).resolve()
|
|
||||||
root_path: Path = file_path.parent
|
|
||||||
directory_path: Path = root_path / "tmp"
|
|
||||||
file_path = directory_path / "file"
|
|
||||||
|
|
||||||
fs.wipe(directory_path)
|
|
||||||
fs.make_directory(directory_path)
|
|
||||||
fs.write(file_path, "Martine écrit beaucoup.")
|
|
||||||
fs.empty_file(file_path)
|
|
||||||
fs.write(file_path, "Martine écrit moins.")
|
|
||||||
|
|
@ -1,13 +0,0 @@
|
||||||
"""Handle system arguments."""
|
|
||||||
|
|
||||||
import sys
|
|
||||||
|
|
||||||
|
|
||||||
def split() -> tuple[str, list[str]]:
|
|
||||||
"""Split command & actual arguments.
|
|
||||||
|
|
||||||
:return: both
|
|
||||||
:rtype: tuple[str, list[str]]
|
|
||||||
"""
|
|
||||||
command, *arguments = sys.argv
|
|
||||||
return command, arguments
|
|
||||||
|
|
@ -1,22 +0,0 @@
|
||||||
"""Handle system commands & packages."""
|
|
||||||
|
|
||||||
commands: list[str] = []
|
|
||||||
packages: list[str] = []
|
|
||||||
|
|
||||||
|
|
||||||
def need(command: str) -> None:
|
|
||||||
"""Assert package dependency for a command.
|
|
||||||
|
|
||||||
:param command: name of the requested command
|
|
||||||
:type command: str
|
|
||||||
"""
|
|
||||||
package: str | None
|
|
||||||
match command:
|
|
||||||
case "debootstrap":
|
|
||||||
package = "debootstrap"
|
|
||||||
case "mksquashfs" | "unsquashfs":
|
|
||||||
package = "squashfs-tools"
|
|
||||||
case _:
|
|
||||||
package = None
|
|
||||||
if package and package not in packages:
|
|
||||||
packages.append(package)
|
|
||||||
|
|
@ -1,26 +0,0 @@
|
||||||
"""Wrap SquashFS commands."""
|
|
||||||
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from rwx import cmd, ps
|
|
||||||
|
|
||||||
cmd.need("mksquashfs")
|
|
||||||
|
|
||||||
|
|
||||||
def mksquashfs(input_root: Path, output_file: Path) -> None:
|
|
||||||
"""Make a SquashFS bootable image file.
|
|
||||||
|
|
||||||
:param input_root: ?
|
|
||||||
:type input_root: Path
|
|
||||||
:param output_file: ?
|
|
||||||
:type output_file: Path
|
|
||||||
"""
|
|
||||||
ps.run(
|
|
||||||
"mksquashfs",
|
|
||||||
str(input_root),
|
|
||||||
str(output_file),
|
|
||||||
"-comp",
|
|
||||||
"zstd",
|
|
||||||
"-Xcompression-level",
|
|
||||||
str(18),
|
|
||||||
)
|
|
||||||
|
|
@ -1,31 +0,0 @@
|
||||||
"""Wrap Debian commands."""
|
|
||||||
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from rwx import cmd, ps
|
|
||||||
|
|
||||||
cmd.need("debootstrap")
|
|
||||||
|
|
||||||
BOOTSTRAP_ARCHITECTURE = "amd64"
|
|
||||||
BOOTSTRAP_VARIANT = "minbase"
|
|
||||||
|
|
||||||
|
|
||||||
def bootstrap(root_path: Path, suite: str, mirror_location: str) -> None:
|
|
||||||
"""Boostrap a base operating filesystem.
|
|
||||||
|
|
||||||
:param root_path: target output path
|
|
||||||
:type root_path: Path
|
|
||||||
:param suite: target distribution name
|
|
||||||
:type suite: str
|
|
||||||
:param mirror_location: source input repository
|
|
||||||
:type mirror_location: str
|
|
||||||
"""
|
|
||||||
command = (
|
|
||||||
"debootstrap",
|
|
||||||
("--arch", BOOTSTRAP_ARCHITECTURE),
|
|
||||||
("--variant", BOOTSTRAP_VARIANT),
|
|
||||||
suite,
|
|
||||||
str(root_path),
|
|
||||||
mirror_location,
|
|
||||||
)
|
|
||||||
ps.run(*command)
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
"""Handle errors."""
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
|
|
||||||
class Error(Object, Exception):
|
|
||||||
"""Parent class for all errors."""
|
|
||||||
|
|
@ -1,159 +0,0 @@
|
||||||
"""Operations involving FileSystems."""
|
|
||||||
|
|
||||||
import os
|
|
||||||
import shutil
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
import tomllib
|
|
||||||
|
|
||||||
from rwx import ps
|
|
||||||
|
|
||||||
CHARSET = "UTF-8"
|
|
||||||
|
|
||||||
|
|
||||||
def create_image(file_path: Path, size_bytes: int) -> None:
|
|
||||||
"""Create a virtual device image file.
|
|
||||||
|
|
||||||
:param file_path: target image file
|
|
||||||
:type file_path: Path
|
|
||||||
:param size_bytes: virtual volume
|
|
||||||
:type size_bytes: int
|
|
||||||
"""
|
|
||||||
ps.run(
|
|
||||||
("qemu-img", "create"),
|
|
||||||
("-f", "qcow2"),
|
|
||||||
(str(file_path), str(size_bytes)),
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
def empty_file(path: Path) -> None:
|
|
||||||
"""Empty the file at provided path.
|
|
||||||
|
|
||||||
:param path: target file to empty
|
|
||||||
:type path: Path
|
|
||||||
"""
|
|
||||||
write(path, "")
|
|
||||||
|
|
||||||
|
|
||||||
def get_mount_uuid(path: Path) -> str:
|
|
||||||
"""Return the filesystem UUID of a mountpoint path.
|
|
||||||
|
|
||||||
:param path: mountpoint path
|
|
||||||
:type path: Path
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return ps.run_line(
|
|
||||||
"findmnt",
|
|
||||||
"--noheadings",
|
|
||||||
("--output", "UUID"),
|
|
||||||
str(path),
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
def get_path_mount(path: Path) -> Path:
|
|
||||||
"""Return the mountpoint path of an arbitrary path.
|
|
||||||
|
|
||||||
:param path: arbitrary path
|
|
||||||
:type path: Path
|
|
||||||
:rtype: Path
|
|
||||||
"""
|
|
||||||
return Path(
|
|
||||||
ps.run_line(
|
|
||||||
"stat",
|
|
||||||
("--format", "%m"),
|
|
||||||
str(path),
|
|
||||||
),
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
def get_path_uuid(path: Path) -> str:
|
|
||||||
"""Return the filesystem UUID of an arbitrary path.
|
|
||||||
|
|
||||||
:param path: arbitrary path
|
|
||||||
:type path: Path
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return get_mount_uuid(get_path_mount(path))
|
|
||||||
|
|
||||||
|
|
||||||
def make_directory(path: Path) -> None:
|
|
||||||
"""Make a directory (and its parents) from a path.
|
|
||||||
|
|
||||||
:param path: directory to create
|
|
||||||
:type path: Path
|
|
||||||
"""
|
|
||||||
path.mkdir(exist_ok=True, parents=True)
|
|
||||||
|
|
||||||
|
|
||||||
def read_file_bytes(file_path: Path) -> bytes:
|
|
||||||
"""Read whole file bytes.
|
|
||||||
|
|
||||||
:param file_path: source input file
|
|
||||||
:type file_path: Path
|
|
||||||
:rtype: bytes
|
|
||||||
"""
|
|
||||||
with file_path.open("br") as file_object:
|
|
||||||
return file_object.read()
|
|
||||||
|
|
||||||
|
|
||||||
def read_file_dict(file_path: Path, charset: str = CHARSET) -> dict:
|
|
||||||
"""Read whole file as toml object.
|
|
||||||
|
|
||||||
:param file_path: source input file
|
|
||||||
:type file_path: Path
|
|
||||||
:param charset: charset to use for decoding input
|
|
||||||
:type charset: str
|
|
||||||
:rtype: dict
|
|
||||||
"""
|
|
||||||
text = read_file_text(file_path, charset)
|
|
||||||
return tomllib.loads(text)
|
|
||||||
|
|
||||||
|
|
||||||
def read_file_lines(file_path: Path, charset: str = CHARSET) -> list[str]:
|
|
||||||
"""Read whole file lines.
|
|
||||||
|
|
||||||
:param file_path: source input file
|
|
||||||
:type file_path: Path
|
|
||||||
:param charset: charset to use for decoding input
|
|
||||||
:type charset: str
|
|
||||||
:rtype: list[str]
|
|
||||||
"""
|
|
||||||
return read_file_text(file_path, charset).split(os.linesep)
|
|
||||||
|
|
||||||
|
|
||||||
def read_file_text(file_path: Path, charset: str = CHARSET) -> str:
|
|
||||||
"""Read whole file text.
|
|
||||||
|
|
||||||
:param file_path: source input file
|
|
||||||
:type file_path: Path
|
|
||||||
:param charset: charset to use for decoding input
|
|
||||||
:type charset: str
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return read_file_bytes(file_path).decode(charset)
|
|
||||||
|
|
||||||
|
|
||||||
def wipe(path: Path) -> None:
|
|
||||||
"""Wipe provided path, whether directory or file.
|
|
||||||
|
|
||||||
:param path: target path
|
|
||||||
:type path: Path
|
|
||||||
"""
|
|
||||||
try:
|
|
||||||
path.unlink(missing_ok=True)
|
|
||||||
except IsADirectoryError:
|
|
||||||
shutil.rmtree(path)
|
|
||||||
|
|
||||||
|
|
||||||
def write(file_path: Path, text: str, charset: str = CHARSET) -> None:
|
|
||||||
"""Write text into a file.
|
|
||||||
|
|
||||||
:param file_path: target file path
|
|
||||||
:type file_path: Path
|
|
||||||
:param text: content to write
|
|
||||||
:type text: str
|
|
||||||
:param charset: charset to use for encoding ouput
|
|
||||||
:type charset: str
|
|
||||||
"""
|
|
||||||
with file_path.open(encoding=charset, mode="w") as file_object:
|
|
||||||
file_object.write(text)
|
|
||||||
|
|
@ -1,54 +0,0 @@
|
||||||
"""Wrap GRUB commands."""
|
|
||||||
|
|
||||||
from __future__ import annotations
|
|
||||||
|
|
||||||
from rwx import cmd, ps
|
|
||||||
|
|
||||||
cmd.need("grub-mkimage")
|
|
||||||
|
|
||||||
COMPRESSION = "xz"
|
|
||||||
ENV_BYTES = 1024
|
|
||||||
ENV_COMMENT = "#"
|
|
||||||
ENV_HEADER = f"""{ENV_COMMENT} GRUB Environment Block
|
|
||||||
"""
|
|
||||||
MODULES = {
|
|
||||||
"i386-pc": [
|
|
||||||
("biosdisk",),
|
|
||||||
("ntldr",),
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
def make_image(
|
|
||||||
image_format: str,
|
|
||||||
image_path: str,
|
|
||||||
modules: list[str],
|
|
||||||
memdisk_path: str,
|
|
||||||
pubkey_path: str | None = None,
|
|
||||||
) -> None:
|
|
||||||
"""Make a binary bootable image.
|
|
||||||
|
|
||||||
:param image_format: output format (x86_64-efi, i386-pc, arm64-efi)
|
|
||||||
:type image_format: str
|
|
||||||
:param image_path: output file
|
|
||||||
:type image_path: str
|
|
||||||
:param modules: modules to embed
|
|
||||||
:type modules: list[str]
|
|
||||||
:param memdisk_path: archive to include
|
|
||||||
:type memdisk_path: str
|
|
||||||
:param pubkey_path: extra public key to add
|
|
||||||
:type pubkey_path: str | None
|
|
||||||
"""
|
|
||||||
args: list[str | tuple[str, ...]] = [
|
|
||||||
"grub-mkimage",
|
|
||||||
("--compress", COMPRESSION),
|
|
||||||
("--format", image_format),
|
|
||||||
("--output", image_path),
|
|
||||||
("--memdisk", memdisk_path),
|
|
||||||
]
|
|
||||||
if pubkey_path:
|
|
||||||
args.append(("--pubkey", pubkey_path))
|
|
||||||
args.extend(modules)
|
|
||||||
if extra_modules := MODULES.get(image_format):
|
|
||||||
args.extend(extra_modules)
|
|
||||||
ps.run(*args)
|
|
||||||
|
|
@ -1,51 +0,0 @@
|
||||||
"""Handle logging."""
|
|
||||||
|
|
||||||
import logging
|
|
||||||
import sys
|
|
||||||
|
|
||||||
|
|
||||||
def get_file_logger(name: str) -> logging.Logger:
|
|
||||||
"""Return a file logger.
|
|
||||||
|
|
||||||
:param name: arbitrary name
|
|
||||||
:type name: str
|
|
||||||
:rtype: logging.Logger
|
|
||||||
"""
|
|
||||||
# formatter
|
|
||||||
items = [
|
|
||||||
"%(name)s: %(asctime)s",
|
|
||||||
"%(levelname)s",
|
|
||||||
"%(filename)s:%(lineno)s",
|
|
||||||
"%(process)d >>> %(message)s",
|
|
||||||
]
|
|
||||||
template = " | ".join(items)
|
|
||||||
formatter = logging.Formatter(template)
|
|
||||||
# handler
|
|
||||||
out_handler = logging.StreamHandler(stream=sys.stdout)
|
|
||||||
out_handler.setFormatter(formatter)
|
|
||||||
out_handler.setLevel(logging.INFO)
|
|
||||||
# logger
|
|
||||||
logger = logging.getLogger(name)
|
|
||||||
logger.addHandler(out_handler)
|
|
||||||
logger.setLevel(logging.INFO)
|
|
||||||
return logger
|
|
||||||
|
|
||||||
|
|
||||||
def get_stream_logger(level: int) -> logging.Logger:
|
|
||||||
"""Return a stream logger.
|
|
||||||
|
|
||||||
:param level: filtering level
|
|
||||||
:type level: int
|
|
||||||
:rtype: logging.Logger
|
|
||||||
"""
|
|
||||||
# handler
|
|
||||||
out_handler = logging.StreamHandler(stream=sys.stdout)
|
|
||||||
out_handler.setLevel(level)
|
|
||||||
# logger
|
|
||||||
logger = logging.getLogger()
|
|
||||||
logger.addHandler(out_handler)
|
|
||||||
logger.setLevel(level)
|
|
||||||
return logger
|
|
||||||
|
|
||||||
|
|
||||||
stream = get_stream_logger(logging.INFO)
|
|
||||||
|
|
@ -1,20 +0,0 @@
|
||||||
"""Control Operating Systems."""
|
|
||||||
|
|
||||||
from os import sep
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from .abstract import OS
|
|
||||||
from .debian import Debian
|
|
||||||
|
|
||||||
|
|
||||||
def from_path(path: Path) -> OS:
|
|
||||||
"""Initialize from an already existing path.
|
|
||||||
|
|
||||||
:param path: source root directory
|
|
||||||
:type path: Path
|
|
||||||
:rtype: OS
|
|
||||||
"""
|
|
||||||
return Debian(path)
|
|
||||||
|
|
||||||
|
|
||||||
up = from_path(Path(sep))
|
|
||||||
|
|
@ -1,26 +0,0 @@
|
||||||
"""Abstract Operating System."""
|
|
||||||
|
|
||||||
from abc import ABC, abstractmethod
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
|
|
||||||
class OS(Object, ABC):
|
|
||||||
"""Operating System."""
|
|
||||||
|
|
||||||
def __init__(self, path: Path) -> None:
|
|
||||||
"""Set root.
|
|
||||||
|
|
||||||
:param path: root directory
|
|
||||||
:type path: Path
|
|
||||||
"""
|
|
||||||
self.root = path
|
|
||||||
self.name = self.get_name()
|
|
||||||
|
|
||||||
@abstractmethod
|
|
||||||
def get_name(self) -> str:
|
|
||||||
"""Return mandatory name.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
|
|
@ -1,14 +0,0 @@
|
||||||
"""Debian operating system."""
|
|
||||||
|
|
||||||
from .abstract import OS
|
|
||||||
|
|
||||||
|
|
||||||
class Debian(OS):
|
|
||||||
"""Debian operating system."""
|
|
||||||
|
|
||||||
def get_name(self) -> str:
|
|
||||||
"""Return name.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return "Debian"
|
|
||||||
|
|
@ -1,29 +0,0 @@
|
||||||
"""Package Manager."""
|
|
||||||
|
|
||||||
from abc import ABC, abstractmethod
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
from rwx.ps import Command
|
|
||||||
|
|
||||||
|
|
||||||
class PM(Object, ABC):
|
|
||||||
"""Package Manager."""
|
|
||||||
|
|
||||||
def __init__(self) -> None:
|
|
||||||
"""Set commands."""
|
|
||||||
self.clean = self.get_clean_command()
|
|
||||||
self.install = self.get_install_command()
|
|
||||||
|
|
||||||
@abstractmethod
|
|
||||||
def get_clean_command(self) -> Command:
|
|
||||||
"""Command to clean packages cache.
|
|
||||||
|
|
||||||
:rtype: Command
|
|
||||||
"""
|
|
||||||
|
|
||||||
@abstractmethod
|
|
||||||
def get_install_command(self) -> Command:
|
|
||||||
"""Command to install package(s).
|
|
||||||
|
|
||||||
:rtype: Command
|
|
||||||
"""
|
|
||||||
|
|
@ -1,22 +0,0 @@
|
||||||
"""Advanced Package Tool."""
|
|
||||||
|
|
||||||
from rwx.os.pm import PM
|
|
||||||
from rwx.ps import Command
|
|
||||||
|
|
||||||
|
|
||||||
class APT(PM):
|
|
||||||
"""Advanced Package Tool."""
|
|
||||||
|
|
||||||
def get_clean_command(self) -> Command:
|
|
||||||
"""Return clean command.
|
|
||||||
|
|
||||||
:rtype: Command
|
|
||||||
"""
|
|
||||||
return Command()
|
|
||||||
|
|
||||||
def get_install_command(self) -> Command:
|
|
||||||
"""Return install command.
|
|
||||||
|
|
||||||
:rtype: Command
|
|
||||||
"""
|
|
||||||
return Command()
|
|
||||||
|
|
@ -1,20 +0,0 @@
|
||||||
"""Handle projects."""
|
|
||||||
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
|
|
||||||
class Project(Object):
|
|
||||||
"""Parent class for any type of project."""
|
|
||||||
|
|
||||||
def __init__(self, file: Path) -> None:
|
|
||||||
"""Set file, root & name.
|
|
||||||
|
|
||||||
:param file: root reference file
|
|
||||||
:type file: Path
|
|
||||||
"""
|
|
||||||
self.raw = file
|
|
||||||
self.file = self.raw.resolve()
|
|
||||||
self.root: Path = self.file.parent
|
|
||||||
self.name: str = self.root.name
|
|
||||||
|
|
@ -1,39 +0,0 @@
|
||||||
"""Project consisting only of a Sphinx documentation."""
|
|
||||||
|
|
||||||
from typing import TYPE_CHECKING
|
|
||||||
|
|
||||||
from sphinx.cmd.build import build_main
|
|
||||||
|
|
||||||
from rwx.fs import wipe
|
|
||||||
from rwx.prj import Project
|
|
||||||
|
|
||||||
if TYPE_CHECKING:
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
|
|
||||||
class SphinxProject(Project):
|
|
||||||
"""Child class for a project based on Sphinx."""
|
|
||||||
|
|
||||||
def build(self) -> None:
|
|
||||||
"""Build the project."""
|
|
||||||
output_root: Path = self.root / "out"
|
|
||||||
wipe(output_root)
|
|
||||||
arguments: list[str] = [
|
|
||||||
"-E",
|
|
||||||
"-j",
|
|
||||||
"2",
|
|
||||||
"-b",
|
|
||||||
"html",
|
|
||||||
"-D",
|
|
||||||
f"project={self.name}",
|
|
||||||
"-D",
|
|
||||||
"master_doc=index",
|
|
||||||
"-D",
|
|
||||||
"html_theme=sphinx_rtd_theme",
|
|
||||||
"-c",
|
|
||||||
str(self.root),
|
|
||||||
# "-C",
|
|
||||||
str(self.root / self.name),
|
|
||||||
str(output_root / "web"),
|
|
||||||
]
|
|
||||||
build_main(arguments)
|
|
||||||
|
|
@ -1,85 +0,0 @@
|
||||||
"""Handle processes."""
|
|
||||||
|
|
||||||
from __future__ import annotations
|
|
||||||
|
|
||||||
import subprocess
|
|
||||||
|
|
||||||
from rwx import Object, txt
|
|
||||||
|
|
||||||
|
|
||||||
class Command(Object):
|
|
||||||
"""Command to run."""
|
|
||||||
|
|
||||||
def __init__(self, *arguments: str | tuple[str, ...]) -> None:
|
|
||||||
"""Set raw & flat arguments.
|
|
||||||
|
|
||||||
:param *arguments: single argument or grouped ones
|
|
||||||
:type *arguments: str | tuple[str, ...]
|
|
||||||
"""
|
|
||||||
self.raw = arguments
|
|
||||||
self.flat: list[str] = []
|
|
||||||
|
|
||||||
|
|
||||||
def get_tuples_args(*items: str | tuple[str, ...]) -> list[str]:
|
|
||||||
"""Turn arguments tuples into an arguments list.
|
|
||||||
|
|
||||||
:param *items: single item or grouped ones
|
|
||||||
:type *items: str | tuple[str, ...]
|
|
||||||
:rtype: list[str]
|
|
||||||
"""
|
|
||||||
args: list[str] = []
|
|
||||||
for item in items:
|
|
||||||
match item:
|
|
||||||
case str():
|
|
||||||
args.append(item)
|
|
||||||
case tuple():
|
|
||||||
args.extend(item)
|
|
||||||
return args
|
|
||||||
|
|
||||||
|
|
||||||
def run(*items: str | tuple[str, ...]) -> subprocess.CompletedProcess:
|
|
||||||
"""Run from a list of arguments tuples.
|
|
||||||
|
|
||||||
:param *items: single item or grouped ones
|
|
||||||
:type *items: str | tuple[str, ...]
|
|
||||||
:rtype: subprocess.CompletedProcess
|
|
||||||
"""
|
|
||||||
return subprocess.run(
|
|
||||||
get_tuples_args(*items),
|
|
||||||
capture_output=False,
|
|
||||||
check=True,
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
def run_line(*items: str | tuple[str, ...], charset: str = txt.CHARSET) -> str:
|
|
||||||
"""Run and return output line.
|
|
||||||
|
|
||||||
:param *items: single item or grouped ones
|
|
||||||
:type *items: str | tuple[str, ...]
|
|
||||||
:param charset: charset to use for decoding binary output
|
|
||||||
:type charset: str
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
line, *_ = run_lines(*items, charset=charset)
|
|
||||||
return line
|
|
||||||
|
|
||||||
|
|
||||||
def run_lines(
|
|
||||||
*items: str | tuple[str, ...],
|
|
||||||
charset: str = txt.CHARSET,
|
|
||||||
) -> list[str]:
|
|
||||||
"""Run and return output lines.
|
|
||||||
|
|
||||||
:param *items: single item or grouped ones
|
|
||||||
:type *items: str | tuple[str, ...]
|
|
||||||
:param charset: charset to use for decoding binary output
|
|
||||||
:type charset: str
|
|
||||||
:rtype: list[str]
|
|
||||||
"""
|
|
||||||
process = subprocess.run(
|
|
||||||
get_tuples_args(*items),
|
|
||||||
capture_output=True,
|
|
||||||
check=True,
|
|
||||||
)
|
|
||||||
string = process.stdout.decode(charset)
|
|
||||||
return string.rstrip().splitlines()
|
|
||||||
|
|
@ -1 +0,0 @@
|
||||||
"""Configure FreeTube."""
|
|
||||||
|
|
@ -1,31 +0,0 @@
|
||||||
"""FreeTube authors."""
|
|
||||||
|
|
||||||
from typing import TYPE_CHECKING
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
if TYPE_CHECKING:
|
|
||||||
from .playlists import Playlist
|
|
||||||
|
|
||||||
|
|
||||||
class Author(Object):
|
|
||||||
"""FreeTube author."""
|
|
||||||
|
|
||||||
def __init__(self, uid: str, name: str) -> None:
|
|
||||||
"""Set uid & name.
|
|
||||||
|
|
||||||
:param uid: identifier
|
|
||||||
:type uid: str
|
|
||||||
:param name: label
|
|
||||||
:type name: str
|
|
||||||
"""
|
|
||||||
self.uid = uid
|
|
||||||
self.name = name
|
|
||||||
self.playlist: Playlist
|
|
||||||
|
|
||||||
def to_db(self) -> str:
|
|
||||||
"""Return non-breakable name.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return self.name.replace(" ", chr(0xA0))
|
|
||||||
|
|
@ -1,29 +0,0 @@
|
||||||
"""FreeTube channels."""
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
|
|
||||||
class Channel(Object):
|
|
||||||
"""FreeTube channel."""
|
|
||||||
|
|
||||||
def __init__(self, uid: str, name: str) -> None:
|
|
||||||
"""Set uid & name.
|
|
||||||
|
|
||||||
:param uid: unique identifier
|
|
||||||
:type uid: str
|
|
||||||
:param name: label
|
|
||||||
:type name: str
|
|
||||||
"""
|
|
||||||
self.uid = uid
|
|
||||||
self.name = name
|
|
||||||
|
|
||||||
def to_db(self) -> str:
|
|
||||||
"""Return identifier as db.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return f"""\
|
|
||||||
{{\
|
|
||||||
"id":"{self.uid}"\
|
|
||||||
}}\
|
|
||||||
"""
|
|
||||||
|
|
@ -1,21 +0,0 @@
|
||||||
"""Output FreeTube db."""
|
|
||||||
|
|
||||||
|
|
||||||
def to_db(value: object) -> str:
|
|
||||||
"""Render value as string.
|
|
||||||
|
|
||||||
:param value: value to render
|
|
||||||
:type value: object
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
match value:
|
|
||||||
case bool():
|
|
||||||
text = str(value).lower()
|
|
||||||
case dict():
|
|
||||||
sub = ",".join([f'"{i}":{to_db(v)}' for i, v in value.items()])
|
|
||||||
text = f"{{{sub}}}"
|
|
||||||
case float() | str():
|
|
||||||
text = f'"{value}"'
|
|
||||||
case _:
|
|
||||||
text = str(value)
|
|
||||||
return text
|
|
||||||
|
|
@ -1,24 +0,0 @@
|
||||||
"""FreeTube languages."""
|
|
||||||
|
|
||||||
from typing import TYPE_CHECKING
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
if TYPE_CHECKING:
|
|
||||||
from .playlists import Playlist
|
|
||||||
|
|
||||||
|
|
||||||
class Language(Object):
|
|
||||||
"""FreeTube language."""
|
|
||||||
|
|
||||||
def __init__(self, uid: str, name: str) -> None:
|
|
||||||
"""Set uid & name.
|
|
||||||
|
|
||||||
:param uid: identifier
|
|
||||||
:type uid: str
|
|
||||||
:param name: label
|
|
||||||
:type name: str
|
|
||||||
"""
|
|
||||||
self.uid = uid
|
|
||||||
self.name = name
|
|
||||||
self.playlist: Playlist
|
|
||||||
|
|
@ -1,47 +0,0 @@
|
||||||
"""FreeTube playlists."""
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
from .videos import Video
|
|
||||||
|
|
||||||
|
|
||||||
class Playlist(Object):
|
|
||||||
"""FreeTube playlist."""
|
|
||||||
|
|
||||||
def __init__(self, uid: str, name: str) -> None:
|
|
||||||
"""Set uid & name.
|
|
||||||
|
|
||||||
:param uid: identifier
|
|
||||||
:type uid: str
|
|
||||||
:param name: label
|
|
||||||
:type name: str
|
|
||||||
"""
|
|
||||||
self.uid = uid
|
|
||||||
self.name = name
|
|
||||||
self.videos: list[Video] = []
|
|
||||||
|
|
||||||
def add(self, video: Video) -> None:
|
|
||||||
"""Add video.
|
|
||||||
|
|
||||||
:param video: video to add
|
|
||||||
:type video: Video
|
|
||||||
"""
|
|
||||||
self.videos.append(video)
|
|
||||||
|
|
||||||
def to_db(self) -> str:
|
|
||||||
"""Return identifier, name & videos.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
videos = ",".join([video.to_db() for video in self.videos])
|
|
||||||
return f"""\
|
|
||||||
{{\
|
|
||||||
"_id":"{self.uid}"\
|
|
||||||
,\
|
|
||||||
"playlistName":"{self.name}"\
|
|
||||||
,\
|
|
||||||
"protected":true\
|
|
||||||
,\
|
|
||||||
"videos":[{videos}]\
|
|
||||||
}}\
|
|
||||||
"""
|
|
||||||
|
|
@ -1,45 +0,0 @@
|
||||||
"""FreeTube profiles."""
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
from .channels import Channel
|
|
||||||
|
|
||||||
|
|
||||||
class Profile(Object):
|
|
||||||
"""FreeTube profile."""
|
|
||||||
|
|
||||||
def __init__(self, uid: str, name: str) -> None:
|
|
||||||
"""Set uid & name.
|
|
||||||
|
|
||||||
:param uid: unique identifier
|
|
||||||
:type uid: str
|
|
||||||
:param name: label
|
|
||||||
:type name: str
|
|
||||||
"""
|
|
||||||
self.id = uid
|
|
||||||
self.name = name
|
|
||||||
self.channels: list[Channel] = []
|
|
||||||
|
|
||||||
def add(self, channel: Channel) -> None:
|
|
||||||
"""Add channel.
|
|
||||||
|
|
||||||
:param channel: channel to add
|
|
||||||
:type channel: Channel
|
|
||||||
"""
|
|
||||||
self.channels.append(channel)
|
|
||||||
|
|
||||||
def to_db(self) -> str:
|
|
||||||
"""Return identifier, name & channels.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
channels = ",".join([channel.to_db() for channel in self.channels])
|
|
||||||
return f"""\
|
|
||||||
{{\
|
|
||||||
"_id":"{self.id}"\
|
|
||||||
,\
|
|
||||||
"name":"{self.name}"\
|
|
||||||
,\
|
|
||||||
"subscriptions":[{channels}]\
|
|
||||||
}}\
|
|
||||||
"""
|
|
||||||
|
|
@ -1,33 +0,0 @@
|
||||||
"""FreeTube settings."""
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
from .db import to_db
|
|
||||||
|
|
||||||
|
|
||||||
class Setting(Object):
|
|
||||||
"""FreeTube setting."""
|
|
||||||
|
|
||||||
def __init__(self, uid: str, value: object) -> None:
|
|
||||||
"""Set uid & value.
|
|
||||||
|
|
||||||
:param uid: unique identifier
|
|
||||||
:type uid: str
|
|
||||||
:param value: value
|
|
||||||
:type value: object
|
|
||||||
"""
|
|
||||||
self.uid = uid
|
|
||||||
self.value = value
|
|
||||||
|
|
||||||
def to_db(self) -> str:
|
|
||||||
"""Return uid & value as db string.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return f"""\
|
|
||||||
{{\
|
|
||||||
"_id":"{self.uid}"\
|
|
||||||
,\
|
|
||||||
"value":{to_db(self.value)}\
|
|
||||||
}}\
|
|
||||||
"""
|
|
||||||
|
|
@ -1,33 +0,0 @@
|
||||||
"""FreeTube videos."""
|
|
||||||
|
|
||||||
from rwx import Object
|
|
||||||
|
|
||||||
|
|
||||||
class Video(Object):
|
|
||||||
"""FreeTube video."""
|
|
||||||
|
|
||||||
def __init__(self, uid: str, name: str) -> None:
|
|
||||||
"""Set id & name.
|
|
||||||
|
|
||||||
:param uid: identifier
|
|
||||||
:type uid: str
|
|
||||||
:param name: label
|
|
||||||
:type name: str
|
|
||||||
"""
|
|
||||||
self.uid = uid
|
|
||||||
self.name = name
|
|
||||||
|
|
||||||
def to_db(self) -> str:
|
|
||||||
"""Return identifier, zero length & title.
|
|
||||||
|
|
||||||
:rtype: str
|
|
||||||
"""
|
|
||||||
return f"""\
|
|
||||||
{{\
|
|
||||||
"videoId":"{self.uid}"\
|
|
||||||
,\
|
|
||||||
"lengthSeconds":0\
|
|
||||||
,\
|
|
||||||
"title":"{self.name}"\
|
|
||||||
}}\
|
|
||||||
"""
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
"""Handle text."""
|
|
||||||
|
|
||||||
CHARSET = "UTF-8"
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
RWX_GIT_LOG_FORMAT="\
|
SH_GIT_LOG_FORMAT="\
|
||||||
%C(auto)%h%d
|
%C(auto)%h%d
|
||||||
S %C(red)%GS
|
S %C(red)%GS
|
||||||
A %C(green)%an %ae
|
A %C(green)%an %ae
|
||||||
|
|
@ -240,12 +240,11 @@ a__git_diff_word() {
|
||||||
# fetch from the remote repository
|
# fetch from the remote repository
|
||||||
gf() { a__git_fetch "${@}"; }
|
gf() { a__git_fetch "${@}"; }
|
||||||
a__git_fetch() {
|
a__git_fetch() {
|
||||||
rwx_gpg_agent_update &&
|
git \
|
||||||
git \
|
fetch \
|
||||||
fetch \
|
--tags \
|
||||||
--tags \
|
--verbose \
|
||||||
--verbose \
|
"${@}"
|
||||||
"${@}"
|
|
||||||
}
|
}
|
||||||
|
|
||||||
# fetch from remote repository and prune local orphan branches
|
# fetch from remote repository and prune local orphan branches
|
||||||
|
|
@ -294,7 +293,7 @@ a__git_log() {
|
||||||
log \
|
log \
|
||||||
--abbrev=8 \
|
--abbrev=8 \
|
||||||
--abbrev-commit \
|
--abbrev-commit \
|
||||||
--format="${RWX_GIT_LOG_FORMAT}" \
|
--format="${SH_GIT_LOG_FORMAT}" \
|
||||||
--graph \
|
--graph \
|
||||||
"${@}"
|
"${@}"
|
||||||
}
|
}
|
||||||
|
|
@ -372,12 +371,11 @@ a__git_merge_tool() {
|
||||||
# push to the remote repository
|
# push to the remote repository
|
||||||
gp() { a__git_push "${@}"; }
|
gp() { a__git_push "${@}"; }
|
||||||
a__git_push() {
|
a__git_push() {
|
||||||
rwx_gpg_agent_update &&
|
git \
|
||||||
git \
|
push \
|
||||||
push \
|
--tags \
|
||||||
--tags \
|
--verbose \
|
||||||
--verbose \
|
"${@}"
|
||||||
"${@}"
|
|
||||||
}
|
}
|
||||||
|
|
||||||
# delete from the remote repository
|
# delete from the remote repository
|
||||||
|
|
@ -535,14 +533,3 @@ a__git_tag_delete() {
|
||||||
--delete \
|
--delete \
|
||||||
"${@}"
|
"${@}"
|
||||||
}
|
}
|
||||||
|
|
||||||
# update head ref
|
|
||||||
gurh() { a__git_update_ref_head "${@}"; }
|
|
||||||
a__git_update_ref_head() {
|
|
||||||
if [ -n "${2}" ]; then
|
|
||||||
git \
|
|
||||||
update-ref \
|
|
||||||
"refs/heads/${1}" \
|
|
||||||
"${2}"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
|
||||||
|
|
@ -8,5 +8,7 @@ a__gpg_agent_kill() {
|
||||||
# bind gpg agent to current tty
|
# bind gpg agent to current tty
|
||||||
gau() { a__gpg_agent_update "${@}"; }
|
gau() { a__gpg_agent_update "${@}"; }
|
||||||
a__gpg_agent_update() {
|
a__gpg_agent_update() {
|
||||||
rwx_gpg_agent_update
|
gpg-connect-agent \
|
||||||
|
updatestartuptty \
|
||||||
|
/bye
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -17,7 +17,7 @@ x() {
|
||||||
"${@}"
|
"${@}"
|
||||||
}
|
}
|
||||||
|
|
||||||
[ "${RWX_SHELL}" = "bash" ] || return
|
[ "${SH_SHELL}" = "bash" ] || return
|
||||||
|
|
||||||
# shellcheck disable=SC3033
|
# shellcheck disable=SC3033
|
||||||
..() {
|
..() {
|
||||||
|
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
_rwx_cmd_cs() { rwx_crypt_setup "${@}"; }
|
|
||||||
|
|
||||||
rwx_crypt_setup() {
|
|
||||||
local action="${1}"
|
|
||||||
echo "cs: ${action}"
|
|
||||||
}
|
|
||||||
194
sh/ffmpeg.sh
194
sh/ffmpeg.sh
|
|
@ -1,194 +0,0 @@
|
||||||
# ╭────────┬─────────┬───────╮
|
|
||||||
# │ ffmpeg │ devices │ reset │
|
|
||||||
# ╰────────┴─────────┴───────╯
|
|
||||||
|
|
||||||
_rwx_cmd_rwx_ffmpeg_devices_reset() { rwx_ffmpeg_devices_reset "${@}"; }
|
|
||||||
rwx_ffmpeg_devices_reset() {
|
|
||||||
local module="uvcvideo"
|
|
||||||
modprobe --remove "${module}" &&
|
|
||||||
modprobe "${module}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭────────┬────────┬─────────╮
|
|
||||||
# │ ffmpeg │ device │ formats │
|
|
||||||
# ╰────────┴────────┴─────────╯
|
|
||||||
|
|
||||||
rwx_ffmpeg_device_formats() {
|
|
||||||
local device="${1}"
|
|
||||||
[ -n "${device}" ] || device="/dev/video0"
|
|
||||||
ffmpeg \
|
|
||||||
-f "v4l2" \
|
|
||||||
-list_formats "all" \
|
|
||||||
-i "${device}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭────────┬───────╮
|
|
||||||
# │ ffmpeg │ input │
|
|
||||||
# ╰────────┴───────╯
|
|
||||||
|
|
||||||
rwx_ffmpeg_input_blue_yeti() {
|
|
||||||
local device="alsa_input.\
|
|
||||||
usb-Generic_Blue_Microphones_2051BAB04XY8-00.analog-stereo"
|
|
||||||
set -- \
|
|
||||||
-f "pulse" \
|
|
||||||
-i "${device}" \
|
|
||||||
-ac "2" \
|
|
||||||
-ar "48000"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_input_dell_precision() {
|
|
||||||
local device="alsa_input.\
|
|
||||||
pci-0000_00_1f.3.analog-stereo"
|
|
||||||
set -- \
|
|
||||||
-f "pulse" \
|
|
||||||
-i "${device}" \
|
|
||||||
-ac "2" \
|
|
||||||
-ar "48000"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_input_file() {
|
|
||||||
local file="${1}"
|
|
||||||
local from="${2}"
|
|
||||||
local to="${3}"
|
|
||||||
[ -n "${file}" ] || return
|
|
||||||
set -- \
|
|
||||||
-i "${file}"
|
|
||||||
if [ -n "${to}" ]; then
|
|
||||||
set -- "${@}" \
|
|
||||||
-ss "${from}" \
|
|
||||||
-to "${to}"
|
|
||||||
fi
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_input_hdmi() {
|
|
||||||
local device="${1}"
|
|
||||||
[ -n "${device}" ] || device="/dev/video0"
|
|
||||||
set -- \
|
|
||||||
-f "v4l2" \
|
|
||||||
-video_size "1920x1080" \
|
|
||||||
-framerate "60" \
|
|
||||||
-input_format "yuyv422" \
|
|
||||||
-i "${device}"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭────────┬────────╮
|
|
||||||
# │ ffmpeg │ output │
|
|
||||||
# ╰────────┴────────╯
|
|
||||||
|
|
||||||
rwx_ffmpeg_output_audio_fast() {
|
|
||||||
set -- \
|
|
||||||
-codec:a "flac" \
|
|
||||||
-compression_level "0"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_output_audio_slow() {
|
|
||||||
set -- \
|
|
||||||
-codec:a "libopus" \
|
|
||||||
-b:a "128k"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_output_file() {
|
|
||||||
local file="${1}"
|
|
||||||
[ -n "${file}" ] || return
|
|
||||||
set -- \
|
|
||||||
-y "${file}"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_output_video_fast() {
|
|
||||||
set -- \
|
|
||||||
-codec:v "libx264" \
|
|
||||||
-preset "ultrafast" \
|
|
||||||
-crf "0"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_output_video_slow() {
|
|
||||||
local crf="${1}"
|
|
||||||
local codec="${2}"
|
|
||||||
[ -n "${codec}" ] || codec="libx264"
|
|
||||||
if [ -z "${crm}" ]; then
|
|
||||||
case "${codec}" in
|
|
||||||
"libx264") crf="23" ;;
|
|
||||||
"libx265") crf="28" ;;
|
|
||||||
*) ;;
|
|
||||||
esac
|
|
||||||
fi
|
|
||||||
set -- \
|
|
||||||
-codec:v "${codec}" \
|
|
||||||
-preset "veryslow" \
|
|
||||||
-crf "${crf}" \
|
|
||||||
-movflags "+faststart" \
|
|
||||||
-pix_fmt "yuv420p"
|
|
||||||
local argument
|
|
||||||
for argument in "${@}"; do echo "${argument}"; done
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭────────┬────────╮
|
|
||||||
# │ ffmpeg │ record │
|
|
||||||
# ╰────────┴────────╯
|
|
||||||
|
|
||||||
rwx_ffmpeg_record_hdmi_precision() {
|
|
||||||
local file="${1}"
|
|
||||||
[ -n "${file}" ] || return
|
|
||||||
# LATER alternative
|
|
||||||
# shellcheck disable=SC2046,SC2312
|
|
||||||
set -- \
|
|
||||||
$(rwx_ffmpeg_input_hdmi) \
|
|
||||||
$(rwx_ffmpeg_input_dell_precision) \
|
|
||||||
$(rwx_ffmpeg_output_video_fast) \
|
|
||||||
$(rwx_ffmpeg_output_audio_fast) \
|
|
||||||
$(rwx_ffmpeg_output_file "${file}")
|
|
||||||
echo "${@}"
|
|
||||||
ffmpeg "${@}"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ffmpeg_record_hdmi_yeti() {
|
|
||||||
local file="${1}"
|
|
||||||
[ -n "${file}" ] || return
|
|
||||||
# LATER alternative
|
|
||||||
# shellcheck disable=SC2046,SC2312
|
|
||||||
set -- \
|
|
||||||
$(rwx_ffmpeg_input_hdmi) \
|
|
||||||
$(rwx_ffmpeg_input_blue_yeti) \
|
|
||||||
$(rwx_ffmpeg_output_video_fast) \
|
|
||||||
$(rwx_ffmpeg_output_audio_fast) \
|
|
||||||
$(rwx_ffmpeg_output_file "${file}")
|
|
||||||
echo "${@}"
|
|
||||||
ffmpeg "${@}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭────────┬────────╮
|
|
||||||
# │ ffmpeg │ reduce │
|
|
||||||
# ╰────────┴────────╯
|
|
||||||
|
|
||||||
rwx_ffmpeg_reduce() {
|
|
||||||
local input="${1}"
|
|
||||||
local output="${2}"
|
|
||||||
local from="${3}"
|
|
||||||
local to="${4}"
|
|
||||||
[ -n "${output}" ] || return
|
|
||||||
# LATER alternative
|
|
||||||
# shellcheck disable=SC2046,SC2312
|
|
||||||
set -- \
|
|
||||||
$(rwx_ffmpeg_input_file "${input}" "${from}" "${to}") \
|
|
||||||
$(rwx_ffmpeg_output_video_slow) \
|
|
||||||
$(rwx_ffmpeg_output_audio_slow) \
|
|
||||||
$(rwx_ffmpeg_output_file "${output}")
|
|
||||||
echo "${@}"
|
|
||||||
ffmpeg "${@}"
|
|
||||||
}
|
|
||||||
47
sh/gnome.sh
47
sh/gnome.sh
|
|
@ -1,27 +1,3 @@
|
||||||
# ╭───────┬────────────╮
|
|
||||||
# │ gnome │ background │
|
|
||||||
# ╰───────┴────────────╯
|
|
||||||
|
|
||||||
rwx_gnome_background_black() {
|
|
||||||
rwx_gnome_set_background "color-shading-type" "solid"
|
|
||||||
rwx_gnome_set_background "primary-color" "#000000"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_gnome_background_white() {
|
|
||||||
rwx_gnome_set_background "color-shading-type" "solid"
|
|
||||||
rwx_gnome_set_background "primary-color" "#ffffff"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_gnome_background_win3() {
|
|
||||||
rwx_gnome_set_background "color-shading-type" "vertical"
|
|
||||||
rwx_gnome_set_background "primary-color" "#000000"
|
|
||||||
rwx_gnome_set_background "secondary-color" "#0000ff"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭───────┬───────╮
|
|
||||||
# │ gnome │ proxy │
|
|
||||||
# ╰───────┴───────╯
|
|
||||||
|
|
||||||
rwx_gnome_proxy() {
|
rwx_gnome_proxy() {
|
||||||
local value
|
local value
|
||||||
case "${1}" in
|
case "${1}" in
|
||||||
|
|
@ -31,29 +7,6 @@ rwx_gnome_proxy() {
|
||||||
gsettings set "org.gnome.system.proxy" "mode" "${value}"
|
gsettings set "org.gnome.system.proxy" "mode" "${value}"
|
||||||
}
|
}
|
||||||
|
|
||||||
# ╭───────┬─────╮
|
|
||||||
# │ gnome │ set │
|
|
||||||
# ╰───────┴─────╯
|
|
||||||
|
|
||||||
rwx_gnome_set() {
|
|
||||||
local group="${1}"
|
|
||||||
local key="${2}"
|
|
||||||
local value="${3}"
|
|
||||||
[ -n "${value}" ] || return
|
|
||||||
gsettings set "${group}" "${key}" "${value}"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_gnome_set_background() {
|
|
||||||
local key="${1}"
|
|
||||||
local value="${2}"
|
|
||||||
[ -n "${value}" ] || return
|
|
||||||
rwx_gnome_set "org.gnome.desktop.background" "${key}" "${value}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭───────┬────────────╮
|
|
||||||
# │ gnome │ workspaces │
|
|
||||||
# ╰───────┴────────────╯
|
|
||||||
|
|
||||||
rwx_gnome_workspaces_primary() {
|
rwx_gnome_workspaces_primary() {
|
||||||
local bool
|
local bool
|
||||||
local group="org.gnome.mutter"
|
local group="org.gnome.mutter"
|
||||||
|
|
|
||||||
|
|
@ -1,10 +1,3 @@
|
||||||
# bind gpg agent to current tty
|
|
||||||
rwx_gpg_agent_update() {
|
|
||||||
gpg-connect-agent \
|
|
||||||
updatestartuptty \
|
|
||||||
/bye
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_gpg_ssh_auth_sock() {
|
rwx_gpg_ssh_auth_sock() {
|
||||||
local user_id
|
local user_id
|
||||||
user_id=$(id --user)
|
user_id=$(id --user)
|
||||||
|
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
rwx_gitlint() {
|
|
||||||
local path="${1}"
|
|
||||||
gitlint \
|
|
||||||
--target "${path}" \
|
|
||||||
"lint"
|
|
||||||
}
|
|
||||||
|
|
@ -1,78 +0,0 @@
|
||||||
# lint code
|
|
||||||
rwx_lint() {
|
|
||||||
local path="${1}"
|
|
||||||
[ -n "${path}" ] || return 1
|
|
||||||
rwx_lint_clean "${path}"
|
|
||||||
rwx_lint_tasks "${path}"
|
|
||||||
set \
|
|
||||||
"python" \
|
|
||||||
"shell"
|
|
||||||
local code
|
|
||||||
for code in "${@}"; do
|
|
||||||
rwx_log "" "${code}"
|
|
||||||
"rwx_lint_${code}" "${path}"
|
|
||||||
done
|
|
||||||
rwx_lint_clean "${path}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# clean
|
|
||||||
rwx_lint_clean() {
|
|
||||||
local path="${1}"
|
|
||||||
[ -n "${path}" ] || return 1
|
|
||||||
rwx_log "" "clean" ""
|
|
||||||
py3clean "${path}"
|
|
||||||
set \
|
|
||||||
"mypy" \
|
|
||||||
"ruff"
|
|
||||||
local tool
|
|
||||||
for tool in "${@}"; do
|
|
||||||
rwx_remove "${path}/.${tool}_cache"
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
||||||
# lint python code
|
|
||||||
rwx_lint_python() {
|
|
||||||
local path="${1}"
|
|
||||||
local action
|
|
||||||
set \
|
|
||||||
"pylint" \
|
|
||||||
"pydoclint" \
|
|
||||||
"mypy" \
|
|
||||||
"ruff"
|
|
||||||
for action in "${@}"; do
|
|
||||||
rwx_log "" "${action}"
|
|
||||||
"rwx_${action}" "${path}"
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
||||||
# lint shell code
|
|
||||||
rwx_lint_shell() {
|
|
||||||
local path="${1}"
|
|
||||||
local action
|
|
||||||
set \
|
|
||||||
"shellcheck" \
|
|
||||||
"shfmt"
|
|
||||||
for action in "${@}"; do
|
|
||||||
rwx_log "" "${action}"
|
|
||||||
"rwx_${action}" "${path}"
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
||||||
# lint code tasks
|
|
||||||
rwx_lint_tasks() {
|
|
||||||
local path="${1}"
|
|
||||||
local type
|
|
||||||
set \
|
|
||||||
"LATER" \
|
|
||||||
"TODO" \
|
|
||||||
"FIXME"
|
|
||||||
for type in "${@}"; do
|
|
||||||
rwx_log "" "${type}"
|
|
||||||
grep \
|
|
||||||
--after "1" \
|
|
||||||
--directories "recurse" \
|
|
||||||
--line-number \
|
|
||||||
" ${type}" \
|
|
||||||
"${path}"
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
rwx_mypy() {
|
|
||||||
local path="${1}"
|
|
||||||
mypy "${path}"
|
|
||||||
}
|
|
||||||
|
|
@ -1,9 +0,0 @@
|
||||||
rwx_pydoclint() {
|
|
||||||
local path="${1}"
|
|
||||||
pydoclint \
|
|
||||||
--allow-init-docstring True \
|
|
||||||
--quiet \
|
|
||||||
--skip-checking-short-docstrings False \
|
|
||||||
--style "sphinx" \
|
|
||||||
"${path}"
|
|
||||||
}
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
rwx_pylint() {
|
|
||||||
local path="${1}"
|
|
||||||
pylint \
|
|
||||||
--enable-all-extensions \
|
|
||||||
"${path}/**/*.py"
|
|
||||||
}
|
|
||||||
|
|
@ -1,28 +0,0 @@
|
||||||
rwx_ruff() {
|
|
||||||
local path="${1}"
|
|
||||||
local action
|
|
||||||
set \
|
|
||||||
"check" \
|
|
||||||
"format"
|
|
||||||
for action in "${@}"; do
|
|
||||||
"rwx_ruff_${action}" "${path}"
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ruff_check() {
|
|
||||||
local path="${1}"
|
|
||||||
ruff check \
|
|
||||||
--ignore "D203,D213" \
|
|
||||||
--isolated \
|
|
||||||
--select "ALL" \
|
|
||||||
"${path}"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_ruff_format() {
|
|
||||||
local path="${1}"
|
|
||||||
ruff format \
|
|
||||||
--diff \
|
|
||||||
--isolated \
|
|
||||||
--line-length "80" \
|
|
||||||
"${path}"
|
|
||||||
}
|
|
||||||
|
|
@ -1,20 +1,14 @@
|
||||||
rwx_shellcheck() {
|
rwx_shellcheck_check() {
|
||||||
local root="${1}"
|
local root="${1}"
|
||||||
local file module modules path
|
local file module modules path
|
||||||
file="$(mktemp)"
|
file="$(mktemp)"
|
||||||
modules="$(rwx_find_shell "${root}")"
|
modules="$(rwx_find_sh "${root}")"
|
||||||
rwx_ifs_set
|
rwx_ifs_set
|
||||||
for module in ${modules}; do
|
for module in ${modules}; do
|
||||||
path="${root}/${module}"
|
path="${root}/${module}"
|
||||||
echo ". \"${path}\"" >>"${file}"
|
echo ". \"${path}\"" >>"${file}"
|
||||||
done
|
done
|
||||||
rwx_ifs_unset
|
rwx_ifs_unset
|
||||||
rwx_shellcheck_file "${file}"
|
|
||||||
rwx_remove "${file}"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_shellcheck_file() {
|
|
||||||
local file="${1}"
|
|
||||||
shellcheck \
|
shellcheck \
|
||||||
--check-sourced \
|
--check-sourced \
|
||||||
--enable "all" \
|
--enable "all" \
|
||||||
|
|
@ -22,13 +16,5 @@ rwx_shellcheck_file() {
|
||||||
--external-sources \
|
--external-sources \
|
||||||
--shell "dash" \
|
--shell "dash" \
|
||||||
"${file}"
|
"${file}"
|
||||||
}
|
rm "${file}"
|
||||||
|
|
||||||
rwx_shellcheck_write() {
|
|
||||||
rwx_file_write ".shellcheckrc" "\
|
|
||||||
disable=3043
|
|
||||||
enable=all
|
|
||||||
external-sources=true
|
|
||||||
shell=sh
|
|
||||||
"
|
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
rwx_shfmt() {
|
rwx_shfmt_check() {
|
||||||
local path="${1}"
|
local root="${1}"
|
||||||
shfmt --diff "${path}"
|
shfmt --diff "${root}"
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -60,9 +60,9 @@ _rwx_log() {
|
||||||
local line
|
local line
|
||||||
for line in "${@}"; do
|
for line in "${@}"; do
|
||||||
if [ -n "${prefix}" ]; then
|
if [ -n "${prefix}" ]; then
|
||||||
__rwx_log "${prefix} ${line}"
|
_rwx_main_log "${prefix} ${line}"
|
||||||
else
|
else
|
||||||
__rwx_log "${line}"
|
_rwx_main_log "${line}"
|
||||||
fi
|
fi
|
||||||
done
|
done
|
||||||
}
|
}
|
||||||
|
|
@ -1,25 +0,0 @@
|
||||||
# ╭───────────────╮
|
|
||||||
# │ __ = internal │
|
|
||||||
# ╰───────────────╯
|
|
||||||
|
|
||||||
# __RWX_BAR_TOP
|
|
||||||
# __RWX_BAR_MIDDLE
|
|
||||||
# __RWX_BAR_BOTTOM
|
|
||||||
|
|
||||||
# __RWX_STEP_LEVEL
|
|
||||||
# __RWX_STEP_level_INDEX
|
|
||||||
# __RWX_STEP_level_LABEL
|
|
||||||
|
|
||||||
# ╭─────────────╮
|
|
||||||
# │ _ = private │
|
|
||||||
# ╰─────────────╯
|
|
||||||
|
|
||||||
_RWX_BOX_DOWN_AND_HORIZONTAL="┬"
|
|
||||||
_RWX_BOX_DOWN_AND_LEFT="╮"
|
|
||||||
_RWX_BOX_DOWN_AND_RIGHT="╭"
|
|
||||||
_RWX_BOX_HORIZONTAL="─"
|
|
||||||
_RWX_BOX_LEFT="╴"
|
|
||||||
_RWX_BOX_UP_AND_HORIZONTAL="┴"
|
|
||||||
_RWX_BOX_UP_AND_LEFT="╯"
|
|
||||||
_RWX_BOX_UP_AND_RIGHT="╰"
|
|
||||||
_RWX_BOX_VERTICAL="│"
|
|
||||||
146
sh/main.sh
Executable file → Normal file
146
sh/main.sh
Executable file → Normal file
|
|
@ -1,49 +1,43 @@
|
||||||
#! /usr/bin/env sh
|
# ╭───────────╮
|
||||||
|
# │ constants │
|
||||||
|
# ╰───────────╯
|
||||||
|
|
||||||
# ╭──────┬───────────╮
|
RWX_MAIN_FILE_NAME="main.sh"
|
||||||
# │ main │ constants │
|
RWX_NAME="sh"
|
||||||
# ╰──────┴───────────╯
|
|
||||||
|
|
||||||
RWX_MAIN_NAME="main.sh"
|
RWX_ROOT_SYSTEM="/etc/${RWX_NAME}"
|
||||||
RWX_SELF_NAME="rwx"
|
|
||||||
|
|
||||||
RWX_SELF_COMMAND="_${RWX_SELF_NAME}_cmd_"
|
RWX_MAIN="${RWX_ROOT_SYSTEM}/${RWX_MAIN_FILE_NAME}"
|
||||||
|
|
||||||
# ╭──────┬───────────╮
|
# ╭───────────╮
|
||||||
# │ main │ variables │
|
# │ variables │
|
||||||
# ╰──────┴───────────╯
|
# ╰───────────╯
|
||||||
|
|
||||||
RWX_COMMAND_ARGUMENT="${0}"
|
|
||||||
RWX_SHELL="$(cat "/proc/${$}/comm")"
|
RWX_SHELL="$(cat "/proc/${$}/comm")"
|
||||||
|
RWX_ROOT_USER="${HOME}/${RWX_NAME}"
|
||||||
|
|
||||||
RWX_COMMAND_NAME="$(basename "${RWX_COMMAND_ARGUMENT}" |
|
# ╭──────────╮
|
||||||
sed "s|^-||")"
|
# │ internal │
|
||||||
case "${RWX_COMMAND_NAME}" in
|
# ╰──────────╯
|
||||||
"bash" | "dash" | "sh") unset RWX_COMMAND_NAME ;;
|
|
||||||
*) ;;
|
|
||||||
esac
|
|
||||||
RWX_ROOT_SYSTEM="/usr/local/lib/${RWX_SELF_NAME}"
|
|
||||||
RWX_SELF_USER="${HOME}/${RWX_SELF_NAME}"
|
|
||||||
|
|
||||||
RWX_MAIN_PATH="${RWX_ROOT_SYSTEM}/${RWX_MAIN_NAME}"
|
# _RWX_IFS
|
||||||
|
|
||||||
# ╭──────┬───────╮
|
# ╭─────────╮
|
||||||
# │ main │ shell │
|
# │ private │
|
||||||
# ╰──────┴───────╯
|
# ╰─────────╯
|
||||||
|
|
||||||
# test if active shell is in interactive mode
|
rwx_ifs_set() {
|
||||||
rwx_shell_interactive() {
|
_RWX_IFS="${IFS}"
|
||||||
case "${-}" in
|
IFS="
|
||||||
*i*) ;;
|
"
|
||||||
*) return 1 ;;
|
|
||||||
esac
|
|
||||||
}
|
}
|
||||||
|
|
||||||
# ╭──────┬─────╮
|
rwx_ifs_unset() {
|
||||||
# │ main │ log │
|
IFS="${_RWX_IFS}"
|
||||||
# ╰──────┴─────╯
|
unset RWX_IFS
|
||||||
|
}
|
||||||
|
|
||||||
__rwx_log() {
|
_rwx_main_log() {
|
||||||
if rwx_shell_interactive; then
|
if rwx_shell_interactive; then
|
||||||
[ ${#} -gt 0 ] || set -- ""
|
[ ${#} -gt 0 ] || set -- ""
|
||||||
local line
|
local line
|
||||||
|
|
@ -53,9 +47,9 @@ __rwx_log() {
|
||||||
fi
|
fi
|
||||||
}
|
}
|
||||||
|
|
||||||
# ╭──────┬──────╮
|
# ╭────────╮
|
||||||
# │ main │ find │
|
# │ public │
|
||||||
# ╰──────┴──────╯
|
# ╰────────╯
|
||||||
|
|
||||||
# find directory’s files by extension
|
# find directory’s files by extension
|
||||||
rwx_find_extension() {
|
rwx_find_extension() {
|
||||||
|
|
@ -76,44 +70,55 @@ rwx_find_extension() {
|
||||||
}
|
}
|
||||||
|
|
||||||
# find directory’s sh files
|
# find directory’s sh files
|
||||||
rwx_find_shell() {
|
rwx_find_sh() {
|
||||||
rwx_find_extension "sh" "${@}"
|
rwx_find_extension "sh" "${@}"
|
||||||
}
|
}
|
||||||
|
|
||||||
# ╭──────┬─────╮
|
# get functions from file
|
||||||
# │ main │ ifs │
|
rwx_grep_functions() {
|
||||||
# ╰──────┴─────╯
|
local file="${1}"
|
||||||
|
grep "()" "${file}" |
|
||||||
rwx_ifs_set() {
|
cut --delimiter "(" --fields 1
|
||||||
_RWX_IFS="${IFS}"
|
|
||||||
IFS="
|
|
||||||
"
|
|
||||||
}
|
}
|
||||||
|
|
||||||
rwx_ifs_unset() {
|
# output help message
|
||||||
IFS="${_RWX_IFS}"
|
rwx_help() {
|
||||||
unset RWX_IFS
|
rwx_log \
|
||||||
|
"rwx_… = functions" \
|
||||||
|
" a__… = aliases" \
|
||||||
|
" u__… = user"
|
||||||
}
|
}
|
||||||
|
|
||||||
# ╭──────┬────────╮
|
# test if active shell is in interactive mode
|
||||||
# │ main │ source │
|
rwx_shell_interactive() {
|
||||||
# ╰──────┴────────╯
|
case "${-}" in
|
||||||
|
*i*) ;;
|
||||||
|
*) return 1 ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
rwx_source() {
|
rwx_main_source() {
|
||||||
local path="${1}"
|
local path="${1}"
|
||||||
[ -d "${path}" ] ||
|
[ -d "${path}" ] ||
|
||||||
return 1
|
return 1
|
||||||
local count module
|
local cmd count module modules
|
||||||
count=0
|
modules="$(rwx_find_sh "${path}" "${RWX_MAIN_FILE_NAME}")"
|
||||||
__rwx_log "" \
|
|
||||||
". ${path}"
|
|
||||||
rwx_ifs_set
|
rwx_ifs_set
|
||||||
for module in $(rwx_find_shell "${path}" "${RWX_MAIN_NAME}"); do
|
count=0
|
||||||
|
_rwx_main_log "" \
|
||||||
|
". ${path}"
|
||||||
|
for module in ${modules}; do
|
||||||
count=$((count + 1))
|
count=$((count + 1))
|
||||||
__rwx_log "$(printf "%02d" "${count}") ${module%.sh}"
|
_rwx_main_log "$(printf "%02d" "${count}") ${module%.sh}"
|
||||||
module="${path}/${module}"
|
module="${path}/${module}"
|
||||||
# shellcheck disable=SC1090
|
# shellcheck disable=SC1090
|
||||||
. "${module}"
|
. "${module}"
|
||||||
|
cmd="$(rwx_grep_functions "${module}")"
|
||||||
|
if [ -n "${cmd}" ]; then
|
||||||
|
[ -n "${CMD}" ] && CMD="${CMD}
|
||||||
|
"
|
||||||
|
CMD="${CMD}${cmd}"
|
||||||
|
fi
|
||||||
done
|
done
|
||||||
rwx_ifs_unset
|
rwx_ifs_unset
|
||||||
}
|
}
|
||||||
|
|
@ -125,20 +130,25 @@ rwx_source() {
|
||||||
# run initial steps
|
# run initial steps
|
||||||
rwx_main() {
|
rwx_main() {
|
||||||
# system root
|
# system root
|
||||||
if ! rwx_source "${RWX_ROOT_SYSTEM}"; then
|
if ! rwx_main_source "${RWX_ROOT_SYSTEM}"; then
|
||||||
__rwx_log "Not a directory: ${RWX_ROOT_SYSTEM}"
|
_rwx_main_log "Not a directory: ${RWX_ROOT_SYSTEM}"
|
||||||
return 1
|
return 1
|
||||||
fi
|
fi
|
||||||
# user root
|
# user root
|
||||||
rwx_source "${RWX_SELF_USER}"
|
rwx_main_source "${RWX_ROOT_USER}"
|
||||||
# context / command
|
# run interactive extras
|
||||||
if [ -n "${RWX_COMMAND_NAME}" ]; then
|
if rwx_shell_interactive; then
|
||||||
"${RWX_SELF_COMMAND}${RWX_COMMAND_NAME}" "${@}"
|
# check format
|
||||||
# context / shell
|
rwx_log
|
||||||
else
|
rwx_shfmt_check "${RWX_ROOT_SYSTEM}"
|
||||||
rwx_self_init
|
# check syntax
|
||||||
|
rwx_log
|
||||||
|
rwx_shellcheck_check "${RWX_ROOT_SYSTEM}"
|
||||||
|
# help
|
||||||
|
rwx_log
|
||||||
|
rwx_help
|
||||||
fi
|
fi
|
||||||
}
|
}
|
||||||
|
|
||||||
# run main function
|
# run main function
|
||||||
rwx_main "${@}"
|
rwx_main
|
||||||
|
|
|
||||||
14
sh/python.sh
14
sh/python.sh
|
|
@ -1,14 +0,0 @@
|
||||||
# ╭────────╮
|
|
||||||
# │ python │
|
|
||||||
# ╰────────╯
|
|
||||||
|
|
||||||
# ╭────────┬──────╮
|
|
||||||
# │ python │ venv │
|
|
||||||
# ╰────────┴──────╯
|
|
||||||
|
|
||||||
rwx_python_venv() {
|
|
||||||
local path="${1}"
|
|
||||||
[ -d "${path}" ] || return 1
|
|
||||||
export VIRTUAL_ENV="${path}" && \
|
|
||||||
export PATH="${VIRTUAL_ENV}/bin:${PATH}"
|
|
||||||
}
|
|
||||||
|
|
@ -63,8 +63,6 @@ rwx_rescue_wipe_0_init_hetzner_8_8() {
|
||||||
for device in "${@}"; do
|
for device in "${@}"; do
|
||||||
members="${members} ${device}2"
|
members="${members} ${device}2"
|
||||||
done
|
done
|
||||||
# LATER alternative
|
|
||||||
# shellcheck disable=SC2086
|
|
||||||
rwx_fs_raid_create \
|
rwx_fs_raid_create \
|
||||||
"boot" "00000000:00000000:00000000:00000002" ${members}
|
"boot" "00000000:00000000:00000000:00000002" ${members}
|
||||||
#
|
#
|
||||||
|
|
@ -89,8 +87,6 @@ rwx_rescue_wipe_0_init_hetzner_8_8() {
|
||||||
for device in "${@}"; do
|
for device in "${@}"; do
|
||||||
members="${members} ${device}1"
|
members="${members} ${device}1"
|
||||||
done
|
done
|
||||||
# LATER alternative
|
|
||||||
# shellcheck disable=SC2086
|
|
||||||
rwx_fs_raid_create \
|
rwx_fs_raid_create \
|
||||||
"crypt" "00000000:00000000:00000000:00000001" ${members}
|
"crypt" "00000000:00000000:00000000:00000001" ${members}
|
||||||
# encrypt
|
# encrypt
|
||||||
|
|
|
||||||
162
sh/self.sh
162
sh/self.sh
|
|
@ -1,162 +0,0 @@
|
||||||
# meta doc
|
|
||||||
rwx_doc() {
|
|
||||||
local name="${1}"
|
|
||||||
[ -n "${name}" ] || return
|
|
||||||
local doc line module
|
|
||||||
rwx_ifs_set
|
|
||||||
for module in $(rwx_find_shell "${RWX_ROOT_SYSTEM}"); do
|
|
||||||
while read -r line; do
|
|
||||||
case "${line}" in
|
|
||||||
"#"*) doc="${doc}${line}" ;;
|
|
||||||
"${name}() {")
|
|
||||||
echo "${doc}"
|
|
||||||
return
|
|
||||||
;;
|
|
||||||
*) doc="" ;;
|
|
||||||
esac
|
|
||||||
done <"${RWX_ROOT_SYSTEM}/${module}"
|
|
||||||
done
|
|
||||||
rwx_ifs_unset
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬───────╮
|
|
||||||
# │ self │ check │
|
|
||||||
# ╰──────┴───────╯
|
|
||||||
|
|
||||||
# check source code
|
|
||||||
rwx_self_check() {
|
|
||||||
# check format
|
|
||||||
rwx_log
|
|
||||||
rwx_shfmt "${RWX_ROOT_SYSTEM}"
|
|
||||||
# check syntax
|
|
||||||
rwx_log
|
|
||||||
rwx_shellcheck "${RWX_ROOT_SYSTEM}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬──────────╮
|
|
||||||
# │ self │ commands │
|
|
||||||
# ╰──────┴──────────╯
|
|
||||||
|
|
||||||
# get commands from root
|
|
||||||
rwx_self_commands() {
|
|
||||||
grep \
|
|
||||||
--directories "recurse" \
|
|
||||||
--no-filename \
|
|
||||||
"^${RWX_SELF_COMMAND}" "${RWX_ROOT_SYSTEM}" |
|
|
||||||
cut --delimiter "(" --fields 1 |
|
|
||||||
sed "s|^${RWX_SELF_COMMAND}||"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬───────────╮
|
|
||||||
# │ self │ functions │
|
|
||||||
# ╰──────┴───────────╯
|
|
||||||
|
|
||||||
# get functions from root
|
|
||||||
rwx_self_functions() {
|
|
||||||
grep \
|
|
||||||
--directories "recurse" \
|
|
||||||
--no-filename \
|
|
||||||
"()" "${RWX_ROOT_SYSTEM}" |
|
|
||||||
cut --delimiter "(" --fields 1
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬──────╮
|
|
||||||
# │ self │ help │
|
|
||||||
# ╰──────┴──────╯
|
|
||||||
|
|
||||||
# output help message
|
|
||||||
rwx_self_help() {
|
|
||||||
rwx_log \
|
|
||||||
"rwx_… = functions" \
|
|
||||||
" a__… = aliases" \
|
|
||||||
" u__… = user"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬──────╮
|
|
||||||
# │ self │ init │
|
|
||||||
# ╰──────┴──────╯
|
|
||||||
|
|
||||||
rwx_self_init() {
|
|
||||||
# run interactive extras
|
|
||||||
if rwx_shell_interactive; then
|
|
||||||
# help
|
|
||||||
rwx_log
|
|
||||||
rwx_self_help
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬─────────╮
|
|
||||||
# │ self │ install │
|
|
||||||
# ╰──────┴─────────╯
|
|
||||||
|
|
||||||
_rwx_cmd_rwx_install() { rwx_self_install "${@}"; }
|
|
||||||
rwx_self_install() {
|
|
||||||
local target="${1}"
|
|
||||||
local command file root
|
|
||||||
# code
|
|
||||||
if [ -n "${target}" ]; then
|
|
||||||
root="${target}${RWX_ROOT_SYSTEM}"
|
|
||||||
rwx_remove "${root}"
|
|
||||||
cp --recursive "${RWX_ROOT_SYSTEM}" "${root}"
|
|
||||||
fi
|
|
||||||
# commands
|
|
||||||
root="${target}/usr/local/bin"
|
|
||||||
for command in $(rwx_self_commands); do
|
|
||||||
file="${root}/${command}"
|
|
||||||
rwx_remove "${file}"
|
|
||||||
rwx_link "${file}" "${RWX_MAIN_PATH}"
|
|
||||||
done
|
|
||||||
# sh
|
|
||||||
file="${target}/etc/profile.d/${RWX_SELF_NAME}.sh"
|
|
||||||
rwx_remove "${file}"
|
|
||||||
rwx_file_write "${file}" "\
|
|
||||||
export ENV=\"${RWX_MAIN_PATH}\"
|
|
||||||
"
|
|
||||||
# bash
|
|
||||||
file="${target}/etc/bash.bashrc"
|
|
||||||
rwx_remove "${file}"
|
|
||||||
rwx_link "${file}" "${RWX_MAIN_PATH}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬────────╮
|
|
||||||
# │ self │ subset │
|
|
||||||
# ╰──────┴────────╯
|
|
||||||
|
|
||||||
rwx_self_subset() {
|
|
||||||
local argument path
|
|
||||||
for argument in "${@}"; do
|
|
||||||
path="${RWX_ROOT_SYSTEM}/${argument}"
|
|
||||||
if [ -d "${path}" ]; then
|
|
||||||
local file
|
|
||||||
for file in $(rwx_find_shell "${path}"); do
|
|
||||||
echo "${argument}/${file}"
|
|
||||||
done
|
|
||||||
elif [ -f "${path}" ]; then
|
|
||||||
echo "${argument}"
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
||||||
# ╭──────┬───────╮
|
|
||||||
# │ self │ write │
|
|
||||||
# ╰──────┴───────╯
|
|
||||||
|
|
||||||
rwx_self_write() {
|
|
||||||
local target="${1}"
|
|
||||||
if [ -n "${target}" ]; then
|
|
||||||
shift
|
|
||||||
local file text
|
|
||||||
text="#! /usr/bin/env sh
|
|
||||||
"
|
|
||||||
rwx_ifs_set
|
|
||||||
for file in $(rwx_self_subset "${@}"); do
|
|
||||||
text="${text}
|
|
||||||
$(cat "${RWX_ROOT_SYSTEM}/${file}")
|
|
||||||
"
|
|
||||||
done
|
|
||||||
rwx_ifs_unset
|
|
||||||
rwx_file_write "${target}" "${text}"
|
|
||||||
rwx_shfmt "${target}"
|
|
||||||
rwx_shellcheck_file "${target}"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
19
sh/shell.sh
19
sh/shell.sh
|
|
@ -1,6 +1,6 @@
|
||||||
_rwx_shell_color() {
|
_rwx_shell_color() {
|
||||||
local code="${1}"
|
local code="${1}"
|
||||||
case "${RWX_SHELL}" in
|
case "${SH_SHELL}" in
|
||||||
"bash")
|
"bash")
|
||||||
printf "\x01\e[0"
|
printf "\x01\e[0"
|
||||||
if [ -n "${code}" ]; then
|
if [ -n "${code}" ]; then
|
||||||
|
|
@ -27,13 +27,13 @@ RWX_COLOR_MAGENTA="$(_rwx_shell_color 35)"
|
||||||
RWX_COLOR_RED="$(_rwx_shell_color 32)"
|
RWX_COLOR_RED="$(_rwx_shell_color 32)"
|
||||||
|
|
||||||
rwx_shell_configure() {
|
rwx_shell_configure() {
|
||||||
[ -n "${ENV}" ] || ENV="${RWX_MAIN_PATH}"
|
[ -n "${ENV}" ] || ENV="${SH_MAIN}"
|
||||||
export ENV
|
export ENV
|
||||||
# prompt
|
# prompt
|
||||||
PS1="\$(rwx_shell_prompt \${?})"
|
PS1="\$(rwx_shell_prompt \${?})"
|
||||||
PS2="├ "
|
PS2="├ "
|
||||||
# specific
|
# specific
|
||||||
case "${RWX_SHELL}" in
|
case "${SH_SHELL}" in
|
||||||
"bash")
|
"bash")
|
||||||
# completion
|
# completion
|
||||||
local root="/usr/share/bash-completion"
|
local root="/usr/share/bash-completion"
|
||||||
|
|
@ -71,7 +71,7 @@ rwx_shell_prompt() {
|
||||||
id="$(id --user)"
|
id="$(id --user)"
|
||||||
local path="${PWD}"
|
local path="${PWD}"
|
||||||
local user="${USER}"
|
local user="${USER}"
|
||||||
local view="╰ "
|
local view="└ "
|
||||||
# code
|
# code
|
||||||
if [ "${code}" -ne 0 ]; then
|
if [ "${code}" -ne 0 ]; then
|
||||||
view="${view}${RWX_COLOR_GREEN}"
|
view="${view}${RWX_COLOR_GREEN}"
|
||||||
|
|
@ -96,7 +96,7 @@ rwx_shell_prompt() {
|
||||||
# new
|
# new
|
||||||
view="${view}\\n"
|
view="${view}\\n"
|
||||||
# frame
|
# frame
|
||||||
view="${view}${RWX_COLOR_DEFAULT}╭ "
|
view="${view}${RWX_COLOR_DEFAULT}┌ "
|
||||||
# user
|
# user
|
||||||
if [ "${id}" -eq 0 ]; then
|
if [ "${id}" -eq 0 ]; then
|
||||||
view="${view}${RWX_COLOR_GREEN}"
|
view="${view}${RWX_COLOR_GREEN}"
|
||||||
|
|
@ -114,3 +114,12 @@ rwx_shell_prompt() {
|
||||||
# print
|
# print
|
||||||
printf "%b" "${view}"
|
printf "%b" "${view}"
|
||||||
}
|
}
|
||||||
|
|
||||||
|
rwx_shell_setup() {
|
||||||
|
# shell
|
||||||
|
echo "export ENV=\"${ENV}\"" >"/etc/profile.d/${SH_NAME}.sh"
|
||||||
|
# bash
|
||||||
|
local file="/etc/bash.bashrc"
|
||||||
|
rm --force --recursive "${file}"
|
||||||
|
ln --symbolic "${ENV}" "${file}"
|
||||||
|
}
|
||||||
|
|
|
||||||
264
sh/tmux.sh
264
sh/tmux.sh
|
|
@ -1,264 +0,0 @@
|
||||||
# ╭──────┬───────╮
|
|
||||||
# │ tmux │ setup │
|
|
||||||
# ╰──────┴───────╯
|
|
||||||
|
|
||||||
rwx_tmux_setup() {
|
|
||||||
local file
|
|
||||||
file="${HOME}/.tmux.conf"
|
|
||||||
rwx_file_write "${file}" "\
|
|
||||||
# ╭────────╮
|
|
||||||
# │ option │
|
|
||||||
# ╰────────╯
|
|
||||||
|
|
||||||
# empty name for windows
|
|
||||||
set-option -g automatic-rename-format '#{pane_current_command}'
|
|
||||||
set-option -g automatic-rename on
|
|
||||||
|
|
||||||
# first index number
|
|
||||||
set-option -g base-index 1
|
|
||||||
|
|
||||||
# display duration
|
|
||||||
set-option -g display-time 1536
|
|
||||||
|
|
||||||
# extend history limit
|
|
||||||
set-option -g history-limit 1048576
|
|
||||||
|
|
||||||
# style for messages
|
|
||||||
set-option -g message-style bg=red,fg=white
|
|
||||||
|
|
||||||
# activity monitoring
|
|
||||||
set-window-option -g monitor-activity on
|
|
||||||
|
|
||||||
# silence monitoring
|
|
||||||
set-window-option -g monitor-silence 0
|
|
||||||
|
|
||||||
# enable mouse actions
|
|
||||||
set-option -g mouse on
|
|
||||||
|
|
||||||
# prefix with ^B or F12
|
|
||||||
set-option -g prefix C-b
|
|
||||||
set-option -g prefix2 F12
|
|
||||||
|
|
||||||
# renumber windows after closing one
|
|
||||||
set-option -g renumber-windows on
|
|
||||||
|
|
||||||
# enable title
|
|
||||||
set-option -g set-titles on
|
|
||||||
|
|
||||||
# set title to working directory
|
|
||||||
set-option -g set-titles-string '\
|
|
||||||
#{session_name}\
|
|
||||||
- \
|
|
||||||
#{window_index}∕#{session_windows} #{window_name}\
|
|
||||||
- \
|
|
||||||
#{pane_index}∕#{window_panes} #{pane_current_command}\
|
|
||||||
'
|
|
||||||
|
|
||||||
# ╭────────┬──────╮
|
|
||||||
# │ option │ pane │
|
|
||||||
# ╰────────┴──────╯
|
|
||||||
|
|
||||||
# first index number
|
|
||||||
set-option -g pane-base-index 1
|
|
||||||
|
|
||||||
# ╭────────┬──────┬────────╮
|
|
||||||
# │ option │ pane │ border │
|
|
||||||
# ╰────────┴──────┴────────╯
|
|
||||||
|
|
||||||
# active style
|
|
||||||
set-option -g pane-active-border-style fg=green
|
|
||||||
|
|
||||||
# regular style
|
|
||||||
set-option -g pane-border-style fg=blue
|
|
||||||
|
|
||||||
# ╭────────┬────────╮
|
|
||||||
# │ option │ status │
|
|
||||||
# ╰────────┴────────╯
|
|
||||||
|
|
||||||
# status lines
|
|
||||||
set-option -g status 3
|
|
||||||
|
|
||||||
# background color
|
|
||||||
set-option -g status-bg '#0D0D0D'
|
|
||||||
|
|
||||||
# foreground color
|
|
||||||
set-option -g status-fg white
|
|
||||||
|
|
||||||
# line 1
|
|
||||||
set-option -g status-format[0] '\
|
|
||||||
#{W:\
|
|
||||||
#[bg=##202020] #[bg=##303030]\
|
|
||||||
#{?window_zoomed_flag,#[fg=magenta][, }\
|
|
||||||
#[fg=yellow]#{window_index}\
|
|
||||||
#{?window_zoomed_flag,#[fg=magenta]], }\
|
|
||||||
\
|
|
||||||
#{?window_active,#[fg=green],\
|
|
||||||
#{?window_activity_flag,#[fg=red],#[fg=blue]}}\
|
|
||||||
#{window_name}\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
#[bg=default] \
|
|
||||||
}\
|
|
||||||
#[align=right]\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#[fg=yellow]%H:%M:%S\
|
|
||||||
#[bg=##303030] #[bg=##202020]\
|
|
||||||
#{?client_prefix,#[fg=green]p, }\
|
|
||||||
'
|
|
||||||
|
|
||||||
# line 2
|
|
||||||
set-option -g status-format[1] '\
|
|
||||||
#{S:\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#{?session_many_attached,#[fg=red],\
|
|
||||||
#{?session_attached,#[fg=magenta],#[fg=blue]}}\
|
|
||||||
#{session_name}\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
#[bg=default] \
|
|
||||||
}\
|
|
||||||
#[fg=yellow]→ #[fg=green]#{session_name} \
|
|
||||||
#[align=right]\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#[fg=yellow]%Y-%m-%d\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
'
|
|
||||||
|
|
||||||
# line 3
|
|
||||||
set-option -g status-format[2] '\
|
|
||||||
#[fg=cyan]#{pane_current_path}\
|
|
||||||
#[align=right]\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#[fg=yellow]#{host}\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
'
|
|
||||||
|
|
||||||
# line 4
|
|
||||||
set-option -g status-format[3] '\
|
|
||||||
#{P:\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#[fg=yellow]#{pane_index}\
|
|
||||||
\
|
|
||||||
#{?pane_active,#[fg=green],#[fg=blue]}\
|
|
||||||
#{pane_current_command}\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
#[bg=default] \
|
|
||||||
}\
|
|
||||||
#[align=right]\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#{?uid,#[fg=green],#[fg=red]}\
|
|
||||||
#{user}\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
'
|
|
||||||
|
|
||||||
# line 5
|
|
||||||
set-option -g status-format[4] '\
|
|
||||||
#{P:\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#[fg=yellow]#{pane_index}\
|
|
||||||
\
|
|
||||||
#{?pane_active,#[fg=green],#[fg=blue]}\
|
|
||||||
#{pane_width}×#{pane_height}\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
#[bg=default] \
|
|
||||||
}\
|
|
||||||
#[align=right]\
|
|
||||||
#[bg=##202020] #[bg=##303030] \
|
|
||||||
#[fg=green]#{window_width}×#{window_height}\
|
|
||||||
#[bg=##303030] #[bg=##202020] \
|
|
||||||
'
|
|
||||||
|
|
||||||
# refresh period
|
|
||||||
set-option -g status-interval 1
|
|
||||||
|
|
||||||
# bar location
|
|
||||||
set-option -g status-position bottom
|
|
||||||
|
|
||||||
# ╭─────╮
|
|
||||||
# │ key │
|
|
||||||
# ╰─────╯
|
|
||||||
|
|
||||||
# detach client
|
|
||||||
bind-key -n F6 detach-client
|
|
||||||
|
|
||||||
# new window
|
|
||||||
bind-key -n F2 new-window
|
|
||||||
|
|
||||||
# select pane
|
|
||||||
bind-key -n C-S-Down select-pane -D
|
|
||||||
bind-key -n C-S-Left select-pane -L
|
|
||||||
bind-key -n C-S-Right select-pane -R
|
|
||||||
bind-key -n C-S-Up select-pane -U
|
|
||||||
|
|
||||||
# status lines
|
|
||||||
bind-key -n C-F10 set-option -g status off
|
|
||||||
bind-key -n C-F1 set-option -g status on
|
|
||||||
bind-key -n C-F2 set-option -g status 2
|
|
||||||
bind-key -n C-F3 set-option -g status 3
|
|
||||||
bind-key -n C-F4 set-option -g status 4
|
|
||||||
bind-key -n C-F5 set-option -g status 5
|
|
||||||
|
|
||||||
# switch session
|
|
||||||
bind-key -n M-Down switch-client -n
|
|
||||||
bind-key -n M-Up switch-client -p
|
|
||||||
|
|
||||||
# switch window
|
|
||||||
bind-key -n M-Left previous-window
|
|
||||||
bind-key -n M-Right next-window
|
|
||||||
|
|
||||||
# ╭─────┬────────╮
|
|
||||||
# │ key │ prefix │
|
|
||||||
# ╰─────┴────────╯
|
|
||||||
|
|
||||||
# rename
|
|
||||||
bind-key C-s command-prompt { rename-session '%%' }
|
|
||||||
bind-key C-w command-prompt { rename-window '%%' }
|
|
||||||
|
|
||||||
# split window
|
|
||||||
bind-key h split-window -h
|
|
||||||
bind-key v split-window -v
|
|
||||||
|
|
||||||
# toggle mouse
|
|
||||||
bind-key t set-option -g mouse \\; display-message 'mouse = #{mouse}'
|
|
||||||
|
|
||||||
# reload configuration
|
|
||||||
bind-key r source-file ${file} \\; display-message 'source-file ${file}'
|
|
||||||
|
|
||||||
# swap window
|
|
||||||
bind-key M-Left swap-window -t -1
|
|
||||||
bind-key M-Right swap-window -t +1
|
|
||||||
|
|
||||||
# ╭─────────────╮
|
|
||||||
# │ default │
|
|
||||||
# ╭───────────┬─────────┼─────┬───────┤
|
|
||||||
# │ -n │ F12 │ -n │ C-b │
|
|
||||||
# ╭───────────────────┼───────────┼─────────┼─────┼───────┤
|
|
||||||
# │ command-prompt │ │ │ │ : │
|
|
||||||
# │ copy-mode │ │ │ │ PPage │
|
|
||||||
# │ detach-client │ │ │ │ d │
|
|
||||||
# │ new-session │ │ │ │ │
|
|
||||||
# │ new-window │ F2 │ │ │ c │
|
|
||||||
# │ next-window │ M-Right │ │ │ n │
|
|
||||||
# │ previous-window │ M-Left │ │ │ p │
|
|
||||||
# │ rename-session │ │ C-s │ │ │
|
|
||||||
# │ rename-window │ │ C-w │ │ │
|
|
||||||
# │ resize-pane -Z │ │ │ │ z │
|
|
||||||
# │ select-pane -D │ C-S-Down │ │ │ │
|
|
||||||
# │ select-pane -L │ C-S-Left │ │ │ │
|
|
||||||
# │ select-pane -R │ C-S-Right │ │ │ │
|
|
||||||
# │ select-pane -U │ C-S-Up │ │ │ │
|
|
||||||
# │ set -g mouse │ │ t │ │ │
|
|
||||||
# │ set -g status off │ C-F10 │ │ │ │
|
|
||||||
# │ set -g status on │ C-F1 │ │ │ │
|
|
||||||
# │ set -g status 2 │ C-F2 │ │ │ │
|
|
||||||
# │ set -g status 3 │ C-F3 │ │ │ │
|
|
||||||
# │ set -g status 4 │ C-F4 │ │ │ │
|
|
||||||
# │ set -g status 5 │ C-F5 │ │ │ │
|
|
||||||
# │ source-file │ │ r │ │ │
|
|
||||||
# │ split-window -h │ │ h │ │ % │
|
|
||||||
# │ split-window -v │ │ v │ │ \" │
|
|
||||||
# │ swap-window -t -1 │ │ M-Left │ │ │
|
|
||||||
# │ swap-window -t +1 │ │ M-Right │ │ │
|
|
||||||
# │ switch-client -n │ M-Down │ │ │ │
|
|
||||||
# │ switch-client -p │ M-Up │ │ │ │
|
|
||||||
# ╰───────────────────┴───────────┴─────────┴─────┴───────╯
|
|
||||||
"
|
|
||||||
}
|
|
||||||
39
sh/util.sh
39
sh/util.sh
|
|
@ -1,35 +1,3 @@
|
||||||
rwx_file_append() {
|
|
||||||
local file="${1}"
|
|
||||||
local text="${2}"
|
|
||||||
if [ -n "${file}" ]; then
|
|
||||||
printf "%s" "${text}" >>"${file}"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_file_empty() {
|
|
||||||
local file="${1}"
|
|
||||||
if [ -n "${file}" ]; then
|
|
||||||
rwx_file_write "${file}" ""
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_file_write() {
|
|
||||||
local file="${1}"
|
|
||||||
local text="${2}"
|
|
||||||
if [ -n "${file}" ]; then
|
|
||||||
printf "%s" "${text}" >"${file}"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_link() {
|
|
||||||
local link="${1}"
|
|
||||||
local target="${2}"
|
|
||||||
ln \
|
|
||||||
--symbolic \
|
|
||||||
"${target}" \
|
|
||||||
"${link}"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_list_block_devices() {
|
rwx_list_block_devices() {
|
||||||
lsblk \
|
lsblk \
|
||||||
--noempty \
|
--noempty \
|
||||||
|
|
@ -60,13 +28,6 @@ rwx_read_secret() {
|
||||||
unset secret
|
unset secret
|
||||||
}
|
}
|
||||||
|
|
||||||
rwx_remove() {
|
|
||||||
rm \
|
|
||||||
--force \
|
|
||||||
--recursive \
|
|
||||||
"${@}"
|
|
||||||
}
|
|
||||||
|
|
||||||
rwx_warn_wipe() {
|
rwx_warn_wipe() {
|
||||||
local tmp
|
local tmp
|
||||||
rwx_list_block_devices
|
rwx_list_block_devices
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue