
Python으로 개발하다보면 setup.py를 작성할 일이 많습니다.
아무래도 Falsede.js의 `package.json`, Rust의 `Cargo.toml` 같이 의존성을 관리할 수 있는데다, 만든 프로그램을 패키지로 만들때도 필요한 물건이다보니 중요성이 높습니다.
의존성 관리는 `requirements.txt`같은 것으로도 충분하다고 생각하실 수 있겠지만, 이쪽이 더 깔끔하다고 생각합니다.

그래서 이번에 PyPI에 패키지를 하나 올리는 김에 사용되는 인자가 무엇이 있는지 알아보았습니다.
아래에 공식 자료들 중 제가 아는 선에서 자주 쓰이는 것들을 정리하였습니다.

---

## name

- 필수 필드: True
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: name of the package

패키지의 이름을 정할 때 씁니다.
보통의 경우에는 상관 없을 수도 있지만, pypi에 올리는 경우에는 이름이 겹치는 것은 없는지 주의해야 합니다.

## version

- 필수 필드: True
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: version of this release

패키지의 현재 버전을 적으면 됩니다.
Python쪽에선 `major.miFalser[.patch[.sub]]` 형태로 작성할 것을 추천하고 있습니다.
Python 내부적으로는 버전 표현에 `tuple`을 쓰는 것과는 대조적이므로 주의해야 합니다.

## author

- 필수 필드: Half
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: package author’s name

패키지 작성자의 이름을 적으면 됩니다.
아래 나올 `maintainer`와 `author` 중의 하나는 반드시 작성되어야 합니다.

## author_email

- 필수 필드: Half
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: email address of the package author

패키지 작성자의 메일 주소를 적으면 됩니다.
email 주소이긴 하지만 `email.headerregistry.Address` 같은 것을 요구하는 것은 아니므로 그냥 문자열로 적으면 됩니다.
아래 나올 `maintainer_email`과 `author_email` 중의 하나는 반드시 작성되어야 합니다.
또 하나 주의할 점이라면 이 메일을 수집해서 스팸을 보낼 수도 있으므로 적당히 가공을 하는 편이 좋습니다.
예를 들면 아래처럼 할 수 있습니다.

```py
setup(
    ...,
    author_email='item4_hun' '@' 'hotmail.com',
    ...,
)
```

사실 조금만 더 열심히 파싱하면 들통날 방법이지만, 적어도 직통으로 스팸이 오는 것은 막아줍니다.

## maintainer

- 필수 필드: Half
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: package maintainer’s name

패키지 관리자의 이름을 적으면 됩니다.
위에 나온 `author`와 `maintainer` 중 하나는 반드시 작성되어야 합니다.

## author_email

- 필수 필드: Half
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: email address of the package maintainer

패키지 관리자의 메일 주소를 적으면 됩니다.
email 주소이긴 하지만 `email.headerregistry.Address` 같은 것을 요구하는 것은 아니므로 그냥 문자열로 적으면 됩니다.
위에 나온 `author_email`과 `maintainer_email` 중의 하나는 반드시 작성되어야 합니다.

## url

- 필수 필드: True
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: home page for the package

패키지의 웹 사이트를 적으면 됩니다.
별도의 웹 사이트가 있는 경우엔 웹 사이트를 적으면 되고, 적당히 GitHub 등의 저장소 주소를 적어도 됩니다.

## description

- 필수 필드: False
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: short, summary description of the package

패키지에 대한 짧은 설명입니다.
GitHub으로 예를 들자면 저장소 소개를 짧게 적는 칸 같은 느낌입니다.
너무 길지 않게 적는 것이 좋습니다.

## long_description

- 필수 필드: False
- 필드 타입: `bytes`
- 출처: distutils
- 공식 설명: longer description of the package

