api-macro: add expanded data to tests for verification

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: add test-harness feature

If enabled, the Schema type implements Eq and PartialEq for
testing the api macro better.

Note that these implementations don't make all too much
since since they also compare `dyn Fn` types which do not
implement Eq. Since they're also `&'static` they can't
really be runtime closures, so this should be fine, we know
they'll always point to some regular function.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support empty api macro on structs

The description comes from the doc comment, the field types
and description from field doc comments and types.
Previously we needed to add at least the hint that the
schema is an object schema. Now we support an empty #[api]
attribute as well.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support renamed struct fields

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support rename_all in enums

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: start using serde attribute helpers

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: prepare to support serde::rename_all

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: more option type handling

infer_type now also returns whether it was encapsualted in
an Option<>. So `type: String, optional: true` is now
inferred propertly from `Option<String>`.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: derive optional values correctly

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: reorganize field iteration

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: error on extraneous fields

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: add basic struct handling

- handle doc comments for descriptions
- infer fields from structs when possible
- perform some basic error checking

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: factor out type inference for reuse with structs

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: split struct handling into newtype, regular, unit, ...

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: derive descriptions for structs

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

cargo: switch to use packaged crates by default

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

tools: remove accidentally commited debian/files

it's a build artifact, no need to version control it.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

version bump

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: drop unused dev-dependencies

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

readme: add cargo config for packaged crates

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-tools: reference valgrind_request via git

to allow using 'cargo XXX' with cargo config pointing to packaged
sources instead of crates.io

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

sys: add a bunch of error helpers

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

sys: add some helpful macros

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: bump bytes to 0.5

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

more versioning fixups

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

-dev bump for proxmox crate as well

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

add a 'Versioning' readme section

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

bump proxmox-tools to 0.1.1-dev.1

We now use this between package releases.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: fs: default to 644 for mode in replace_file

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox: initial packaging

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-api-macro: initial packaging

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-sortable-macro: initial packaging

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-sys: initial packaging

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-sys: update lazy-static to 1.4

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-api: use proxmox-tools package in d/rules

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-api: initial packaging

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-api: update rustyline to 5.0.5

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-api: update lazy_static to 1.4

which is available in Debian unstable.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-tools: initial packaging

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

proxmox-tools: update regex and lazy_static

to those versions available in Debian unstable

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

add a top level doc comment to fs submodule

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

bump nix to 0.16

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

linux/procfs: add read_proc_stat

For now we just parse the CPU "time-spent" counters and calculate the
CPU usage of the whole system. As we do not want a total average we
use a state-full implementation, which calculates the usage since the
last request (if older than 1 second).

Somewhat modeled after our Perl version of this. But for the "total"
we do not use the:
> ($ctime - $last_proc_stat->{ctime}) * $clock_ticks * $cpucount;
calculation, but just add _all_ fields together, as that is the total
of CPU time.

Use a Reader-Writer lock to sync updating. First check under the
reader lock if the data is recent enough, else update it under the
writer lock.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

cleanup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: create_path: return whether the dir was created

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: create_dir: pass EEXIST to the caller

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: fix create_path: don't use O_PATH

open(2) says file descriptors opened with O_PATH cannot be
passed to fchmod(), fchown(), etc.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

src/cli/format.rs - print_help: by default, use verbose output for simply commands

api/macro: add NumberSchema

Adapted from the integer schema, uses f64 type.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
Cc: Wolfgang Bumiller <w.bumiller@proxmox.com>
Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

replace create_dir_chown with create_dir using CreateOptions

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

deprecate file_set_contents{,_full}

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: replace_file, make options not an option...

CreateOptions::new() creates an all-None option set anyway

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: introduce replace_file

nicer api with CreateOptions
see doc-comments for more info

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

drop derive-builder dependency

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

remove old router macro documentation

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: remove now-unnecessary PropertySchema type

Schemas can now generally refer to an externally defined
schema.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: generalized '{ schema: PATH }' schemas

allow 'schema: PATH' outside object property context

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support 'async fn' with new async api method

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

implement ApiHandler::Async

api: update url crate to 2.1

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

update bytes to 0.5

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

updates for hyper 0.13 release

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox-api/src/cli.rs: simplify cli setup using generics.

proxmox-api/src/cli/format.rs - generate_nested_usage: fix formating with empty prefix

api: add 'router' and 'cli' features

Move API types into the router module and make router and
cli optional.

This way the 'router' module is the only thing with a
dependency on 'hyper', allowing the use of the schema alone
without pulling in the entire hyper stack.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: use http::{Parts,Response,Method}

hyper just reexports them

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

more clippy fixups

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

clippy fixups

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

please run `make` to check formatting before committing

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow methods without return types

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: don't return Null without return schema

serde_json turns () into Null anyway, so there's no need to
check this!

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: get enum description from doc comments

instead of:
    #[api(description: "Some description.")]
    pub enum { ... }

support:
    #[api]
    /// Some description.
    pub enum { ... }

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: move doc-comment reading to util

The function attribute reader doesn't read any other
attributes anymore, so make it reusable!

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: let ConstRegexPattern deref to Regex

This way we can just use `SOME_REGEX.is_match()` again
without having to explicitly call `(SOME_REGEX.regex_obj)()`
first.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: rename SimpleIdent to FieldName

Initially it was a wrapper around Ident to avoid some
copies, but now it's what we use to allow hyphenated names
for fields in objects (as `syn::Ident` doesn't allow that at
all), so give it a more fitting name.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support hyphenated parameter names

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: drop ToTokens for SimpleIdent

The user must be explicit about whether the ident or string
is required.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: drop Deref of SimpleIdent

The user must always be explicit about whether the Ident or
the String is required, since they may differ.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: fixup idents in SimpleIdent

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: remove Into<Ident> for SimpleIdent

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow referencing external schemas in properties

Reference a predefined BACKUP_ARCHIVE_NAME StringSchema like
this:
    #[api(
        input: {
            properties: {
                archive: {
                    optional: true,
                    schema: BACKUP_ARCHIVE_NAME,
                },
            }
        }
    )]
    fn get_archive(archive: String) -> Result<(), Error> {
        ...
    }

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox_api/src/format.rs - get_property_description: fix paragraph indention

proxmox-api/src/format.rs: improve docs

proxmox-api/src/format.rs: add missing docs

proxmox-api/src/cli/shellword.rs: re-export Quote from rustyline

proxmox-api/src/cli/completion.rs: add more tests

proxmox-api/src/cli/completion.rs: add help completion tests

proxmox_api: add cli submodule (copied from proxmox-backup)

api-macro: allow inferring some types automatically

non-optional boolean, string and integer types can be
inferred from the function

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: test optional value invocation

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow skipping `input` schema

when there are no parameters

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: add test with no parameters

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow 'bool' and rust int types

in place of Boolean and Integer

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: make return schema optional

and support returning () from methods

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox-api: fix text_wrap() - use join instead of concat (separate by newlines)

api-macro: some more test code

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>