Git Product home page Git Product logo

vpkg's Introduction

vpkg Latest version Build status

vpkg is an alternative package manager written on V for V.

Features

Bringing the best of dependency management on V.

  • Decentralized. Download and use packages from other sources aside from VPM and the vpkg registry.
  • Easy to use. Set-up, use, and master the commands of vpkg CLI within minutes.
  • Fast. Runs perfectly on your potato PC up to the fastest supercomputers.
  • Interoperable. Supports v.mod, and .vpm.json for reading package manifests and managing dependencies.
  • Light. Weighs at less than 300kb. Perfect with devices running on tight storage or in low network conditions.
  • Reliable. Uses a lockfile mechanism to ensure that all your dependencies work across all of your machines.

Installation

Pre-built binaries

Install vpkg by downloading the pre-built binaries available found below the release notes of the latest release.

Building from Source

For those platforms which aren't included in the available pre-built binaries or would like to compile it by yourself, just clone this repository and build directly with the V compiler with the -prod flag.

git clone https://github.com/vpkg-project/vpkg.git
cd vpkg/
v -prod .

Running your own registry

Use the provided registry server template to start running your own registry server. Just modify registry.json and use any HTTP or web library of your choice to get up and running.

Commands

Usage: vpkg <COMMAND> [ARGS...] [options]

COMMANDS

get [packages]                             Fetch and installs packages from the registry or the git repo.
help                                       Show this help message.
info                                       Show project's package information.
init                                       Create a package manifest file into the current directory. Defaults to "vpkg".
install                                    Read the package manifest file and installs the necessary packages.
link                                       Symlink current module/package to ".vmodules" folder.
migrate manifest                           Migrate manifest file to a specified format.
release                                    Release a new version of the module.
remove [packages]                          Remove packages
test                                       Test the current lib/app.
update                                     Update the packages.
unlink                                     Remove the symlink of current module/package from ".vmodules" folder.
version                                    Show the version of this program.

OPTIONS

--files [file1,file2]                      Specifiy other locations of test files (For "test" command)
--force                                    Force download the packages.
--format [vpkg|vmod]                       Specifiy file format used to init manifest. (For "migrate" and "init" commands)
--global, -g                               Install the modules/packages into the ".vmodules" folder.
--inc [major|minor|patch]                  Increment the selected version of the module/package. (For "release" command)
--state [state_name]                       Indicate the state of the release (alpha, beta, fix) (For "release" command)

vpkg API

Use vpkg as a module that you can use to integrate into your own programs. Create your own VSH scripts, automated installation, and more without needing a separate CLI program.

// install.v
module main

import vpkg.api as vpkg // or import nedpals.vpkg.api as vpkg

fn main() {
    mut inst := vpkg.new('.')
    inst.run(['install'])

    os.system('rm ${os.executable()}')
}
$ v run install.v
Installing packages
Fetching nedpals.vargs

vargs@fc193513733c2ed99467f5d903a824ea9087ed52
1 package was installed successfully.

Roadmap

  • ability to publish packages into VPM and the vpkg registry.
  • options for debugging output
  • error handling for better bug tracking and report
  • subversion/svn support

Copyright

(C) 2019 Ned Palacios

vpkg's People

Contributors

nedpals avatar dhonx avatar alexesprit avatar vulpivia avatar djoodle avatar torbencarstens avatar eregnier avatar

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.