Product
Introducing License Enforcement in Socket
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
CLI for managing and developing ArangoDB Foxx services.
foxx-cli is a standalone tool for the shell that can be used to talk to ArangoDB servers to manage Foxx services.
To learn more about Foxx, see the official ArangoDB Foxx documentation.
foxx-cli runs on Node.js and can be installed with yarn:
yarn global add foxx-cli
Or with npm:
npm install --global foxx-cli
Note: using yarn you can also run foxx-cli from your project's
devDependencies
:
yarn add --dev foxx-cli
yarn foxx help
If you're using a recent version of npm you can also use npx:
npx -p foxx-cli foxx help
After you've installed foxx-cli, you should be able to use the foxx
program. You can learn more about the different commands foxx
supports by
using the --help
flag.
foxx --help
You can also use the --help
flag with commands to learn more about them, e.g.:
foxx install --help # Help for the "install" command
foxx server --help # Help for the "server" command
foxx server list --help # Subcommands are supported, too
The manifest.json
or manifest file contains a service's meta-information. For
more information on the manifest format, see the
official ArangoDB documentation.
The directory containing a service's manifest.json
file is called the root
directory of the service.
If you want to exclude files from the service bundle that will uploaded to
ArangoDB you can create a file called .foxxignore
in the root directory of
your service. Each line should specify one pattern you wish to ignore:
Patterns starting with !
will be treated as an explicit whitelist. Paths
matching these patterns will not be ignored even if they would match any of
the other patterns.
Example: !index.js
will override any pattern matching a file called
index.js
.
Patterns starting with /
will only match paths relative to the service's
root directory.
Example: /package.json
will not match node_modules/joi/package.json
.
Patterns ending with /
will match a directory and any files inside of it.
Example: node_modules/
will exclude all node_modules
directories and
all of their contents.
A single *
(glob) will match zero or more characters (even dots) in a file
or directory name.
Example: .*
will match any files and directories with a name starting
with a dot.
A double **
(globstar) will match zero or more levels of nesting.
Example: hello/**/world
will match hello/world
, hello/foo/world
,
hello/foo/bar/world
, and so on.
Patterns starting with #
are considered comments and will be ignored.
For more details on the pattern matching behaviour, see the documentation of the
minimatch module (with the dot
flag
enabled).
If no .foxxignore
file is present in the service's root directory the
following patterns will be ignored automatically: .git/
, .svn/
, .hg/
,
*.swp
, .DS_Store
.
Should you need to include files that match these patterns for some reason, you
can override this list by creating an empty .foxxignore
file.
You can also create a .foxxignore
file in the current directory using the
ignore
command:
foxx ignore # creates a file pre-populated with the defaults
foxx ignore --force # creates an empty file
To add individual patterns to the .foxxignore
file just pass them as
additional arguments:
foxx ignore .git/ .svn/ # you can pass multiple patterns at once
foxx ignore '*.swp' # make sure to escape special characters
If you define servers using the server
commands, a .foxxrc
file will be
created in your $HOME
directory, which is typically one of the following
paths:
/home/$USER
on Linux
/Users/$USER
on macOS
C:\Users\$USER
on Windows
This file contains sections for each server which may contain server credentials should you decide to save them.
Feel free to dive in! Open an issue or submit PRs.
All JavaScript code should conform to standard coding style.
This README conforms to the standard-readme specification.
The Apache License, Version 2.0. For more information, see the accompanying LICENSE file.
[1.0.0] - 2018-03-21
FAQs
CLI for ArangoDB Foxx.
The npm package foxx-cli receives a total of 100 weekly downloads. As such, foxx-cli popularity was classified as not popular.
We found that foxx-cli demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
Product
We're launching a new set of license analysis and compliance features for analyzing, managing, and complying with licenses across a range of supported languages and ecosystems.
Product
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.