# Expressions - 2

#### 1) Metin İşleme Fonksiyonları

* **contains(search, item)**
  * Belirtilen `search` dizesinde `item` ifadesi geçip geçmediğini kontrol eder.
  * Örnek:
    * `if: ${{ contains('Hello world', 'llo') }}` → `true` döner, çünkü “llo” “Hello world” içinde geçiyor.
    * Bir YAML satırında:

```yaml
if: ${{ contains(github.event.head_commit.message, '[deploy]') }}
```

Böylece commit mesajında `[deploy]` geçiyorsa job ya da step çalışır.

**startsWith(searchString, searchValue)**

* `searchString` değeri, `searchValue` ile başlıyor mu diye bakar.
* Gerçek senaryoda branch kontrolü:

```yaml
if: ${{ startsWith(github.ref, 'refs/heads/feature-') }}
```

Eğer branch adı `feature-` ile başlıyorsa step’i çalıştır.

**endsWith(searchString, searchValue)**

* `searchString` değeri, `searchValue` ile bitiyor mu diye bakar.
* Örnek:
  * Tag kontrolü:

```bash
if: ${{ endsWith(github.ref, '/v1.0.0') }}
```

Branch ya da tag `'v1.0.0'` ile bitiyorsa çalıştır.

#### 2) Dize Birleştirme ve Biçimlendirme

* **format(string, replaceValue0, replaceValue1, ...)**
  * Metin içindeki `{0}`, `{1}`, `{2}` alanlarını sırasıyla girilen değerlerle değiştirir.
  * Örnek:
    * `format('Hello {0} {1}', 'Mona', 'Octocat')` → `"Hello Mona Octocat"`.
    * Bir “echo” komutunda kullanmak için:

```yaml
run: echo "${{ format('Deploying version {0} to {1}', '1.2.3', 'production') }}"
```

**join(array, optionalSeparator)**

* Array (dizi) elemanlarını birleştirir, istersen araya özel bir ayırıcı (separatör) koyar.
* Örnek:
  * `join(github.event.issue.labels.*.name, ', ')` → Issue üzerindeki label isimlerini virgülle birleştirir.
  * Ya da manuel array: `join(['apple','orange','banana'], ' | ')` → `"apple | orange | banana"`.

#### 3) JSON İşleme

* **toJSON(value)**
  * Verilen değişkeni ya da nesneyi JSON formatına çevirir (string olarak).
  * Örnek:
    * `if: ${{ toJSON(job) }}` → O anki job nesnesini JSON’a döndürür (daha çok debug amaçlı).
    * Step içinde:

```yaml
run: echo '${{ toJSON(github.event) }}'
```

Bu şekilde event içeriğini JSON formatında görürsün.

**fromJSON(value)**

* JSON formatındaki bir string’i GitHub Actions içinde bir nesneye dönüştürür.
* Örnek:
  * `fromJSON('{"name": "Mona", "role": "Octocat"}').role` → `"Octocat"`.
  * Eğer `client_payload`’da karmaşık bir JSON varsa bu fonksiyonla parse edebilirsin.

#### 4) Dosya Hash Fonksiyonu

* **hashFiles(path)**
  * Belirtilen dosya/dosyaların içeriğini hash’leyip tek bir hash döndürür.
  * Örnek:
    * `hashFiles('**/package-lock.json', '**/Gemfile.lock')` → Bu dosyaların toplu içeriğinin bir karmasını (hash) üretir.
    * Genelde cache kullanırken “cache key” üretmek için kullanılır. Örnek:

```yaml
- name: Cache dependencies
  uses: actions/cache@v3
  with:
    path: node_modules
    key: ${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
```

{% embed url="<https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/evaluate-expressions-in-workflows-and-actions>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://note.onurbolatoglu.com/github-actions/expressions-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.