Add userver recipe by apolukhin · Pull Request #28173 · conan-io/conan-center-index

apolukhin · 2025-08-15T10:46:24Z

Summary

Added a recipe for https://github.com/userver-framework/userver

Motivation

This PR adds a popular (2.8k stars) project 🐙 userver to the Conan Center.

Details

The recipe is extensively tested in the https://github.com/userver-framework/userver repository in the following combinations:

MacOS
Ubuntu (pure 22.04 image)
Ubuntu with github additions

Unlike the previous PR #20712 this PR is much shorter, as the recipe now reuses the CMake installation.

🐙 userver heavily relies on CMake. It can not work without it, so the recipe does not attempt to be usable with other build systems for now (maybe later we will support other build systems in userver and in that case we'll update the recipe)

Unfortunately, one of the Python modules used by userver builds from sources. We failed to provide that dependency to the stage when users build Python venv with userver from Conan. Because of that the recipe has a libpq-dev system package requirement. We'd be happy to improve that place, but our last attempt took two weeks and failed.

Tests

Tested locally with conan create all/conanfile.py --version=2.13 --build=missing. Without --build=missing many packages were not found

Tests pass well, including Python based tests:

1: ../../testsuite/test_basic.py::test_kv PASSED                            [100%]
1: 
1: ============================== 1 passed in 2.24s ===============================
1/1 Test #1: testsuite-userver-easy-samples-json ...   Passed    3.93 sec

100% tests passed, 0 tests failed out of 1

Total Test time (real) =   3.94 sec

P.S.: Any recipe change from this PR will be synchronized to the userver-framework/userver to get extensive testing.

Read the contributing guidelines
Checked that this PR is not a duplicate: list of PRs by recipe
Tested locally with at least one configuration using a recent version of Conan

CLAassistant · 2025-08-15T10:46:30Z

All committers have signed the CLA.

apolukhin · 2025-08-26T09:08:03Z

Gentle ping

xakod · 2025-09-19T13:31:16Z

@apolukhin thank you that you pushing this idea again :)
I couldn't, maybe you'll finish

jcar87

Thanks for your contribution!

Apologies this has taken so long.

We are happy to prioritize this - I've added review comments as this recipe differs considerably from Conan Center conventions - please let us know if you have any questions and we're happy to help!

recipes/userver/all/test_package/main.cpp

recipes/userver/all/conanfile.py

apolukhin · 2025-11-23T14:15:25Z

@jcar87 I've fixed some of the issues and asked questions for the remaining issues. Please take a look

apolukhin · 2025-11-26T08:04:07Z

@jcar87 gentle reminder

Tests: протестировано github CI, на прод не влияет Conan center PR conan-io/conan-center-index#28173 --- Pull Request resolved: #1015 Co-authored-by: antoshkka <antoshkka@userver.tech> Co-authored-by: antoshkka <antoshkka@userver.tech> Co-authored-by: Antony Polukhin <antoshkka@gmail.com> commit_hash:25ab73cb03ff9b746536c13bab83aa668b35d175

recipes/userver/all/conanfile.py

rklepov · 2026-01-13T14:57:01Z

recipes/userver/all/conanfile.py

+    def build(self):
+        # pg_config is required to build psycopg2 from source without system package.
+        # However, this approach fails on later stage, when venv for tests is built.
+        libpq = self.dependencies['libpq']


