bump proxmox to 0.11.0

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

fmt

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

use Send+Sync on dyn ObjectSchemaType

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

support AllOfSchemas in section_config

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

get rid of associated type in ObjectSchemaType trait

The AllOfProperties Iterator is capable of also being the
Iterator for the regular ObjectSchemas by simply filling it
like it was the "last" object type in an AllOf.

This makes the ObjectSchemaType trait more usable later.

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

AllOfSchema support in parse_property_string

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

fix AllOfSchema::lookup to allow nesting

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

proxmox: bump api-macro dep to 0.3.3

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

bump api-macro to 0.3.3-1

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

Updater: take serde renames into account

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

bump proxmox to 0.10.7

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

rustfmt

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

proxmox::tools: rustfmt

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

proxmox::test: rustfmt

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

remove u2f example for now

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

minor cleanup

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

proxmox::test::io: properly forward flush

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

proxmox: add sparse_copy(_async) to tools::io

this is able to seek the target instead of writing zeroes, which
generates sparse files where supported

also add tests for it

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

proxmox: add test/{io, task} modules

contains:
* AsyncBlocking{Reader,Writer} for dummy async code
  by wrapping a 'standard reader/writer'
* poll_result_once for pulling a future once (copied from pxar)

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

bump proxmox version to 0.10.6-1

make get_property_string_type_text public

We need that to generate nice docs.

bump proxmox version to 0.10.5

implement dump_section_config

rename dump_api_parameters to dump_properties

And do not dump object description automatically.

bump api-macro to 0.3.2-1

This got lost in a rebase...

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

bump proxmox to 0.10.4-1

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

bump api-macro dependency to 0.3.2

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

bump proxmox version to 0.10.3-1

api: implement schema doc generator for PropertyStrings

SectionConifg: allow access to plugin properties

api: add type_text to StringSchema

api: improve reST formating

api: add dump_enum_properties(), make dump_api_parameter pub

bump proxmox to 0.10.2-1

CliCommandMap: add usage_skip_options to suppress options in generate_usage_str()

This is useful for commands where sub-commands all takes the same options.
You can supress them in the generated manual pages (printdoc), and instead
document them somewhere else.

api-macro: pull in 'extra-traits' feature from syn

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

cleanup: remove serde_derive dependency

this comes from the 'derive' feature in serde

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

ignore member crate target dirs as well

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

api-macro: let tests depend on api-macro

the updater tests require both the trait and the proc macros
to be visible, running tests with `--all-features` prevents
them from being imported from two separate locations as
their names are the same, so let's always include the macro
versions in test cases by depending on the `api-macro`
feature in tests in the api-macro crate

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

doc fixup

not sure if it's worth looking up that link?

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

formatting fixups

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

updaters: docs and exports

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

api-macro: introduce updaters

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

schema: introduce Updatable and Updater traits

The `Updatable` trait is our mechanism for "updating"
values. The `Updater` trait is a serde-helper to allow using
`skip_serializing_if` on api type structs which
`#[derive(Updater)]`

All basic types implement `Updatable<Updater = Option<T>>`,
and all `Option<T>` where `T: Updatable` are implicitly also
updatable from `Option<T>`.

With the update to the `#[api]` macro, all `#[api]` types
will implicitly `#[derive(Updatable)]` via the default
implementation (which simply assignes from an
`Option<Self>`), unless they explicitly also
`#[derive(Updater)]` in which case an implementation is
derived which goes through each "field" found in the
updater. To prevent fields from being updatable via an
Updater `#[updater(fixed)]` can be used.

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

schema: fix AllOf property iteration for nested objects

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

schema: support AllOf in ExtractValueDeserializer

fixes nested AllOfs in api methods

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

bump proxmox to 0.10.1-1

cli: improve completion of array arguments

debcargo: fix maintainer directive

and remove accidentally committed files

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

clippy: use std::ptr::null

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

clippy fixups

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

bump proxmox to 0.10.0-1

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

bump proxmox-api-macro to 0.3.1-1

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

build: add autopkgtest target

which runs the autopkgtests on the built packages.

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

move ParameterSchema from router to schema

it's the place where it belongs, and unbreaks the --no-default-features
build

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

