diff options
author | Wojtek Kosior <koszko@koszko.org> | 2022-04-25 18:50:22 +0200 |
---|---|---|
committer | Wojtek Kosior <koszko@koszko.org> | 2022-04-25 18:50:22 +0200 |
commit | a1242be58d53ed1f1441b4620898780fe1c4d160 (patch) | |
tree | 796d40cdf73b744044e79370b9df4d0d792f5c17 /README.md | |
parent | e588b99e0c7a17664e3293ad4bf4635fdb5eac09 (diff) | |
download | hydrilla-builder-a1242be58d53ed1f1441b4620898780fe1c4d160.tar.gz hydrilla-builder-a1242be58d53ed1f1441b4620898780fe1c4d160.zip |
update READMEv1.0
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 63 |
1 files changed, 58 insertions, 5 deletions
@@ -1,12 +1,65 @@ -# These are the sources of Hydrilla builder, a tool to convert packages into a form serveable by Hydrilla. +# Hydrilla builder -TODO... +This is the repository of the builder part of [Hydrilla](https://hydrillabugs.koszko.org/projects/hydrilla/wiki). You can find the repository of its server part [here](https://git.koszko.org/pydrilla/). + +Hydrilla builder is a tool to create Haketilo packages in serveable form. The information below is meant to help hack on the codebase. If you're instead looking for some noob-friendly documentation, see the [user manual](https://hydrillabugs.koszko.org/projects/hydrilla/wiki/User_manual). + +## Dependencies + +### Runtime + +* Python3 (>= 3.7) +* click +* jsonschema (>= 3.0) +* reuse [optional] + +### Build + +* setuptools +* wheel +* setuptools_scm +* babel + +### Test + +* pytest +* reuse + +## Building & testing + +Build and test processed are analogous to those described in the [README of Hydrilla server part](https://git.koszko.org/pydrilla/about). + +## Running + +This package provides a hydrilla-builder command. You can use it to build the supplied example with something along the lines of: -To build the supplied example you can do something along the lines of: ``` mkdir /tmp/bananowarzez/ +hydrilla-builder -s src/test/source-package-example/ -d /tmp/bananowarzez/ +# Now, list the serveable package files we just produced. +find /tmp/bananowarzez/ +``` + +You might as well like to run from sources, without installation: +mkdir /tmp/bananowarzez/ +./setup.py compile_catalog # generate the necessary .po files PYTHONPATH=src python3 -m hydrilla.builder -s src/test/source-package-example/ \ -d /tmp/bananowarzez/ -# Now, list the files we just produced -find /tmp/bananowarzez/ ``` + +You can also consult the included manpage (`man` tool required): +``` shell +man ./doc/man/man1/hydrilla-builder.1 +``` + +## Copying + +Hydrilla is Copyright (C) 2021-2022 Wojtek Kosior and contributors, entirely available under the GNU Affero General Public License version 3 or later. Some files might also give you broader permissions, see comments inside them. + +*I, Wojtek Kosior, thereby promise not to sue for violation of this project's license. Although I request that you do not make use this code in a proprietary program, I am not going to enforce this in court.* + +## Contributing + +Please visit our Redmine instance at https://hydrillabugs.koszko.org. + +You can also write an email to koszko@koszko.org. |