If self.options.with_postgresql == False then this line will fail (there'll be no 'libpq' key). I assume the conditional in the next line could be changed to something like:

if self.options.with_postgresql and (libpq := self.dependencies['libpq']):

Or even simply:

if self.options.with_postgresql:

because the test on libpq is redundant if the option is enabled.

Thanks! Fixed

uilianries · 2026-01-22T07:10:51Z

@apolukhin Hello! Thank you for not only maintaining Userver, but also bringing it as a pull request here. I see this recipe is huge and complex to maintain, so I would like to know if it would be possible to start with something really simple, as Arch Linux has done with their package: https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=userver-community, a really simple build with a few requirements only.

I may understand, as you are one of the maintainers of that project, it would be favorable to give all those features available in the recipe as well, but as a side step, it will increase the maintainability of these recipes exponentially, and users may not be interested in consuming all those features in the end. Regards.

apolukhin · 2026-02-03T13:39:29Z

@rklepov I've relaxed a bunch of dependency requirements. There are some issues with Boost other than 1.86 and something is wrong with concurrentqueue=1.0.4. We're investigating that, but that should not block from reviewing this PR.

@uilianries I followed your advice and disabled Mongo and SQLite parts of the framework by default. Those technologies are not used in majority of projects

I also updated the userver release. Please take a look

…er PR review Fix issues noted in conan-io/conan-center-index#28173 --- Pull Request resolved: #1119 commit_hash:419d462bf40c3c306c38e92e9622429b6324d5f7

apolukhin · 2026-02-10T08:06:46Z

@jcar87 @rklepov gentle reminder, that this PR needs review or even merge :)

rklepov · 2026-02-12T13:21:05Z

gentle reminder, that this PR needs review or even merge :)

@apolukhin I've added some comments from my side. In fact nothing critical there. So I'm absolutely not opposed to merging the PR and eager to see userver recipe added to conan-center. Unfortunately I'm not the repository maintainer and so have no word here. Also I see that there're some red checks below. Not sure if that's important but likely not a positive sign.

rklepov · 2026-02-12T09:45:39Z

recipes/userver/all/conanfile.py

+    def build(self):
+        # pg_config is required to build psycopg2 from source without system package.
+        # However, this approach fails on later stage, when venv for tests is built.
+        if libpq := self.dependencies.get('libpq'):


Actually, doesn't seem that it will work. self.dependencies in fact is not a Python dict but rather an instance of ConanFileDependencies class. I get basically the same error as previously:

ERROR: userver/2.15: Error in build() method, line 246 if libpq := self.dependencies.get('libpq'): KeyError: "'libpq' not found in the dependency set"

So I'm afraid there's no way but to follow the suggestion from my previous comment and check self.options.with_postgresql option.

Fixed. Please check that it works fine in your environment (all the versions of those lines worked fine in my environment)

Thanks! Works for me. I wonder what version of conan you're on? I'm simply using the latest one currently available: Conan version 2.25.2.

Anyway, I believe that this form of the check is actually more idiomatic.

rklepov · 2026-02-12T10:36:17Z

recipes/userver/all/conanfile.py

+        'with_s3api': True,
+        'with_grpc_reflection': True,
+        'with_grpc_protovalidate': False,
+        'mongo-c-driver/*:with_sasl': 'cyrus',


The items following this in default_options dict are in fact the options for the external dependencies.

However, as a consumer of the userver recipe, do I really need to see them here? They will be overridden by the values from my build profile anyway. Here's an example of conan output for that matter:

Options conflicts grpc/1.69.0:php_plugin=False (current value) userver/2.15->php_plugin=True It is recommended to define options values in profiles, not in recipes WARN: risk: There are options conflicts in the dependency graph

I assume the options are important for a developer of userver itself when they work on a component that needs particular facilities from one or more external libraries. But I suppose that it's preferable to keep the options in a local build profile too (probably also under a version control).

Going into details, for example, we can look at the options for grpc. Is it really a problem if I link userver to the version of grpc library with the listed plugins enabled (imagine that I already have that one in my own environment)? I assume it's not.

On the other hand, I realize that the options, for example, for librdkafka might be crucial (ssl etc.). However, arguably the better location to check the expected values of the options is validate() function below. And I see that you already do the checks for mongo-c-driver there.

There're the discussions that expand on the matter here and here.

To summarize, I suggest that we should consider removing the options for the external dependencies from default_options.

Experimenting with reduced dependencies in this PR userver-framework/userver#1126

If our Conan CI shows no degradation, I'll update this PR

Yep, that worked. Pushed in the changes to this PR

rklepov · 2026-02-12T12:52:41Z

recipes/userver/all/conanfile.py

