C implementation of createrepo
Run createrepo -h
for usage syntax.
Package build requires - Pkg name in Fedora/Ubuntu:
From your checkout dir:
mkdir build cd build/ cmake .. make
To build the documentation, from the build/ directory:
make doc
Note: For build with debugging symbols you could use (from the build/ directory):
cmake -DCMAKE_BUILD_TYPE:STRING=DEBUG .. && make
E.g. when you want to try weak and rich dependencies.
cmake .. && make
Note: The RPM must be built in that directory
Commands I am using for building the RPM:
cd /home/tmlcoch/git/rpm CPPFLAGS='-I/usr/include/nss3/ -I/usr/include/nspr4/' ./autogen.sh --rpmconfigure --with-vendor=redhat --with-external-db --with-lua --with-selinux --with-cap --with-acl --enable-python make clean && make
By default, cmake should set up things to build for Python 3, but you can do a build for Python 2 like this::
cmake -DPYTHON_DESIRED=2 .
-DENABLE_LEGACY_WEAKDEPS=ON
Enable legacy SUSE/Mageia/Mandriva weakdeps support (Default: ON)
-DENABLE_THREADED_XZ_ENCODER=ON
Threaded XZ encoding (Default: OFF)
Note: This option is disabled by default, because Createrepo_c parallelizes a lot of tasks (including compression) by default; this only adds extra threads on XZ library level which causes thread bloat and for most usecases doesn't bring any performance boost. On regular hardware (e.g. less-or-equal 4 cores) this option may even cause degradation of performance.
-DENABLE_DRPM=ON
Enable DeltaRPM support using drpm library (Default: ON)
Adds support for creating DeltaRPMs and incorporating them into the repository.
-DWITH_ZCHUNK=ON
Build with zchunk support (Default: ON)
-DWITH_LIBMODULEMD=ON
Build with libmodulemd support (Default: ON)
Adds support for working with repos containing Fedora Modularity metadata.
utils/make_tarball.sh [git revision]
Without git revision specified HEAD is used.
To create a binary "wheel" distribution, use:
python setup.py bdist_wheel
To create a source distribution, use:
python setup.py sdist
Installing source distributions require the installer of the package to have all of the build dependencies installed on their system, since they compile the code during installation. Binary distributions are pre-compiled, but they are likely not portable between substantially different systems, e.g. Fedora and Ubuntu.
Note: if you are building a bdist or installing the sdist on a system with an older version of Pip, you may need to install the scikit-build
Python package first.
To install either of these packages, use:
pip install dist/{{ package name }}
To create an "editable" install of createrepo_c, use:
python setup.py develop
Note: To recompile the libraries and binaries, you muse re-run this command.
Modify createrepo_c.spec and run:
utils/make_rpm.sh
Note: Current .spec for Fedora rawhide
All unit tests run from librepo checkout dir
make tests && make test
Note: For a verbose output of testing use: make ARGS="-V" test
build/tests/run_gtester.sh
Note: The C tests have to be built by make tests
)!
PYTHONPATH=`readlink -f ./build/src/python/` nosetests -s tests/python/tests/
Or, for an alternative python version, specify the appropriate nosetests executable:
PYTHONPATH=`readlink -f ./build/src/python/` nosetests-3.4 -s tests/python/tests/
Note: When compiling createrepo_c without libmodulemd support add WITH_LIBMODULEMD=OFF
In original createrepo sha
is a nickname for the sha1
checksum.
Createrepo_c mimics this behaviour.
Modifyrepo_c is compatible with classical Modifyrepo except some misbehaviour:
When there is need to do several modification to repository (repomd.xml
)
a batch file could be used.
Batch file is Modifyrepo_c specific. It is not supported by the classical Modifyrepo - at least not yet.
# Add: # [<path/to/file>] # <options> # Metadata that use a bunch of config options [some/path/comps.xml] type=group compress=true compress-type=gz unique-md-filenames=true checksum=sha256 new-name=group.xml # Metadata that use default settings [some/path/bar.xml] # Remove: # [<metadata name>] # remove=true [updateinfo] remove=true
Option name | Description | Supported value(s) | Default |
---|---|---|---|
path | Path to the file. When specified it override the path specified in group name (name between [] parenthesis) | Any string | group name (string between '[' ']') |
type | Type of the metadata | Any string | Based on filename |
remove | Remove specified file/type from repodata | true or false |
false |
compress | Compress the new metadata before adding it to repo | true or false |
true |
compress-type | Compression format to use | gz , bz2 , xz |
gz |
checksum | Checksum type to use | md5 , sha , sha1 , sha224 , sha256 , sha384 , sha512 |
sha256 |
unique-md-filenames | Include the file's checksum in the filename | true or false |
true |
new-name | New name for the file. If compress is true , then compression suffix will be appended. If unique-md-filenames is true , then checksum will be prepended. |
Any string | Original source filename |
remove=true
is used, no other config options should be used