Skip to content
This repository has been archived by the owner on Dec 25, 2023. It is now read-only.

Commit

Permalink
Merge branch 'elenatorro-master'
Browse files Browse the repository at this point in the history
* elenatorro-master:
  some fixes
  README revised
  Update README.md
  • Loading branch information
Kikobeats committed May 29, 2015
2 parents a6850ac + a7578be commit c0731ad
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 33 deletions.
64 changes: 32 additions & 32 deletions README.md
Expand Up @@ -18,12 +18,12 @@
## Why?

- Separates the process of create software to publish software.
- Synchronizes, unifies and publishes your software version in the different packages managers.
- Easy to integrate with current or new projects.
- Associates actions before or after publish your software *(not yet, but soon!)*.
- Separates the processes of creating and publishing software.
- Syncronizes, unifies and publishes different software versions into the different package managers.
- Easy to integrate it with both with your current and new projects.
- Associated actions before or after publishing your software *(not yet, but soon!)*.

**Bumped** synchronizes the version of your software across different package managers configuration files (npm, bower,...) and controls, edits and releases the version for be sure that is the same in all the files.
**Bumped** synchronizes your software version across different package manager configuration files (npm, bower,...) and controls, edits and releases each of its versions to ensure all the files have the same version.

Because writing software is hard enough, we must make the publishing process of software simple and effective.

Expand All @@ -37,19 +37,18 @@ npm install bumped -g

### .init

The first command that you need to run is `bumped init`. If you run it in a totally blank project, you
see something like:
The first command that you need to run is `bumped init`. If you run it in a totally blank project, you'll see something like this:

```bash
$ bumped init

warn : It has been impossible to detect files automatically.
warn : Try to add manually with 'add' command.
warn : There aren't a version declared.
warn : There isn't version declared.
success : Config file created!.
```
But running it in a project with common package managers configuration files `package.json` or `bower.json` the magic begins to appear:
The magic appears when running it in a project with common package manager configuration files, for instance, like `package.json` or `bower.json`:
```bash
$ bumped init
Expand All @@ -59,47 +58,47 @@ info : Current version is '1.0.1'.
success : Config file created!.
```
At this moment, **Bumped** will create a configuration file `.bumpedrc` that is associate with the folder of the project. If you open the files this content a list of files to syncrhonizes:
At this moment, **Bumped** creates a configuration file `.bumpedrc`, which is associated with the project folder. If you open this file, its content is a list made up of all the synchronized files:
```cson
files: [
"package.json"
]
```
The format of the file is [CSON](https://github.com/bevry/cson), However you can use JSON, but this file is auto-generate for **Bumped**.
The file format is [CSON](https://github.com/bevry/cson). You can also use JSON format, however, this file is auto-generated by **Bumped**.
### .version
When you are not sure what is the current version synchronized across your configuration files just run `bumped version`:
If you're not sure what the current synchronized version across your configuration files, then run `bumped version`:

```bash
$ bumped version
info : Current version is '1.0.0'.
```

The shared version of the files is the major version detected between them. However, will not be syncrhonized until the next releases.
The shared version is the major version detected in them. On the other hand, it will not be syncrhonized until the next release.

### .release

It's moment to release a new version of your sofware. You can do this in two different ways.
It's moment to release a new version of your sofware. You can do this in two different ways:
- Providing the exact version that you want to release
- Providing the exact version that you want to release.
- Providing the semantic semver version to release (using the keywords `major`, `minor`, `patch`,...
In both cases the unique requisite is that the version to be releases want to be major that the current version.
In both cases, the only requisite is that the version to be released has to be major than the current version.
For example, if your current version is `1.0.0` and you want to release the version `1.1.0` you can do:
For example, if your current version is `1.0.0` and you want to release to the version `1.1.0`, you can do:
```bash
$ bumped release 1.1.0
success : Releases version '1.1.0'.
```
or, if you prefer a more semantic semver way to do the same you can do:
Or, if you prefer a more semantic semver way to do the same, you simply can do:
```bash
$ bumped release minor
Expand All @@ -109,17 +108,17 @@ success : Releases version '1.1.0'.
### .add
In the beginning **Bumped** automatically detect common configuration files of the most popular packages managers, but maybe you need to add one manually.
In the beginning, **Bumped** automatically detects common configuration files from the most popular packages managers, but you may need to add one manually.
For example, I want to add a new file called `component.json` that have the version setted to `2.0.0`:
For example, I want to add a new file called `component.json` that which version setted to `2.0.0`:
```json
{
"version": "2.0.0"
"version": "2.0.0"
}
```
For do it, use `bumped add` command:
I can be done typing `bumped add`:
```bash
$ bumped add component.json
Expand All @@ -128,27 +127,28 @@ info : Detected 'component.json' in the directory.
success : 'component.json' has been added.
```
If you check now the `.bumpedrc` file the list of configuration files as been updated:
If you check now the `.bumpedrc` file, the list of configuration files has been updated:
```cson
files: [
"package.json"
"component.json"
]
```
If you type now `bumped version` you can check that the share version has changed:
If you type now `bumped version`, you can check that the shared version has changed:
```bash
$ bumped version
info : Current version is '2.0.0'.
```
Because is the most major version shared between the configuration files.
The version is setted to 2.0.0 because it's the major version between all the configuration files.

### .remove

If you decide to remove a file, just use `remove` command:
If you decide to remove a file, just use the `remove` command:

```
bumped remove component.json
Expand All @@ -158,16 +158,16 @@ info : 'component.json' has been removed.

## What's next?

The really interesting in **Bumped** is the posibility to associate *hooks* before or after a release action. For example, imagine that, when you going to release a new version of your software:

- Run a grunt/gulp task for generate a build.
The most interesting aspect in **Bumped** is the posibility to associate *hooks* before or after a release action. Usually, every time you releases a new version of your software, you always have to accomplish several tasks:
- Run a grunt/gulp task to generate a build.
- Lint the code.
- Create a tagged version using `git`.
- Pushing the code in a `git` repository.
- Push the code to a `git` repository.
- Check if you are using dependencies with vulnerabilities using [NSP](https://nodesecurity.io).

And, basically, whatever that you want.
And, basically, whatever that you need.

Because the core is stable and usable, I decided release early without this feature, but only need a little of time!
Due to the core is stable and usable, I decided to release early without this new feature. I just need a little bit of time!

## License

Expand Down
2 changes: 1 addition & 1 deletion lib/Bumped.messages.coffee
Expand Up @@ -16,6 +16,6 @@ module.exports =
NOT_DETECTED_FILE : (file) -> "'#{file}' hasn\'t been detected in the directory."
NOT_VALID_VERSION : (version) -> "version '#{version}' provided to release is not valid."
NOT_GREATER_VERSION : (last, old) -> "version '#{last}' is not greater that the current '#{old}' version."
NOT_CURRENT_VERSION : -> 'There aren\'t a version declared.'
NOT_CURRENT_VERSION : -> 'There isn\'t version declared.'
NOT_AUTODETECTED : -> "It has been impossible to detect files automatically."
NOT_AUTODETECTED_2 : -> "Try to add manually with 'add' command."

0 comments on commit c0731ad

Please sign in to comment.