Coder Social home page Coder Social logo

rbmhtechnology / vind Goto Github PK

View Code? Open in Web Editor NEW
24.0 8.0 11.0 6.48 MB

Vind is build to enable the integration of search facilities in java projects without getting to deep into the search topic

Home Page: https://rbmhtechnology.github.io/vind/

License: Apache License 2.0

Java 99.93% Shell 0.07%
vind java information-discovery search solr library

vind's Introduction

VIND

Please note: This project is stopped, no bugfixes, features, etc. are done anymore.

Vind (faɪnd) is a modular Java library which aims to lower the hurdle of integrating information discovery facilities in Java projects. It should help programmers to come to a good solution in an assessable amount of time, improve the maintainability of software projects, and simplify a centralized information discovery service management including monitoring and reporting.

Build Status Maven Central Sonatype Nexus (Snapshots) Javadocs Apache 2.0 License Gitter

Design principles

In Vind we try to design an API which follows this 3 design principles:

1. Versatility: Vind will be used in many different projects, so it was an aim to keeping the dependency footprint small, which avoids version-clashes in the downstream projects.

2. Backend Agnostic: Wherever possible and feasible, the library has to abstracted from the basic search framework. This enabled us to change the backend without migrating application software.

3. Flat learning curve: It was an aim to keep the learning curve rather flat, so we tried to use Java built-in constructs whenever possible. Additionally we tried to follow the concept: easy things should be easy, complex things can (but does not have to) be complex.

The search lib is modular and currently implements the following layers:

Search Lib Architecture

Versioning & release policy

Each Vind release is labeled in the repository with a tag fitting the following schema: vind-va.b.c where vind-v just points out that this belongs to a Vind version and a.b.c represents the release number, also used for the artifact version. Prior to vind-v1.3.0 there was not a clear policy on versioning.

From 1.3.0 on releases will strictly stick to the following diagram:

Versioning policy

Regarding the release process, prior to every non hot fix release, a release candidate would be published to be tested on an staging environment as close as possible to production. These releases will apply the previous described name schema followed by RCa suffix, being a the release candidate iteration number. I.e., vind-v1.3.0-RC1 would be the first release candidate for version 1.2.6 which, if rejected due to bugs found in staging environment, will be released again after fixing as vind-v1.3.0-RC2. After approval, the artifact will be released as vind-v1.3.0.

From vind-v1.3.0, all the hot fixes will be handle in a release specific maintenance branch, that means development branch should always be in an a.b.0-SNAPSHOT Vind version.

Roadmap

If you'd like to get a deeper look into the lib or if you are interested in our future goals just have a look at our blog series. There we give an outlook on the next development steps and introduce new features.

How to use

The modules of the Vind lib are provided as Maven artifacts and thus can be seamlessly integrated in new and existing Java Software projects. Vind decouples API and the real indexing components. The first backend which is also the reference implementation is build on top of Apache Solr. The lib integrates an in-memory indexer on top of an Embedded Solr Server which enables developers to start without setting up a complex infrastructure. Furthermore Vind includes a backend maintainance component which makes it easy to setup Vind index collections and keep them in sync with the Vind version.

Get a detailed documentation of all functions and features or dive deeper in the API of the Vind with Javadoc.

How to contribute

Vind is an Open Source project so everyone is encouraged to improve it. Don't hesitate to report bugs, provide fixes or share new ideas with us. We have various ways for contribution:

  • use the issue tracker - report bugs, suggest features or give hints how we can improve the documentation.
  • discuss issues with the community - two brains are better than one.
  • write code - no patch is too small. So even fixing typos helps to improve Vind.

Release Process

  • Snapshot: Pushes to branch develop are automatically deployed to sonatype snapshots. Current version: Sonatype Nexus (Snapshots)

  • Release: Stable releases need to be performed manually:

    1. make sure all changes have been pushed to the repository and all tests are working fine.
    2. run mvn release:prepare
    3. run mvn release:perform
    4. run (cd target/checkout; mvn nexus-staging:release)
    5. push changes to the repository git push && git push --tags

License

Free use of this software is granted under the terms of the Apache License Version 2.0. See the License for more details.

Authors

Vind is lead by Red Bull Media House Technology and was initiated in 2017.

Changelog

The Changelog provides a complete list of changes in older releases.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.