fix u2f example

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

tokio 1.0: drop TimeoutFutureExt

tokio's Sleep/Delay/Timeout are no longer Unpin, complicating this
wrapper. we can just use tokio::time::timeout directly as needed..

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

update to tokio 1.0

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

update to rustyline 7

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

Cargo.toml: update to tokio 1.0

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

macro: refactoring

purely non-functional changes

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

time: fix parsing non-full-hour TZ offsets

and add a test case to avoid regressions in the future.

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

update control files, fix changelogs

update proxmox to 0.9.1-1

add tools::future with TimeoutFutureExt

Implements shorthands to automatically cancel a long-running future
after a timeout is reached.

Signed-off-by: Stefan Reiter <s.reiter@proxmox.com>

proxmox: correctly depend on proxmox-api-macro 0.3

bump versions to 0.9.0-1/0.3.0-1

proxmox changelog update

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

proxmox: temporary d/changelog update

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

macro: temporary d/changelog update

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

schema: ParameterSchema at 'api' level

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

api-macro: support flattened parameters

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

api-macro: factor parameter extraction into a function

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

api-macro: more tuple refactoring

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

api-macro: object schema entry tuple -> struct

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

schema: ExtractValueDeserializer

A deserializer which takes an `&mut Value` and an object
schema reference and deserializes by extracting (removing)
the values from the references serde Value.

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

api-macro: suport AllOf on structs

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

api-macro: add more standard Maybe methods

Note that any methods added there should be oriented around
`Option`.

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

api-macro: forbid flattened fields

They don't appear in the json data structure and therefore
should not be named separately in the schema. Structs with
flattened fields will become an `AllOf` schema instead.

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

api-macro: add 'flatten' to SerdeAttrib

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

schema: allow AllOf schema as method parameter

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

schema: support AllOf schemas

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

api-macro: support optional return values

The return specification can now include an `optional`
field.

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

schema: support optional return values

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

formatting fixup

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

update d/control

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

bump proxmox-api-macro to 0.2.4-1

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

document forward_de/serialize_to_display/from_str

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

doc fixup

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

api-macro: lower a whole bunch of errors

to be non fatal for better error messages, this way the user
will see the compile error, but we still generate all the
code & schema variables so that one error isn't accompanied
by all the ones resulting from not having the generated code
there at all.

Eg.

    error: description not allowed on external type
       --> src/api2/access/user.rs:472:22
        |
    472 |         description: "Get API token metadata (with config digest).",
        |                      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Was previously also accompanied by

    error[E0425]: cannot find value `API_METHOD_READ_TOKEN` in this scope
       --> src/api2/access/user.rs:774:11
        |
    699 | pub fn delete_token(
        | ------ similarly named constant `API_METHOD_DELETE_TOKEN` defined here
    ...
    774 |     .get(&API_METHOD_READ_TOKEN)
        |           ^^^^^^^^^^^^^^^^^^^^^ help: a constant with a similar name exists: `API_METHOD_DELETE_TOKEN`

The second error was "wrong" and came much later, needlessly
filling the screen if this happened on multiple functions.

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

api-macro: forbid description on incompatible schemas

References to external schemas (or types) already include
the description in the external schema and therefore are
illegal.

The implementation consists of multiple parts:

* Introduce a `Maybe` type which can be `Explicit`,
  `Derived` or `None`.
* Forbid `Explicit` descriptions on references.
* Instead of bailing out on such errors which causes all of
  the generated code to vanish and create heaps of
  additional nonsensical errors, add a way to *add* errors
  without bailing out immediately via the `error!()` macro.

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

correct email in changelog

Signed-off-by: Hannes Laimer <h.laimer@proxmox.com>

bump proxmox version to 0.8.1-1

trait ReadExt: add read_exact_or_eof and skip_to_end

proxmox: fix example array in Cargo.toml

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

build: track d/control in git

and check build-dependencies before building..

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

bump proxmox to 0.8.0

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

minor clippy lints

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

introduce FdRef and BorrowedFd

Types used to reprecent borrowed raw file descriptors.

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

make_tmp_file: properly guard file descriptor

and return an Fd

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