Skip to content

Commit

Permalink
feat: add README.md (#13)
Browse files Browse the repository at this point in the history
#5 Resolved
  • Loading branch information
DmitryDodzin authored Nov 24, 2021
1 parent 1491dc9 commit c388efe
Show file tree
Hide file tree
Showing 3 changed files with 84 additions and 0 deletions.
74 changes: 74 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
> This project is still in development and api may change
# Mol

Mol - מו"ל (Motzi Laor) is a versioning and publishig toolset with much inspiration from [atlasian/changesets](https://github.com/atlassian/changesets) but with no specific coupling to any package mananger or versioning scheme.

## cargo-mol

Cargo + Semantic Versioning implemintation of Mol bundled with current version of Mol

```bash
cargo install mol
cargo mol --help
```

Most of the api is ithere cli wizzard or very similar to [changesets](https://github.com/atlassian/changesets)

### 101 Commands

Create a new changeset to describe the change you are plannig to add
```bash
cargo mol add -v patch -p packge1 -p package2 -m "I did some changes"

# what changed
# + .changeset/lorem_ipsum.md >
# + ---
# + packge1: patch
# + package2: patch
# + ---
# +
# + I did some changes
# +
```

Now when you want to update all the versions you requested. Packages will be updated by the most severe version that is requested, ie 0.1.4 + (patch + patch + minor) == 0.2.0
```bash
cargo mol version

# what changed
# - .changeset/lorem_ipsum.md
# - .changeset/lorem_minor.md
# ~ CHANGELOG.md >
# ~ # package1
# ~
# + ## 0.8.0
# +
# + ### Minor Changes
# +
# + - I did some minor changes i did
# +
# + ### Patch Changes
# +
# + - I did some changes
# +
# ~
# ~ ## 0.7.1
```


#### mol --dry-run

You can always preview the changes you are about to add by runnig with --dry-run before the coomand

```bash
cargo mol --dry-run version

# Will print out all the changes that would have happend
```

## Roadmap
- [ ] Plugins
- [ ] mol-nodejs (npm/yarn)
- [ ] mol-pip
- [ ] mol-maven?
5 changes: 5 additions & 0 deletions crates/mol-cargo/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
> This project is still in development and api may change
# mol-cargo

Cargo bindings for [mol](https://github.com/DmitryDodzin/mol) essential for cargo-mol (the bundled cargo cli)
5 changes: 5 additions & 0 deletions crates/mol-core/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
> This project is still in development and api may change
# mol-core

Core library for [mol](https://github.com/DmitryDodzin/mol) cli tool

0 comments on commit c388efe

Please sign in to comment.