Advance Wayland and KDE package bring-up
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
@@ -0,0 +1,28 @@
|
||||
cmake_minimum_required(VERSION 3.16)
|
||||
|
||||
project(%{APPNAMELC})
|
||||
|
||||
set(QT_MIN_VERSION "6.5.0")
|
||||
set(KF6_MIN_VERSION "6.0.0")
|
||||
|
||||
find_package(ECM ${KF6_MIN_VERSION} REQUIRED NO_MODULE)
|
||||
set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH})
|
||||
|
||||
include(KDEInstallDirs)
|
||||
include(KDECMakeSettings)
|
||||
include(KDECompilerSettings NO_POLICY_SCOPE)
|
||||
|
||||
include(ECMQtDeclareLoggingCategory)
|
||||
include(FeatureSummary)
|
||||
|
||||
find_package(Qt6 ${QT_MIN_VERSION} CONFIG REQUIRED Core)
|
||||
find_package(KF6 ${KF6_MIN_VERSION} REQUIRED COMPONENTS
|
||||
KIO
|
||||
I18n
|
||||
)
|
||||
|
||||
add_subdirectory(src)
|
||||
|
||||
ki18n_install(po)
|
||||
|
||||
feature_summary(WHAT ALL INCLUDE_QUIET_PACKAGES FATAL_ON_MISSING_REQUIRED_PACKAGES)
|
||||
@@ -0,0 +1,468 @@
|
||||
GNU LESSER GENERAL PUBLIC LICENSE
|
||||
|
||||
Version 2.1, February 1999
|
||||
|
||||
Copyright (C) 1991, 1999 Free Software Foundation, Inc.
|
||||
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
|
||||
Everyone is permitted to copy and distribute verbatim copies of this license
|
||||
document, but changing it is not allowed.
|
||||
|
||||
[This is the first released version of the Lesser GPL. It also counts as the
|
||||
successor of the GNU Library Public License, version 2, hence the version
|
||||
number 2.1.]
|
||||
|
||||
Preamble
|
||||
|
||||
The licenses for most software are designed to take away your freedom to share
|
||||
and change it. By contrast, the GNU General Public Licenses are intended to
|
||||
guarantee your freedom to share and change free software--to make sure the
|
||||
software is free for all its users.
|
||||
|
||||
This license, the Lesser General Public License, applies to some specially
|
||||
designated software packages--typically libraries--of the Free Software Foundation
|
||||
and other authors who decide to use it. You can use it too, but we suggest
|
||||
you first think carefully about whether this license or the ordinary General
|
||||
Public License is the better strategy to use in any particular case, based
|
||||
on the explanations below.
|
||||
|
||||
When we speak of free software, we are referring to freedom of use, 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 this service if you
|
||||
wish); that you receive source code or can get it if you want it; that you
|
||||
can change the software and use pieces of it in new free programs; and that
|
||||
you are informed that you can do these things.
|
||||
|
||||
To protect your rights, we need to make restrictions that forbid distributors
|
||||
to deny you these rights or to ask you to surrender these rights. These restrictions
|
||||
translate to certain responsibilities for you if you distribute copies of
|
||||
the library or if you modify it.
|
||||
|
||||
For example, if you distribute copies of the library, whether gratis or for
|
||||
a fee, you must give the recipients all the rights that we gave you. You must
|
||||
make sure that they, too, receive or can get the source code. If you link
|
||||
other code with the library, you must provide complete object files to the
|
||||
recipients, so that they can relink them with the library after making changes
|
||||
to the library and recompiling it. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
We protect your rights with a two-step method: (1) we copyright the library,
|
||||
and (2) we offer you this license, which gives you legal permission to copy,
|
||||
distribute and/or modify the library.
|
||||
|
||||
To protect each distributor, we want to make it very clear that there is no
|
||||
warranty for the free library. Also, if the library is modified by someone
|
||||
else and passed on, the recipients should know that what they have is not
|
||||
the original version, so that the original author's reputation will not be
|
||||
affected by problems that might be introduced by others.
|
||||
|
||||
Finally, software patents pose a constant threat to the existence of any free
|
||||
program. We wish to make sure that a company cannot effectively restrict the
|
||||
users of a free program by obtaining a restrictive license from a patent holder.
|
||||
Therefore, we insist that any patent license obtained for a version of the
|
||||
library must be consistent with the full freedom of use specified in this
|
||||
license.
|
||||
|
||||
Most GNU software, including some libraries, is covered by the ordinary GNU
|
||||
General Public License. This license, the GNU Lesser General Public License,
|
||||
applies to certain designated libraries, and is quite different from the ordinary
|
||||
General Public License. We use this license for certain libraries in order
|
||||
to permit linking those libraries into non-free programs.
|
||||
|
||||
When a program is linked with a library, whether statically or using a shared
|
||||
library, the combination of the two is legally speaking a combined work, a
|
||||
derivative of the original library. The ordinary General Public License therefore
|
||||
permits such linking only if the entire combination fits its criteria of freedom.
|
||||
The Lesser General Public License permits more lax criteria for linking other
|
||||
code with the library.
|
||||
|
||||
We call this license the "Lesser" General Public License because it does Less
|
||||
to protect the user's freedom than the ordinary General Public License. It
|
||||
also provides other free software developers Less of an advantage over competing
|
||||
non-free programs. These disadvantages are the reason we use the ordinary
|
||||
General Public License for many libraries. However, the Lesser license provides
|
||||
advantages in certain special circumstances.
|
||||
|
||||
For example, on rare occasions, there may be a special need to encourage the
|
||||
widest possible use of a certain library, so that it becomes a de-facto standard.
|
||||
To achieve this, non-free programs must be allowed to use the library. A more
|
||||
frequent case is that a free library does the same job as widely used non-free
|
||||
libraries. In this case, there is little to gain by limiting the free library
|
||||
to free software only, so we use the Lesser General Public License.
|
||||
|
||||
In other cases, permission to use a particular library in non-free programs
|
||||
enables a greater number of people to use a large body of free software. For
|
||||
example, permission to use the GNU C Library in non-free programs enables
|
||||
many more people to use the whole GNU operating system, as well as its variant,
|
||||
the GNU/Linux operating system.
|
||||
|
||||
Although the Lesser General Public License is Less protective of the users'
|
||||
freedom, it does ensure that the user of a program that is linked with the
|
||||
Library has the freedom and the wherewithal to run that program using a modified
|
||||
version of the Library.
|
||||
|
||||
The precise terms and conditions for copying, distribution and modification
|
||||
follow. Pay close attention to the difference between a "work based on the
|
||||
library" and a "work that uses the library". The former contains code derived
|
||||
from the library, whereas the latter must be combined with the library in
|
||||
order to run.
|
||||
|
||||
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||
|
||||
0. This License Agreement applies to any software library or other program
|
||||
which contains a notice placed by the copyright holder or other authorized
|
||||
party saying it may be distributed under the terms of this Lesser General
|
||||
Public License (also called "this License"). Each licensee is addressed as
|
||||
"you".
|
||||
|
||||
A "library" means a collection of software functions and/or data prepared
|
||||
so as to be conveniently linked with application programs (which use some
|
||||
of those functions and data) to form executables.
|
||||
|
||||
The "Library", below, refers to any such software library or work which has
|
||||
been distributed under these terms. A "work based on the Library" means either
|
||||
the Library or any derivative work under copyright law: that is to say, a
|
||||
work containing the Library or a portion of it, either verbatim or with modifications
|
||||
and/or translated straightforwardly into another language. (Hereinafter, translation
|
||||
is included without limitation in the term "modification".)
|
||||
|
||||
"Source code" for a work means the preferred form of the work for making modifications
|
||||
to it. For a library, complete source code means all the source code for all
|
||||
modules it contains, plus any associated interface definition files, plus
|
||||
the scripts used to control compilation and installation of the library.
|
||||
|
||||
Activities other than copying, distribution and modification are not covered
|
||||
by this License; they are outside its scope. The act of running a program
|
||||
using the Library is not restricted, and output from such a program is covered
|
||||
only if its contents constitute a work based on the Library (independent of
|
||||
the use of the Library in a tool for writing it). Whether that is true depends
|
||||
on what the Library does and what the program that uses the Library does.
|
||||
|
||||
1. You may copy and distribute verbatim copies of the Library's complete source
|
||||
code as you receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice and disclaimer
|
||||
of warranty; keep intact all the notices that refer to this License and to
|
||||
the absence of any warranty; and distribute a copy of this License along with
|
||||
the Library.
|
||||
|
||||
You may charge a fee for the physical act of transferring a copy, and you
|
||||
may at your option offer warranty protection in exchange for a fee.
|
||||
|
||||
2. You may modify your copy or copies of the Library or any portion of it,
|
||||
thus forming a work based on the Library, and copy and distribute such modifications
|
||||
or work under the terms of Section 1 above, provided that you also meet all
|
||||
of these conditions:
|
||||
|
||||
a) The modified work must itself be a software library.
|
||||
|
||||
b) You must cause the files modified to carry prominent notices stating that
|
||||
you changed the files and the date of any change.
|
||||
|
||||
c) You must cause the whole of the work to be licensed at no charge to all
|
||||
third parties under the terms of this License.
|
||||
|
||||
d) If a facility in the modified Library refers to a function or a table of
|
||||
data to be supplied by an application program that uses the facility, other
|
||||
than as an argument passed when the facility is invoked, then you must make
|
||||
a good faith effort to ensure that, in the event an application does not supply
|
||||
such function or table, the facility still operates, and performs whatever
|
||||
part of its purpose remains meaningful.
|
||||
|
||||
(For example, a function in a library to compute square roots has a purpose
|
||||
that is entirely well-defined independent of the application. Therefore, Subsection
|
||||
2d requires that any application-supplied function or table used by this function
|
||||
must be optional: if the application does not supply it, the square root function
|
||||
must still compute square roots.)
|
||||
|
||||
These requirements apply to the modified work as a whole. If identifiable
|
||||
sections of that work are not derived from the Library, and can be reasonably
|
||||
considered independent and separate works in themselves, then this License,
|
||||
and its terms, do not apply to those sections when you distribute them as
|
||||
separate works. But when you distribute the same sections as part of a whole
|
||||
which is a work based on the Library, the distribution of the whole must be
|
||||
on the terms of this License, whose permissions for other licensees extend
|
||||
to the entire whole, and thus to each and every part regardless of who wrote
|
||||
it.
|
||||
|
||||
Thus, it is not the intent of this section to claim rights or contest your
|
||||
rights to work written entirely by you; rather, the intent is to exercise
|
||||
the right to control the distribution of derivative or collective works based
|
||||
on the Library.
|
||||
|
||||
In addition, mere aggregation of another work not based on the Library with
|
||||
the Library (or with a work based on the Library) on a volume of a storage
|
||||
or distribution medium does not bring the other work under the scope of this
|
||||
License.
|
||||
|
||||
3. You may opt to apply the terms of the ordinary GNU General Public License
|
||||
instead of this License to a given copy of the Library. To do this, you must
|
||||
alter all the notices that refer to this License, so that they refer to the
|
||||
ordinary GNU General Public License, version 2, instead of to this License.
|
||||
(If a newer version than version 2 of the ordinary GNU General Public License
|
||||
has appeared, then you can specify that version instead if you wish.) Do not
|
||||
make any other change in these notices.
|
||||
|
||||
Once this change is made in a given copy, it is irreversible for that copy,
|
||||
so the ordinary GNU General Public License applies to all subsequent copies
|
||||
and derivative works made from that copy.
|
||||
|
||||
This option is useful when you wish to copy part of the code of the Library
|
||||
into a program that is not a library.
|
||||
|
||||
4. You may copy and distribute the Library (or a portion or derivative of
|
||||
it, under Section 2) in object code or executable form under the terms of
|
||||
Sections 1 and 2 above provided that you accompany it with the complete corresponding
|
||||
machine-readable source code, which must be distributed under the terms of
|
||||
Sections 1 and 2 above on a medium customarily used for software interchange.
|
||||
|
||||
If distribution of object code is made by offering access to copy from a designated
|
||||
place, then offering equivalent access to copy the source code from the same
|
||||
place satisfies the requirement to distribute the source code, even though
|
||||
third parties are not compelled to copy the source along with the object code.
|
||||
|
||||
5. A program that contains no derivative of any portion of the Library, but
|
||||
is designed to work with the Library by being compiled or linked with it,
|
||||
is called a "work that uses the Library". Such a work, in isolation, is not
|
||||
a derivative work of the Library, and therefore falls outside the scope of
|
||||
this License.
|
||||
|
||||
However, linking a "work that uses the Library" with the Library creates an
|
||||
executable that is a derivative of the Library (because it contains portions
|
||||
of the Library), rather than a "work that uses the library". The executable
|
||||
is therefore covered by this License. Section 6 states terms for distribution
|
||||
of such executables.
|
||||
|
||||
When a "work that uses the Library" uses material from a header file that
|
||||
is part of the Library, the object code for the work may be a derivative work
|
||||
of the Library even though the source code is not. Whether this is true is
|
||||
especially significant if the work can be linked without the Library, or if
|
||||
the work is itself a library. The threshold for this to be true is not precisely
|
||||
defined by law.
|
||||
|
||||
If such an object file uses only numerical parameters, data structure layouts
|
||||
and accessors, and small macros and small inline functions (ten lines or less
|
||||
in length), then the use of the object file is unrestricted, regardless of
|
||||
whether it is legally a derivative work. (Executables containing this object
|
||||
code plus portions of the Library will still fall under Section 6.)
|
||||
|
||||
Otherwise, if the work is a derivative of the Library, you may distribute
|
||||
the object code for the work under the terms of Section 6. Any executables
|
||||
containing that work also fall under Section 6, whether or not they are linked
|
||||
directly with the Library itself.
|
||||
|
||||
6. As an exception to the Sections above, you may also combine or link a "work
|
||||
that uses the Library" with the Library to produce a work containing portions
|
||||
of the Library, and distribute that work under terms of your choice, provided
|
||||
that the terms permit modification of the work for the customer's own use
|
||||
and reverse engineering for debugging such modifications.
|
||||
|
||||
You must give prominent notice with each copy of the work that the Library
|
||||
is used in it and that the Library and its use are covered by this License.
|
||||
You must supply a copy of this License. If the work during execution displays
|
||||
copyright notices, you must include the copyright notice for the Library among
|
||||
them, as well as a reference directing the user to the copy of this License.
|
||||
Also, you must do one of these things:
|
||||
|
||||
a) Accompany the work with the complete corresponding machine-readable source
|
||||
code for the Library including whatever changes were used in the work (which
|
||||
must be distributed under Sections 1 and 2 above); and, if the work is an
|
||||
executable linked with the Library, with the complete machine-readable "work
|
||||
that uses the Library", as object code and/or source code, so that the user
|
||||
can modify the Library and then relink to produce a modified executable containing
|
||||
the modified Library. (It is understood that the user who changes the contents
|
||||
of definitions files in the Library will not necessarily be able to recompile
|
||||
the application to use the modified definitions.)
|
||||
|
||||
b) Use a suitable shared library mechanism for linking with the Library. A
|
||||
suitable mechanism is one that (1) uses at run time a copy of the library
|
||||
already present on the user's computer system, rather than copying library
|
||||
functions into the executable, and (2) will operate properly with a modified
|
||||
version of the library, if the user installs one, as long as the modified
|
||||
version is interface-compatible with the version that the work was made with.
|
||||
|
||||
c) Accompany the work with a written offer, valid for at least three years,
|
||||
to give the same user the materials specified in Subsection 6a, above, for
|
||||
a charge no more than the cost of performing this distribution.
|
||||
|
||||
d) If distribution of the work is made by offering access to copy from a designated
|
||||
place, offer equivalent access to copy the above specified materials from
|
||||
the same place.
|
||||
|
||||
e) Verify that the user has already received a copy of these materials or
|
||||
that you have already sent this user a copy.
|
||||
|
||||
For an executable, the required form of the "work that uses the Library" must
|
||||
include any data and utility programs needed for reproducing the executable
|
||||
from it. However, as a special exception, the materials to be distributed
|
||||
need not include anything that is normally distributed (in either source or
|
||||
binary form) with the major components (compiler, kernel, and so on) of the
|
||||
operating system on which the executable runs, unless that component itself
|
||||
accompanies the executable.
|
||||
|
||||
It may happen that this requirement contradicts the license restrictions of
|
||||
other proprietary libraries that do not normally accompany the operating system.
|
||||
Such a contradiction means you cannot use both them and the Library together
|
||||
in an executable that you distribute.
|
||||
|
||||
7. You may place library facilities that are a work based on the Library side-by-side
|
||||
in a single library together with other library facilities not covered by
|
||||
this License, and distribute such a combined library, provided that the separate
|
||||
distribution of the work based on the Library and of the other library facilities
|
||||
is otherwise permitted, and provided that you do these two things:
|
||||
|
||||
a) Accompany the combined library with a copy of the same work based on the
|
||||
Library, uncombined with any other library facilities. This must be distributed
|
||||
under the terms of the Sections above.
|
||||
|
||||
b) Give prominent notice with the combined library of the fact that part of
|
||||
it is a work based on the Library, and explaining where to find the accompanying
|
||||
uncombined form of the same work.
|
||||
|
||||
8. You may not copy, modify, sublicense, link with, or distribute the Library
|
||||
except as expressly provided under this License. Any attempt otherwise to
|
||||
copy, modify, sublicense, link with, or distribute the Library is void, and
|
||||
will automatically terminate your rights under this License. However, parties
|
||||
who have received copies, or rights, from you under this License will not
|
||||
have their licenses terminated so long as such parties remain in full compliance.
|
||||
|
||||
9. You are not required to accept this License, since you have not signed
|
||||
it. However, nothing else grants you permission to modify or distribute the
|
||||
Library or its derivative works. These actions are prohibited by law if you
|
||||
do not accept this License. Therefore, by modifying or distributing the Library
|
||||
(or any work based on the Library), you indicate your acceptance of this License
|
||||
to do so, and all its terms and conditions for copying, distributing or modifying
|
||||
the Library or works based on it.
|
||||
|
||||
10. Each time you redistribute the Library (or any work based on the Library),
|
||||
the recipient automatically receives a license from the original licensor
|
||||
to copy, distribute, link with or modify the Library subject to these terms
|
||||
and conditions. You may not impose any further restrictions on the recipients'
|
||||
exercise of the rights granted herein. You are not responsible for enforcing
|
||||
compliance by third parties with this License.
|
||||
|
||||
11. If, as a consequence of a court judgment or allegation of patent infringement
|
||||
or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your
|
||||
obligations under this License and any other pertinent obligations, then as
|
||||
a consequence you may not distribute the Library at all. For example, if a
|
||||
patent license would not permit royalty-free redistribution of the Library
|
||||
by all those who receive copies directly or indirectly through you, then the
|
||||
only way you could satisfy both it and this License would be to refrain entirely
|
||||
from distribution of the Library.
|
||||
|
||||
If any portion of this section is held invalid or unenforceable under any
|
||||
particular circumstance, the balance of the section is intended to apply,
|
||||
and the section as a whole is intended to apply in other circumstances.
|
||||
|
||||
It is not the purpose of this section to induce you to infringe any patents
|
||||
or other property right claims or to contest validity of any such claims;
|
||||
this section has the sole purpose of protecting the integrity of the free
|
||||
software distribution system which is implemented by public license practices.
|
||||
Many people have made generous contributions to the wide range of software
|
||||
distributed through that system in reliance on consistent application of that
|
||||
system; it is up to the author/donor to decide if he or she is willing to
|
||||
distribute software through any other system and a licensee cannot impose
|
||||
that choice.
|
||||
|
||||
This section is intended to make thoroughly clear what is believed to be a
|
||||
consequence of the rest of this License.
|
||||
|
||||
12. If the distribution and/or use of the Library is restricted in certain
|
||||
countries either by patents or by copyrighted interfaces, the original copyright
|
||||
holder who places the Library under this License may add an explicit geographical
|
||||
distribution limitation excluding those countries, so that distribution is
|
||||
permitted only in or among countries not thus excluded. In such case, this
|
||||
License incorporates the limitation as if written in the body of this License.
|
||||
|
||||
13. The Free Software Foundation may publish revised and/or new versions of
|
||||
the Lesser 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 Library specifies
|
||||
a version number of this License which applies to it and "any later version",
|
||||
you have the option of following the terms and conditions either of that version
|
||||
or of any later version published by the Free Software Foundation. If the
|
||||
Library does not specify a license version number, you may choose any version
|
||||
ever published by the Free Software Foundation.
|
||||
|
||||
14. If you wish to incorporate parts of the Library into other free programs
|
||||
whose distribution conditions are incompatible with these, write to the author
|
||||
to ask for permission. For software which is copyrighted by the Free Software
|
||||
Foundation, write to the Free Software Foundation; we sometimes make exceptions
|
||||
for this. Our decision will be guided by the two goals of preserving the free
|
||||
status of all derivatives of our free software and of promoting the sharing
|
||||
and reuse of software generally.
|
||||
|
||||
NO WARRANTY
|
||||
|
||||
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
|
||||
THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE
|
||||
STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY
|
||||
"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 LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
|
||||
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
|
||||
THE LIBRARY 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 LIBRARY (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 LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH
|
||||
HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Libraries
|
||||
|
||||
If you develop a new library, and you want it to be of the greatest possible
|
||||
use to the public, we recommend making it free software that everyone can
|
||||
redistribute and change. You can do so by permitting redistribution under
|
||||
these terms (or, alternatively, under the terms of the ordinary General Public
|
||||
License).
|
||||
|
||||
To apply these terms, attach the following notices to the library. It is safest
|
||||
to attach them to the start of each source file to most effectively convey
|
||||
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 library's name and an idea of what it does.>
|
||||
|
||||
Copyright (C) <year> <name of author>
|
||||
|
||||
This library is free software; you can redistribute it and/or modify it under
|
||||
the terms of the GNU Lesser General Public License as published by the Free
|
||||
Software Foundation; either version 2.1 of the License, or (at your option)
|
||||
any later version.
|
||||
|
||||
This library 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 Lesser General Public License for more
|
||||
details.
|
||||
|
||||
You should have received a copy of the GNU Lesser General Public License along
|
||||
with this library; if not, write to the Free Software Foundation, Inc., 51
|
||||
Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
You should also get your employer (if you work as a programmer) or your school,
|
||||
if any, to sign a "copyright disclaimer" for the library, if necessary. Here
|
||||
is a sample; alter the names:
|
||||
|
||||
Yoyodyne, Inc., hereby disclaims all copyright interest in
|
||||
|
||||
the library `Frob' (a library for tweaking knobs) written
|
||||
|
||||
by James Random Hacker.
|
||||
|
||||
< signature of Ty Coon > , 1 April 1990
|
||||
|
||||
Ty Coon, President of Vice
|
||||
|
||||
That's all there is to it!
|
||||
@@ -0,0 +1,2 @@
|
||||
#! /usr/bin/env bash
|
||||
$XGETTEXT src/*.cpp -o $podir/%{APPNAMELC}.pot
|
||||
@@ -0,0 +1,45 @@
|
||||
KIO Worker Template
|
||||
----------------------
|
||||
|
||||
### Build instructions
|
||||
|
||||
```
|
||||
cd /where/your/project/is/created
|
||||
mkdir build
|
||||
cd build
|
||||
cmake \
|
||||
-DKDE_INSTALL_PLUGINDIR=`kf5-config --qt-plugins` \
|
||||
-DKDE_INSTALL_KSERVICESDIR=`kf5-config --install services` \
|
||||
-DKDE_INSTALL_LOGGINGCATEGORIESDIR=`kf5-config --install data`qlogging-categories5 \
|
||||
-DCMAKE_BUILD_TYPE=Release ..
|
||||
make
|
||||
make install
|
||||
```
|
||||
|
||||
After this you can test the new protocol with:
|
||||
`kioclient 'ls' 'myproto:///'`
|
||||
`kioclient 'cat' 'myproto:///Item A'`
|
||||
|
||||
You can also explore the new protocol with dolphin or konqueror:
|
||||
`dolphin myproto:///`
|
||||
|
||||
|
||||
### Adaption instructions
|
||||
|
||||
Because the KAppTemplate format does not yet allow custom variables,
|
||||
the template uses "myproto" in the generated sources as the initial name of the scheme.
|
||||
Grep for all instances of that string in all files and replace it with the name of your scheme,
|
||||
and rename the `myproto.protocol` file accordingly.
|
||||
|
||||
The class `MyDataSystem` just serves as a starting point to see something working right
|
||||
after creating the project. Replace that class and the calls to it with code as needed to map
|
||||
the KIO system to the actual data service/system your KIO worker is wrapping.
|
||||
|
||||
|
||||
### Related documentation
|
||||
|
||||
Find the documentation of `KIO::WorkerBase` for the API to implement at
|
||||
https://api.kde.org/frameworks/kio/html/classKIO_1_1WorkerBase.html
|
||||
|
||||
Learn about debugging your new KIO worker at
|
||||
https://community.kde.org/Guidelines_and_HOWTOs/Debugging/Debugging_KIO_Workers
|
||||
@@ -0,0 +1,18 @@
|
||||
#!/bin/bash
|
||||
|
||||
# Exit if something fails
|
||||
set -e
|
||||
|
||||
mkdir -p build
|
||||
cd build
|
||||
|
||||
cmake \
|
||||
-DKDE_INSTALL_PLUGINDIR=`kf5-config --qt-plugins` \
|
||||
-DKDE_INSTALL_KSERVICESDIR=`kf5-config --install services` \
|
||||
-DKDE_INSTALL_LOGGINGCATEGORIESDIR=`kf5-config --install data`qlogging-categories5 \
|
||||
-DCMAKE_BUILD_TYPE=Release ..
|
||||
make -j$(nproc)
|
||||
sudo make install
|
||||
|
||||
# start dolphin to browse the new IO system
|
||||
dolphin myproto:///
|
||||
@@ -0,0 +1,90 @@
|
||||
[General]
|
||||
Name=C++ Worker (KF6)
|
||||
Name[ar]=عامل سي++ (KF6)
|
||||
Name[be]=C++ Worker (KF6)
|
||||
Name[bg]=C++ Worker (KF6)
|
||||
Name[ca]=Procés de treball C++ (KF6)
|
||||
Name[ca@valencia]=Procés de treball C++ (KF6)
|
||||
Name[da]=C++-arbejder (KF6)
|
||||
Name[de]=C++-Modul (KF6)
|
||||
Name[en_GB]=C++ Worker (KF6)
|
||||
Name[eo]=C++ Worker (KF6)
|
||||
Name[es]=Módulo de trabajo de C++ (KF6)
|
||||
Name[eu]=C++ Behargina (KF6)
|
||||
Name[fi]=C++-työskentelijä (KF6)
|
||||
Name[fr]=Développer C++ (KF6)
|
||||
Name[gl]=Traballador de C++ (KF6)
|
||||
Name[he]=סוכן פעולה C++ (KF6)
|
||||
Name[ia]=C++ Worker (KF6)
|
||||
Name[is]=C++ þræll (KF6)
|
||||
Name[it]=Worker C++ (KF6)
|
||||
Name[ka]=C++ Worker (KF6)
|
||||
Name[ko]=C++ 워커(KF6)
|
||||
Name[lg]=Lutiba Lw'ekyongerwako kya KIO
|
||||
Name[lv]=C++ strādnieks (KF6)
|
||||
Name[nl]=C++-werker (KF6)
|
||||
Name[nn]=C++-arbeidar (KF6)
|
||||
Name[pl]=Pracownik C++ (KF6)
|
||||
Name[ru]=Обработчик C++ (KF6)
|
||||
Name[sa]=C++ कार्यकर्ता (KF6)
|
||||
Name[sl]=C++ Worker (KF6)
|
||||
Name[sq]=C++ Worker (KF6)
|
||||
Name[sv]=C++ arbetare (KF6)
|
||||
Name[tr]=C++ İşçi (KF6)
|
||||
Name[uk]=Обробник C++ (KF6)
|
||||
Name[x-test]=xxC++ Worker (KF6)xx
|
||||
Name[zh_CN]=C++ 工作程序 (KF6)
|
||||
Name[zh_TW]=C++ Worker (KF6)
|
||||
Comment=KIO Worker Template
|
||||
Comment[ar]=قالب عامل الدخل والخرج
|
||||
Comment[az]=KİO modulu nümunəsi
|
||||
Comment[be]=Шаблон KIO Worker
|
||||
Comment[bg]=Шаблон на KIO Worker
|
||||
Comment[ca]=Plantilla de processos de treball KIO
|
||||
Comment[ca@valencia]=Plantilla de processos de treball KIO
|
||||
Comment[cs]=Šablona nástroje KIO
|
||||
Comment[da]=Template for KIO-Arbejder
|
||||
Comment[de]=Vorlage für Ein-/Ausgabemodul
|
||||
Comment[el]=Πρότυπο εργαζόμενου KIO
|
||||
Comment[en_GB]=KIO Worker Template
|
||||
Comment[eo]=KIO-Laboranta Ŝablono
|
||||
Comment[es]=Plantilla de módulo de trabajo KIO
|
||||
Comment[et]=KIO töömooduli mall
|
||||
Comment[eu]=KIO behargin txantiloia
|
||||
Comment[fi]=KIO-työskentelijäpohja
|
||||
Comment[fr]=Modèle de module « KIO »
|
||||
Comment[gl]=Modelo de traballador de KIO.
|
||||
Comment[he]=תבנית סוכן פעולה של KIO
|
||||
Comment[hu]=KIO szolgáltatássablon
|
||||
Comment[ia]=Patrono de Kio Worker (Travaliator de Kio)
|
||||
Comment[id]=Templat KIO Worker
|
||||
Comment[ie]=Modelle de KIO Worker
|
||||
Comment[is]=Sniðmát fyrir KIO-þræl
|
||||
Comment[it]=Modello di KIO Worker
|
||||
Comment[ka]=KIO -ის დამხმარე პროცესის შაბლონი
|
||||
Comment[ko]=KIO 워커 템플릿
|
||||
Comment[lg]=Lutiba Lw'ekyongerwako kya KIO
|
||||
Comment[lt]=KIO darbininko šablonas
|
||||
Comment[lv]=KIO strādnieka veidne
|
||||
Comment[my]=KIO Workerပုံစံပြား
|
||||
Comment[nl]=Sjabloon van KIO-worker
|
||||
Comment[nn]=KIO-arbeidarmal
|
||||
Comment[pa]=KIO ਵਰਕਰ ਟੈਂਪਲੇਟ
|
||||
Comment[pl]=Wzorzec pracownika KIO
|
||||
Comment[pt]=Modelo de Módulo do KIO
|
||||
Comment[pt_BR]=Modelo de KIO worker
|
||||
Comment[ro]=Șablon de lucrător KIO
|
||||
Comment[ru]=Шаблон модуля KIO
|
||||
Comment[sa]=KIO Worker Template
|
||||
Comment[sk]=Šablóna obsluhy KIO
|
||||
Comment[sl]=Predloga za KIO Worker
|
||||
Comment[sq]=Gjedhe Worker-i KIO
|
||||
Comment[sv]=I/O-arbetarmall
|
||||
Comment[ta]=KIO பணிநிரலுக்கான வார்ப்புரு
|
||||
Comment[tr]=KIO İşçisi Şablonu
|
||||
Comment[uk]=Шаблон обробника KIO
|
||||
Comment[vi]=Bản mẫu thợ KIO
|
||||
Comment[x-test]=xxKIO Worker Templatexx
|
||||
Comment[zh_CN]=KIO 工作程序模板
|
||||
Comment[zh_TW]=KIO Worker 範本
|
||||
Category=KIO
|
||||
@@ -0,0 +1,174 @@
|
||||
/*
|
||||
SPDX-FileCopyrightText: %{CURRENT_YEAR} %{AUTHOR} <%{EMAIL}>
|
||||
|
||||
SPDX-License-Identifier: LGPL-2.1-or-later
|
||||
*/
|
||||
|
||||
#include "%{APPNAMELC}.h"
|
||||
|
||||
#include "%{APPNAMELC}_log.h"
|
||||
#include "mydatasystem.h"
|
||||
// KF
|
||||
#include <KIO/UDSEntry>
|
||||
#include <KLocalizedString>
|
||||
// Qt
|
||||
#include <QCoreApplication>
|
||||
#include <QUrl>
|
||||
|
||||
// Pseudo plugin class to embed meta data
|
||||
class KIOPluginForMetaData : public QObject
|
||||
{
|
||||
Q_OBJECT
|
||||
Q_PLUGIN_METADATA(IID "org.kde.kio.worker.myproto" FILE "myproto.json")
|
||||
};
|
||||
|
||||
extern "C" {
|
||||
int Q_DECL_EXPORT kdemain(int argc, char **argv);
|
||||
}
|
||||
|
||||
int kdemain(int argc, char **argv)
|
||||
{
|
||||
QCoreApplication app(argc, argv);
|
||||
app.setApplicationName(QStringLiteral("%{APPNAME}"));
|
||||
|
||||
%{APPNAME} worker(argv[2], argv[3]);
|
||||
worker.dispatchLoop();
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
// utils methods to map our data into KIO data
|
||||
namespace
|
||||
{
|
||||
|
||||
QStringList groupPath(const QUrl &url)
|
||||
{
|
||||
QString path = url.adjusted(QUrl::StripTrailingSlash).path();
|
||||
if (path.startsWith(QLatin1Char('/'))) {
|
||||
path.remove(0, 1);
|
||||
}
|
||||
return path.isEmpty() ? QStringList() : path.split(QLatin1Char('/'));
|
||||
}
|
||||
|
||||
KIO::UDSEntry fileEntry(const DataItem &item)
|
||||
{
|
||||
KIO::UDSEntry entry;
|
||||
entry.reserve(5);
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_NAME, item.name);
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_MIME_TYPE, QStringLiteral("text/plain"));
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_FILE_TYPE, S_IFREG);
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_SIZE, item.data().size());
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_ACCESS, S_IRUSR | S_IRGRP | S_IROTH);
|
||||
return entry;
|
||||
}
|
||||
|
||||
KIO::UDSEntry dirEntry(const QString &name)
|
||||
{
|
||||
KIO::UDSEntry entry;
|
||||
|
||||
entry.reserve(4);
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_NAME, name);
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_MIME_TYPE, QStringLiteral("inode/directory"));
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_FILE_TYPE, S_IFDIR);
|
||||
entry.fastInsert(KIO::UDSEntry::UDS_ACCESS, S_IRUSR | S_IRGRP | S_IROTH);
|
||||
|
||||
return entry;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
%{APPNAME}::%{APPNAME}(const QByteArray &pool_socket, const QByteArray &app_socket)
|
||||
: KIO::WorkerBase("myproto", pool_socket, app_socket)
|
||||
, m_dataSystem(new MyDataSystem)
|
||||
{
|
||||
qCDebug(%{APPNAMEUC}_LOG) << "%{APPNAME} starting up";
|
||||
}
|
||||
|
||||
%{APPNAME}::~%{APPNAME}()
|
||||
{
|
||||
qCDebug(%{APPNAMEUC}_LOG) << "%{APPNAME} shutting down";
|
||||
}
|
||||
|
||||
|
||||
KIO::WorkerResult %{APPNAME}::get(const QUrl &url)
|
||||
{
|
||||
qCDebug(%{APPNAMEUC}_LOG) << "%{APPNAME} starting get" << url;
|
||||
|
||||
QStringList groupPath = ::groupPath(url);
|
||||
const QString itemName = groupPath.takeLast();
|
||||
const DataItem item = m_dataSystem->item(groupPath, itemName);
|
||||
if (!item.isValid()) {
|
||||
groupPath.append(itemName);
|
||||
if (m_dataSystem->hasGroup(groupPath)) {
|
||||
return KIO::WorkerResult::fail(KIO::ERR_IS_DIRECTORY, itemName);
|
||||
}
|
||||
return KIO::WorkerResult::fail(KIO::ERR_DOES_NOT_EXIST, itemName);
|
||||
}
|
||||
|
||||
// as first notify about the MIME type, so the handler can be selected
|
||||
mimeType(QStringLiteral("text/plain"));
|
||||
|
||||
// now emit the data...
|
||||
data(item.data());
|
||||
|
||||
// and we are done
|
||||
return KIO::WorkerResult::pass();
|
||||
}
|
||||
|
||||
KIO::WorkerResult %{APPNAME}::stat(const QUrl &url)
|
||||
{
|
||||
qCDebug(%{APPNAMEUC}_LOG) << "%{APPNAME} starting stat" << url;
|
||||
|
||||
QStringList groupPath = ::groupPath(url);
|
||||
|
||||
// is root directory?
|
||||
if (groupPath.isEmpty()) {
|
||||
statEntry(dirEntry(QStringLiteral(".")));
|
||||
return KIO::WorkerResult::pass();
|
||||
}
|
||||
// test subgroup
|
||||
if (m_dataSystem->hasGroup(groupPath)) {
|
||||
statEntry(dirEntry(groupPath.last()));
|
||||
return KIO::WorkerResult::pass();
|
||||
}
|
||||
|
||||
// test item
|
||||
const QString itemName = groupPath.takeLast();
|
||||
const DataItem item = m_dataSystem->item(groupPath, itemName);
|
||||
if (item.isValid()) {
|
||||
statEntry(fileEntry(item));
|
||||
return KIO::WorkerResult::pass();
|
||||
}
|
||||
|
||||
return KIO::WorkerResult::fail(KIO::ERR_DOES_NOT_EXIST, i18n("No such path."));
|
||||
}
|
||||
|
||||
KIO::WorkerResult %{APPNAME}::listDir(const QUrl &url)
|
||||
{
|
||||
const QStringList groupPath = ::groupPath(url);
|
||||
qCDebug(%{APPNAMEUC}_LOG) << "%{APPNAME} starting listDir" << url << groupPath;
|
||||
|
||||
if (!m_dataSystem->hasGroup(groupPath)) {
|
||||
return KIO::WorkerResult::fail(KIO::ERR_DOES_NOT_EXIST, i18n("No such directory."));
|
||||
}
|
||||
|
||||
const QStringList subGroupNames = m_dataSystem->subGroupNames(groupPath);
|
||||
const QList<DataItem> items = m_dataSystem->items(groupPath);
|
||||
|
||||
// report number of expected entries
|
||||
totalSize(1 + subGroupNames.size() + items.size());
|
||||
// own dir
|
||||
listEntry(dirEntry(QStringLiteral(".")));
|
||||
// subdirs
|
||||
for (const QString &subGroupName : subGroupNames) {
|
||||
listEntry(dirEntry(subGroupName));
|
||||
}
|
||||
// files
|
||||
for (const auto &item : items) {
|
||||
listEntry(fileEntry(item));
|
||||
}
|
||||
|
||||
return KIO::WorkerResult::pass();
|
||||
}
|
||||
|
||||
#include "%{APPNAMELC}.moc"
|
||||
@@ -0,0 +1,30 @@
|
||||
/*
|
||||
SPDX-FileCopyrightText: %{CURRENT_YEAR} %{AUTHOR} <%{EMAIL}>
|
||||
|
||||
SPDX-License-Identifier: LGPL-2.1-or-later
|
||||
*/
|
||||
|
||||
#ifndef %{APPNAMEUC}_H
|
||||
#define %{APPNAMEUC}_H
|
||||
|
||||
// KF
|
||||
#include <KIO/WorkerBase>
|
||||
// Std
|
||||
#include <memory>
|
||||
|
||||
class %{APPNAME} : public KIO::WorkerBase
|
||||
{
|
||||
public:
|
||||
%{APPNAME}(const QByteArray &pool_socket, const QByteArray &app_socket);
|
||||
~%{APPNAME}() override;
|
||||
|
||||
public: // KIO::WorkerBase API
|
||||
KIO::WorkerResult get(const QUrl &url) override;
|
||||
KIO::WorkerResult stat(const QUrl &url) override;
|
||||
KIO::WorkerResult listDir(const QUrl &url) override;
|
||||
|
||||
private: // sample data structure
|
||||
std::unique_ptr<class MyDataSystem> m_dataSystem;
|
||||
};
|
||||
|
||||
#endif
|
||||
@@ -0,0 +1,31 @@
|
||||
add_definitions(-DTRANSLATION_DOMAIN=\"%{APPNAMELC}\")
|
||||
|
||||
add_library(%{APPNAMELC} MODULE)
|
||||
set_target_properties(%{APPNAMELC} PROPERTIES OUTPUT_NAME "myproto")
|
||||
|
||||
target_sources(%{APPNAMELC} PRIVATE
|
||||
mydatasystem.cpp
|
||||
%{APPNAMELC}.cpp
|
||||
)
|
||||
|
||||
ecm_qt_declare_logging_category(%{APPNAMELC}
|
||||
HEADER %{APPNAMELC}_log.h
|
||||
IDENTIFIER %{APPNAMEUC}_LOG
|
||||
CATEGORY_NAME kf.kio.workers.%{APPNAMELC}
|
||||
DESCRIPTION "KIO worker (%{APPNAME})"
|
||||
DEFAULT_SEVERITY Debug # Change "Debug" to "Info" once doing first releases
|
||||
EXPORT %{APPNAMEUC}
|
||||
)
|
||||
|
||||
target_link_libraries(%{APPNAMELC}
|
||||
KF6::KIOCore
|
||||
KF6::I18n
|
||||
)
|
||||
|
||||
install(TARGETS %{APPNAMELC} DESTINATION ${KDE_INSTALL_PLUGINDIR}/kf6/kio)
|
||||
|
||||
ecm_qt_install_logging_categories(
|
||||
EXPORT %{APPNAMEUC}
|
||||
FILE %{APPNAMELC}.categories
|
||||
DESTINATION ${KDE_INSTALL_LOGGINGCATEGORIESDIR}
|
||||
)
|
||||
@@ -0,0 +1,79 @@
|
||||
/*
|
||||
SPDX-FileCopyrightText: %{CURRENT_YEAR} %{AUTHOR} <%{EMAIL}>
|
||||
|
||||
SPDX-License-Identifier: LGPL-2.1-or-later
|
||||
*/
|
||||
|
||||
#include "mydatasystem.h"
|
||||
|
||||
QByteArray DataItem::data() const
|
||||
{
|
||||
// simulating content data fetched for the item
|
||||
return QByteArrayLiteral("Hello world\n");
|
||||
}
|
||||
|
||||
|
||||
MyDataSystem::MyDataSystem()
|
||||
// sample data simulating that in the exposed data system
|
||||
: m_toplevelGroup({
|
||||
{ // subgroups
|
||||
{ QStringLiteral("Subgroup"), {
|
||||
{}, // subgroups
|
||||
{ // items
|
||||
{ QStringLiteral("Item C") },
|
||||
{ QStringLiteral("Item D") },
|
||||
{ QStringLiteral("Item E") },
|
||||
}
|
||||
} }
|
||||
},
|
||||
{ // items
|
||||
{ QStringLiteral("Item A") },
|
||||
{ QStringLiteral("Item B") },
|
||||
}
|
||||
})
|
||||
{
|
||||
}
|
||||
|
||||
const DataGroup* MyDataSystem::group(const QStringList& groupPath) const
|
||||
{
|
||||
const DataGroup* currentGroup = &m_toplevelGroup;
|
||||
for (const QString &group : groupPath) {
|
||||
auto it = currentGroup->subGroups.constFind(group);
|
||||
if (it == currentGroup->subGroups.constEnd()) {
|
||||
return nullptr;
|
||||
}
|
||||
currentGroup = &*it;
|
||||
}
|
||||
return currentGroup;
|
||||
}
|
||||
|
||||
bool MyDataSystem::hasGroup(const QStringList& groupPath) const
|
||||
{
|
||||
return (group(groupPath) != nullptr);
|
||||
}
|
||||
|
||||
QList<DataItem> MyDataSystem::items(const QStringList& groupPath) const
|
||||
{
|
||||
auto* group = this->group(groupPath);
|
||||
return group ? group->items : QList<DataItem>();
|
||||
}
|
||||
|
||||
DataItem MyDataSystem::item(const QStringList& groupPath, const QString &itemName) const
|
||||
{
|
||||
auto* group = this->group(groupPath);
|
||||
if (group) {
|
||||
for (auto &item : group->items) {
|
||||
if (item.name == itemName) {
|
||||
return item;
|
||||
}
|
||||
}
|
||||
}
|
||||
return DataItem();
|
||||
}
|
||||
|
||||
QStringList MyDataSystem::subGroupNames(const QStringList& groupPath) const
|
||||
{
|
||||
auto* group = this->group(groupPath);
|
||||
return group ? group->subGroups.keys() : QStringList();
|
||||
}
|
||||
|
||||
@@ -0,0 +1,53 @@
|
||||
/*
|
||||
SPDX-FileCopyrightText: %{CURRENT_YEAR} %{AUTHOR} <%{EMAIL}>
|
||||
|
||||
SPDX-License-Identifier: LGPL-2.1-or-later
|
||||
*/
|
||||
|
||||
#ifndef MYDATASYSTEM_H
|
||||
#define MYDATASYSTEM_H
|
||||
|
||||
// Qt
|
||||
#include <QHash>
|
||||
#include <QStringList>
|
||||
#include <QByteArray>
|
||||
|
||||
// A sample class transporting the system data structure that would be mapped onto a file
|
||||
class DataItem
|
||||
{
|
||||
public:
|
||||
QString name;
|
||||
QByteArray data() const;
|
||||
bool isValid() const { return !name.isEmpty(); }
|
||||
};
|
||||
|
||||
// A sample class transporting the system data structure that would be mapped onto a directory
|
||||
class DataGroup
|
||||
{
|
||||
public:
|
||||
QHash<QString, DataGroup> subGroups;
|
||||
QList<DataItem> items;
|
||||
};
|
||||
|
||||
|
||||
// A sample data system adapter
|
||||
class MyDataSystem
|
||||
{
|
||||
public:
|
||||
MyDataSystem();
|
||||
|
||||
public: // sync calls querying data from the actual data system
|
||||
bool hasGroup(const QStringList &groupPath) const;
|
||||
QList<DataItem> items(const QStringList &groupPath) const;
|
||||
DataItem item(const QStringList& groupPath, const QString &itemName) const;
|
||||
QStringList subGroupNames(const QStringList &groupPath) const;
|
||||
|
||||
private:
|
||||
const DataGroup* group(const QStringList& groupPath) const;
|
||||
|
||||
private:
|
||||
// hardcoded sample data to simulate that in the data system
|
||||
DataGroup m_toplevelGroup;
|
||||
};
|
||||
|
||||
#endif
|
||||
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"KDE-KIO-Protocols": {
|
||||
"myproto": {
|
||||
"ExtraNames": [],
|
||||
"input": "none",
|
||||
"listing": [
|
||||
"Name",
|
||||
"Type",
|
||||
"Size",
|
||||
"Access"
|
||||
],
|
||||
"output": "filesystem",
|
||||
"protocol": "myproto",
|
||||
"reading": true
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
#!/bin/bash
|
||||
|
||||
# Exit if something fails
|
||||
set -e
|
||||
|
||||
cd build
|
||||
sudo make uninstall
|
||||
Reference in New Issue
Block a user