PyPI에서 패키지 설명 본문으로 사용됩니다.
보통 README로 작성된 것을 읽어서 불러들여서 씁니다.
주의할 점은, 이 부분은 [Restructured Text](http://docutils.sourceforge.net/rst.html)로 작성되어야만 합니다.
markdown 등의 포맷은 전혀 지원되지 않으니 주의를 요합니다.

## download_url

- 필수 필드: False
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: location where the package may be downloaded

패키지를 어디서 다운받을 수 있는지를 적습니다.
실제 다운로드에 쓰이는 것은 아니고, PyPI 사이트에 출력하는 용도로 쓰입니다.
보통 저장소에서 제공하는 tarball 등을 다운로드 대상으로 삼습니다.

## classifiers

- 필수 필드: False
- 필드 타입: `list` of `str`
- 출처: distutils
- 공식 설명: a list of classifiers

이 패키지가 어느 분류에 속하는지 설명하는 용도로 쓰입니다.
넣을 수 있는 속성은 아무렇게나 넣어도 동작은 하는 것 같지만, 대체적으로 이미 정형화되어있는 단어들을 쓰는 편입니다.
[PyPI의 공식 목록](https://pypi.python.org/pypi?%3Aaction=list_classifiers)을 참고하시면 됩니다.
PyPI 사이트에서 태깅 형태로 사용됩니다.

## license

- 필수 필드: False
- 필드 타입: `str`
- 출처: distutils
- 공식 설명: license for the package

패키지의 저작권을 적는 필드입니다.
본디 용도는 `classifiers`만으로 설명이 안되는 저작권을 설명하는 용도입니다.

## packages

- 필수 필드: True
- 필드 타입: `list`
- 출처: distutils
- 공식 설명: 없음

해당 패키지에 포함될 내용을 기입하는 용도로 쓰입니다.
보통 직접 작성 안하고 `setuptools.find_packages` 함수를 사용합니다.

## zip_safe

- 필수 필드: False
- 필드 타입: `bool`
- 출처: setuptools
- 공식 설명: [공식 자료 참조](https://pythonhosted.org/setuptools/setuptools.html#new-and-changed-setup-keywords)

zip 파일로 만들어서 실행해도 패키지가 정상적으로 동작하는지에 대한 설정입니다.

## install_requires

- 필수 필드: False
- 필드 타입: `str` or `list`
- 출처: setuptools
- 공식 설명: [공식 자료 참조](https://pythonhosted.org/setuptools/setuptools.html#new-and-changed-setup-keywords)

패키지를 사용하기 위해 필요한 의존성 목록입니다.
[의존성 목록은 문자열로 줘도 알아서 잘 인식하지만](https://pythonhosted.org/setuptools/setuptools.html#declaring-dependencies) 보통 `list`나 `set`형을 사용해서 표현합니다.

```py
setup(
    ...,
    install_requires={
        'click >= 5.1',
    },
    ...,
)
```

## entry_points

- 필수 필드: False
- 필드 타입: `dict`
- 출처: setuptools
- 공식 설명: [공식 자료 참조](https://pythonhosted.org/setuptools/setuptools.html#new-and-changed-setup-keywords)

해당 값을 지정하면 Command line 명령어를 만들어줍니다.
실제로 어떻게 사용되는지 예제를 들자면 다음과 같습니다.

```py
setup(
    ...,
    entry_points={
        'console_scripts': [
            'ugoira=ugoira.cli:ugoira',
        ],
    },
    ...,
)
```

이렇게 지정하면 터미널에서 `ugoira`라는 명령어를 실행하면 내부적으로 `ugoira.cli`의 `ugoira` 함수가 실행됩니다.

## extras_require

- 필수 필드: False
- 필드 타입: `dict`
- 출처: setuptools
- 공식 설명: [공식 자료 참조](https://pythonhosted.org/setuptools/setuptools.html#new-and-changed-setup-keywords)

`install_requires`와 작성 요령이 비슷합니다.

```py
setup(
    ...,
    extras_require={
        'tests': {'pytest >= 2.8.3',},
        'docs': {'Sphinx >= 1.3.1',},
    },
    ...,
)
```

이런 식으로 지정해놓으면 나중에 추가 의존성들을 설치할 때 용이합니다.
가령 위에서 지정한 `docs`의 의존성들을 설치하려면 다음과 같이 합니다.

```bash
pip install -e .[docs]
```

## tests_require

- 필수 필드: False
- 필드 타입: `str` or `list`
- 출처: setuptools
- 공식 설명: [공식 자료 참조](https://pythonhosted.org/setuptools/setuptools.html#new-and-changed-setup-keywords)

`install_requires`와 작성 요령이 아예 같습니다.
다만 여기에 지정된 의존성은 테스트용으로 지정됩니다.

---

사실 이 외에도 더 많은 속성들이 존재합니다만, 이 정도만 있어도 일반적인 패키지 작성엔 부족함이 없다고 생각합니다.
이 이상의 기능으로 패키지 구성이 필요한 경우라면 [setuptools 공식 문서](http://pythonhosted.org/setuptools/)를 참고하시면 됩니다.[^1]

[^1]: 사실 제가 이것 이상으로 복잡한 무언가를 구성해보지 못했습니다.


Python으로 개발하다보면 setup.py를 작성할 일이 많은데, 사용되는 인자가 무엇이 있는지 알아보았습니다.

Arguments of setuptools.setup

setup.py의 setup함수에 넣을 수 있는 인자


예전 블로그에서 PHP 7의 RFC에 대한 이야기를 다룬 적 있습니다.
그 후로 PHP는 실제로 PHP 7rc6까지 진행되었는데, 차일피일 미루다가 오늘 깔아서 내가 우려하던 문제들이 어떻게 되었는지를 알아보았습니다.

## 1. Spaceship operater

- RFC: [https://wiki.php.net/rfc/combined-comparison-operator](https://wiki.php.net/rfc/combined-comparison-operator)

저는 `<=>` 연산자와 PHP의 타입 처리가 만나면 어찌 될 지 우려했었습니다.

### Source

```php
<?php
var_dump("1eee" <=> 1);

```

### Result

```
int(0)
```

0이 무슨 의미인지 궁금하실텐데, C, C++, PHP의 `strcmp` 함수를 생각하면 됩니다.
문자열 `"1eee"` 과 정수 1은 같다(`==`)는 의미입니다.
이 문제는 [Magic Hashs](https://blog.whitehatsec.com/magic-hashes/)라고 하는 것의 연장선인데, 결국 PHP는 이 문제를 해소할 생각이 없다는 것으로 보여집니다.

## 2. jsond 구현체 사용

- RFC: [https://wiki.php.net/rfc/jsond](https://wiki.php.net/rfc/jsond)

사용자 입장에선 구현체만 변경되었으므로 차이가 없습니다.
따라서 아래의 문제도 그대로 따라옵니다.

### Source

```php
<?php
var_dump(json_decode('NULL'));
var_dump(json_decode('[}'));

```

### Result

```
NULL
NULL
```

여전히 정말 NULL이 넘어온 것인지, decode 실패인 것인지 결과만 봐서는 알 수 없습니다.

## 3. type 선언

- Return Types: [https://wiki.php.net/rfc/return_types](https://wiki.php.net/rfc/return_types)
- Scalar Types: [https://wiki.php.net/rfc/scalar_type_hints_v5](https://wiki.php.net/rfc/scalar_type_hints_v5)

함수 등을 선언할 때에 인자의 변수형이나 반환값의 변수형을 미리 선언할 수 있도록 해주는 부분입니다.
제가 예제를 따로 만들기보다는 그냥 공식 문서가 더 나은 것 같아서 예제는 생략합니다.

## 4. intdiv

- RFC: [https://wiki.php.net/rfc/intdiv](https://wiki.php.net/rfc/intdiv)

Python의 `//` 연산자를 만들자는 제안이었는데, 이미 PHP에선 `//`가 한 줄 주석으로 쓰이고 있는 관계로 `%%`를 제안했다가 연산자는 거부당하고, failback으로 제안되었던 `intdiv`라는 함수가 통과되었습니다.

### Source

```php
<?php
var_dump(100/3);
var_dump(intdiv(100, 3));

```

### Result

```
float(33.333333333333)
int(33)
```

왜 이것이 필요하냐고 묻는다면, 앞에서 다룬 Return Type이 강제 모드(`declare(strict_types=1);`)일 경우, 섣불리 나누기를 할 수 없기 때문입니다.

## 5. Null Coalesce Operator

- RFC: [https://wiki.php.net/rfc/isset_ternary](https://wiki.php.net/rfc/isset_ternary)

예전엔 특정 변수에 기본 값을 주려면 상당히 피곤했습니다.

```php
<?php
$page = isset($_GET['page'])&&(int)$_GET['page'] ? (int)$_GET['page'] : 1;

```

하지만 이러한 작업을 다음과 같이 줄여주는 새 연산자 `??`가 추가되었습니다.

```php
<?php
$page = (int)$_GET['page'] ?? 1;

```

이제 이렇게만 하면 됩니다.
(단, 이 소스는 `$page`가 음수가 되는 경우는 고려하지 않습니다)

## 6. Integer Semantics

- RFC: [https://wiki.php.net/rfc/integer_semantics](https://wiki.php.net/rfc/integer_semantics)

간단히 말하면 미쳐날뛰던 PHP의 상수들을 `int`형으로 cast했을 때의 동작을 재정의합니다.

예제가 잘 되어있으므로 굳이 예시를 들기 위한 새 코드는 짜지 않지만, 이런 문제는 남아있습니다.

### Source

```php
<?php
var_dump(1 > INF);
var_dump(1 > (int)INF);

```

### Result

```
bool(false)
bool(true)
```

저는 이것도 [PHP Sadness](http://phpsadness.com/)에 등록되지 않을까 조심스레 추측해봅니다.

## 7. Syntax

- Abstract Syntax Tree: [https://wiki.php.net/rfc/abstract_syntax_tree](https://wiki.php.net/rfc/abstract_syntax_tree)
- Uniform Variable Syntax: [https://wiki.php.net/rfc/uniform_variable_syntax](https://wiki.php.net/rfc/uniform_variable_syntax)

PHP의 모호했던 문법적 요소들이 체계적으로 정립됩니다.
예를 들어 아래와 같은 소스도 **한 줄에서** 가능해집니다.

### Source

```php
<?php
$second_element_first_char = explode('<>', '123<>456')[1][0];
var_dump($second_element_first_char);

```

### Result

```
string(1) "4"
```

## 8. Unicode Codepoint Escape Syntax

- RFC: [https://wiki.php.net/rfc/unicode_escape](https://wiki.php.net/rfc/unicode_escape)

문자열에 특정 유니코드값의 문자열을 넣을 수 있습니다.
넣으면 자동으로 UTF-8로 치환됩니다.

### Source

```php
<?php
$mizaru = "\u{1F648}";
$kikazaru = "\u{1F649}";
$iwazaru = "\u{1F64A}";
$three_wise_monkeys = "$mizaru $kikazaru $iwazaru";
var_dump($three_wise_monkeys);

```

### Result

```
string(14) "🙈 🙉 🙊"
```

사용된 예제는 [Three Wise Monkeys](https://en.wikipedia.org/wiki/Three_wise_monkeys)라고 하는 일본에서 유래한 것입니다.
주의할 점은, 유니코드를 지원하는 것이 아니라, 유니코드를 넣으면 UTF-8로 바꿔줄 뿐이라는 것입니다.
실제로 5글자가 아니라 14글자라고 하는 부분을 주목해주세요.

---

이 외에도 여러가지 기능들이 추가되었고, 7.0 이후에 추가될 기능들은 아직도 투표중이기도 합니다.
아직 이해할 수 없는 것들 투성이지만[^1] 그래도 PHP 진영도 나름대로 좋아지기 위해 노력하는 것이 느껴져서 PHP로 프로그래밍을 시작한 사람으로써 기분이 좋습니다.

[^1]: [`in` 연산자가 거절당했다](https://wiki.php.net/rfc/in_operator)던가 하는 부분은 여전히 이해가 안갑니다.


PHP 7.0rc6를 사용해보고 적은 짤막한 사용 후기 입니다.

PHP 7.0rc6 짤막 사용 후기


Python에서, 특정 object에 `[]` 연산자를 사용하면 내부적으론 `__getitem__`이라는 메소드가 실행됩니다.
예를 들어서 `arr[1]` 이라고 했다면 `arr.__getitem__(1)` 과 같이 변경되는 것이죠.
그렇다면 slice를 사용하면 어떻게 될까요?
slice가 무엇인지 모르시는 분들을 위해 간략히 예를 들자면 이런 것입니다.

```py
>>> arr = list(range(10))
>>> arr
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
>>> arr[0:4]
[0, 1, 2, 3]
>>> arr[3:8]
[3, 4, 5, 6, 7]
>>> arr[0:7:3]
[0, 3, 6]
>>> arr[9:0:-1]
[9, 8, 7, 6, 5, 4, 3, 2, 1]
```

그런데, 가끔은 `__getitem__`을 직접 구현해야 하는 경우가 있습니다. 이런 경우엔 어떻게 해야할까요?

## `__getitem__`의 동작

먼저, `__getitem__`이 slice를 만났을 때 어떻게 동작하는지 알아보겠습니다.
테스트를 위해 간단한 class를 작성했습니다.

```py
>>> class A:
...   def __getitem__(self, item):
...     print(repr(item))
...
>>> a = A()
>>> a[1]
1
>>> a[1:2]
slice(1, 2, None)
>>> a[1:2:3]
slice(1, 2, 3)
>>> a[1, 2, 3]
(1, 2, 3)
>>> a[1, 2, 3:4]
(1, 2, slice(3, 4, None))
>>> a[1, 2, 3:4, ...]
(1, 2, slice(3, 4, None), Ellipsis)
```

우리는 여기서 3가지 사실을 알 수 있습니다.

1. `:`를 사용한 경우 slice가 생성된다.
2. `,`로 나눠서 적으면 tuple에 나눠서 저장된다.
3. `...`은 `Ellipsis`라는 형태로 처리된다.

아직은 알쏭달쏭합니다.

## tuple이 주어졌을 때의 동작

일단 tuple이 주어지면, 즉 `,`를 사용하면 어떻게 되는지 알아보도록 하겠습니다.

```py
>>> arr = list(range(10))
>>> arr[1, 4]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: list indices must be integers or slices, not tuple
```

일단 일반적으로는 사용할 수 없습니다.
아무래도 확장성을 위한 영역으로 추정됩니다.

[지난번에도 글로 썼었지만 기본 자료형을 상속해서 새 자료형을 만들 수 있습니다.](https://item4.github.io/2015-07-24/Extension-of-Basical-Data-Type.html)
한번 새 class를 list를 상속해서 만든 다음 제 맘대로 동작하도록 바꿔보도록 하죠.
예를 들어 `arr[1, 4]`라고 하면 `[arr[1], arr[4]]`가 리턴되도록 해보겠습니다.

```py
>>> class MyList(list):
...   def __getitem__(self, item):
...     if isinstance(item, tuple):
...       return [self[i] for i in item]
...     else:
...       return super().__getitem__(item)
...
>>> arr = MyList(range(100, 1000, 100))
>>> arr
[100, 200, 300, 400, 500, 600, 700, 800, 900]
>>> arr[1]
200
>>> arr[4]
500
>>> arr[1, 4]
[200, 500]
```

## slice는 어떻게 사용할까?

이 글을 쓰게 된 계기이기도 한데, slice의 사용법은 Python 공식 웹 문서에 **없습니다**.
[slice는 class인데, Built-in Functions 챕터에 소개되어 있습니다.](https://docs.python.org/3/library/functions.html#slice)
하지만 어떻게 사용할지에 대한 정보는 하나도 담겨있지 않습니다.

그렇다면 slice의 사용법은 어떻게 알 수 있을까요?[^1]
Python은 이런 부분들에 대한 문서를 `help` 함수를 통해 확인할 수 있게 해두었습니다.

```py
>>> help(slice)

class slice(object)
 |  slice(stop)
 |  slice(start, stop[, step])
 |
 |  Create a slice object.  This is used for extended slicing (e.g. a[0:10:2]).

... (중략)

 |  indices(...)
 |      S.indices(len) -> (start, stop, stride)
 |
 |      Assuming a sequence of length len, calculate the start and stop
 |      indices, and the stride length of the extended slice described by
 |      S. Out of bounds indices are clipped in a manner consistent with the
 |      handling of normal slices.
 |
 |  ----------------------------------------------------------------------
 |  Data descriptors defined here:
 |
 |  start
 |
 |  step
 |
 |  stop

... (후략)

```

slice는 `indices`라는 메소드와 `start`, `step`, `stop`이라는 프로퍼티를 가지고 있습니다.

일단 간단한 프로퍼티들부터 실제 실행 사례와 함께 살펴보겠습니다.

```py
>>> s = slice(100, 200, 300)
>>> s.start
100
>>> s.stop
200
>>> s.step
300
```

slice를 생성할때 쓰인 값이 그대로 저장되어 있음을 알 수 있습니다.

그렇다면 `indices`는 어떻게 사용할까요?

```py
>>> s = slice(1, 1000, 3)
>>> s.indices(10)
(1, 10, 3)
>>> s.indices(100)
(1, 100, 3)
>>> s.indices(1000)
(1, 1000, 3)
>>> s.indices(10000)
(1, 1000, 3)
```

slice는 길이값을 요구하는데, 길이 값에 따라 실제 slice해야하는 영역을 알려줍니다.
이 결과값을 이용하면 이런 식으로 사용이 가능합니다.

```py
>>> list(range(*s.indices(10)))
[1, 4, 7]
>>> list(range(*s.indices(100)))
[1, 4, 7, 10, 13, 16, 19, 22, 25, 28, 31, 34, 37, 40, 43, 46, 49, 52, 55, 58, 61, 64, 67, 70, 73, 76, 79, 82, 85, 88, 91, 94, 97]
```

반환되어 나오는 값의 양식이 `range`의 인자 순서와 일치하기 때문에, 바로 unpack해서 사용할 수 있습니다.
실제로 slice를 구현해야한다면 이런 식으로 사용할 수 있을 것입니다.

```py
>>> class MySpecialStructure:
...   def __getitem__(self, item):
...     if isinstance(item, slice):
...       return ['item-{}'.format(i) for i in range(*item.indices(self.length))]
...     else:
...       return super().__getitem__(item)
...
>>> m = MySpecialStructure()
>>> m.length = 10
>>> m[1:1000:3]
['item-1', 'item-4', 'item-7']
>>> m.length = 100
>>> m[1:1000:3]
['item-1', 'item-4', 'item-7', 'item-10', 'item-13', 'item-16', 'item-19', 'item-22', 'item-25', 'item-28', 'item-31', 'item-34', 'item-37', 'item-40', 'item-43', 'item-46', 'item-49', 'item-52', 'item-55', 'item-58', 'item-61', 'item-64', 'item-67', 'item-70', 'item-73', 'item-76', 'item-79', 'item-82', 'item-85', 'item-88', 'item-91', 'item-94', 'item-97']
```

## `Ellipsis`는 무엇인가?

`Ellipsis`, 또는 `...`은 Python 3에서 정식적으로 사용 가능한 상수가 되었는데, 공식적으로 딱 어떻게 사용하라는 지침은 없습니다.
즉, 개발자가 필요에 따라 사용할 수 있는 부분입니다.

## 응용하기

`Ellipsis` 등등을 개발자 맘대로 사용하는 예를 들기 위해 저는 아까 위에서 만든 `MySpecialStructure`를 조금 더 확장해보고자 합니다.
예를 들어 `length`가 7인 `arr`를 `arr[2:4, ...]`과 같이 사용하면 `['item-2', 'item-3', 'item-4', 'item-5', 'item-6']`이 나오게 하는 것이죠.

아래 코드와 같은 방식으로 구현이 가능합니다.
tuple이 오는 경우의 처리를 위해 재귀호출로 구현되어 있습니다.
본 코드는 위에 예를 든 `arr[2:4, ...]` 외에도 `arr[1, 1, 1]`, `arr[2:4, ..., 40:80]` 등에도 모두 대응하여 동작합니다.
다만 문자열등의 예상치 못한 자료형을 넣은 경우 등에는 대응하지 못합니다.

```py
class MSS:
    def __getitem__(self, items):
        def getitem(item, before_stop=None, after_item=None, return_before_stop=False):
            if isinstance(item, tuple):
                after_items = list(item)[1:] + [None]
                result = []
                for x, a in zip(item, after_items):
                    res, before_stop = getitem(x, before_stop, a, True)
                    if isinstance(res, list):
                        result += res
                    else:
                        result.append(res)
                return result
            elif isinstance(item, slice):
                range_ = range(*item.indices(self.length))
                result = [getitem(x) for x in range_]
                if return_before_stop:
                    return result, range_[-1]
                else:
                    return result
            elif item is Ellipsis:
                if before_stop is not None:
                    before_stop += 1
                after_start = after_item
                if isinstance(after, slice):
                    after_start = after_item.start
                result = getitem(slice(before_stop, after_start), return_before_stop=True)
                if return_before_stop:
                    return result[0], result[1]
                else:
                    return result[0]
            else:
                if item >= self.length:
                    raise IndexError('너무 큰 값')
                elif item < 0:
                    raise IndexError('너무 작은 값')
                result = 'item-{}'.format(item)
                if return_before_stop:
                    return result, item
                else:
                    return result
        return getitem(items)

```

제 코드는 순전히 예제를 위한 것이지만, 실제로 이러한 `__getitem__`의 확장은 [numpy](http://www.numpy.org/)에서 쓰이고 있습니다.
여러분의 코드가 이러한 확장적인 구조를 필요로 한다면 한번쯤 고려해보시는건 어떨까요?

[^1]: 사실 저는 `help`의 존재를 까먹고 [slice의 Python 내부 구현](https://hg.python.org/cpython/file/tip/Objects/sliceobject.c)을 먼저 살펴봤습니다.


Python에선 Sequencial 자료 구조를 다룰 때 slice를 사용할 수 있습니다. slice는 어떻게 사용하는 것인지 찾아보았습니다.

Python __getitem__과 slice의 이해


지난 밤 이상한모임에선 [이모콘](https://www.youtube.com/channel/UCtznARkZ73hblB3HcWjEmPQ/videos)이란 이름 하에 온라인 컨퍼런스를 개최하였습니다.
그 중에 [@nipol](https://twitter.com/NipolNIpol)님께서 [JSPM으로 시작하는 Systemjs](https://www.youtube.com/watch?v=pZLy24saKXU)라는 발표를 하셨고, 채팅창은 혼란에 빠졌습니다. 발표 내용이 무슨 소린지 이해할 수 없다는 평이었는데, 사실 그럴 수 밖에 없었습니다.
Front-end 개발 방법이 시간이 흐름에 따라 아예 바뀌어버렸으니까요.

이 글은 (제가 아는 한도 내에서) Front-end 개발이 어떻게 바뀌었고, @nipol님의 발표는 무슨 의미인 것인지 해석을 해보고자 합니다.

## Front-end?

이 용어 자체가 생소하신 분도 있으실 거라 봅니다.
대체적으로 HTML, CSS, (Client Side) JavaScript를 의미합니다.
즉, 웹 브라우저에서 이뤄지는 작업을 말합니다.

## 옛날 옛적에

DHTML 전쟁이 있었습니다.
그 과정에서 정말 이상한 것들이 생겼다가 사라졌죠.
그 전쟁의 승자는 Internet Explorer이었고, 현재도 한국에서 군림하고 있죠.

## Table based layout

CSS로 디자인을 한다는 개념이 보급되기 전에는 웹 페이지를 딱 정해진 사이즈로 출력해서 보여줄 방법이 마땅치 않았기 때문에 `<table>` 태그로 구조를 잡았습니다.

이 당시의 CSS, JavaScript는 정말 신기한 존재로써, 대부분의 개발자가 **"외계의 어느 누군가가 만들어 놓은 것을 퍼다가 쓰는 것"** 이라고 여겼습니다.

## XHTML과 Ajax

하지만 `<table>`은 레이아웃을 잡으라고 있는 태그가 아니었습니다.
이에 불만을 품은 개발자들이 `<div>` 태그와 CSS를 사용해서 레이아웃을 잡기 시작했죠.
이때 널리 쓰인 HTML 표준이 XHTML입니다.
적어도 HTML 4.01보다는 제정신이었거든요.

그리고 구글에서 Ajax라는 것을 선보여서[^1] 다들 그걸 쓰고 싶어했습니다.
이때부터 사람들이 CSS와 JavaScript를 직접 손대야한다는걸 인지하기 시작한 것 같습니다.

## jQuery

하지만 당시 웹 브라우저 현황은 끔찍했습니다.
구버전 브라우저에서도 잘 돌아가는 사이트를 만들기 위해서는 너무 복잡한 과정이 필요했죠.
특히나 Ajax를 쓰기 위한 과정은 너무나도 다르고, 그걸 직접 만지기 위해서는 너무나도 피곤했죠.

그 과정에서 여러 라이브러리가 생겨났다가 잊혀졌고, 승자는 jQuery가 되었습니다.
jQuery는 편한 API로 누구나 쉽게 쓸 수 있게 되어있었고, 그마저도 많은 개발자들이 붙어서 여러가지 플러그인을 만들어서 사용자는 플러그인들을 마음대로 퍼다가 쓰면 되게 되었습니다.

## 의존성 지옥

하지만 플러그인을 집어다 쓰다보니 문제점이 생겨나게 됩니다.
서로간에 **의존성**이 있어서, 가져다 붙이는데에 순서가 중요해진 것입니다.

예를 들어서 Bootstrap을 가져다 붙인다고 치면 의존성 순서는 다음과 같이 될 것입니다.

1. jQuery
2. Bootstrap
3. 나머지 직접 짠 소스들

Bootstrap은 jQuery에 의존성이 있습니다.
만약 여기다가 jQuery-ui 등등을 더 가져다가 붙이면 어떻게 될까요?
플러그인이 한 5개만 되더라도 의존성을 표현하는 것이 매우 피곤해질 것입니다.

## Bower

이런 상황에서 브라우저가 아닌 환경에서 JavaScript를 실행할 수 있게 됩니다.
여러분이 알고 있는 Node.js가 바로 그것이죠.
그리고 그것을 바탕으로 JavaScript를 할 줄 알던 개발자들이 **조금 더 제정신으로** JavaScript 의존성을 관리해보자며 만들어낸 것이 Bower입니다.

![Bower](https://avatars1.githubusercontent.com/u/3709251?v=3&s=400)

Bower는 Front-end에서 사용하는 것들의 의존성을 설치해주는, 나름대로 착한 의도를 가진 프로그램이었죠.

## 저 새는 해로운 새다

하지만 Bower는 다운로드만 해줄 뿐 의존성 지옥에서 구원해주진 못했습니다.
별도의 파일이 생겨서 따로 관리를 해줘야 하는 점, bower_components를 서버에 올려야 하는 등 귀찮음을 더 증폭시켜주었습니다.
@nipol님이 Bower가 싫다고 하신건 그런 연유에서죠.

![해로운 새](badbird.jpg)

그냥 npm을 쓰는 것이 더 좋은 지경이 되었고, 지금 실제로도 그러합니다.

## less, Sass, Coffee

이 와중에 CSS와 JavaScript를 좀 더 편하게 써보고자 하는 시도는 더 늘어갔습니다.
node 진영의 less, ruby 진영의 sass같은 CSS의 super-set 언어도 나왔고, CoffeeScript같은 언어도 나왔죠.

이런것들까지 섞이다보니 의존성 지옥은 더 심각해져갔습니다.

## 그래서, JSPM

이 문제를 해결해주는 솔루션으로 이번 발표에선 JSPM이 소개되었습니다.
JSPM은 SystemJS 기반으로 의존성 관리를 해줍니다.

여기부터는 실제 발표를 따라가보겠습니다.
따라하기 위해서는 Node.js가 필요합니다.

### 설치

일단 jspm을 설치합니다.

```
$ npm install -g jspm
```

그리고 실습을 해볼 디렉토리를 만듭시다.

```
$ mkdir drugstore
$ cd drugstore
```

### 초기화

jspm을 실행해봅시다
뭐 물어보는 부분에선 그냥 enter키만 누르시면 됩니다.

```
$ jspm init .

Would you like jspm to prefix the jspm package.json properties under jspm? [yes]:
Enter server baseURL (public folder path) [./]:
Enter jspm packages folder [./jspm_packages]:
Enter config file path [./config.js]:
Configuration file config.js doesn't exist, create it? [yes]:
Enter client baseURL (public folder URL) [/]:
Do you wish to use a transpiler? [yes]:
Which ES6 transpiler would you like to use, Babel, TypeScript or Traceur? [babel]:
```

### 패키지 설치

이제 패키지를 잔뜩 깔아서 의존성을 뒤섞어봅시다.
library로 React를 쓸 것이고, 클라이언트에서 출력할 것이므로 react-dom도 필요합니다.
이모콘에서는 react-dom을 쓰지 않으시려고 0.13.3 버전을 사용하셨었으니 이 부분이 살짝 다를 것입니다.
Bootstrap도 깔아서 CSS 용도로 쓸 생각입니다.
jspm은 이름 그대로 js가 기본이고 나머지는 계산 밖의 물건이므로 CSS 처리를 위해 css 확장도 설치해야합니다.

```
$ jspm install css
$ jspm install react
$ jspm install react-dom
$ jspm install bootstrap
```

### CSS 설정

CSS도 읽어오도록 설정을 해야합니다. `config.js`에 다음 내용을 적절히 추가합니다.

```js
  meta: {
    "github:twbs/bootstrap@3.3.5": {
        "deps": [
          "github:twbs/bootstrap@3.3.5/css/bootstrap.min.css!"
        ]
    }
  },
```

### 돌려봅시다

먼저 index.html을 만들어봅시다.
`<body>` 안에 `<script>` 태그 외에 아무것도 넣지 않았음을 주목해주세요.

```html
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8" />
    <title>약 사세요</title>
  </head>
  <body>
    <script src="jspm_packages/system.js"></script>
    <script src="config.js"></script>
    <script>
      System.import('app/main');
    </script>
  </body>
</html>
```

다음으론 `app` 디렉토리를 만들고 그 안에 `main.js`를 만들어봅시다.

```js
import 'bootstrap';
import React from 'react';
import ReactDOM from 'react-dom';

class DrugStore extends React.Component {
  render() {
    return (
      <main className='container'>
        <header className='row'>
          <h1>약 사세요!</h1>
        </header>
        <section className='row'>
          <table className='table'>
            <thead>
              <tr>
                <th>번호</th>
                <th>이름</th>
                <th>가격</th>
              </tr>
            </thead>
            <tbody>
              <tr>
                <td>1</td>
                <td>React</td>
                <td>Free!</td>
              </tr>
              <tr>
                <td>2</td>
                <td>AngularJS</td>
                <td>Free!</td>
              </tr>
            </tbody>
          </table>
        </section>
      </main>
    );
  }
}

ReactDOM.render(<DrugStore />, document.body);
```

눈에 보이는 것이 많이야 이해가 쉬울 것 같다고 생각했기에 발표때랑 달리 조금 더 많은 내용을 일부러 넣어보았습니다.
해당 소스는 React를 알아야 이해할 수 있는데, 간단히만 설명드리자면 HTML 태그처럼 생긴 것들이 자동으로 JavaScript로 변환되서 실행될 것입니다.

이제 간단히 웹서버를 실행해서 접속해봅시다.
다음 명령어를 실행한 후에 `http://localhost:8000`에 접속하시면 됩니다.

```
$ python -m SimpleHTTPServer
```

### 결과물

![결과물](result.png)

### 이게 무슨 의미가 있나요?

사실 jspm이 필요 없는 분도 많이 계실겁니다.
jQuery랑 플러그인 몇 가지 정도만 붙여서 쓸 거라면 차라리 직접 다운로드 받아서 배치하는게 더 좋을지도 모르죠.
하지만 의존성이 좀 더 복잡해지면 복잡해질수록, JavaScript로 구현해야 하는 부분이 많아질수록 문제는 더욱 힘들어집니다.

지금 당장 만든 예제만 하더라도 `jspm bundle-sfx` 명령어로 수행된 파일을 사용하지 않으면 의존성을 모두 브라우저 상에서 실행하는 걸 볼 수 있는데, 사용되는 의존성만 하더라도 200개 가까이 됩니다. 이걸 일일히 `<script>` 태그를 써서 나열하는 것은 너무 이상하지 않을까요?

## 개인적인 소감

의존성 문제를 해결해주는 친절한 기능이 눈에 띕니다.
실제로 제가 최근 작업한 사이트는 의존성을 `bower`로 관리하다가 `gulp`와 `npm`으로 바꿨는데 그래도 아쉬움이 남아있는 상태였습니다.
예를 들어 `gulp-copy2`를 이용해서 의존성 파일을 옮겨준 다음에 `babel`을 돌려야 한다던가 하는 점 등등이 상당히 피곤했습니다.
하지만 jspm을 쓰면 그 부분은 말끔히 정리가 가능하므로 상당히 기대가 되는 편입니다.

근데 SCSS는 지원하지 않는 문제[^2] 등이 있는데, 그 부분은 `gulp`로 파일을 따로 만들거나 `webpack`을 쓴다던가 하는 방법 외엔 아직 뚜렷히 떠오르는 대안이 없다는 아쉬움이 있습니다.

## 결론

신약입니다.
아직 임상실험이 덜 되서 아쉬운 부분이 있지만 앞으로 좋아지지 않을까 하고 기대해봅니다.

다만 공부할 게 좀 많으니까 한번에 다 먹는건 힘듭니다.
천천히 공부하면서 음미하시면 될 것 같습니다. :)

[^1]: 사실 좀 더 옛날부터 있던 기술이었는데 구글에서 효과적으로 사용해서 재조명 받은 것이죠.
[^2]: 아직 SystemJS쪽에서 개발한 loader가 없습니다. [비공식 로더는 존재하는데](https://github.com/screendriver/plugin-sass), 문제는 웹 문서에 어떻게 적용하는지 방법이 안나와있습니다. 예를 들어 `import 'bootstrap.css!'` 같은 것을 SCSS 문법 내에서 어떻게 사용하는가 하는 점 등등.


이상한모임의 이모콘2015에서 @nipol 님의 발표를 듣고 힘드셨던 분들을 위한 부연 설명입니다. 요즘 Front-end 개발은 어떻게 흘러가는지 아주 간단한 이야기를 다룹니다.

요즘 Front-end 개발 이야기


저는 이제까지 게시물 구독을 위해 Newsflow라는 OSX용 프로그램을 사용했었습니다.
하지만 언제부턴가 원인은 모르겠지만 동작이 이상해지더군요.
그래서 결국 TT-RSS로 이사를 결정했습니다.

TT-RSS를 선택한 이유는 일단 무료입니다.
Newsflow는 유료였지만 무료 이벤트일때 구했었죠.
지갑 사정이 여의치 않으므로 돈을 쓰긴 애매했습니다.
그리고 집에서 놀고있는 서버를 써먹을 수 있다는 점도 한 몫 했습니다.

## 다운로드

이유는 모르겠지만 TT-RSS 공식 사이트는 한국에서 접속이 안됩니다.
다행히도 제가 TT-RSS를 깔고 싶어하자, 저기 접속이 가능하신분께서 [GitHub에 미러를 만들어 주셨습니다.](https://github.com/dittos/ttrss-mirror)

Git이므로 그냥 손쉽게 clone하면 됩니다.

```
$ git clone https://github.com/dittos/ttrss-mirror.git
```

## Nginx 세팅

보통 게시물을 찾아보면 Apache2를 사용하는데, 저는 Python 개발을 자주 하고, Apache의 특정 기능이 필요한 것이 아니라 그냥 PHP를 구동만 하면 되는 것이므로 Nginx를 설치해보기로 했습니다.

```
$ sudo apt-get install nginx
```

Nginx가 어디를 index로 잡고 있는지 확인해봅니다.

```
$ cat /etc/nginx/sites-available/default | grep root
```

제 경우엔 `/var/www/html/`로 되어 있었습니다.
이 위치는 중요하니 메모해둡시다.
앞으로 이 글에선 `/var/www/html/`이라고 가정하고 작성합니다.
값이 다르신 분들은 변경해서 작업해주세요.

## PHP 세팅

TT-RSS는 PHP로 되어 있습니다.
설치를 위해서는 PHP가 가능한 환경이 필요합니다.

```
$ sudo apt-get install php5 php5-fpm
```

그 다음 `php.ini`에서 `Engine = On`으로 설정해줍니다.

```
$ sudo vi /etc/php5/fpm/php.ini
```

변경사항의 적용을 위해 서비스를 재시작합니다.

```
$ sudo systemctl restart php5-fpm
```

제대로 되었는지 테스트용 파일을 하나 만들어서 실험해봅시다.
다음 내용을 `/var/www/html/`에 `test.php`란 파일명으로 저장해주세요.

```php
<?php
phpinfo();

```

그리고 접속이 가능한지 확인해봅시다.

```
$ curl localhost/test.php
```

## PostgreSQL 세팅

TT-RSS는 MySQL과 PostgreSQL 중 한가지 DBMS를 선택하여 사용할 수 있습니다.
어차피 홈서버에 설치하는 것이니 PostgreSQL을 설치하기로 했습니다.

```
$ sudo apt-get install postgresql postgresql-contrib
$ sudo systemctl start postgresql
```

그 다음엔 User를 생성해야하는데 그러려면 postgres 유저의 권한이 필요합니다.

```
$ sudo su
# su - postgres
```

postgres 유저로 접근한 김에 postgres 유저의 비밀번호도 설정해주도록 하겠습니다.
이를 위해 `psql`을 실행합니다.
`\password`를 이용해서 비밀번호를 생성해줍니다.

```
$ psql
> \password postgres
 ( 비밀번호 생성)
> \q
 (quit)
```

postgres 유저의 인증을 비밀번호로 할 수 있도록 변경해줍시다.
보안상 좋은 세팅은 아니므로 준비가 완료된 후에는 되돌리는게 좋습니다.

```
$ sudo vi /etc/postgresql/9.4/main/pg_hba.conf
```

여기서 METHOD에 해당하는 값(맨 뒷 값)들을 모두 `md5`로 바꿔줍니다.
이렇게 하고 나면 관리 작업을 비밀번호로 할 수 있습니다.

사용자 생성은 `createuser`명령어로 합니다.

```
$ createuser --interactive -P item4
```

사용자 이름과 매칭되는 Database도 만들어줍시다.

```
$ createdb item4
```

이제 볼 일이 끝났으니 logout합시다.

```
$ logout
# exit
```

## 의존성 설치

제 경우엔 PostgreSQL을 사용했으므로 `php5-pgsql`이 필요합니다.
또, TT-RSS가 `php5-curl`을 요구합니다.

```
$ sudo apt-get install php5-pgsql
$ sudo apt-get install php5-curl
```

## 파일 옮기기

아까 위에서 기억했던 `/var/www/html/` 아래로 php 파일들을 옮겨다 놓습니다.

```
$ sudo mv ~/tt-rss/. /var/www/html/tt-rss
```

소유권과 권한도 바꿔줍니다.

```
$ cd /var/www/html/tt-rss
$ sudo chown -R www-data:www-data .
$ sudo chmod -R 777 cache/images
$ sudo chmod -R 777 cache/upload
$ sudo chmod -R 777 cache/export
$ sudo chmod -R 777 cache/js
$ sudo chmod -R 777 feed-icons
$ sudo chmod -R 777 lock
```

## 설치하기

http://localhost/tt-rss/ 로 접속하면 설치 화면이 나옵니다.
요구하는 정보를 모두 입력하시면 설치됩니다.

## Daemon 세팅

TT-RSS는 백그라운드에서 실행될 데몬이 필요합니다.
저는 매번 실행하기 귀찮다고 판단, systemd에 추가해버렸습니다.

다음 내용을 `/etc/systemd/system/tt-rss.service` 란 이름으로 저장합니다.

```
[Unit]
Description=Tiny Tiny RSS Daemon
After=postgresql.service

[Service]
Type=oneshot
ExecStart=/usr/bin/php /var/www/html/tt-rss/update_daemon2.php
User=www-data

[Install]
WantedBy=multi-user.target
```

그 뒤에 이 명령어를 실행합니다.

```
$ sudo systemctl enable tt-rss
$ sudo systemctl start tt-rss
```

잘 되었는지 확인하기 위해 다음 명령어를 실행합니다.

```
$ sudo systemctl status tt-rss
```

## 로그인

기본 관리자 계정 정보는 `admin` / `password` 입니다.

이제 feed를 추가하고 확인해보시면 됩니다.
필요에 따라 계정을 추가하셔도 됩니다.

## 결과물

![TT-RSS](ttrss.png)

## 예상 가능한 문제

### 1. 접속이 아예 안 됨

nginx가 켜져 있지 않으면 그럴 수 있다고 생각합니다.
다음 명령어를 실행해보세요.

```
$ sudo systemctl restart nginx
```

### 2. 설치중 DB에 접속할 수 없다고 함

postgresql 데몬이 켜져 있지 않으면 그럴 수 있다고 생각합니다.
다음 명령어를 실행해보세요.

```
$ sudo systemctl restart postgresql
```

### 3. 새 글을 자동으로 읽어오지 않음

TT-RSS 데몬이 잘못 설정되어있을 것입니다.

## 후기

상당히 유용한 툴임에는 틀림 없으나 입맛에 맛게 뜯어고치고 싶어진다면 꽤 곤란할 것 같습니다.
설치 방법은 꽤 간단히 글로 나왔지만, 사실 Linux 자체에 익숙치 못한 부분들로 인해 설치 도중에 상당히 많은 사고가 있었습니다.
그런 부분까지 모두 다루고 싶었지만 지금와서 되돌아보니 글로 정리하기엔 너무 잡다하더군요.
저의 경우는 Firefox 확장과 Android 어플을 이용해서 글을 구독하고 있습니다.
단독으로 써도 괜찮지만 다른 프로그램들과 같이 쓸 때 더 좋은 것 같습니다.


Open Source RSS Client인 TT-RSS를 설치하는 과정을 설명합니다.

item4 dev story

Posts