Apache Commons Configuration

Инструменты для помощи в чтении файлов конфигурации/настроек в различных форматах; требуется Java 8.

Документация

Более подробную информацию можно найти на домашней странице Apache Commons Configuration. Можно ознакомиться с Javadoc. Вопросы, связанные с использованием Apache Commons Configuration, следует размещать в списке рассылки пользователей.

Получение последнего релиза Скачать исходные коды и двоичные файлы можно на нашей странице для скачивания по ссылке: https://commons.apache.org/proper/commons-configuration/download_configuration.cgi.

Также вы можете скачать их из центральных репозиториев Maven:

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-configuration2</artifactId>
  <version>2.11.0</version>
</dependency>

Сборка

Для сборки проекта вам потребуется Java JDK и Apache Maven. Необходимая версия Java указана в файле pom.xml как свойство maven.compiler.source.

Чтобы запустить все тесты и проверки, выполните команду mvn без аргументов в командной строке.

Вклад в проект

Мы принимаем запросы на внесение изменений (Pull Requests) через GitHub. Основной канал связи для участников — список рассылки разработчиков по адресу: https://commons.apache.org/mail-lists.html.

Вот несколько рекомендаций, которые облегчат нам обработку запросов:

• Используйте пробелы для отступов вместо табуляции.
• Соблюдайте существующий стиль кода для каждого файла.
• Создавайте минимальные изменения — отключите действия при сохранении, такие как переформатирование исходного кода или организация импорта. Если вы считаете, что исходный код следует переформатировать, создайте отдельный запрос на изменение для этого изменения.
• Предоставьте тесты JUnit для ваших изменений и убедитесь, что ваши изменения не нарушают существующие тесты, выполнив команду mvn.
• Прежде чем отправлять запрос на изменение, запустите команду mvn (самостоятельно), которая запускает цель по умолчанию, содержащую все проверки сборки.
• Чтобы увидеть отчёт о покрытии кода, независимо от сбоев покрытия, выполните команду mvn clean site -Dcommons.jacoco.haltOnFailure=false.

Если вы планируете регулярно вносить свой вклад, рассмотрите возможность заключения лицензионного соглашения с участником (contributor license agreement) по адресу: https://www.apache.org/licenses/#clas. Вы можете узнать больше о внесении вклада через GitHub в наших рекомендациях по внесению вклада (CONTRIBUTING.md).

Лицензия

Этот код лицензирован под лицензией Apache License v2 по адресу: https://www.apache.org/licenses/LICENSE-2.0.

Необходимые уведомления и указания атрибуции см. в файле NOTICE.txt.

Пожертвования

Вам нравится Apache Commons Configuration? Тогда сделайте пожертвование обратно в ASF по адресу: https://www.apache.org/foundation/contributing.html, чтобы поддержать разработку.

Дополнительные ресурсы:

• Домашняя страница Apache Commons: https://commons.apache.org/.
• Трекер проблем Apache (JIRA): https://issues.apache.org/jira/browse/CONFIGURATION.
• Канал Slack Apache Commons: https://the-asf.slack.com/archives/C60NVB8AD.
• Аккаунт Apache Commons в Twitter: https://twitter.com/ApacheCommons.

Компоненты Apache Commons

Пожалуйста, ознакомьтесь со списком компонентов по адресу: https://commons.apache.org/components.html.