Skip to content

Commit

Permalink
Merge pull request #157 from arduino/per1234/update-product-name
Browse files Browse the repository at this point in the history
Use "Arduino Lint" as the project name
  • Loading branch information
per1234 authored Jan 12, 2021
2 parents 9c045ec + 4c62d7f commit bf0d1b4
Show file tree
Hide file tree
Showing 77 changed files with 185 additions and 185 deletions.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# arduino-lint
# Arduino Lint

[![Tests Status](https://github.com/arduino/arduino-lint/workflows/Run%20tests/badge.svg)](https://github.com/arduino/arduino-lint/actions?workflow=Run+tests)
[![Nightly Status](https://github.com/arduino/arduino-lint/workflows/Nightly%20build/badge.svg)](https://github.com/arduino/arduino-lint/actions?workflow=Nightly+build)
[![Docs Status](https://github.com/arduino/arduino-lint/workflows/Publish%20documentation/badge.svg)](https://github.com/arduino/arduino-lint/actions?workflow=Publish+documentation)

**arduino-lint** is a command line tool that checks for common problems in [Arduino](https://www.arduino.cc/) projects:
**Arduino Lint** is a command line tool that checks for common problems in [Arduino](https://www.arduino.cc/) projects:

- Sketches
- Libraries
Expand All @@ -16,7 +16,7 @@ For usage instructions, see [the documentation](https://arduino.github.io/arduin

## Continuous Integration

There is a GitHub Actions action that makes it easy to use **arduino-lint**` in your CI workflows!
There is a GitHub Actions action that makes it easy to use **Arduino Lint**` in your CI workflows!

See https://github.com/arduino/arduino-lint-action for more information.

Expand Down
18 changes: 9 additions & 9 deletions docs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,10 @@ There are several ways you can get involved:

## Issue Reports

Do you need help or have a question about using arduino-lint? Support requests should be made to the
Do you need help or have a question about using Arduino Lint? Support requests should be made to the
[Arduino forum](https://forum.arduino.cc/index.php?board=3.0).

High quality bug reports and feature requests are valuable contributions to the arduino-lint project.
High quality bug reports and feature requests are valuable contributions to the Arduino Lint project.

### Before reporting an issue

Expand Down Expand Up @@ -63,7 +63,7 @@ submitting a PR:
- <a id="breaking"></a> If the PR contains a breaking change, please start the commit message and PR title with the
string **[breaking]**. Don't forget to describe in the PR description what changes users might need to make in their
workflow or application due to this PR. A breaking change is a change that forces users to change their command-line
invocations or parsing of the JSON formatted output when upgrading from an older version of arduino-lint.
invocations or parsing of the JSON formatted output when upgrading from an older version of Arduino Lint.
- PR titles indirectly become part of the CHANGELOG so it's crucial to provide a good record of **what** change is being
made in the title; **why** it was made will go in the PR description, along with
[a link to a GitHub issue](https://docs.github.com/en/free-pro-team@latest/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)
Expand All @@ -76,7 +76,7 @@ submitting a PR:

### Development prerequisites

To build arduino-lint from sources you need the following tools to be available in your local environment:
To build Arduino Lint from sources you need the following tools to be available in your local environment:

- [Go](https://golang.org/doc/install) version 1.14 or later
- [Taskfile](https://taskfile.dev/#/installation) to help you run the most common tasks from the command line
Expand Down Expand Up @@ -123,7 +123,7 @@ To run only the Go unit tests, run:
task go:test-unit
```

By default, all tests for all arduino-lint's Go packages are run. To run unit tests for only one or more specific
By default, all tests for all Arduino Lint's Go packages are run. To run unit tests for only one or more specific
packages, you can set the `TARGETS` environment variable, e.g.:

```
Expand All @@ -144,11 +144,11 @@ TEST_REGEX='^TestFindProjects$' TARGETS=./internal/project task go:test-unit

#### Integration tests

Being a command line interface, arduino-lint is heavily interactive and it has to stay consistent in accepting the user
Being a command line interface, Arduino Lint is heavily interactive and it has to stay consistent in accepting the user
input and providing the expected output and proper exit codes.

For these reasons, in addition to regular unit tests the project has a suite of integration tests that actually run
arduino-lint in a different process and assess the options are correctly understood and the output is what we expect.
`arduino-lint` in a different process and assess the options are correctly understood and the output is what we expect.

##### Running tests

Expand Down Expand Up @@ -227,7 +227,7 @@ https://arduino.github.io/arduino-lint/dev/
#### Local development

The documentation consists of static content written over several Markdown files under the `docs` subfolder of the
arduino-lint repository, as well as the dynamically generated [command line reference](commands/arduino-lint.md).
Arduino Lint repository, as well as the dynamically generated [command line reference](commands/arduino-lint.md).

When working on the documentation, it is useful to be able to see the effect the changes will have on the generated
documentation website. You can build the documentation website and serve it from your personal computer by running the
Expand Down Expand Up @@ -269,7 +269,7 @@ Checks are automatically run on every pull request to verify that documentation

#### Documentation publishing

The arduino-lint git repository has a special branch called `gh-pages` that contains the generated HTML code for the
The Arduino Lint git repository has a special branch called `gh-pages` that contains the generated HTML code for the
documentation website. Every time a change is pushed to this special branch, GitHub automatically triggers a deployment
to pull the change and publish a new version of the website. Do not open Pull Requests to push changes to the `gh-pages`
branch; that will be done exclusively from the CI.
Expand Down
20 changes: 10 additions & 10 deletions docs/build.py
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# This file is part of arduino-lint.
# This file is part of Arduino Lint.

# Copyright 2020 ARDUINO SA (http://www.arduino.cc/)

# This software is released under the GNU General Public License version 3,
# which covers the main part of arduino-lint.
# which covers the main part of Arduino Lint.
# The terms of this license can be found at:
# https://www.gnu.org/licenses/gpl-3.0.en.html

Expand All @@ -21,37 +21,37 @@
import click
from git import Repo

# In order to provide support for multiple arduino-lint releases, Documentation is versioned so that visitors can select
# In order to provide support for multiple Arduino Lint releases, Documentation is versioned so that visitors can select
# which version of the documentation website should be displayed. Unfortunately this feature isn't provided by GitHub
# pages or MkDocs, so we had to implement it on top of the generation process.
#
# Before delving into the details of the generation process, here follow some requirements that were established to
# provide versioned documentation:
#
# - A special version of the documentation called `dev` is provided to reflect the status of the arduino-lint on the
# - A special version of the documentation called `dev` is provided to reflect the status of Arduino Lint on the
# `main` branch - this includes unreleased features and bugfixes.
# - Docs are versioned after the minor version of an arduino-lint release. For example, arduino-lint `0.99.1` and
# - Docs are versioned after the minor version of an Arduino Lint release. For example, Arduino Lint `0.99.1` and
# `0.99.2` will be both covered by documentation version `0.99`.
# - The landing page of the documentation website will automatically redirect visitors to the documentation of the most
# recently released version of arduino-lint.
# recently released version of Arduino Lint.
#
# To implement the requirements above, the execution of MkDocs is wrapped using a CLI tool called Mike
# (https://github.com/jimporter/mike) that does a few things for us:
#
# - It runs MkDocs targeting subfolders named after the arduino-lint version, e.g. documentation for version `0.10.1`
# - It runs MkDocs targeting subfolders named after the Arduino Lint version, e.g. documentation for version `0.10.1`
# can be found under the folder `0.10`.
# - It injects an HTML control into the documentation website that lets visitors choose which version of the docs to
# browse from a dropdown list.
# - It provides a redirect to a version we decide when visitors hit the landing page of the documentation website.
# - It pushes generated contents to the `gh-pages` branch.
#
# In order to avoid unwanted changes to the public website hosting the arduino-lint documentation, only Mike is allowed
# In order to avoid unwanted changes to the public website hosting the Arduino Lint documentation, only Mike is allowed
# to push changes to the `gh-pages` branch, and this only happens from within the CI, in the "Publish documentation"
# workflow: https://github.com/arduino/arduino-lint/blob/main/.github/workflows/publish-docs.yml
#
# The CI is responsible for guessing which version of arduino-lint we're building docs for, so that generated content
# The CI is responsible for guessing which version of Arduino Lint we're building docs for, so that generated content
# will be stored in the appropriate section of the documentation website. Because this guessing might be fairly complex,
# the logic is implemented in this Python script. The script will determine the version of arduino-lint that was
# the logic is implemented in this Python script. The script will determine the version of Arduino Lint that was
# modified in the current commit (either `dev` or an official, numbered release) and whether the redirect to the latest
# version that happens on the landing page should be updated or not.

Expand Down
20 changes: 10 additions & 10 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
**arduino-lint** is a command line tool that checks for common problems with [Arduino](https://www.arduino.cc/)
**Arduino Lint** is a command line tool that checks for common problems with [Arduino](https://www.arduino.cc/)
projects.

Its focus is on the structure, metadata, and configuration of Arduino projects, rather than the code. Rules cover
Expand All @@ -18,7 +18,7 @@ arduino-lint

This will automatically detect the project type and check it against the relevant rules.

The default configuration of **arduino-lint** provides for the most common use case, but you have the option of changing
The default configuration of **Arduino Lint** provides for the most common use case, but you have the option of changing
settings via [command line flags](commands/arduino-lint.md):

### Compliance setting
Expand All @@ -42,7 +42,7 @@ accepted by this flag are:
updates of Arduino libraries. In order to be accepted for inclusion in Library Manager, a library is required to meet
[some requirements](https://github.com/arduino/Arduino/wiki/Library-Manager-FAQ).

**arduino-lint** provides checks for these requirements as well, controlled by the `--library-manager` flag.
**Arduino Lint** provides checks for these requirements as well, controlled by the `--library-manager` flag.

The Library Manager submission-specific rules are enabled via `--library-manager submit`. Even if your library isn't yet
ready to be added to Library Manager, it's a good idea to use this setting to ensure no incompatibilities are
Expand All @@ -54,11 +54,11 @@ tell you whether your library is compliant with these rules.

### Integration

The `--format` flag configures the format of **arduino-lint**'s output. The default `--format text` setting provides
human readable output. For automation or integration with other tools, the machine readable output provided by
`--format json` may be more convenient. This setting exposes every detail of the rules that were applied.
The `--format` flag configures the format of `arduino-lint`'s output. The default `--format text` setting provides human
readable output. For automation or integration with other tools, the machine readable output provided by `--format json`
may be more convenient. This setting exposes every detail of the rules that were applied.

The `--report-file` flag causes **arduino-lint** to write the JSON output to the specified file.
The `--report-file` flag causes `arduino-lint` to write the JSON output to the specified file.

### Environment variables

Expand All @@ -72,7 +72,7 @@ Additional configuration options intended for internal use or development can be

## Continuous integration

**arduino-lint** would be a great addition to your
**Arduino Lint** would be a great addition to your
[continuous integration](https://en.wikipedia.org/wiki/Continuous_integration) system. Running the tool after each
change to the project can allow you to identify any problems that were introduced.

Expand All @@ -81,11 +81,11 @@ This is easily done by using the `arduino/arduino-lint-action`
https://github.com/arduino/arduino-lint-action

Add [a simple workflow file](https://github.com/arduino/arduino-lint-action#usage) to the repository of your Arduino
project and GitHub will automatically run arduino-lint on every pull request and push.
project and GitHub will automatically run Arduino Lint on every pull request and push.

## Support and feedback

You can discuss or get assistance with using **arduino-lint** on the
You can discuss or get assistance with using **Arduino Lint** on the
[Arduino Forum](https://forum.arduino.cc/index.php?board=3.0).

Feedback is welcome! Please submit feature requests or bug reports to the
Expand Down
12 changes: 6 additions & 6 deletions docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
The script requires `sh`, which is always available on Linux and macOS. `sh` is not available by default on Windows. The
script can be run on Windows by installing [Git for Windows](https://gitforwindows.org/), then running it from Git Bash.

This script will install the latest version of arduino-lint to `$PWD/bin`:
This script will install the latest version of Arduino Lint to `$PWD/bin`:

```
curl -fsSL https://raw.githubusercontent.com/arduino/arduino-lint/main/etc/install.sh | sh
Expand All @@ -15,10 +15,10 @@ If you want to target a different directory, for example `~/local/bin`, set the
curl -fsSL https://raw.githubusercontent.com/arduino/arduino-lint/main/etc/install.sh | BINDIR=~/local/bin sh
```

If you would like to use the `arduino-lint` command from any location, install arduino-lint to a directory already in
your `PATH` or add the arduino-lint installation path to your `PATH` environment variable.
If you would like to use the `arduino-lint` command from any location, install Arduino Lint to a directory already in
your `PATH` or add the Arduino Lint installation path to your `PATH` environment variable.

If you want to download a specific arduino-lint version, for example `0.9.0` or `nightly-latest`, pass the version
If you want to download a specific Arduino Lint version, for example `0.9.0` or `nightly-latest`, pass the version
number as a parameter like this:

```
Expand All @@ -30,7 +30,7 @@ curl -fsSL https://raw.githubusercontent.com/arduino/arduino-lint/main/etc/insta
Pre-built binaries for all the supported platforms are available for download from the links below.

If you would like to use the `arduino-lint` command from any location, extract the downloaded file to a directory
already in your `PATH` or add the arduino-lint installation path to your `PATH` environment variable.
already in your `PATH` or add the Arduino Lint installation path to your `PATH` environment variable.

#### Latest release

Expand Down Expand Up @@ -81,5 +81,5 @@ Checksums for the nightly builds are available at

### Build from source

If you’re familiar with Golang or if you want to contribute to the project, you will probably build arduino-lint locally
If you’re familiar with Golang or if you want to contribute to the project, you will probably build Arduino Lint locally
with your Go toolchain. See the ["How to contribute"](CONTRIBUTING.md#building-the-source-code) page for instructions.
2 changes: 1 addition & 1 deletion docsgen/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
// Arduino software without disclosing the source code of your own applications.
// To purchase a commercial license, send an email to [email protected].

// Package main generates Markdown documentation for the arduino-lint CLI.
// Package main generates Markdown documentation for the Arduino Lint CLI.
package main

import (
Expand Down
4 changes: 2 additions & 2 deletions etc/install.sh
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@
#
# Usage:
#
# To install the latest version of arduino-lint:
# To install the latest version of Arduino Lint:
# ./install.sh
#
# To pin a specific release of arduino-lint:
# To pin a specific release of Arduino Lint:
# ./install.sh 0.9.0
#

Expand Down
8 changes: 4 additions & 4 deletions internal/cli/cli.go
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
// This file is part of arduino-lint.
// This file is part of Arduino Lint.
//
// Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
//
// This software is released under the GNU General Public License version 3,
// which covers the main part of arduino-lint.
// which covers the main part of Arduino Lint.
// The terms of this license can be found at:
// https://www.gnu.org/licenses/gpl-3.0.en.html
//
Expand All @@ -13,7 +13,7 @@
// Arduino software without disclosing the source code of your own applications.
// To purchase a commercial license, send an email to [email protected].

// Package cli defines the arduino-lint command line interface.
// Package cli defines the Arduino Lint command line interface.
package cli

import (
Expand All @@ -25,7 +25,7 @@ import (
func Root() *cobra.Command {
rootCommand := &cobra.Command{
Short: "Linter for Arduino projects.",
Long: "arduino-lint checks for specification compliance and other common problems with Arduino projects",
Long: "Arduino Lint checks for specification compliance and other common problems with Arduino projects",
DisableFlagsInUseLine: true,
Use: "arduino-lint [FLAG]... [PROJECT_PATH]...\n\nLint project in PROJECT_PATH or current path if no PROJECT_PATH argument provided.",
Run: command.ArduinoLint,
Expand Down
4 changes: 2 additions & 2 deletions internal/command/command.go
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
// This file is part of arduino-lint.
// This file is part of Arduino Lint.
//
// Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
//
// This software is released under the GNU General Public License version 3,
// which covers the main part of arduino-lint.
// which covers the main part of Arduino Lint.
// The terms of this license can be found at:
// https://www.gnu.org/licenses/gpl-3.0.en.html
//
Expand Down
8 changes: 4 additions & 4 deletions internal/configuration/configuration.go
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
// This file is part of arduino-lint.
// This file is part of Arduino Lint.
//
// Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
//
// This software is released under the GNU General Public License version 3,
// which covers the main part of arduino-lint.
// which covers the main part of Arduino Lint.
// The terms of this license can be found at:
// https://www.gnu.org/licenses/gpl-3.0.en.html
//
Expand All @@ -13,7 +13,7 @@
// Arduino software without disclosing the source code of your own applications.
// To purchase a commercial license, send an email to [email protected].

// Package configuration handles the configuration of the arduino-lint tool.
// Package configuration handles the configuration of the Arduino Lint tool.
package configuration

import (
Expand Down Expand Up @@ -205,7 +205,7 @@ func Version() string {

var commit string

// Commit returns the HEAD commit of the arduino-lint repository when the application was built.
// Commit returns the HEAD commit of the Arduino Lint repository when the application was built.
func Commit() string {
return commit
}
Expand Down
4 changes: 2 additions & 2 deletions internal/configuration/configuration_test.go
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
// This file is part of arduino-lint.
// This file is part of Arduino Lint.
//
// Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
//
// This software is released under the GNU General Public License version 3,
// which covers the main part of arduino-lint.
// which covers the main part of Arduino Lint.
// The terms of this license can be found at:
// https://www.gnu.org/licenses/gpl-3.0.en.html
//
Expand Down
4 changes: 2 additions & 2 deletions internal/configuration/defaults.go
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
// This file is part of arduino-lint.
// This file is part of Arduino Lint.
//
// Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
//
// This software is released under the GNU General Public License version 3,
// which covers the main part of arduino-lint.
// which covers the main part of Arduino Lint.
// The terms of this license can be found at:
// https://www.gnu.org/licenses/gpl-3.0.en.html
//
Expand Down
Loading

0 comments on commit bf0d1b4

Please sign in to comment.