generator-videojs-plugin
Advanced tools
This is an opinionated Yeoman generator for Video.js plugins. It is based on the recommendations of the Video.js core team as well as tools and conventions for developing plugins at Brightcove.
To learn more about Video.js plugins and this generator's conventions and opinions, see:
Enter a package scope, if any, for npmEnter the name of this pluginEnter a description for your pluginEnter the author of this pluginChoose a license for your projectDo you want to include CSS styling, including Sass preprocessing?Do you want to support Internet Explorer 8?Do you want to include documentation support?Do you need a Video.js language file setup for internationalized strings?Do you want to support Bower with special versioning handling?What should be done before you git push?If you don't know what Yeoman is or what generators are, check out the Yeoman Getting Started document. In short, Yeoman generators are tools which simplify the setup of a new project by creating folders and files.
Note: The generator assumes you have Git installed!
First, make sure you have Yeoman and this generator installed globally:
$ npm install -g yo generator-videojs-plugin
Then, starting your Video.js plugin project is as simple as:
$ yo videojs-plugin
You will be walked through several prompts and finish with a working, buildable, testable Video.js plugin in the current directory. Of course, this plugin won't do much out of the box - that part is left to your creativity!
Enter a package scope, if any, for npmOptional! This is useful for scoped npm packages. You don't need to include the @ or / characters - only the actual scope name.
Enter the name of this pluginOnly lower-case characters, numbers, and hyphens are allowed in plugin names.
By convention, Video.js plugin names are prefixed with videojs-. The generator will add this prefix automatically; so, don't include it here. So, providing a plugin name of world will produce a plugin named videojs-world.
If a scope of hello is given above, the plugin name will be prefixed with that as well (and formatted according to npm's conventions), yielding a name of @hello/videojs-world. Again, the scope is optional.
Enter a description for your pluginPopulates the package.json description field.
Enter the author of this pluginWhen starting a new project with the generator, it will attempt to retrieve this information from your Git installation.
Follow the string formatting convention outlined for package.json people fields.
Choose a license for your projectThis provides a couple pre-configured, popular options for the package.json license field. If your preferred license isn't found, simply choose "UNLICENSED" and update it manually.
Do you want to include CSS styling, including Sass preprocessing?Respond "Y" to set up your project with a base .scss file.
Do you want to support Internet Explorer 8?Respond "Y" to include some Babel presets to polyfill missing ES5 features for IE8. See videojs-spellbook for more.
Do you want to include documentation support?Respond "Y" to include base files for documentation as well as configuration for generating API documentation. This will also include a placeholder in the README.md for generating a table of contents.
Do you need a Video.js language file setup for internationalized strings?Respond "Y" to include base files for translation and inclusion with your packaged plugin.
Do you want to support Bower with special versioning handling?Respond "Y" to set up your project with a bower.json file and, more importantly, will adjust the release process to create tags which include your dist/ directory.
What should be done before you git push?This prompt presents several options for automation via ghooks before pushing to any Git remote.
Check code quality: The default. Code must pass videojs-standard before anything can be pushed.Check code quality and run tests: Code must pass videojs-standard and unit tests must pass before anything can be pushed.Nothing: Does nothing. There are no pre-push hooks configured.By default, the generator will run npm install after it is finished. This can be a slow process and you may not always need it; so, it can be disabled (this option is provided by Yeoman itself, but it's useful and worth documenting here).
Turn installation off with: yo videojs-plugin --skip-install
By default, the generator will present the user with a series of prompts to choose various settings. This can be disabled if you've previously selected values and don't want to change them.
Turn prompts off with: yo videojs-plugin --skip-prompt
If you don't want to change configuration, but just want to update an existing plugin and skip all the other stuff (prompts, installation, "yosay"s), you can use this option to do that. You may need to run the installation manually if dependencies changed!
Turn prompts off with: yo videojs-plugin --hurry
In some cases - especially when updating previously generated projects - you may want to only update certain "meta" files without needing to deal with prompts for source files and test files you definitely do not want to overwrite. The --limit-to and --limit-to-meta option helps with this.
--limit-to accepts keys which will limit the generated files to only those specified. The possible keys are:
dotfiles: Updates only those files starting with a . and bower.json.pkg: Updates only package.json.These keys can be combined to create larger sets of files. For example, --limit-to=dotfiles,pkg will update the files matched by dotfiles and pkg.
Finally, the --limit-to-meta option is available as a shortcut for using --limit-to with all the available keys.
Update a subset of files with: yo videojs-plugin --limit-to=pkg,dotfiles
Update all "meta" files with: yo videojs-plugin --limit-to-meta
Set certain values automatically for Brightcove-authored plugins. Has the following effects:
"Brightcove, Inc."Apache-2.0 only.Turn on these Brightcove defaults with: yo videojs-plugin --bcov
Running a Yeoman generator in an empty directory poses no difficulties; however, running it against an existing project can cause conflicts. Yeoman provides a mechanism, which can be confusing because it's not clearly documented, for resolving these conflicts. It will prompt you to choose one of:
Y: yes (default)n: noa: yes to allx: exitd: diffh: helpMost of what this generator does is localized to the package.json file. Luckily, the generator does a good job of merging your existing contents with the generated contents. In general, it's safe to select Y for the package.json in your project.
Other files you'll usually want to select n on - particularly those files plugin authors will edit the most: anything in src/ or test/.
This generator provides some simple CLI programs that go beyond the basic generator behavior.
These programs can be used on any plugin project - not just those using the generator! They do not provide prompts or accept arguments or options; they do one thing only. The only expectation is that they are run in the project root of a Video.js plugin (process.cwd()).
vjsgencleanThe generator is non-destructive: it will only add to or update your project. This script will remove files and package.json fields that were removed in previous major versions of the generator.
For example, if 1.x produced the file foo/bar.js, but 2.x does not, this script will delete it.
$ vjsgenclean
Note: This script should be run after applying the latest generator version!
vjsplugincheckThis script supports validating a directory as following current Video.js Plugin Conventions. Using it is simple; run the following command:
$ vjsplugincheck
FAQs
A Yeoman generator for Video.js plugins
The npm package generator-videojs-plugin receives a total of 14 weekly downloads. As such, generator-videojs-plugin popularity was classified as not popular.
We found that generator-videojs-plugin demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 19 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.
Security News
Michigan TypeScript founder Dimitri Mitropoulos implements WebAssembly runtime in TypeScript types, enabling Doom to run after processing 177 terabytes of type definitions.
Security News
vlt's new "reproduce" tool verifies npm packages against their source code, outperforming traditional provenance adoption in the JavaScript ecosystem.
Research
Security News
Socket researchers uncovered a malicious PyPI package exploiting Deezer’s API to enable coordinated music piracy through API abuse and C2 server control.