+        tool_ch.cache_variables['USERVER_FEATURE_EASY'] = self.options.with_easy
+        tool_ch.cache_variables['USERVER_FEATURE_S3API'] = self.options.with_s3api
+        tool_ch.cache_variables['USERVER_FEATURE_GRPC_REFLECTION'] = self.options.with_grpc_reflection
+        tool_ch.cache_variables['USERVER_FEATURE_GRPC_PROTOVALIDATE'] = self.options.with_grpc_protovalidate


Not all the features and build options that are available in CMakeLists.txt are actually listed here and therefore available for configuration via a build profile or conan command line. Is that intentional? For example, for some particular reasons I'm personally interested in USERVER_DISABLE_PHDR_CACHE option among the others.

This contradicts the "start with something really simple" review comment.

However, the USERVER_DISABLE_PHDR_CACHE option seems trivial, so I went further and added it.

Great, thanks! Yes, I later realized that this a bit contradicts the earlier comment from @jcar87. However, I hope this won't prevent him from approving and eventually merging the PR, because the option was added on a popular demand)

rklepov

LGTM

apolukhin added 3 commits August 14, 2025 18:56

Add userver recipe

a7be6c8

fixes

0d076b5

do not loose file permissions

298c1b7

apolukhin mentioned this pull request Sep 1, 2025

Synchronize conanfile.py with the one from conan-center PR userver-framework/userver#1015

Closed

apolukhin added 2 commits September 1, 2025 18:23

Update conanfile.py with latest changes from userver

feece12

Update conandata.yml to use the recent release

ca9ca69

perseoGI mentioned this pull request Sep 8, 2025

clickhouse-cpp: CMake 4 support and stop publishing revisions for older versions #28350

Merged

apolukhin added 2 commits September 23, 2025 10:15

Update conanfile.py with latest upstream changes

ce0c562

Fix typo

8e44f7c

apolukhin mentioned this pull request Oct 1, 2025

Add userver to conan-center userver-framework/userver#384

Open

jcar87 requested changes Oct 24, 2025

View reviewed changes

jcar87 added the waiting on contributor label Oct 24, 2025

apolukhin added 2 commits November 23, 2025 16:12

review fixes

0bd012a

shorter test

856357c

typo

e98d64a

apolukhin requested a review from jcar87 November 23, 2025 14:23

big simplification

d4bc40e

minor fix and formatting

b58350f

rklepov reviewed Jan 12, 2026

View reviewed changes

recipes/userver/all/conanfile.py Show resolved Hide resolved

rklepov reviewed Jan 13, 2026

View reviewed changes

apolukhin mentioned this pull request Feb 2, 2026

Update conanfile.py userver-framework/userver#1119

Closed

Review fixes and updates

aa61af5

apolukhin requested a review from rklepov February 10, 2026 08:05

rklepov reviewed Feb 12, 2026

View reviewed changes

apolukhin added 2 commits February 15, 2026 20:21

More review fixes, including phdr option, relaxed dependencies

c237aa2

reduce defaults

b101b89

rklepov approved these changes Feb 16, 2026

View reviewed changes

Conversation

apolukhin commented Aug 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Motivation

Details

Tests

Uh oh!

CLAassistant commented Aug 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apolukhin commented Aug 26, 2025

Uh oh!

xakod commented Sep 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jcar87 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apolukhin commented Nov 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apolukhin commented Nov 26, 2025

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

uilianries commented Jan 22, 2026

Uh oh!

apolukhin commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apolukhin commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rklepov commented Feb 12, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rklepov Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rklepov Feb 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rklepov Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rklepov left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

apolukhin commented Aug 15, 2025 •

edited

Loading

CLAassistant commented Aug 15, 2025 •

edited

Loading

xakod commented Sep 19, 2025 •

edited

Loading

apolukhin commented Nov 23, 2025 •

edited

Loading

apolukhin commented Feb 3, 2026 •

edited

Loading

apolukhin commented Feb 10, 2026 •

edited

Loading

rklepov Feb 16, 2026 •

edited

Loading

rklepov Feb 12, 2026 •

edited

Loading

rklepov Feb 16, 2026 •

edited

Loading